Deployment - UNIX - Notes Database iDataAgent

Deployment - Windows Deployment - Unix Configuration Backup Restore

Where to Install

Install the software on an IBM Domino that you want to backup.

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

Setting a UNIX Group

During installation, you must provide a UNIX group to be assigned to all SnapProtect files. We recommend to create a dedicated group for all SnapProtect files.

Ensure that Domino Notes users belong to the specified UNIX group.

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 standard installation options.

Method 1: Remote Installation Using CommCell Console

  1. Open CommCell Console:

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

  3. Click Next.

  4. Click Next.

  5. Click Manually Select Computers.

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

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

    • The user must be an Administrator or a member of the Administrator group on that computer.
    • 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 Database under Domino Lotus Notes.

    Click 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 Add to specify the name of the Domino Server.

    Click Next.

  12. Click Next.

    If necessary you can select additional options. Click the Help button to get more information on the available options.

  13. Specify a name for the Unix Group and click Next.

    If necessary you can select advanced options. Click the Help button to get more information on the available options.

  14. Click Next.

    If necessary you can select additional options. Click the Help button to get more information on the available options.

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

  16. Select Immediate.

    Click Next.

  17. Click Finish.

    This screen will reflect the components you selected for install, and may look different from the example shown.

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

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

    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.

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. 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 Lotus Notes Database iDataAgent and press Enter.

    Selecting Modules to Install.
    [ ] 1) UNIX File System Basic [1002] [CVGxBase]
    [ ] 2) UNIX File System Advanced [1101] [CVGxIDA]
    [ ] 3) MediaAgent [1301] [CVGxMA]
    [ ] 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: 13

  9. Type d for Done, and press Enter.

    Selecting Modules to Install.
    [ ] 1) UNIX File System Basic [1002] [CVGxBase]
    [ ] 2) UNIX File System Advanced [1101] [CVGxIDA]
    [ ] 3) MediaAgent [1301] [CVGxMA]
    [ ] 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]
    [X] 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. 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

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

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

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

  25. Verify the default path for Domino Home Directory  where IBM Domino is installed.

    Press Enter.

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

    Setting Domino Home Directory
    Please enter Domino Home Directory.

    Domino Home Directory: [/opt/ibm/lotus]

  26. Verify the information listed on the confirmation screen, and press Enter.

    To change Domino Home Directory, type no and press Enter. The system returns you to enter the Domino Home Directory again.

    Confirming Domino Home and Version

    Please confirm and answer "yes", if it is correct:

    Domino Home Directory.. /opt/ibm/lotus

    Is this correct? [yes]

  27. Type the name of the Domino partition, and press Enter.

    The partition name reflects the name of the computer on which the software is installed.

    Setting Domino Partition Name
    Please enter Domino Partition Name.

    Domino Partition Name:[Partition_0]

  28. Type the name of the data directory for the partition, and press Enter.

    The data directory reflects the directory in which all databases reside.

    Setting Domino Data Directory
    Please enter Domino Data Directory.

    Domino Data Directory:

  29. Verify the information listed on the confirmation screen, and press Enter.

    To change partition information, type no and press Enter. The system returns you to enter the partition name again.

    Confirming Domino Instance
    You have entered all the required information for testpartition1.

    Please review it now and answer "yes", if it is correct:

    Domino Partition Name.. testpartition1
    Domino Data Directory.. /lotus/datapath

    Is this correct? [yes]

  30. Do one of the following:
    • If you don't want to configure another partition, press Enter.
    • If you want to configure another partition, type Yes and then press Enter.

    Confirming Domino Instance
    Configured 1 partition(s) of Notes so far.

    Would you like to configure another partition? [no]

    Setting Domino Data Directory
    Please enter Domino Data Directory.

    Domino Data Directory:

  31. Verify the information listed on the confirmation screen, and press Enter.

    To change partition information, type no and press Enter. The system returns you to enter the partition name again.

    Confirming Domino Instance
    You have entered all the required information for testpartition1.

    Please review it now and answer "yes", if it is correct:

    Domino Partition Name.. testpartition1
    Domino Data Directory.. /lotus/datapath

    Is this correct? [yes]

  32. Do one of the following:
    • If you don't want to configure another partition, press Enter.
    • If you want to configure another partition, type Yes and then press Enter.

    Confirming Domino Instance
    Configured 1 partition(s) of Notes so far.

    Would you like to configure another partition? [no]

  33. Enter the number associated with the storage policy you want to use and 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, continue with the following step.

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

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.

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.