Deployment on UNIX - Informix iDataAgent

Where to Install

Note: To protect a 32-bit Informix Dynamic Server Application on a 64-bit LINUX client, configure the client installation program to install 32-bit agents. For information on how to perform this operation, see Installing UNIX Agents on a 64-Bit Platform

Install the software on a computer that you want to backup.

The computer will be added as a client in the CommCell as soon as you complete the installation 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 SnapProtect® software using the Download Manager application. The Download Manager bundles an installation package from the SnapProtect 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.

Interactive Installation

  1. Logon to the client computer as root.
  2. Run the following command from the installation package that was created using the Download Manager.

    ./cvpkgadd

    If the installation package was copied to a DVD, run the following command to mount the DVD:

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

    You can also run the installation 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.

  3. The product banner and other information is displayed.

    Press Enter.

  4. Read the license agreement. Type y and press Enter.
  5. 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]

  6. 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 SnapProtect Java GUI.
    Please check the interface name below, and make corrections if necessary:
    Client/Physical Machine Host Name: [myclient.company.com]

  7. 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]

  8. Type the number associated with the Informix iDataAgent 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]
    [ ] 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: 8

  9. 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]
    [ ] 5) Oracle iDataAgent [1204] [CVGxOrIDA]
    [ ] 6) SAP for Oracle [1205] [CVGxOrSAP]
    [ ] 7) SAP for MaxDB [1206] [CVGxSAPMAXDB]
    [X] 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

  10. 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]

  11. 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]

  12. 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 SnapProtect 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 "snapprotect" subdirectory, so if you enter "/opt", the files will actually be placed into "/opt/snapprotect".
    Installation Directory: [/opt]

  13. 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 SnapProtect 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 "snapprotect/Log_Files" subdirectory, so if you enter "/var/log", the logs will actually be placed into "/var/log/snapprotect/Log_Files".
    Log Directory: [/var/log]

  14. Press Enter.

    Deciding If to Use a Unix Group
    Most of SnapProtect 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 "snapprotect" 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 SnapProtect 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]

  15. 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 SnapProtect files and on behalf of which all SnapProtect processes will run.
    In most of the cases it's a good idea to create a dedicated "snapprotect" 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 SnapProtect Informix, DB2, Sybase or Lotus Notes iDataAgent, please make sure to include Informix, DB2, etc. users into group "testgrp1"..
    Press <ENTER> to continue...

  16. 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 SnapProtect 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 SnapProtect 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

  17. 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 SnapProtect 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]

  18. Press Enter.

    Setting Instance Port Number of EvMgrC
    Every instance of SnapProtect 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]

  19. 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]

  20. 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

  21. 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]

  22. 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 SnapProtect 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]

  23. 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

  24. 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

  25. 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 SnapProtect services...done.
    Thank you for choosing SnapProtect.

    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 25.

    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 do not have Storage Policy created, continue with the following step.

  26. To create a storage policy, you must have configured a library in the CommCell.
  27. You are advised that the system is preparing to relink Informix. Press Enter.

    The control now passes to the Ifx_install.sh script to allow it to relink Informix.
    Press ENTER to continue.
    Installing NetApp, Inc. SnapProtect Onbar.....

  28. You are asked if you want to relink the Informix instance now. This is required before performing backups.
    If you want to do this now, type y and press Enter, and proceed to step 31.
    If you want to do this later, type n and press Enter, and go to next step.

    Do you wish to relink Informix instance now? (n/[y])

  29. Press Enter.

    We are back from Ifx_install.sh
    Press <ENTER> to continue.

  30. You are warned that Informix must be relinked before performing backups and are provided with the appropriate post-install instructions. Press Enter and proceed to the step to validate the relinking of the instances.

    WARNING: relink of Informix is required before performing backups. Please execute /opt/snapprotect/iDataAgent/Ifx_install.sh to relink Informix after the install.

  31. You are prompted to specify the Informix User ID. Enter the name of the user that has administrative access to the Informix database server.
    Enter the Informix User ID or accept the default value and press Enter.

    Please enter INFORMIX_USER ID [informix]:

  32. You are prompted to specify the user group for Informix. The INFORMIX_USER must belong to this group.
    Enter the user group name or accept the default value and press Enter.

    Please enter user group for informix [informix]:

  33. You are prompted to enter the Informix home directory.  This is where you installed the database server.
    Enter a path to the home directory and press Enter.

    Please enter INFORMIXDIR directory:

  34. You are prompted to enter the name of the appropriate ONCONFIG file. This file holds the configuration parameters for the database server. By default this file is in the $INFORMIXDIR/etc directory.
    Enter the file name and press Enter.

    Please enter the ONCONFIG environment variable:

  35. You are prompted to enter the unique name associated with this specific occurrence of the database server. The value of the INFORMIXSERVER environment variable on the client must match the DBSERVERNAME parameter in the ONCONFIG file.

    Enter the name of the server and press Enter.

    Please enter the INFORMIXSERVER environment variable:

  36. You are prompted to enter the path to the Informix libraries. By default this library will be present in $INFORMIXDIR/lib. Enter the path or select the default and press Enter.

    Please enter the BAR_BSALIB_PATH [/usr/lib]:

  37. The following message is displayed. As prompted, include the indicated parameter into the ONCONFIG file and then press Enter to continue.
    The BAR_BSALIB_PATH parameter is supported only on some platforms. Consult the appropriate Informix application documentation to determine if BAR_BSALIB_PATH is supported on your platform.

    Put "BAR_BSALIB_PATH /usr/lib/sparcv9/ibsad001.<xx>" into configuration file onconfig.inf_921.
    Replace <xx> with the shared library file extension, e.g., ibsad001.so is for SOLARIS, ibsad001.sl is for HP.
    We are back from Ifx_install.sh
    Press <ENTER> to continue...

  38. If you do not want to relink another Informix instance now, type n and press Enter. Go to the next step.
    If you want to relink another Informix now, type y and press Enter.

    Do you wish to relink another informix instance now? (y/[n])

  39. You are advised that the installation is completed, and you are provided with instructions for installing other Informix instances. Press Enter.

    Installation complete. If you wish to install other Informix instances, please execute /opt/snapprotect/iDataAgent/Ifx_install.sh after installation
    We are back from Ifx_install.sh
    Press <ENTER> to continue...

  40. Validate the relinking of the instance.
  41. If you have multiple instances of the database, ensure that the items listed are satisfied. Press Enter.

    IMPORTANT

    If you are planning to use SnapProtect <package> with several instances of the database, each running on behalf of different UNIX users, you must make sure that:

    1) All database users have been added to each of the database groups involved. For example, if there is a "db2inst1" user from group "dba1" and "db2inst2" user from group "dba2", then both "db2inst1" and "db2inst2" should be included into "dba1" and "dba2" groups. On most UNIXes this can be accomplished by editing the /etc/group file.

    2) The .profile of each database user must contains a "umask 002" command at the end, which will guarantee that all files created by one database user can be open for writing by other database users.

    3) All database users should be added to the "dba" group that you have chosen for SnapProtect at the time of CVGxBase install.

    If all of the above requirements are not fulfilled, SnapProtect will run into various "Permission denied" errors, and backups will not work.

    Press <ENTER> to continue ...

  42. Messages similar to the following are displayed. Press Enter.

    Updating registry tree under /etc/Registry ... done.
    Preconfiguring Informix DataAgent on the CommServe ... done.
    Successfully installed CVGxIfIDA.
    Press ENTER to continue ...
    Setup Complete.

  43. The following prompt is displayed only when you are installing on HP-UX, Linux, or Solaris computers.
    Enter the number corresponding to the Exit and then press Enter. The installation is now complete.

    Certain SnapProtect packages can be associated with a virtual IP, or in other words, installed on a "virtual machine" belonging to some cluster. At any given time the virtual machine's services and IP address are active on only one of the cluster's servers. The virtual machine can "fail-over" from one server to another, which includes stopping services and deactivating IP address on the first server and activating the IP address/services on the other server.
    Currently you have SnapProtect installed on physical node stone.company.com.
    Now you have a choice of either adding another package to the existing installation or configure SnapProtect on a virtual machine for use in a cluster.
    1) Add another package to stone.company.com
    2) Install SnapProtect on a virtual machine
    3) Exit
    Your choice: [1]

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.

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.
    • Review the details and click Finish to create the Storage Policy.

This will create a storage policy.

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.

Installing Restore Only Agents

Setup a client in the CommCell for restore purposes.