Search <book_title>...

NetBackup IT Analytics Installation and Upgrade Guide for Windows

Last Published: 2025-03-04

Product(s): NetBackup IT Analytics (11.4)

Upgrade and migrate to a new Windows server

The Portal must be running a minimum of NetBackup IT Analytics version 11.1 to upgrade to NetBackup IT Analytics 11.4.

If you migrate a portal from one machine to another, apart from copying over the database, you also need to copy the c:\opt\aptare\datarcvrconf\aptare.ks and c:\opt\aptare\datarcvrconf\aptare_external_password.properties files, and ensure the file permissions allow writing by the 'tomcat' user. If these files are not copied to the new machine, you will not be able to edit existing collector policies and data collection will stop working.

NetBackup IT Analytics installer supports Portal and database installation on custom path. If your Portal or database is installed in a non-default location, replace \opt with the respective absolute installation path in the commands and procedures provided in this section.

Install the latest release of NetBackup 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.
The NetBackup IT Analytics Portal will be installed with evaluation license valid for 60 days. Ensure you request a new license with appropriate entitlement. Refer the NetBackup IT Analytics Licensing Guide for more information.
Install the new license, once you receive it.

Perform an export of the database on the existing server

The database user Aptare must have access to the export files stored in the directory:

c:\opt\oracle\database\tools

Verify that Oracle user has read and execute privileges on these files before starting the database export.

Log into the Windows database server.
Ensure Oracle TNS Listener and Oracle services are running.
At the command prompt execute the script:
c:\opt\oracle\database\tools\expdp_database_template.bat
After successful completion, the export file aptare_scdb.exp is saved on the Windows database server in the directory:
C:\opt\oracle\logs
Copy the c:\opt\datarcvrconf\aptare.ks file to a temporary location.
From the temporary location, copy the aptare.ks file to c:\opt\datarcvrconf\ directory for the target system.

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 11.4 for your new NetBackup IT Analytics 11.4 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 NetBackup IT Analytics portal.
Verify that all NetBackup 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.