APTARE IT Analytics Installation and Upgrade Guide for Windows

Last Published:
Product(s): APTARE IT Analytics (10.5)
  1. Install APTARE IT Analytics Portal on a Windows server
    1.  
      Introduction
    2.  
      Portal installation memory requirements
    3.  
      Task 1: Portal and database deployment strategies (Windows)
    4.  
      Task 2: Pre-installation configuration (Windows)
    5. Task 3: Installing Oracle application binaries (Windows)
      1.  
        Troubleshoot the Oracle installation
    6.  
      Task 4: Installing Portal application binaries (Windows)
    7.  
      Task 5: Request the license key file (Windows)
    8.  
      Task 6: Log into the Portal (Windows)
    9.  
      Task 7: Install the license key file (Windows)
    10.  
      Task 8: Performing a cold backup (Windows)
    11.  
      Supported third-party and open source products
    12.  
      Uninstall Portal server software
  2. Upgrade APTARE IT Analytics Portal on Windows
    1.  
      Overview
    2.  
      Upgrade path
    3.  
      Before upgrading
    4. Upgrade the Oracle database application binaries to19c (Windows)
      1.  
        Upgrading the Oracle database application binaries (Windows)
    5. Upgrade APTARE IT Analytics Portal
      1.  
        Upgrading a shared services environment
      2.  
        Run the upgrade utility installer (Windows)
      3.  
        Running the upgrade utility
      4. Attribute merging during the Portal upgrade
        1.  
          Attribute management during the Portal upgrade
      5.  
        Upgrading the Portal with additional licensed modules
      6.  
        Database table creation scripts
      7.  
        Add additional products
      8.  
        Enable new features and report templates using the Portal
    6.  
      Data Collector upgrades
    7.  
      Troubleshooting - manual Data Collector upgrades
    8.  
      Collector updates from the APTARE IT Analytics Portal
    9.  
      Clustered NetBackup Upgrade Procedure
    10.  
      Upgrade methods to incorporate enterprise objects
  3. Oracle patches for the database server
    1.  
      Install Oracle 19c Windows July 2021 patch
  4. Upgrade and migrate to a new server
    1.  
      Upgrade and migrate to a new server
  5. Portal upgrades (Win): Tomcat and Apache
    1.  
      Overview
    2.  
      Upgrade from Tomcat 7 to Tomcat 8 (Win)
    3.  
      Upgrade the Apache Web Server to 2.4.xx to 2.4.yy (Windows)

Task 4: Installing Portal application binaries (Windows)

In this procedure, you will install Portal Server software on your Windows Server.

System: Web/Application Server

