Search <book_title>...

APTARE IT Analytics Installation and Upgrade Guide for Windows

Last Published: 2022-09-01

Product(s): APTARE IT Analytics (10.6)

Upgrade and migrate 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, 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 9.x to upgrade to APTARE Release Version 10.

The Portal must be running a minimum of APTARE IT Analytics version 10.3 to upgrade to APTARE IT Analytics 10.5.

Note:

From version 10.5 onwards, if you migrate a portal from one machine to another, apart from copying over the database, you also need to copy the /opt/aptare/datarcvrconf/aptare.ks file and ensure the file permissions allow writing by the 'tomcat' user. If this file is not copied to new machine, you will not be able to edit existing collector policies and data collection will stop working.

Install the latest release of APTARE IT Analytics on the new server

Download the latest release and installation instructions from the www.veritas.com.
Perform a fresh install of the database and portal on the new server.
See Introduction.
Request a new license key for the server from license-aptare@veritas.com.
See Task 5: Request the license key file (Windows).
See Task 5: Request the license key file (Windows).
Install the new license, once you receive it.
See Task 7: Install the license key file (Windows).

Perform an export of the database on the existing server

Follow the instructions for your platform in the System Administrator Guide to create a database export.
Copy/Transfer the export file to your new server.

Stop Portal and agent services on the new server

On Windows (as an admin):

Execute \opt\aptare\utils\stopportal.bat
Execute \opt\aptare\utils\stopagent.bat

Drop and re-create the existing portal user on the new server

On Windows (as member of ORA_DBA group):

sqlplus / as sysdba
drop user portal cascade;
@/opt/aptare/database/ora_scripts/create_portal_user.plb;

Import the database onto the new server

Follow the instructions for your platform in the Importing the Oracle Database section in the APTARE IT Analytics System Administrator Guide.

Start Portal and agent services on the new server

On Windows (as an admin):

Execute \opt\aptare\utils\startportal.bat
Execute \opt\aptare\utils\startagent.bat

Download, install, and execute to upgrade the database schema

If you are importing an old version database to 10.6 for your new APTARE IT Analytics 10.6 portal, you can follow below instructions

Download the upgrade installer and documentation from the www.veritas.com.
Run the upgrade installer.
See Run the upgrade utility installer (Windows).
This installs the upgrade executable, but does not execute it.
In the last step of upgrader, select Run Later option to continue.
Open a command prompt and go to C:\opt\aptare\upgrade.
Run db-upgrade.bat and follow the instructions to upgrade the database.
After completion of db-upgrade.bat, you can login to portal with your admin credentials and try installing the new license.
Login again and access APTARE IT Analytics portal.
Verify that all APTARE IT Analytics application services are up and running.
As user root, run the following relevant command and respond to the prompts accordingly:
- On Windows:
```
C:\opt\aptare\upgrade\upgrade.bat
```
  You will receive warnings that your current version is already up to date, proceed.
  Once the script has completed, review the log file indicated to check for any errors

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.

Download the Data Collector installer and documentation from www.veritas.com.
Follow the instructions in the documentation for your Data Collector to uninstall.
Re-install the Data Collector to the latest version, giving the correct URL for the new server.