First, we recommend you to make a list of Apache web servers (Hardware Nodes and VPSs) you wish to upgrade to Apache 2.2. All such hosts will have the Apache application installed.
Then, for each of such hosts, perform the procedure described below.
To upgrade a Hardware Node-based Apache host from Apache 2.0 to Apache 2.2, perform these steps:
1 In your POA Panel, go to Top > Deployment Director > Server Manager > Hardware Nodes >
Hardware Node name > Packages tab > RPM subtab.
2 Make sure that the packages listed below are updated to the following versions:
apr (version 1.2.8-1 or later) apr-util (version 1.2.8-1 or later) httpd (version 2.2.11-1 or later)
httpd-manual (version 2.2.11-1 or later) mod_ssl (version 2.2.11-1 or later) openssl (version 0.9.8b-8 or later) openssl-perl (version 0.9.8b-8 or later) openssl097a (version 0.9.7a-9 or later) pcre (version 6.6-1 or later)
If necessary, update the RPMs using the rpm -Uhv rpm1 rpm2 rpm3 command. If the RPM versions above are unavailable in POA, contact your Parallels
representative to obtain the URL of the POA Updates server.
3 Log on to the target host via SSH as root.
4 To any directory of your choice, upload the following RPMs from the POA distribution:
mod_cband-httpd22x mod_frontpage-httpd22x mod_init_crypto-httpd22x mod_limitipconn-httpd22x mod_mono-httpd22x php4-httpd22x
php4-httpd22x-curl php4-httpd22x-domxml php4-httpd22x-gd php4-httpd22x-imap php4-httpd22x-ldap php4-httpd22x-mbstring php4-httpd22x-mcrypt php4-httpd22x-mhash php4-httpd22x-mysql php4-httpd22x-ncurses php4-httpd22x-odbc php4-httpd22x-pear php4-httpd22x-pgsql php4-httpd22x-snmp php4-httpd22x-xmlrpc php5-cgi-httpd22x php4-ioncube-loader php5-ioncube-loader php4-sqlite2
- for example, using the command: wget <url>
If the RPMs listed in Step 2 are unavailable in POA, upload them from the POA Updates server (the one pointed by your Parallels representative) to the same directory.
Note: The php4-ioncube-loader, php5-ioncube-loader and php4-sqlite2
RPMs are necessary for provisioning of Parallels Plesk Sitebuilder (see page 100); they also install ionCube PHP Loader support and SQLite2 support for PHP 4 on the Apache server.
5 From the same directory, run the RPM update command:
rpm -Uvh rpm1 rpm2 rpm3
Important: In the command, indicate the full list of new RPMs: the ones listed in Step 4
and, if necessary, the ones listed in Step 2.
6 On POA Management Node, re-generate the Apache service configuration files:
Depending on the platform of your POA Management Node, log in to the: Linux-based POA Management Node via SSH as root and go to the
Windows-based POA Management Node via RDP as administrator, open the command prompt and go to the "C:\Program Files\SWsoft\PEM\bin" directory
and execute: apache_ctl service dumpStaticConfig <service_id> To get the value of the <service_id> parameter, go the host management Top >
Deployment Director > Server Manager > Hardware Nodes > Hardware Node name > Applications tab and view the ID of the Apache application.
7 Go to Top > System Director > Task Manager > Background Tasks and wait until the task Generate config for apache service <service_id> is executed successfully.
To upgrade a VPS-based Apache host(s) from Apache 2.0 to Apache 2.2, perform these steps:
1 Download from POA Updates server and import the following OS and Application
templates:
[OS]-template-20090117-1.0-1.i386.rpm
mod_ssl-[OS]-template-20090117-1.0-1.i386.rpm
- where [OS] indicates the corresponding Operating system version of the template: redhat-as4, centos-4 for the OS template; or as4, ce4 for the mod_ssl
Application template.
The required OS template and the mod_ssl Application template are available for downloading at the following URLs:
RHES 4 http://download.pa.parallels.com/download/templates/pvclin/redhat-as4-template- 20090117-1.0-1.i386.rpm http://download.pa.parallels.com/download/templates/pvclin/mod_ssl-as4-template- 20090117-1.0-1.i386.rpm CentOS 4 http://download.pa.parallels.com/download/templates/pvclin/centos-4-template- 20090117-1.0-1.i386.rpm http://download.pa.parallels.com/download/templates/pvclin/mod_ssl-ce4-template- 20090117-1.0-1.i386.rpm
Note: All previous versions of the OS template and the mod_ssl application template
should also be imported to POA.
For importing instructions, refer to section Importing Templates (on page 134).
2 Remove the following Apache 2.0-specific Application templates from the host (one by
one, in the specified order): vzpem-apache-httpd
vzpem-sitebuilder-support (if present; this template contains PHP 4 extensions required for operation of Parallels Plesk Sitebuilder (see page 100)) vzpem-sitebuilder-support-php5 (if present; this template contains PHP 5
extensions required for operation of Parallels Plesk Sitebuilder (see page 100)) vzpem-php5-cgi
version 20090212 of vzpem-php Application Template.
To find this version, click the Show detailed view button on the Top > Service Director >
Virtuozzo Manager > VPSs > VPS name > Application Templates tab and view the
expanded list of vzpem-php Application template versions
vzpem-php itself. To delete the package, click Hide details and select the vzpem-
php Application template in the list
vzpem-webfilemanager (if present; this template contains WebFileManager) vzpem-mono (if present; this template contains WebFileManager)
To remove the Application templates, go to Top > Service Director > Virtuozzo Manager >
VPSs > VPS name > Application Templates tab, select the application templates in the list
and click Uninstall.
3 Upgrade the redhat-as4 (centos-4) and mod_ssl-as4 (mod_ssl-ce4)
templates to the version imported at Step 1 (20090117-1.0-1 or later).
To upgrade the templates, in POA CP, go to Top > Service Director > Virtuozzo Manager >
VPSs > VPS name > Application Templates tab, click Install Updates, select the imported
versions of the OS template and mod_ssl Application template and click Install.
4 Install the following Application templates on the host:
vzpem-apache-httpd22x vzpem-php-httpd22x vzpem-php5-cgi-httpd22x
vzpem-mono-httpd22x (contains WebFileManager) vzpem-webfilemanager (contains WebFileManager) vzpem-sitebuilder-support (if was present; see above) vzpem-sitebuilder-support-php5 (if was present; see above)
To install these Application templates, import them all from the POA distribution package as described in section Importing Templates, and then go to Top > Service
Director > Virtuozzo Manager > VPSs > VPS name > Application Templates tab, click Install,
select the packages in the list and click Install.
5 On POA MN, re-generate the Apache service configuration files:
Depending on the platform of your POA Management Node, log in to the: Linux-based POA Management Node via SSH as root and go to the
Windows-based POA Management Node via RDP as administrator, open the command prompt and go to the "C:\Program Files\SWsoft\PEM\bin" directory
and execute: apache_ctl service dumpStaticConfig <service_id> To get the value of the service_id parameter, go the host management Top >
Deployment Director > Server Manager > Hardware Nodes > Hardware Node name > Applications Templates tab and view the ID of the Apache application.
6 Go to Top > System Director > Task Manager > Background Tasks and wait until the task Generate config for apache service <service_id> is executed successfully.