APTARE IT Analytics Installation and Upgrade Guide for Windows

Last Published:
Product(s): APTARE IT Analytics (10.6)
  1. Install APTARE IT Analytics Portal on a Windows server
      Portal installation memory requirements
      Multi-language support and locale considerations (Windows)
      Task 1: Portal and database deployment strategies (Windows)
      Task 2: Pre-installation configuration (Windows)
    6. Task 3: Installing Oracle application binaries (Windows)
        Troubleshoot the Oracle installation
      Task 4: Installing Portal application binaries (Windows)
      Task 5: Request the license key file (Windows)
      Task 6: Log into the Portal (Windows)
      Task 7: Install the license key file (Windows)
      Task 8: Performing a cold backup (Windows)
      Supported third-party and open source products
      Uninstall the APTARE IT Analytics Portal
  2. Upgrade APTARE IT Analytics Portal on Windows
      Upgrade path
      Before upgrading
    4. Upgrade the Oracle database application binaries to19c (Windows)
        Upgrading the Oracle database application binaries (Windows)
    5. Upgrade APTARE IT Analytics Portal
        Upgrading a shared services environment
        Run the upgrade utility installer (Windows)
        Running the upgrade utility
      4. Attribute merging during the Portal upgrade
          Attribute management during the Portal upgrade
      Data Collector upgrades
      Troubleshooting - manual Data Collector upgrades
      Collector updates from the APTARE IT Analytics Portal
      Clustered NetBackup upgrade procedure
      Upgrade methods to incorporate enterprise objects
  3. Oracle patches for the database server
      Install Oracle 19c Windows July 2022 patch
  4. Upgrade and migrate to a new server
      Upgrade and migrate to a new server

Troubleshoot the Oracle installation

Because the Oracle installation relies on Oracle requirements and processes, you may encounter issues that require your intervention.

General troubleshooting

The Oracle installation process logs errors that can aid in troubleshooting. Locate the log file that coincides with the date and time of the error:

C:\Program Files\Oracle\Inventory\logs\installActions<YYYY-MM-DD_HH-MM>
Account lockout

Too many incorrect password entry attempts will lock out the Oracle Service User account. To unlock the account, take the following steps.

  1. Enter lusrmgr.msc in the Windows PowerShell command prompt window to launch the Local Users and Groups Manager.

  2. Open the Users folder and double-click the user that needs to be unlocked.

  3. In the User Properties window, uncheck the Account is locked out item to re-enable the user account.


    An alternative method for unlocking an account can be accessed via the Windows Server Manager: Server Manager > Tools > Computer Management > Local Users and Groups > Users

Invalid Oracle Service User Account

When an invalid Oracle Service User Name is entered, the Oracle Universal Installer displays the following messages:

The password field is empty.
CAUSE: The password should not be empty.
ACTION: Provide a non-empty password.
Please press Enter to exit...

These messages do not necessarily reflect the true issue. At this point, the password is not relevant. The process actually needs the Oracle Service User Name.

To recover from this error, take the following steps.

  1. In the command prompt window, press Enter.

  2. Return to the Failed to Install Oracle window and click Previous.

  3. Enter a valid account name for the Oracle Service User Name and resume the installation.

Oracle universal installer fails

The most common reason for the Oracle Universal Installer to fail is due to an invalid Oracle Service User account.

See Invalid Oracle Service User Account.

Other failures must be investigated by reviewing log messages, using the following steps.

  1. In the Failed to Install Oracle installer window, click Exit.

  2. Locate the error in the log file:

    C:\Program Files\Oracle\Inventory\logs\installActions<YYYY-MM_HH-MM>


If you abort the Oracle Universal Installer process by closing the command window, close the installer window and re-run the installer from the beginning.

Oracle already exists on the portal server

If you are installing Oracle on a server that at some point had APTARE IT Analytics Oracle software installed, the installer will display an error dialog window.

Encountering previously installed software may occur under the following circumstances:

  • You chose a server that has a version of the APTARE IT Analytics Portal already installed. Determine the version of Oracle that is already installed and reference the APTARE IT Analytics documentation for the steps to uninstall the database/Portal.

  • You ran the Oracle installer more than once. In this case, it is likely that you do not want to proceed unless you have determined that it was not a successful installation. If you need to re-run this installer, refer to the following.

    See Uninstall the Oracle application binaries.

Unsupported Windows operating system

If you try to install Oracle on a version earlier than Windows Server 2016, you will get a warning message: WARNING: The current OS is not supported.

Exit the installation and choose a server with a supported Windows OS.