Custom Package - UNIX

Before you Begin

Verify System Requirements

Verify that the computer in which you want to install the custom package 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 and create a custom package.

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

Create a Custom Package

Use the following steps to create a custom package for Unix components.

  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. Type 2 and 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] 2

  6. Press Enter to create a Custom install package.

    Selecting Unix Setup Advanced Options
    Please select a setup task you want to perform from the list below:
    [Custom Package Creator]
    1) Create a custom install package
    [ De-coupled Installer ]
    2) Pre-install software Components (De-coupled Mode)
    3) Exit this menu

    Your Choice: [1]

  7. Press Enter.

    Selecting Package Type
    Besides general package, you may choose to create one additional native package from the list below.
    Please make sure to allow write permission to /opt if you choose to create native package(except Mac package)
    1) General package only
    2) Please also create RPM
    3) Please also create solaris native package
    4) Please also create hpux native package
    5) Please also create Mac package using PackageMaker
    6) Please also create APT
    7) Exit
    Your Choice: [1]

  8. Type the number associated with the platform for which you want to create the custom package, and press Enter.

    Selecting Platform
    Please choose one or more platforms to package from the list below.
    [ ] 1) Linux X86
    [ ] 2) Linux X86_64
    [ ] 3) Linux PPC64
    [ ] 4) Linux S390
    [ ] 5) Solaris10 SPARC
    [ ] 6) Solaris10 X86_64
    [ ] 7) Aix PPC
    [ ] 8) HP-UX IA64
    [ ] 9) Darwin X86
    [ ] 10) FreeBSD7 X86
    [ ] 11) FreeBSD7 X86_64
    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 2

  9. Type d for done, and then press Enter.

    Selecting Platform
    Please choose one or more platforms to package from the list below.
    [ ] 1) Linux X86
    [X] 2) Linux X86_64
    [ ] 3) Linux PPC64
    [ ] 4) Linux S390
    [ ] 5) Solaris10 SPARC
    [ ] 6) Solaris10 X86_64
    [ ] 7) Aix PPC
    [ ] 8) HP-UX IA64
    [ ] 9) Darwin X86
    [ ] 10) FreeBSD7 X86
    [ ] 11) FreeBSD7 X86_64

    [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. Type the number associated with component (s) that you want to include in the custom package, and press Enter.

     Selecting Subsystem

    Please choose one or more subsystems to package from the list below.

    [ ] 1) File System Core [1002] [CVGxBase]
    [ ] 2) File System [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) PostgreSQL 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: 2

  11. Type d for done and then press Enter.

    Selecting Subsystem

    Please choose one or more subsystems to package from the list below.

    [ ] 1) File System Core [CVGxBase]
    [x] 2) File System [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) PostgreSQL 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 to save the Custom Package to the default path. If you want to specify a different location, type the path and then press Enter.

    Setting Custom Package Directory

    Please enter the directory name for saving the custom package to.

    Save custom package to: [/opt]

  13. Type Yes and press Enter.

    Deciding If to Record the Install

    Optionally, you may choose to record install to an xml parameter file now so that you can play it later. The recorded xml will be encapsulated into the
    custom package and can be used as an answer file in two ways:
    (1) from the custom package run "cvpkgadd" or "silent_install -p default";
    (2) from the native package run native installer(rpm/pkgadd/swinstall...)

    You can still perform the above two tasks without custom recording if you choose to use all default parameters.

    Do you want to record the install now? [no] yes

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

    Press Enter to hide the above option during install.

    Hide this screen? [yes]

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

    Press Enter to hide the above option during install.

    Hide this screen? [yes]

  16. Verify the default path for software installation. Custom Package will be installed to this location.

    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

    Please specify where you want us to install binaries.

    It must be a local directory and there should be at least 680MB 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

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  17. Verify the default path for log files. While installing the Custom Package, the log files will be saved to this location.

    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 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: /Log_Files

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  18. Verify the default path for JobResults Directory and press Enter.

    Preparing Job Results Directory

    Please specify the name for the JobResults directory.

    It must be a local directory and there should be at least 20MB of free space
    available. It will be used to store intermediate data that should be passed
    from one backup phase to another.

    JobResults Directory: /opt/snapprotect/iDataAgent/jobResults

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  19. Type the Group name and press Enter.

    Press Enter again.

    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 SnapProtect? [yes]

    If you do not want the above screen to be displayed at the time of installation of this Custom Package, press Enter.

    Hide this screen? [yes]

  20. Type the UNIX group and press Enter.

    Make sure that the group you specified above exists on the computer on which you would install this custom package.

    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: galaxy

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  21. Press Enter.

    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: galaxy
    REMINDER
    If you are planning to install SnapProtect Informix, DB2, Sybase or LotusNotes iDataAgent, please make sure to include informix, db2, etc. users into group "galaxy"..
    Press <ENTER> to continue...

  22. 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 here 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
    [X] 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

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

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

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

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

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

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

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  26. 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: cserve.idclab.loc

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  27. Press Enter.

    If you want to record the install as decupled install, type yes and then press Enter.

    Deciding If to Record as Decoupled Install

    You may choose to create a package that will not register to CommServe during
    install.

    Do you want to record the install as decoupled install? [no]

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  28. Perform one of the following actions:
    • If CommCell authentication is enabled, type y, press Enter, and specify your CommCell credentials.

      The user that installs the custom package will also be prompted for credentials to authenticate the installation.

    • If CommCell authentication is not enabled, press Enter.

    Deciding If to Use CommCell Authentication

    If CommCell client authentication is enabled, you must enter a valid username
    and password in order to register this client to the CommCell.

    Do you want to enter CommCell username and password? [no]

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

    Setting Client Computer Group

    Please enter one Client Computer Group name for this client to join.

    Client Computer Group Name: CCGroup_01

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  30. Press Enter.

    Setting Storage Policy

    Please enter a storage policy name for this IDA.

    Storage Policy Name: Storage_policy_01

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  31. Type 11 and then press Enter.

    If you want to install the components to a different instance, type the number associated with the instance and then press Enter.

    Please select which instance you want to install/replay for this recording:

    1) Always install to Instance001
    2) Always install to Instance002
    3) Always install to Instance003
    4) Always install to Instance004
    5) Always install to Instance005
    6) Always install to Instance006
    7) Always install to Instance007
    8) Always install to Instance008
    9) Always install to Instance009
    10) Always install to Instance010
    11) Always install to a new instance
    12) I want to specify another instance

    Your Choice: [11]

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  32. Type yes and press Enter.

    Archiving
    Optionally, you may choose to tar the custom package in a tar file now.
    Do you want to create the tar file now? [no] yes

    Press Enter to hide the above option during custom package install.

    Hide this screen? [yes]

  33. Press Enter

    ***IMPORTANT*** You were using default tar on this machine to make the
    archiving. Make sure you use the same/compatible tar to unzip the archive on
    the target machine.
    Press <ENTER> to continue ...

    Make a note of the locations at which the Packages are created.

    [Custom Regular Package Summary] General package created at
    /opt/UnixCustomPackage/pkg
    [Custom Native Package Summary] Tar package created at
    /opt/UnixCustomPackage/tar

Install Using the Custom Package

Use this procedure to install using the custom package self extracting file.

Before You Begin

  • If you want to install 32-bit binaries on a 64-bit computer, create the cvpkgadd_unlock_32 key by using the following command:

    touch /tmp/cvpkgadd_unlock_32

    From the menu that appears during the installation, you can select a 32-bit or 64-bit installation. If you do not create the key, the custom package installs 64-bit binaries by default.

  • If you want to change some of the configurations made during the custom package creation, you can edit the custom package XML file. The XML is located in Custom_Package_Directory/rec/default.xml.

Procedure

  1. Navigate to the location specified during Custom Package creation.

    For example:

    /opt/UnixCustomPackage/pkg

  2.  Run ./silent_install -p default. For example:

    <client_computer>/opt/UnixCustomPackage# ./silent_install -p default

    Performing non-interactive Install of the following modules...
    * Base Client [1002] [CVGxBase]
    * Base0 Client [1003] [CVGxBase0]
    * UNIX File System iDataAgent [1101] [CVGxIDA]
    Install of the above modules completed successfully.