2 Installing OKM Manager

Oracle's OKM Manager is a client application used to configure, control, and monitor the KMA. You install the OKM Manager on your local PC or workstation. You do not need administrator (Windows) or root (Solaris) privileges to install and run OKM Manager.

Supported Platforms for OKM Manager

  • Solaris 10 — 10/09 (update 8) x86, 9/10 (update 9) SPARC, 9/10 (update 9) x86

  • Microsoft Windows 10

  • Microsoft Windows 8

  • Microsoft Windows 7 Business and Enterprise

  • Microsoft Windows Server 2016, 2012, 2008 version 6.0

Uninstall Previous Version of OKM Manager

Uninstall any previous OKM Manager version before installing the new OKM Manager:

Do not use older OKM GUIs (OKM 3.2 or earlier) to connect to KMAs running OKM 3.3 or later. You must use the OKM 3.3.2 GUI to upgrade a KMA to OKM 3.3.2. Uninstall any previous OKM GUI version before installing the latest OKM GUI.

Uninstall OKM Manager by Invoking the Executable File

  1. Navigate to the directory listed below, which resides under the directory where the OKM Manager was installed.

    • _Oracle Key Manager_installation (for OKM 3.3.2 and above)

    • Uninstall_Oracle_Key_Manager (for OKM 3.3 and below)

  2. To launch the uninstall process, invoke:

    For Windows:

    • Change Oracle Key Manager Installation.exe (for OKM 3.3.2 and above)

    • Uninstall_Oracle_Key_Manager.exe (for OKM 3.3 and below)

    For Solaris:

    • Change Oracle Key Manager Installation (for OKM 3.3.2 and above)

    • Uninstall_Oracle_Key_Manager (for OKM 3.3 and below)

  3. The Preparing Setup window displays while the install/uninstall program prepares for the uninstall process.

  4. After launching the uninstaller, click Next.

    Note:

    Uninstallation will not remove your connection profiles.
  5. When the uninstall process completes, click Finish.

Uninstall OKM Manager by Using Add/Remove Programs (Windows Only)

As an alternative to invoking the executable, you can use the add/remove programs option on Windows.

  1. Click Start, select Settings, Control Panel, double-click Add or Remove Programs. Select OKM Manager, then click Change/Remove.

  2. The Preparing Setup window displays while the install/uninstall program prepares for the uninstall process.

  3. After launching the uninstaller, click Next.

    Note:

    Uninstallation will not remove your connection profiles.
  4. When the uninstall process completes, click Finish.

Download the OKM Installer

  1. Log in to the My Oracle Support (MOS): https://support.oracle.com/

  2. Open the Patches & Updates tab (near the top of the window).

  3. In the Patch Search pane, with the Search tab open, click Product or Family (Advanced).

  4. Select the Include all products in a family check box.

  5. In the Product field, type OKM and select Oracle Key Manager (OKM) from the menu.

  6. In the Release field menu, select the appropriate OKM release (for example Oracle Key Manager (OKM) 3.3.2).

  7. Close the Release menu window and click the Search button.

Launch the OKM Installer

For Windows:
Double-click the shortcut to start the installer program.

For Solaris:

  1. Set your DISPLAY environment to identify the system to which this installer should be displayed.

    • If you start the installer program on the local Solaris system, set your DISPLAY environment variable to ":0.0."

    • Navigate to the directory where you downloaded the installer.

  2. Invoke the installer.

    For example, if you downloaded the installer to the /tmp directory, and you plan to invoke it on your local Solaris system, you start the installer by entering the following commands at a shell prompt:

    DISPLAY=:0.0
    export DISPLAY
    cd /tmp
    ls OKMManager_solaris_3_3_2.bin
    sh ./OKMManager_solaris_3_3_2.bin
    

    Note:

    If you invoke the installer on one Solaris system and want it to be displayed on another Solaris system, set your DISPLAY environment variable to identify the system on which it should be displayed.

    On the display system, first run the xhost(1) utility to allow access from the system from which you invoke the installer.

    For example, on the system (named "hosta") where you wish to display the installer, enter:

    xhost +
    

    On the system where you start the installer, enter:

    ping hosta
    DISPLAY=hosta:0.0 
    export DISPLAY 
    cd /tmp 
    ls OKMManager_solaris_3_3_2.bin 
    sh ./OKMManager_solaris_3_3_2.bin
    

Complete the OKM Installation Wizard

  1. After launching the installer, in the Introduction screen of the installation wizard, click Next.

  2. The Elevated Privileges window displays, telling you that you need elevated privileges to complete the installation (this screen does not appear on the Solaris installer). Click Next.

  3. In the Choose Install Folder window, select the default folder, click Next, or supply your own installation folder, and click Next.

  4. In the Choose Shortcut Folder window, select where to create the product icons and then click Next.

  5. In Pre-Installation Summary window, review the settings and then click Install, or Previous to revise the setup.

  6. Once the installation process completes, click Done to exit.

Launch OKM Manager

For Windows:
Double-click the startup icon to launch the OKM Manager application. Or, launch Windows Explorer, navigate to where you installed the OKM Manager, and launch OKM_Manager.exe.

For Solaris:
Invoke the shortcut at a shell prompt by entering: ~/OKM_Manager .
Or, navigate to where you installed the OKM Manager and invoke it by entering: ./OKM_Manager