Install the CommCell Console - Macintosh

Click on a link below to go to a specific section of the software installation:

Install Requirements
The CommCell Console is the graphical user interface (GUI) that you use to control the operation of the CommCell. By installing the CommCell Console on a Macintosh computer, you can remotely administer the CommCell from that computer.

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements - CommCell Console as a Stand-Alone Application.

Review the following Install Requirements before installing the software:

General

  • The CommCell Console can only be installed after the CommServe has already been installed in the CommCell and is running.
  • Close all applications and disable any programs that run automatically, including anti-virus, screen savers and operating system utilities.

    Some programs, including many anti-virus programs, may be running as a service. Stop and disable such services before you begin. You can re-enable them after the installation has completed.

  • Verify that you have the software installation disc that is appropriate to the destination computer’s operating system.

    Make sure that you have the latest software installation disc before you start to install or upgrade the software. If you are not sure, contact your software provider.

Firewall

  • If the CommServe is on the opposite side of the firewall from the CommCell Console, verify and ensure that port 8401 is open. For more information on firewall configuration, see Firewall Considerations.

Macintosh

  • For Macintosh, create user groups with permissions to help with the install/upgrade as follows:
    1. From the Finder, go to the NetInfo Manager utility by selecting Applications > Utilities > NetInfo Manager .
    2. Select Security > Authenticate.
    3. In the pop-up screen, enter a user name and password with administration privileges.
    4. Highlight Groups.
    5. Select Directory > New Subdirectory > Get “New_Directory”.
    6. Change “New_Directory” to a user-defined directory name.
    7. Select Directory > New Properties.
    8. Assign the property name GID and property value 777.
    9. Save the changes and update the copy.

Install Checklist
Collect the following information before installing the software. Use the space provided to record the information, and retain this information in your Disaster Recovery binder.
1. Network host name:____________________________________

Client name:____________________________________

For example, green.domainname.com and green.

See Step 5 for more information.

2. Install directory location:________________________________________________________________

The default is /opt, but you may designate any location you want.

See Base Software Installation for more information.
3. Log files directory location:________________________________________________________________

The default is /var/log, but you may designate any location you want.

See Base Software Installation for more information.
4. If the CommServe Server and the client computer communicate across a firewall:

Firewall ports: ______________________________________________________________________

Hostnames and/or IP Addresses and corresponding GxCVD port numbers of computers on the other side of the firewall:______________

Keep Alive Interval minutes:____________________________________________________________

Hostname for outgoing tunnel connections:_________________________________________________

Tunnel Initialization Interval seconds:_____________________________________________________

See Firewall Configuration for more information.
5. CommServe Name and the CommServe Host Name:______________________________________

For example, orange and orange.domainname.com.

See Base Software Installation (continued) for more information.
6. Job result directory location:________________________________________________________________

The default is /opt, but you may designate any location you want.

See Base Software Installation (continued) for more information.

Before You Begin
  • Log on to the client as root.
  • The install package requires super-user permissions to execute.

Install Procedure

Getting Started
1. Place the software installation disc for Macintosh clients into the client’s disc drive and mount the installation disc.

NOTES

  • You can also install the product using a disc drive mounted on another computer on the network.

Open the Terminal window, navigate to the software installation disc and then enter cvpkgadd.

  
2. The product banner and other information is displayed.

Press Enter to continue.

  
3. Read the license agreement. Type y and press Enter to continue.  
4. If you have only one network interface, press Enter to accept the default network interface name and continue.

If you have multiple network interfaces, enter the number corresponding to the network interface that you wish to use as default, and then press Enter to continue.

NOTES

  • The interface name and IP addresses depend on the computer in which the software is installed and may be different from the example shown.
 Network interface with the following IPs have been found available on your system. One of these interfaces should be associated with the physical machine being installed. It will also be used by the CommServe to initiate connections to the physical machine. Note that you will be able to additionally customize Datapipe Interface Pairs used for the backup data traffic later in the Calypso Java GUI.

Please select the correct network interface below.
1) client (201.42.33.598)
2) hk97::489:9glg:hk8d:9490
3) client.company.com (hr90:8842:2:78:013:8ghh:hg8k:9x54)

Interface number: [1]
  If you have multiple network interfaces, enter the number corresponding to the network interface that you wish to use as default, and then press Enter to continue.

NOTES

  • The interface name and IP addresses depend on the computer in which the software is installed and may be different from the example shown.
 Network interfaces with the following IPs have been found configured on your system. Please select one to be used by the CommServe to contact the client.
