Editing Virtuozzo / Linux Reference (section)

= Adding new OS/application templates =

Virtuozzo will lag a bit behind the initial release of an OS, perhaps by a month or more. Further, a newly-released OS may be available, but there may not be many/any application templates available initially. It pays to wait a bit.

A template is easily installed via [[#vzup2date|vzup2date]]:

 vzup2date -z

You will be given a list of OS's to install. Select an OS, then customize that selection by checking/unchecking the application templates we do/don't want to include/offer.

Generally, here are the app templates we include/offer:
<pre>cyrus-imap
devel
imp
jre
jsdk
mailman
mod_perl
mod_ssl
mysql
php
phpmyadmin
phppgadmin
postgresql
proftpd
spamassassin
squirrelmail
tomcat
vsftpd
</pre>

We do not (any longer) offer webalizer or analog.

After selecting and installing the OS and apps, you should ensure it's installed:

 vzpkg list -O

Your new OS (ex. fedora-core-13-x86_64) will be listed, without a corresponding cache date:
<pre>
[root@virt13 /vzconf]# vzpkg list -O
centos-6-x86                       2011-07-22 13:24:41
centos-6-x86_64                    2012-03-09 20:42:22
centos-5-x86                       2009-07-27 16:58:24
centos-5-x86_64                    2012-03-09 22:38:53
ubuntu-11.10-x86_64                2012-03-01 23:13:33
ubuntu-9.04-x86                    2009-06-02 11:32:39
ubuntu-12.04-x86_64                2012-05-29 13:50:50
ubuntu-8.04-x86                    2008-09-17 21:27:20
ubuntu-8.10-x86                    2009-03-13 13:58:57
ubuntu-11.04-x86                   2011-12-05 11:15:46
ubuntu-7.04-x86                    2008-09-24 16:42:50
redhat-el6-x86_64
fedora-core-13-x86_64              
fedora-core-12-x86                 2010-02-06 13:24:32
fedora-core-15-x86                 2011-12-05 11:36:43
fedora-core-11-x86                 2009-10-01 16:30:59
fedora-core-14-x86
fedora-core-16-x86_64              2012-03-13 11:40:23
fedora-core-9-x86                  2008-11-29 10:52:18
debian-6.0-x86                     2011-07-29 16:00:35
debian-6.0-x86_64                  2012-03-12 19:53:33
debian-5.0-x86                     2009-03-12 12:39:11
</pre>

You can also confirm the apps installed:
<pre>[root@virt13 /vzconf]# vzpkg list fedora-core-13-x86_64
fedora-core-13-x86_64              2013-03-08 11:39:44
fedora-core-13-x86_64 devel
fedora-core-13-x86_64 php
fedora-core-13-x86_64 proftpd
fedora-core-13-x86_64 postgresql
fedora-core-13-x86_64 phpmyadmin
fedora-core-13-x86_64 mysql
</pre>

Before you can use the OS you must cache it. To create the cache run:
 vzpkg cache [OS]

ex: <tt>vzpkg cache fedora-core-13-x86_64</tt>

Now it's ready to use. In order to be able to use it with the [[VPS_Management#vm|vm]] command, you must create a file:
 jctmpl-[OS]

ex: <tt>jctmpl-fedora-core-13-x86_64</tt>

In it, on line 1 we place the OS, followed by the app names, ex:
<pre>more jctmpl-fedora-core-13-x86_64
fedora-core-13-x86_64
postgresql
jsdk
mod_ssl
phpmyadmin
mod_perl
tomcat
devel
php
mailman
cyrus-imap
squirrelmail
proftpd
mysql
phppgadmin
spamassassin
</pre>

The packages will be installed in that order, so any pre-req's should be handled there.

Now, when you run [[VPS_Management#vm|vm]] it will show you the newly-added OS and you may create a CT using it.

The last few tasks are related to mgmt:

1. add to mgmt->reference->templates (use the existing templates as an example). Once added, the new template will be included with the list of OS's available for the given HN.
2. if this is going to be a new OS offered for ordering, it needs to be added to the order form and webpage.

a. to get a list of applications and versions in the new OS, you should create a test CT, enter it and run <tt>dpkg -l|sort</tt> (or <tt>rpm -aq|sort</tt> in centos/fedora) and enter that list in the following places:<br>
<tt>/usr/local/www/jc_pub/[osname].html</tt><br>
<tt>/usr/local/www/signup/html/[osname].html</tt><br>
Note, you will have to move the most recent OS data from <tt>/usr/local/www/signup/html/[osname].html</tt> into the corresponding <tt>/usr/local/www/signup/html/[osname]_old.html</tt> updating the version links in both.

b. to add the new OS to the order form, you will need to update <tt>/usr/local/www/signup/html/step1.html</tt> in several places (for regular and OSS orders) as well as updating the templateID which you can get from mgmt->reference->templates (or [[Management_System_/_Public_Website_/_Signup_/_Account_Manager#jc:ref_templates|jc:ref_templates]])



Old method to obtain the templates:

Go to http://www.parallels.com/en/virtuozzo/templates/catalog/

Download the RPM's and install them

 vzpkg list
to see the new packages/os templates

 vzpkg create cache "OS_EZ_template_name"
to create a cache