Upgrading and Migrating to a New Server
  
Version 10.3.00P13
Upgrading and Migrating to a New Server
If you are upgrading from an 8.4.02 Portal to a 9.x Portal and then to APTARE Release Version 10.x.xx, you may need to migrate your Linux server. This section covers migrating to a Linux Portal server and then migrating the APTARE IT Analytics database to this new server.
Users must be running a minimum of version 10.2.00 to upgrade to APTARE Release Version 10.3.xx.
Install the latest release of APTARE IT Analytics on the new server
1. Download the latest release and installation instructions from the APTARE Customer Portal.
2. Perform a fresh install of the database and portal on the new server. See Installing the Portal on a Linux Server.
3. Request a new license key for the server from license-aptare@veritas.com. See Task 7: Requesting the License Key File (Linux).
4. Install the new license, once you receive it. See Task 8: Installing the License Key File (Linux).
Perform an export of the database on the existing server
1. Follow the instructions for your platform in the APTARE IT Analytics System Administrator’s Guide to create a database export.
2. Copy/Transfer the export file to your new server.
Stop Portal and Agent Services on the new server
1. On Linux (as root):
Execute /opt/aptare/bin/tomcat-agent stop
Execute /opt/aptare/bin/tomcat-portal stop
Drop and re-create the existing portal user on the new server
1. On Linux (as "aptare" user):
sqlplus / as sysdba
drop user portal cascade;
@/opt/aptare/database/ora_scripts/create_portal_user.plb;
Import the database onto the new server
1. Follow the instructions for your platform in the Importing the Oracle Database section in the APTARE IT Analytics System Administrator’s Guide.
Start Portal and Agent Services on the new server
1. On Linux (as root):
Execute /opt/aptare/bin/tomcat-agent start
Execute /opt/aptare/bin/tomcat-portal start
Download, install, and execute to upgrade the database schema
1. Download the upgrade installer and documentation from the Customer Portal.
2. Run the upgrade installer. See Running the Upgrade Utility Installer. This installs the upgrade executable, but does not execute them.
3. Verify that all APTARE IT Analytics application services are up and running.
4. As user root, run the following relevant command and respond to the prompts accordingly:
On Linux:
sh /opt/aptare/upgrade/upgrade.sh
You will receive warnings that your current version is already up to date, proceed.
Choose component two (2) for both
Once the script has completed, review the log file indicated to check for any errors 
5. If you are using the bundled, local OpenLDAP for authentication, export the LDAP DB from your existing server and import it on the new server.
6. Follow the steps under Migrating OpenLDAP for your platform in the APTARE IT Analytics System Administrator’s Guide.
Testing
If desired, you can use the local host file method of IP address resolution to test the functionality of the new portal prior to any DNS cut-over from the existing server.
Update Data Collector binaries (if necessary)
Do not install on the same machine as the new portal/database server.
1. Download the Data Collector installer and documentation from the Customer Portal.
2. Follow the instructions in the documentation for your Data Collector to uninstall.
3. Re-install the Data Collector to the latest version, giving the correct URL for the new server.