1) dunk.company.com (480.19.65.333)
2) 480.19.66.326

Interface number: [1]

  Verify the default network interface name.

Press Enter to accept the default network interface name and continue, or
Type the default network interface name, and then press Enter to continue.

NOTES

  • This prompt will be displayed only when you have multiple network interfaces for the computer.
 Please verify the physical machine interface name below. Make it as complete (with fully qualified domain name) as possible:

Physical Machine Host Name: [angel.company.com]
5. Specify the client name for the computer.

Press Enter to accept the default name and continue, or
Enter a new client name for the computer and then press Enter to continue.

 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.

Client name: [angel]

Select Components for Installation
6. Enter the number corresponding to the CVGxGUI module.

NOTES

  • Your screen may look different from the example shown.
  • Components that either have already been installed, or which cannot be installed, will not be shown.
  • In addition, the list of modules that appear depends on the specific Unix File System in which the package is installed. (e.g., CVGxWA will appear only when the installation package is run on a Solaris computer.)

Press Enter to continue.

 Install Calypso on physical machine client.company.com

Select the Calypso module that you would like to install

1) Media Agent             <= CVGxMA
2) FileSystem iDataAgent   <= CVGxIDA
3) Exit this menu

Module number: [1]

Base Software Installation
7. Select from the following:
  • If this is the first package to be installed on the computer, press Enter to continue.
  • If this is NOT the first package to be installed on the computer, this screen will not be displayed. Skip to Setup Complete.
 Here is a list and status of the dependent modules:

     1) Calypso Base0 Module                     NOT installed

    2) Calypso Base Module                      NOT installed

 If there are any modules listed as NOT installed/upgraded, they will be installed/upgraded first.

 Press <ENTER> to proceed ...
8. Specify the location where you want to install the software.

NOTES

  • The amount of free space required depends on the components selected for install, and may look different from the example shown.

Press Enter to accept the default path and continue, or
Enter a path and then press Enter to continue.

Press Enter again to confirm the path.

 Please specify where you want us to install Calypso binaries.

It must be a local directory and there should be at least 98MB of free space available. All files will be installed in a "calypso" subdirectory, so if you enter "/opt", the files will actually be placed into "/opt/calypso".

Installation Directory: [/opt]

..

Calypso will be installed in /opt/calypso.
Press ENTER to continue ...

9. Specify the location for the log files.

NOTES

  • All the modules installed on the computer will store the log files in this directory.
  • The amount of free space required depends on the components selected for install, and may look different from the example shown.

Press Enter to accept the default path and continue, or
Enter a path and then press Enter to continue.

Press Enter again to confirm the path.

 Please specify where you want to keep Calypso 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 "calypso/Log_Files" subdirectory, so if you enter "/var/log", the logs will actually be placed into "/var/log/calypso/Log_Files".

Log Directory: [/var/log]

..

Calypso log files will be created in /var/log/calypso/Log_Files.
Press ENTER to continue ...

10. Indicate whether you would like to launch processes with inherent database access rights.

Press Enter to assign a new group, or
Type No and then press Enter to continue.

 Most of Calypso 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 "calypso" 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 Calypso processes, all temporary and configuration files will be created with -rw-rw-rw permissions.

If you're planning to backup Oracle DB you should use "dba" group.

Would you like to assign a specific group to Calypso? [yes]
11. If you indicated Yes in the previous step, you will be prompted for the group name that must be used to launch processes.

Enter the group name and then press Enter to continue.

Press Enter again to continue.

 Please enter the name of the group which will be assigned to all Calypso files and on behalf of which all Calypso processes will run.

In most of the cases it's a good idea to create a dedicated "calypso" group. However, if you're planning to use Oracle iDataAgent or SAP Agent, you should enter Oracle's "dba" group here.

Group name: dba

REMINDER

If you are planning to install Calypso Informix, DB2, Sybase or Lotus Notes iDataAgent, please make sure to include Informix, DB2, etc. users into group "dba".
Press <ENTER> to continue ...

Firewall Configuration
12. If this computer communicates with the CommServe, MediaAgent and/or other clients across a firewall, type Yes, and then press Enter to continue. Proceed to the next Step.

Press Enter, if you do not wish to configure the firewall services. Proceed to the next section.

 Various Calypso components need to communicate with each other: iDataAgents and MediaAgents establish connections to CommServe and talk to each other as well. If any of the involved parties are situated on the opposite sides of a firewall, Calypso should be made aware of it so that it could bind its pipeline sockets to open ports and could establish tunnels for control traffic.

