Deploying Oracle Agents on UNIX Platforms

Where to Install

Install the software on a computer on which the Oracle server resides.

For Solaris, software can be installed on one of the following:

  • Unix computer hosting the global zone on which Oracle database application resides.
  • Unix computer in a non-global zone on which Oracle database application resides.

Follow the steps given below to install the Oracle Agent.

The computer will be added as a client in the CommCell as soon as the installation completes successfully.

Before You Begin

System Requirements

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements.

Download Software Packages

Download the latest Simpana® software using the Download Manager application. The Download Manager bundles an installation package from the Simpana components that you chose to download. Use the installation package to launch the software installer on a client computer.

See Download Manager - Getting Started for instructions on creating an installation package.

On AIX, it is recommended to grant read permissions for others (chmod o+r) on shared libraries and executables so that the services are started without any issues.

Installation

The software can be installed using one of the following methods:

Method 1: Remote Installation Using CommCell Console

Use this procedure to install remotely on a client computer.

Method 2: Interactive Installation

Use this procedure to install the software using the custom installation options.

Method 1: Remote Installation Using CommCell Console

  1. Open CommCell Console:

    • Click Start and point to All Programs.
    • Click Commvault .
    • Click Simpana  Administrative Console.
  2. From the CommCell Browser, click Tools | Add/Remove Software | Install Software.
  3. Click Next.

  4. Select Unix and Linux, then Next.
  5. Click Manually Select Computers, then Next.
  6. Enter the fully qualified domain name of the client computer.

    For example: mycomputer.mydomain.mycompany.com

    Click Next.

    • Do not use space and the following characters when specifying the Host Name:

      \|`~!_@#$%^&*()+=<>/?,[]{}:;'"

  7. Choose one of  the following:

    • Click Next if you want to use the default cache location
    • Click Override Software Cache and specify a new location in the Software Cache box and then click Next

    • The software cache is the location from where the remote install program installs the software.
    • This screen will not appear if the remote cache is not configured. For more information, see Managing Cache - Remote Cache.

  8. Specify the User Name and Password that must be used to access the client computer, and then click Next.

    • You can also specify the SUDO user credentials here, provided that the user is an Administrator or a member of the Administrator group with root privileges on that computer.

      To add a SUDO user to /etc/sudoers, see Adding SUDO Users with Root Privileges to Log On to a UNIX Client.

    • Account information is required while performing remote installs for the first time on a client. For subsequent remote installs on that client, click Next without specifying the account information.

  9. Click Oracle, then Next.
  10. Select the following:

    • Select a client group from the available Client Groups, and then click Add.
    • From the Global Filters list, select one of the following:
      • Use Cell level Policy to inherit the global filter policy configuration set for the CommCell.
      • Always use Global Filters to apply the global filters policy to the default subclient regardless of the policy set for the CommCell.
      • Do not use Global Filters if you plan to define specific filters for the Agent.
    • From the Storage Policy To Use list, select a storage policy.
    • Click Next.

    This screen will not be displayed if Client Groups are not configured in the CommCell Console. For more information, see Client Computer Groups.

    If you do not have a Storage Policy, the list will not be displayed. You can create the Storage Policy later in step 19.

  11. Click Next. If necessary you can select additional options. Click the Help button to get more information on the available options.
  12. Click Next. Select the Unix group for Oracle. The Oracle user must be part of this group. If necessary, you can select other advanced options. Click the Help button to get more information on the available options.
  13. Click Next. If necessary you can select optional settings. Click the Help button to get more information on the available options.
  14. Select one of the following:

    • If firewall configuration is not required, click Next.
    • If this computer and the CommServe is separated by a firewall, click Configure firewall services.

    For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

  15. Select Immediate and click Next.
  16. The screen displays the selected components. Click Finish.
  17. You can track the progress of the job from the Job Controller window of the CommCell console.
    • From the Home menu, click Job Controller.

    Once the job is complete, view the job details from the Admin Job History.

    • Right-click the <CommServe>, point to View and then click Admin Job History.
    • Click Select Install/Upgrade/Remove/Repair Software.
    • Click OK.
    • You can view the following by right-clicking the job:
      • Details of the job
      • Option to Resubmit the job
      • Events associated with the job
      • Logs associated with the job
      • Option to send the Logs associated with the job
  18. To create a storage policy, you must have configured a library in the CommCell.

Several additional options are available for remotely installing the software from CommCell Console, refer to Install Software from the CommCell Console (Remote Install) for more information.

Method 2: Interactive Installation

  1. Logon to the client computer as root.
  2. If the installation package that was created using the Download Manager was copied to a DVD, use one of the following options depending on your environment:
    • Mount the DVD on a global zone or a UNIX machine using the following command:

      mount -t iso9660,udf /dev/cdrom /mnt/cdrom

    • Mount the DVD on the non-global zone using the following commands:

      mkdir <Non-Global Zone root location>/<Non-Global Zone local directory>

      mount -F lofs <Global zone DVD mount point> <Non-Global Zone root location>/<Non-Global Zone local directory>

      Connect to the non-global zone terminal.
  3. Run the following command from the installation package or mount point:

    ./cvpkgadd

    You can also run this command as a SUDO user with root privileges:

    ./sudo cvpkgadd

    To add a SUDO user to /etc/sudoers, see Adding SUDO Users with Root Privileges to Log On to a UNIX Client.

  4. The product banner and other information is displayed.

    Press Enter.

  5. Read the license agreement. Type y and press Enter.
  6. Press Enter.

    Selecting Unix Setup Task
    Please select a setup task you want to perform from the list below:
    Advanced options provide extra setup features such as creating custom package, recording/replaying user selections and installing External Data Connector software.
    1) Install data protection agents on this computer
    2) Advanced options
    3) Exit this menu
    Your choice: [1]

  7. Press Enter.

      This prompt is displayed only when you are installing on AIX or Solaris computers.

      Always make sure choice 1 is selected when installing this agent.

    32 or 64?
    This machine supports both 32 bit and 64 bit binaries. By default, we will install 32 bit binary set that has full support for all the modules included in this package. Please note that 64 bit binary set currently only support limited modules.
    1) All platforms(32 bit)
    2) FS and MA only(64 bit)
    Your choice: [1]

  8. The default network interface name of the client computer is displayed if the computer has only one network interface (NIC card), press Enter to accept.
    • If the computer has multiple network interfaces, enter the interface name that is preferred for communication with the CommServe, and then press Enter.

    The interface names and IP addresses depend on the computer in which the software is installed and may be different from the example shown.

    Setting Client/Physical Machine Host Name
    We found one network interface available on your machine. We will associate it with the client being installed, and it will also be used by the CommServe to connect to the client. Note that you will be able to additionally customize Datapipe Interface Pairs used for the backup data traffic later in the Simpana Java GUI.
    Please check the interface name below, and make corrections if necessary:
    Client/Physical Machine Host Name: [myclient.company.com]

  9. The local name of the client computer is displayed, press Enter to accept.

    • If necessary you can also enter a new (friendly) name for the client, and then press Enter. This name will be used in the CommCell and will also be displayed in the CommCell Console.
    • Do not use spaces when specifying a new name for the client.

    Setting Client Name
    Please specify the client name for this machine.
    It does not have to be the network host name: you can enter any word here without spaces. The only requirement is that it must be unique on the CommServe.
    Physical Machine Client name: [myclient]

  10. Type the number associated with the Oracle iDataAgent and press Enter.

    On AIX and Solaris clients, if you do not see Oracle iDataAgent in the list, do the following:

    • Make sure choice 1 (32-bit) was selected in step 7.
    • Check if any File System iDataAgent or MediaAgent was previously installed with 64-bit package on the client. In such cases, uninstall the agent and re-install using 32-bit package.

    Selecting Modules to Install.
    [ ] 1) UNIX File System iDataAgent [1101] [CVGxIDA]
    [ ] 2) MediaAgent [1301] [CVGxMA]
    [ ] 3) ProxyHost iDataAgent [1102] [CVGxProxyIDA]
    [ ] 4) Documentum iDataAgent [1126] [CVGxDctmIDA]
    [ ] 5) Oracle iDataAgent [1204] [CVGxOrIDA]
    [ ] 6) SAP for Oracle [1205] [CVGxOrSAP]
    [ ] 7) SAP for MaxDB [1206] [CVGxSAPMAXDB]
    [ ] 8) Informix iDataAgent [1201] [CVGxIfIDA]
    [ ] 9) Sybase iDataAgent [1202] [CVGxSybIDA]
    [ ] 10) DB2 iDataAgent [1207] [CVGxDB2]
    [ ] 11) MySQL iDataAgent [1208] [CVGxMySQL]
    [ ] 12) PostGres iDataAgent [1209] [CVGxPostGres]
    [ ] 13) Lotus Notes Database iDataAgent [1051] [CVGxLndbIDA]
    >) >>>>>>>>>>>> NEXT PAGE >>>>>>>>>>>>
    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 5

  11. Type d for Done, and press Enter.

    Selecting Modules to Install.
    [ ] 1) UNIX File System iDataAgent [1101] [CVGxIDA]
    [ ] 2) MediaAgent [1301] [CVGxMA]
    [ ] 3) ProxyHost iDataAgent [1102] [CVGxProxyIDA]
    [ ] 4) Documentum iDataAgent [1126] [CVGxDctmIDA]
    [X] 5) Oracle iDataAgent [1204] [CVGxOrIDA]
    [ ] 6) SAP for Oracle [1205] [CVGxOrSAP]
    [ ] 7) SAP for MaxDB [1206] [CVGxSAPMAXDB]
    [ ] 8) Informix iDataAgent [1201] [CVGxIfIDA]
    [ ] 9) Sybase iDataAgent [1202] [CVGxSybIDA]
    [ ] 10) DB2 iDataAgent [1207] [CVGxDB2]
    [ ] 11) MySQL iDataAgent [1208] [CVGxMySQL]
    [ ] 12) PostGres iDataAgent [1209] [CVGxPostGres]
    [ ] 13) Lotus Notes Database iDataAgent [1051] [CVGxLndbIDA]
    >) >>>>>>>>>>>> NEXT PAGE >>>>>>>>>>>>
    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: d

  12. Press Enter.

    Deciding if to Config for Laptop or Desktop Backups
    Do you want to configure the iDataAgent for laptop or desktop backups?
    Config for Laptop or Desktop Backups? [no]

  13. Press Enter.

    Deciding if to Install Agents for Restore Only
    Do you want to install the agents for restore only without consuming licenses?
    Install Agents for Restore Only? [no]

  14. Verify the default path for software installation.

    Press Enter.

    If necessary, enter a path to modify the default path and press Enter.

    • Do not install the software to a mapped network drive
    • Do not use the following characters when specifying the path:

      !@#$%^&*():/?\

    • It is recommended that you use alphanumeric characters only

    Preparing Installation Directory
    Please specify where you want us to install Simpana binaries.
    It must be a local directory or NFS and there should be at least 281MB of free space available. All files will be installed in a "simpana" subdirectory, so if you enter "/opt", the files will actually be placed into "/opt/simpana".
    Installation Directory: [/opt]

  15. Verify the default path for log files.

    Press Enter.

    If necessary, enter a path to modify the default path and press Enter.

    • Do not use the following characters when specifying the path:

      !@#$%^&*():/?\

    • It is recommended that you use alphanumeric characters only
    • All the modules installed on the computer will store the log files in this directory.

    Preparing Log Directory
    Please specify where you want to keep Simpana log files.
    It must be a local directory or NFS share and there should be at least 100MB of free space available. All log files will be created in a "simpana/Log_Files" subdirectory, so if you enter "/var/log", the logs will actually be placed into "/var/log/simpana/Log_Files".
    Log Directory: [/var/log]

  16. Press Enter.

    Deciding If to Use a Unix Group
    Most of Simpana processes run with root privileges, but some are launched by databases and inherit database access rights. To make sure that registry and log files can be written to by both kinds of processes we can either make such files world-writeable or we can grant write access only to processes belonging to a particular group, e.g. a "simpana" or a "dba" group.
    We highly recommend now that you create a new user group and enter its name in the next setup screen. If you choose not to assign a dedicated group to Simpana processes, you will need to specify the access permissions later.
    If you're planning to backup Oracle DB you should use "dba" group.
    Would you like to assign a specific group to Software? [yes]

  17. Type the Group name and press Enter.

    Press Enter again.

    Setting Unix Group
    Please enter the name of the group which will be assigned to all Simpana files and on behalf of which all Simpana processes will run.
    In most of the cases it's a good idea to create a dedicated "simpana" group.
    However, if you're planning to use Oracle iDataAgent or SAP Agent, you should enter Oracle's "dba" group here.
    Group name: testgrp1
    REMINDER
    If you are planning to install Simpana Informix, DB2, Sybase or Lotus Notes iDataAgent, please make sure to include Informix, DB2, etc. users into group "testgrp1"..
    Press <ENTER> to continue...

  18. Type d for done with the selection and press Enter.

    Setting Access Permissions for Group and Other Users
    Installer will assign full access rights to root user for all installed Simpana files and its processes.
    For group and any other users, you can specify the access permissions now.
    If you did not assign a dedicated group in previous step, make sure you specify sufficient access rights for other users if you are also planning to install Simpana agents involving third party software protection.
    [X] 1) Allow read permission to group users
    [X] 2) Allow write permission to group users
    [X] 3) Allow execute permission to group users
    [X] 4) Allow read permission to other users
    [ ] 5) Allow write permission to other users
    [X] 6) Allow execute permission to other users
    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: d

  19. The default port numbers used for CommCell communication is displayed. If necessary, you can modify the port numbers.

    Press Enter.

    Setting Instance Port Number of cvd
    Every instance of Simpana should use a unique set of network ports to avoid interfering with other instances running on the same machine.
    The port numbers selected must be from the reserved port number range and have not been registered by another application on this machine.
    Please enter the port numbers.
    Port Number for CVD : [8400]

  20. Press Enter.

    Setting Instance Port Number of EvMgrC
    Every instance of Simpana should use a unique set of network ports to avoid interfering with other instances running on the same machine.
    The port numbers selected must be from the reserved port number range and have not been registered by another application on this machine.
    Please enter the port numbers.
    Port Number for CVD: 8400
    Port Number for EvMgrC: [8402]

  21. Do one of the following:
    • If firewall configuration is not required, press Enter.
    • If this computer and the CommServe is separated by a firewall, type Yes and then press Enter.

    For firewall options and configuration instructions, see Firewall Configuration.

    Deciding If to Configure Firewall
    You need to configure firewall settings if there is a firewall between this client and the CommServe.
    Is there a firewall between this client and the CommServe? [no]

  22. Type the fully qualified domain of the CommServe host name and press Enter.
    • Do not use space and the following characters when specifying the CommServe Host Name:

      \|`~!@#$%^&*()+=<>/?,[]{}:;'"

    Setting CommServe Host Name
    Please specify hostname of the CommServe below. Make sure the hostname is fully qualified, resolvable by the name services configured on this machine.
    CommServe Host Name: mycommserve.company.com

  23. If you have enabled per-client certificate on CommServe, type y and press Enter.

    Else, press Enter.

    Specifying If CommServe Per-Client Certificate is Enabled
    If you have checked "Force per-client certificate authentication on CommServe" on the CommServe or Proxy, you need to provide installer with a Temp Certificate.
    This Temp Certificate can be obtained by opening "Certificate Administration Applet" from the Java GUI's Control Panel, clicking "Temp Certificate" button, selecting newly created client in the popped up window and copying/pasting generated certificate to a local file accessible from this installer.
    Have you enabled per-client certificate authentication on CommServe? [no]

  24. Choose one of the following:
    • 1 - To inherit global filter policy configuration set for the CommCell.
    • 2 - To apply the global filters policy to the default subclient regardless of the policy set for the CommCell.
    • 3 - If you plan to define specific filters for the Agent.

    Press Enter.

    Selecting How to Set CommCell Level Global Filters
    CommCell Level Global Filters are set through Simpana GUI's Control Panel in order to filter out certain directories or files from backup CommCell-widely.
    If you turn on the Global filters, they will be effective to the default subclient. There are three options you can choose to set the filters. Please select how to set the Global Filters for the default subclient?
    1) Use Cell level policy
    2) Always use Global filters
    3) Do not use Global filters
    Your Choice: [1]

  25. Type the appropriate number to select the Client Group and press Enter.

    This screen will be displayed only if Client Groups are configured for the CommCell.

    Selecting Client Computer Groups
    Client Group(s) is currently configured on CommServe mycommserve.company.com. Please choose the group(s) that you want to add this client myclient.company.com to.
    [ ] 1) Client Grp1
    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 1

  26. Type d for Done, and press Enter.

    Selecting Client Computer Groups
    Client Group(s) is currently configured on CommServe mycommserve.company.com. Please choose the group(s) that you want to add this client myclient.company.com to.
    [X] 1) Client Grp1
    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: d

  27. Press Enter.

    Deciding if to Configure Storage Policy
    Would you like to configure Storage Policy on this client?
    Configure? [no]

    Adjusting modes and permissions of files...done.
    Starting Simpana services...done.
    Thank you for choosing Simpana.

    If you do not have Storage Policy created, this message will be displayed. You may not be prompted for user input. You can create the Storage Policy later in step 27.

    There seem to be no Storage Policies configured on the CommServe. Before you can run any backups of this IDA, you will need to install a MediaAgent, create a Storage Policy and assign it to all subclients..

    If you already have a storage policy selected in step 26, proceed to the next page.

    If you do not have Storage Policy created, continue with the following step.

  28. To create a storage policy, you must have configured a library in the CommCell.

