Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  3. IT Analytics Installation and Upgrade Guide for Windows
  5. Upgrade and migrate to a new server
  7. Upgrade and migrate to a new Windows server
IT Analytics Installation and Upgrade Guide for Windows

Upgrade and migrate to a new Windows server

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

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.

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 IT Analytics on the new server

  1. Download the latest release and installation instructions from the www.veritas.com.

  2. Perform a fresh install of the database and portal on the new server.

  3. The IT Analytics Portal will be installed with evaluation license valid for 60 days. Ensure you request a new license with appropriate entitlement. Refer the IT Analytics Licensing Guide for more information.

  4. 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.

  1. Log into the Windows database server.

  2. Ensure Oracle TNS Listener and Oracle services are running.

  3. At the command prompt execute the script:

    c:\opt\oracle\database\tools\expdp_database_template.bat

  4. After successful completion, the export file aptare_scdb.exp is saved on the Windows database server in the directory:

    C:\opt\oracle\logs

  5. Copy the c:\opt\datarcvrconf\aptare.ks file to a temporary location.

  6. 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 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.8 for your new IT Analytics 11.8 portal, you can follow below instructions

  1. Download the upgrade installer and documentation from the www.veritas.com.

  2. Run the upgrade installer.

    See Run the upgrade utility installer (Windows).

    This installs the upgrade executable, but does not execute it.

  3. In the last step of upgrader, select Run Later option to continue.

  4. Open a command prompt and go to C:\opt\aptare\upgrade.

  5. Run db-upgrade.bat and follow the instructions to upgrade the database.

  6. After completion of db-upgrade.bat, you can login to portal with your admin credentials and try installing the new license.

  7. Login again and access IT Analytics portal.

  8. Verify that all IT Analytics application services are up and running.

  9. 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.

  1. Download the Data Collector installer and documentation from www.veritas.com.

  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.

Feedback

Was this page helpful?
Previous

Upgrade and migrate to a new server

Next

Storage Array Overview

Feedback

Was this page helpful?