You must configure Calypso firewall services if there are other Calypso machines, which are expected to communicate with this one.

Do you want to configure Calypso firewall services? [no]
13. Enter the port range(s), and then press Enter to continue.

NOTES

 Calypso needs to know which TCP ports of this machine are available for connections initiated by machines on the other side of the firewall.

If this machine is not reachable from the other side of the firewall at all (because the FW is one-way and allows only outgoing connections), enter any unused port number here (e.g. 8600).
Otherwise please consult your FW configuration for the list of open incoming ports and enter all of them here (with the exception of port 8400).

Currently there are no ports configured. Please enter a single port number or a port range (like 8600-8620) to be added to the FW configuration:

Port range: [8600-8620]
14. Enter the number corresponding to the option you wish to perform.

NOTES

  • If you choose option 1, refer the previous step.
  • If you choose option 3, proceed to the next step.
 What would you like to do:

  1) Add another open port or a range of ports

  2) Delete an existing port or a range of ports

  3) Continue with the firewalled host setup

Your choice: [3]
15. Enter the host name(s) of the computers that will need to be contacted through a firewall, and then press Enter to continue. We need to know which Calypso hosts are located on the other side of the firewall, and whether the firewall will allow direct or reverse connections to/from those hosts.

You can specify hosts by either entering their names, IP addresses or name/IP wildcards. The wildcards are available only if the firewall is symmetrical, i.e. allows to open connections to certain ports both ways.

Currently there are no firewall hosts configured.

Please enter the name or IP address of a host on the other side of the firewall. If the firewall is symmetrical, you are allowed to use wildcards, i.e. things like 192.168.* or *.firewall.company.com:

Firewalled Host: lavender.company.com
16. Choose the option associated with type of firewall configuration based on the firewall setup in your environment.

NOTES

  • Choose Two-way (symmetrical) firewall if you can open certain ports as bi-directional ports.
  • Choose One-way firewall; <port> is reachable from here if this computer communicates with MediaAgent/Client on the other side of the firewall.
  • Choose One-way firewall; this machine is reachable from <port> when the CommServe and any Clients/MediaAgents) communicates with this computer.
 Please specify the type of the firewall separating this machine from 172.19.61.89.

  1) Two-way (symmetrical) firewall

  2) One-way firewall, 172.19.61.89 is reachable from here

  3) One-way firewall, this machine is reachable from 172.19.61.89

Your choice: [1]

17. Enter the number corresponding to the option you wish to perform.

NOTES

  • If you choose option 1, refer the previous two steps.
  • If you choose option 3, proceed to the next step.
 What would you like to do:

 1) Configure another host

 2) Delete an existing host

 3) Continue with the firewall keep-alive setup

Your choice: [3] 1
18. If desired, modify the Keep Alive interval, and then press Enter to continue, or
Press Enter to accept the default. 		Please specify Keep Alive interval for Calypso firewall services.

Many firewalls disconnect idle Network connections after some period of time. Some of the Calypso Services need continuous connections. Calypso keeps such connections active by sending periodic "keep-alive" packets.
Consult your firewall documentation, or contact your Network Administrator, for the exact value after which idle connections will be closed (snip time). Then enter a value, which is at least one minute less than the snip time.

Keep-alive interval, minutes [5]
19. To configure advanced firewall settings, type Yes, and then press Enter. Proceed to the next Step.

If you do not want to configure advanced firewall settings, type No, and then press Enter. Proceed to the next section.

 The Generic part of the Calypso Firewall Config has been completed successfully. There are some additional advanced settings that you may want to review now. All of them can be customized later by editing the .properties file under /etc/CommVaultRegistry/Galaxy/Instance003/Firewall.

Would you like to review the advanced settings now? [no]
20. To bind the local end of tunnel connections to a specified interface, type Yes, and then press Enter. Proceed to the next Step.

If you do not want to bind the local end of tunnel connections to a specified interface, type No, and then press Enter. Skip the next Step.

 Normally Calypso Firewall code doesn't bind local end of TCP/IP sockets when establishing outgoing tunnel connections relying on the OS to pick correct interface and arbitrary port automatically. Usually this doesn't cause connectivity problems because we require that the firewall must allow connections for as long as 1meither source or destination socket end is bound to one of the ports in the open range.

Sometimes, however, on hosts with several NICs it's important to force the OS to bind the local socket end to a specific network interface. There is a Calypso setting called 1mnBIND_BEFORE_CONNECT_IFACEm, which enables this behavior. If present, Calypso will bind the local end of tunnel connections to the specified interface.