Disk Library Creation

  1. From the CommCell Browser, navigate to Storage Resources, right-click the Libraries, point to Add and then click Disk Library...

    Alternatively, you can also navigate to MediaAgents, right-click <MediaAgent>, point to All Tasks | Create Library and then click Disk Library...

  2. From the Add Disk Library dialog box, specify the following:
    • In the Name box, specify name of the disk library.
    • From the MediaAgent list, select the MediaAgent.

    Perform one of the following:

    • Select Local Path if you wish to specify a local path in the MediaAgent computer.

      In the Disk Device box, type the name of the folder in which the disk library must located or click button to select the folder.

    • Select Network Path, if you wish to specify a network path as the target share.

      In the Connect As box, type the user name.

      In the Password and Verify Password box, type the password to access the network share.

      In the Folder box, type the mount path or click button to select a mount path.

    • Click OK.
  3. The newly created disk library will be displayed under Libraries node.

This will create a library and Storage Policy. Click Next to proceed to the Configuration section.

Storage Policy Creation

  1. From the CommCell Browser, navigate to Policies.
  2. Right-click the Storage Policies and then click New Storage Policy.
  3. Follow the prompts displayed in the Storage Policy Wizard. The required options are mentioned below:
    • Select the Storage Policy type as Data Protection and Archiving and click Next.
    • Enter the name in the Storage Policy Name box and click Next.
    • From the Library list, click the name of a disk library to which the primary copy should be associated and then click Next.

      Ensure that you select a library attached to a MediaAgent operating in the current release.

    • From the MediaAgent list, click the name of a MediaAgent that will be used to create the primary copy and then click Next.
    • For the device streams and the retention criteria information, click Next to accept default values.
    • Select Yes to enable deduplication for the primary copy.
    • From the MediaAgent list, click the name of the MediaAgent that will be used to host the Deduplication Database (DDB).

      In the Location box, type the name of the folder in which the DDB must be located or click the Browse button to select the folder and then click Next.

    • Review the details and click Finish to create the Storage Policy.

This will create a storage policy. Click Next to proceed to the Configuration section.

Additional Installation Methods

Custom Package

Create a compact software package for quick deployment to multiple clients.

Decoupled Install

Install the software first and later register the client in the CommCell.

Remote Install

Deploy the software from CommCell Console on multiple clients.

Installing Restore Only Agents

Setup a client in the CommCell for restore purposes.

Silent Install

Deploy the software silently on multiple clients.