Portal Upgrades (Win): Tomcat and Apache
If your environment requires the latest versions of Tomcat and Apache to comply with security standards, use the following instructions to update to the latest versions. These upgrades are required only if you must satisfy security audit requirements. The Tomcat and Apache upgrades are independent—that is, you can do one without the other.
To simplify the upgrade process, these upgrades should be done after the upgrade.
Note: These upgrade instructions apply to the standard, default Portal environments. If you have a multi-tenancy environment (for example, services providers) or if there are multiple tomcat instances for the Data Receiver, you may have to contact APTARE Global Support Services to assist in customizing the instructions.
Upgrading to Tomcat 7 (Windows)
1. Stop Apache and Tomcat services.
2. Rename /opt/tomcat as tomcat_old. Extract the new tomcat 7 binaries from bins3rdparty\Tomcat\windows\apache-tomcat-7.0.50_x64.zip to C:\opt.
3. Run the script to delete old portal and agent Tomcat services.
C:\opt\aptare\utils\removePortalServices.bat
4. Run the scripts to set up portal and agent Tomcat services which now point to the new tomcat7.exe
C:\opt\aptare\utils\setupAgentTomcatService.bat
C:\opt\aptare\utils\setupPortalTomcatService.bat
5. Unzip aptare-instances.zip from attachment aptare-instances.zip to C:\opt\tomcat.
6. Copy server-portal.xml and server-agent.xml from tomcat_old\conf to your folder for editing:
a Open server-agent.xml and server-portal.xml.
b Search for "ServerLifecycleListener", and then delete the definition of ServerLifecycleListener:
<Listener className="org.apache.catalina.mbeans.ServerLifecycleListener"
debug="0"/>
c Save server-portal.xml and server-agent.xml
7. Copy server-portal.xml from you folder to Tomcat:
a Copy server-portal.xml to C:\opt\tomcat\conf
b Copy server-portal.xml to C:\opt\tomcat\aptare-instances\portal\conf\server.xml
8. Copy server-agent.xml from your folder to Tomcat:
a Copy server-agent.xml from your folder to C:\opt\tomcat/conf
b Copy server-agent.xml from your folder to C:\opt\tomcat\aptare-instances\agent\conf\server.xml
9. Restart Apache and Tomcat services.
Upgrading to Apache http web server 2.2.19 (Windows)
1. Run the Win32 Binary including OpenSSL 0.9.8r (MSI Installer).
2. Provide the appropriate values for the server name and domain name during installation process.
3. Retain the default selection of Port 80 when prompted for the port number for Apache.
4. Retain the default selected installation option as Typical.
5. Copy the installed Apache binary files (C:\Program Files(x86)\Apache Software Foundation\Apache 2.2) to C:\opt.
6. Copy C:\opt\apache\conf\httpd.conf / to C:\opt\Apache 2.2\conf
7. Delete C:\opt\apache.
8. Rename C:\opt\Apache 2.2 as "apache".
9. Restart.
10. Go to Start and search for Regedit.
11. Edit the service name for Apache 2.2 as "AptareApache" and display name as "Aptare Apache"
Upgrading to Apache 2.2.20 (Windows)
1. Stop Apache and Tomcat services and copy the binaries for Apache 2.2.20 under /opt.
2. Copy httpd.conf and workers.properties to conf directory from the older version to the new version.
3. Copy httpd-ssl.conf to conf\extra directory from the older version to the new version.
4. Rename the old Apache folder under opt to apache_old.
5. Rename the new Apache binaries folder to apache.
6. Restart Apache and Tomcat services.