Would you like to configure nBIND_BEFORE_CONNECT_IFACE? [no]
21. Type a number corresponding to one of the listed network interfaces, to use for outgoing tunnel connections through the firewall.

Press Enter to continue.

 Please select network interface that should be used for all outgoing tunnel connections:

1) <ip_address>

Interface number: [1]
22. If desired, modify the Tunnel Initialization interval by typing a number.

Press Enter to continue.

 When tunnel to a destination machine cannot be established because the machine is down or is not accepting connections, Calypso will retry the connection after some time. Tunnels piercing one-way firewalls are 1mPERSISTENTm meaning that Calypso will keep on trying to initialize them until success. These attempts can generate a lot of network traffic if a central machine (e.g. CommServe) suddenly goes down.

Here you can adjust the interval (called 1mnTUNNEL_INIT_INTERVALm in registry) between tunnel init attempts.

Tunnel Init Interval, seconds, [5]

Base Software Installation (continued)
23. Type the name of the CommServe computer and press Enter to continue.

NOTES

  • Ensure that the CommServe is accessible before typing the name; otherwise the installation will fail.
  • If you enter a short name which resolves to the same IP address as the fully qualified CommServe name, you will be asked if you would prefer to use the fully qualified name.
 Please enter the hostname of the Calypso CommServe. It can be either short or long; the only requirement is that it must be resolvable by the name services configured on this machine.

CommServe Name:
24. Specify the location of the job results directory.

NOTES

  • All the agent modules installed on the computer uses the job results directory to store the backup and restore job results.
  • The amount of free space required depends on the components selected for install, and may look different from the example shown.

Press Enter to accept the default path and continue, or
Enter a path and then press Enter to continue.

 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: [/test1]

Kernel Parameters
25. Enter the appropriate number of streams, and then press Enter to continue, or
Press Enter to accept the default number of streams and continue.

NOTES

This prompt is relevant only when you install/upgrade on a Macintosh or Solaris computer as appropriate.

 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]
26. Indicate whether you would like modifications to be made to the /etc/system configuration file.

Type Yes, and then press Enter to automatically update the file and continue, or
Press Enter to accept the default No and continue (if you do not want to automatically update the file).

This prompt is displayed only when you install/upgrade on a Solaris or Macintosh computer.

 We now need to modify the /etc/system configuration file on this computer. It is done to make sure that there will be enough shared memory and semaphores available for Calypso programs.

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

set shmsys:shminfo_shmmni=8570 (was 7930)
set shmsys:shminfo_shmseg=8420 (was 7780)
set semsys:seminfo_semmns=10320 (was 9680)
set semsys:seminfo_semmni=8570 (was 7930)
set semsys:seminfo_semmsl=8570(was 7930)

Do you want us to apply these changes now? [no]

Changes saved into /etc/system.gal.1744

Press <ENTER> to continue.
27. If you indicated No in the previous step, the file to which the changes have been saved is displayed.
Make sure that these values are established later to ensure that all the requirements for this setup is satisfied.

NOTES

  • The settings that are displayed are the maximum or minimum required settings. Value ’640’, which is provided for various shared memory segment or semaphore requirements, is a maximum value based on 10 streams.

Press Enter to continue.

This prompt is displayed only when you install/upgrade on a Solaris computer, in cases where the install detects that the computer does not have the maximum or minimum required shared memory settings.

 Although a ’no’ answer can be selected to this question during install, the user should make sure the min requirements (below) for shared memory are met, otherwise the backups may fail (the message in logs is ’could not start the pipeline’).

set shmsys:shminfo_shmmax=4199304
set shmsys:shminfo_shmmin=1
set semsys:shminfo_shmmni=640
set semsys:shminfo_shmseg=640
set semsys:seminfo_semmns=640
set semsys:seminfo_semmni=640
set semsys:seminfo_semmsl=640
set maxusers=256

Setup Complete
28. Press Enter to continue. Updating registry tree under /etc/CommVaultRegistry.

+-------------------------------------+

IMPORTANT:

To start Calypso GUI:

RUN Calypso.

+-------------------------------------+

Adjusting modes and permissions of Calypso files

Successfully installed CVGxGUI.

Press ENTER to continue ...

Post-Install Considerations

General

  • Install post-release updates or Service Packs that may have been released after the release of the software. If you are installing a Service Pack, verify and ensure that it is the same version as the one installed in the CommServe Server. Alternatively, you can enable Automatic Updates for quick and easy installation of updates in the CommCell component.