To install your Portal server software

  1. Perform the steps outlined in Task 2.
  2. Log in to the Portal server as a Local Administrator.

    Note:

    Oracle requires that you are logged in as a Local Administrator. Logging in as a Domain Administrator is not sufficient for this installation.

  3. Go to the downloads section under Support at www.veritas.com and click the relevant download link.
    • Once downloaded, the Portal Installation Wizard should launch automatically. If it does not, using Windows Explorer, navigate to the CD drive, and double-click the executable file: sc_installer_<releaseversion>_win_<MMDDYYYY>.exe

    • The Portal Installation Wizard requires about a minute to start up. During this time, the following window is displayed:.

      Once the Portal Installation Wizard extracts the necessary startup files, the Portal Installation Wizard displays the launch screen.

  4. Click Next to start the installation process. The Portal Installation Wizard displays the License Agreement screen and prompts you to accept the End User License Agreement (EULA) to continue.
  5. Read and agree to the terms of the License Agreement.
  6. Click the "I accept the terms of the License Agreement" and then click Next. The Choose Install Set screen is displayed.
  7. Select your product component installation option:
    • Portal and Reporting Database Installation - Select this option if you are installing all the components on the same server.

    • Reporting Database Only Installation

    • Portal Only Installation

    Note:

    You can select Reporting Database Only Installation or Portal Only Installation as recommended by Veritas Support. Otherwise, you need to select Portal and Reporting Database Installation as the default install option.

  8. Click Next. The Pre-Installation Summary screen is displayed. This screen summarizes the product components that will be installed and describes the available and required disk space for these components.

    Note:

    This screen will automatically be skipped if you are installing the Oracle binaries and database on a server that is different from the Portal server. For this type of setup, the Installation Wizard skips this screen and automatically installs the Portal only.

    Note:

    The requirements shown on the following example screen may not match the requirements displayed on the installation screen. Refer to the actual Pre-Installation Summary screen for the current requirements.

  9. Click Install to install the Portal Server software in the default C:\opt directory on the Portal Server.

    The Portal Server software must be installed on the C:\ drive.

    The Portal Installation Wizard displays several status screens as the various software binaries are copied to specific locations on your Portal Server. Afterward, the Portal Installation Wizard prompts for configuration settings.

  10. Enter the hostname or IP address of the server on which the Oracle Application binaries have been installed. The installer prompts for the IP address of your Oracle database server. If Oracle is running on the Portal server, you can enter localhost.
  11. Enter the Domain Name and Admin Password.

    Domain Name

    Enter the domain name for your environment (e.g., yourcompany.com). The value entered here determines the URL you will use in your browser to access the portal. For example, aptareportal.yourcompany.com.

    Admin Password

    The admin userid is created during the installation in the format admin@domainname (e.g., admin@yourcompany.com). You will be prompted for this admin userid and the password you supply below when you first log in to the Portal.

  12. Make a note of the configurations. They will be used during the Data Collector installation.
  13. Select the products to install. Press the Ctrl key to make multiple selections.

    Products

    Select only the products for which you have purchased licenses. If you select a product for which you do not have a valid license, you will not be able to access the reports for that product. To make multiple selections, click Control and select the products.

  14. Select the drive on which the Oracle database will be created.

    Oracle Data Drive

    Select the drive letter on which you intend to create the Oracle database. The Portal Installation Wizard customizes the Database SQL Script based on the drive letter. Note the disk space requirements for this drive.

  15. Select a time zone. For a list of valid Oracle time zones see http://docs.oracle.com/cd/B13866_04/webconf.904/b10877/timezone.htm

    Now, the installer will customize the installation, based on the values you just provided. The installer prepares to launch the database creation script.

  16. Click OK to launch the database creation process. The Create Database command prompt window opens.
  17. Click Done in the InstallAnywhere dialog to exit the installer.

    At this stage of the installation process, all the third-party and software components are in place on your Windows Server. You should now ensure that aptareportal.mydomain and aptareagent.mydomain (where mydomain is the value entered in a previous step) have been added to DNS or %WINDOWS_HOME%\SYSTEM32\DRIVERS\ETC\HOSTS

    Note:

    Throughout this section, the example output and screens are used to provide a reasonable representation of the screens that you will be viewing. However, they may not display precisely the same text that you'll see on the installation screens.

  18. The database will be created (this step will take between 5-10 minutes to complete).
  19. The installer will then load the database with Oracle packages (this step will take between 15-25 minutes to complete).
  20. The Portal users and the database schema are now created.
    Creating APTARE IT Analytics Portal user...
    Disconnected from Oracle Release xx - Production
    JServer Release xx - Production
    Creating APTARE IT Analytics base schema tables...
    ...
    ...		(EACH STEP LOGS TO THE screen...)
    ...
    Completed creating APTARE IT Analytics base schema tables
    Creating APTARE IT Analytics <product> schema tables...
    
  21. Next, the Packages are validated.

    Note:

    The actual output will vary, depending on the products you chose to install.

    Note:

    If you do not see the message "Successfully validated ALL Packages" at the end of this step, or if the installer script reported errors during the install, there is a possible problem with the install and you should save a copy of the following log file and contact the Veritas Support: C:\opt\oracle\logs\aptare_installer*.log

    Note:

    If you do not see the message "Successfully validated ALL Packages" at the end of this step, or if the installer script reported errors during the install, there is a possible problem with the install. Save copies of the following log files and contact Veritas Support: C:\opt\oracle\logs\aptare_installer*.log and C:\opt\oracle\logs\aptare_db_create.log

    This completes the setup of the Portal and the database creation.