Run the Oracle client 32-bit configuration script

The Oracle client 32-bit configuration shell script creates the environment for the client software installation on the local system.

About this task

This script is named configure_client and is located with the Tivoli® Netcool® Performance Manager files downloaded as part of the Tivoli Netcool Performance Manager distribution. If you are performing this step as part of an upgrade procedure, make sure that you run the configuration script provided with the target version of Tivoli Netcool Performance Manager.

The client configuration script makes the following changes to the local system:

  • Adds the dba and oinstall groups to /etc/group.
  • Adds the Oracle login name oracle, whose primary group membership is dba, and secondary group membership is oinstall.
    Note: You must use the same Oracle username across all instances of Oracle Client and Server throughout your Tivoli Netcool Performance Manager system.
  • Creates the Oracle client directory structure. When you create the environment for Oracle 12.1.0.2, the default location for this directory structure is /opt/oracle/product/12.1.0-client32. You specify this directory as the target location when you install the Oracle client.
Note: None of the above changes are made if the changes are already in place.

To configure the Oracle installation environment:

Procedure

  1. Log in as root.
  2. Set the ORACLE_BASE environment variable to point to the top-level directory where you want the Oracle client files installed. The default installation directory is /opt/oracle.

    For example:

    # ORACLE_BASE=/opt/oracle
    # export ORACLE_BASE
    Note: The configure_client script places this variable into the oracle login name's .profile file.

    To check that the variable is set correctly, enter the following command:

    # env | grep ORA
  3. Set the ORACLE_HOME environment variable. For example:
    # ORACLE_HOME=/opt/oracle/product/12.1.0-client32
    # export ORACLE_HOME
    Note: The value defined in the configure_client script for ORACLE_HOME is the value needed in the Topology Editor for Oracle Home on the host level.
  4. Change to the following directory:

    systems:

    # cd <DIST_DIR>/proviso/SOLARIS/DataBase/SOL<version_num>/oracle/instance

    systems:

     # cd <DIST_DIR>/proviso/AIX/DataBase/AIX<version_num>/oracle/instance
    

    systems:

    # cd <DIST_DIR>/proviso/RHEL/DataBase/RHEL<version_num>/oracle/instance
    

    where:

    <DIST_DIR> is the directory on the hard drive where you copied the contents of the Tivoli Netcool Performance Manager distribution in Download the Oracle distribution to disk.

  5. Run the Oracle configuration script using the following command:
    # ./configure_client

    The following screen is displayed:

    
    --------------------------------------------------
    configure_client
      Setting the Oracle client environment
      Fri Apr 6 14:51:23 CST 2018
    --------------------------------------------------
      OS ........... : [ SunOS 5.11 11.3 ]
      Host ......... : [ l3provsol1z3 ]
      Logname ...... : [ root ]
    
      ORACLE_BASE .. : [ /opt/oracle ]
      ORACLE_HOME .. : [ /opt/oracle/product/12.1.0-client32]
      DBA group ................. : [ dba ]
      OUI Inventory group ....... : [ oinstall ]
      Oracle Software owner ..... : [ oracle ]
    
      Configure Oracle release .. : [12.1.0] 
    
    Menu :
       1. Modify Oracle software owner.
       2. Next supported release.
       3. Check environment.
       0. Exit
    
    Choice :
    
  6. Type 3 at the Choice prompt and press Enter.

    The script creates the dba and oinstall groups, and the ORACLE_BASE directory, unless they already exist.

    Checking environment...
      Checking for group [ dba ] --> Created. 
      Checking for group [ oinstall ] --> Created.
      Checking ORACLE_BASE 
    ** WARNING
    ** ORACLE_BASE directory does not exist.
    **    [ /opt/oracle ]
    **
    ** Create it ? (n/y) y

    If prompted, type y and press Enter.

    The script creates the /opt/oracle directory and continues as follows:

    Checking for user [ oracle ] 
    ** WARNING
    ** User [ oracle ] does not exist.
    **
    ** Create it locally ? (n/y) y

    If prompted, type y to create the oracle user and press Enter.

    The script creates the oracle user and continues as follows:

    --> Created.
      Checking for oracle directory tree :
         [ /opt/oracle/product ] --> Created.
         [ /opt/oracle/product ] --> Created.
         [ /opt/oracle/product/12.1.0 ] --> Created.
      Checking for oracle .profile file --> Created.
    
    Press Enter to continue... 
  7. Press Enter to continue. The configure_client main screen is displayed.
  8. Type 0 and press Enter to exit the script.

What to do next

Note: Install database step fails during deployment if permission to the $ORACLE_BASE directory is not granted. During Oracle installation, the /opt/oracle folder that is created by configure_client script has no permission that is granted to any other users. Therefore, after you run the configure_client script, assign the following permission to the $ORACLE_BASE directory (for example, /opt/oracle):
  1. Log in as oracle user.
  2. Run the following command:
    chmod 755 /opt/oracle