Install the CommCell Console - UNIX

The CommCell Console is a graphical user interface (GUI) that allows you to manage CommCell operations.

Where to Install

By installing the CommCell Console on a Unix computer, you can remotely administer the CommCell from that computer.

Use the following steps to install the CommCell Console.

Install Requirements

The CommCell Console must be installed after the CommServe has been deployed.

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 Install

  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 CommCell Console and press Enter.

    [ ] 16) Continuous Data Replicator [1114] [CVGxCDR]
    [X] 17) CommCell Console [1118] [CVGxGUI]
    [ ] 18) Novell OES Groupwise DataBase iDataAgent [1122] [CVGxGW]
    [ ] 19) Novell OES File System iDataAgent [1121] [CVGxOES]
    [ ] 20) Novell OES Directory Services [1124] [CVGxNDS]
    [ ] 21) Object Link [1129] [CVGxOBJSRV]
    [ ] 22) External Data Connector [1128] [CVGxEDC]
    [ ] 23) Resource Pack [1130] [CVGxRP]
    [ ] 24) Predictor for Continuous Data Replicator [1133] [CVGxCDRP]

    [a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]
    Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 17
     

  9. Type d for Done, and press Enter.

    [ ] 16) Continuous Data Replicator [1114] [CVGxCDR]
    [X] 17) CommCell Console [1118] [CVGxGUI]
    [ ] 18) Novell OES Groupwise DataBase iDataAgent [1122] [CVGxGW]
    [ ] 19) Novell OES File System iDataAgent [1121] [CVGxOES]
    [ ] 20) Novell OES Directory Services [1124] [CVGxNDS]
    [ ] 21) Object Link [1129] [CVGxOBJSRV]
    [ ] 22) External Data Connector [1128] [CVGxEDC]
    [ ] 23) Resource Pack [1130] [CVGxRP]
    [ ] 24) Predictor for Continuous Data Replicator [1133] [CVGxCDRP]

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

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

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

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

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

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

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

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

    This screen is displayed if you do not assign any group to the software and type no in step 15.

    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

  18. Verify the default number of streams. If necessary, modify the number of streams and press Enter.

    Setting Number of Streams
    Please enter the total number of streams that you plan to run at the same time. We need to make sure that you have enough semaphores and shared memory segments configured in /etc/system.
    Number of Streams [10]

  19. Type yes  to apply the changes; this requires a system reboot immediately after the install.

    Press Enter.

    If desired, press Enter to save the system configuration file changes to another file and apply them manually later.

    Deciding If to Modify System Configuration File
    We now need to modify the /etc/sysctl.conf and /boot/loader.conf configuration file on this computer. It is done to make sure that there will be enough shared memory and semaphores available for SnapProtect programs.

    Please review the changes below, and answer "yes", if you want us to apply them to /etc/sysctl.conf and /boot/loader.conf file. Otherwise the installation will proceed, the changes will saved to some other file, and you will have to apply them manually.

    ***IMPORTANT*** PLEASE APPLY THE CHANGE AND REBOOT IMMEDIATE AFTER INSTALL.
    kern.ipc.shmmax=2147479552 (unchanged)
    kern.ipc.shmall=524287 (unchanged)
    kern.ipc.shmmin=1 (unchanged)
    kern.ipc.shmmni=5792 (was:5152)
    kern.ipc.shmseg=5768 (was:5128)
    kern.ipc.semmns=93141 (was:92501)
    kern.ipc.semmni=87381 (unchanged)
    kern.ipc.semmsl=93141 (was:92501)

    Do you want us to apply these changes now? [no] yes
    Changes saved into /etc/sysctl.conf.gal.tmp.717.

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

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

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

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

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

  25. To review the setup, you may find the following logs useful if available:
  26. [LOG INFO] To review the setup, you may find the following logs useful if available:
    (1) logs under /tmp/.gxsetup
    (2) install.log|env and UpdateInfo.log|env under Log Directory
    (3) logs under /var/log/.gxsetup/10-116-csawantunix1.idclab.loc-172.16.60.50-20048[-f]

To start CommCell GUI, run the following command from the command line.

console