Click on a link below to go to a specific section of the software installation:
Install Requirements |
|
The Quick Recovery Agent is installed
on the computer on which the volume to be protected is mounted. (This
computer is referred to as the Client computer in this install
procedure.)
Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements - Quick Recovery Agent. The following procedure describes the steps for installing the Quick Recovery Agent. If you choose to install additional components, refer to the appropriate procedures for installation requirements and steps specific to the component. Review the following before installing the software: General
Firewall
Agent Specific
Multi Instancing
HP-UX
|
|
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. |
Network TCP port number for the Communications Service (CVD):_____________________________ Network TCP port number for the Client Event Manager Service (EvMgrC):___________________________ See Base Software Installation for more information. |
5. |
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. |
6. |
CommServe Name and the CommServe Host Name:______________________________________
For example, orange and orange.domainname.com. See Base Software Installation (continued) for more information. |
7. |
Job result directory location:________________________________________________________________
The default is /opt, but you may designate any location you want. See Base Software Installation (continued) for more information. |
8. |
Storage Policy used by the default subclient:________________________________________________
See Storage Policy Selection for more information. |
9. |
Client Group to which this Client will be associated:_____________________________________________
See Client Group Selection for more information. |
Before You Begin |
|
|
Install Procedure |
||
Getting Started |
||
1. |
Place the software
installation disc for the Unix platform into the disc drive. You can also install the product using a disc drive mounted on another computer on the network.
|
|
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. |
This prompt is displayed only when you are installing on AIX, HP-UX, Linux, or
Solaris computers.
Press Enter to continue NOTES
|
Certain Calypso 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.
You now have a choice of performing a regular Calypso install on the physical host or installing Calypso on a virtual machine for operation within a cluster. Most users should select "Install on a physical machine" here. 1) Install on a physical machine 2) Install on a virtual machine 3) Exit Your choice: [1] |
5. |
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
|
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. Interface number: [1] |
Verify the default network interface name.
Press Enter to accept the default network interface name and continue,
or NOTES
|
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] |
|
6. |
Specify the client name for the computer.
Press Enter to accept the default name and continue, or |
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 |
7. | Enter the number corresponding to the CVGxQRA
module.
NOTES
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 Module number: [1] |
Base Software Installation |
||
8. |
|
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 ... |
9. |
Specify the location where you want to install the software.
NOTES
Press Enter to accept the default path and continue, or 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.
|
10. |
Specify the location for the log files.
NOTES
Press Enter to accept the default path and continue, or 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. |
11. |
Indicate whether you would like to launch processes with inherent database
access rights.
Press Enter to
assign a new group, or |
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] |
12. |
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. For installs on a Solaris computer, proceed to the next step. Otherwise, skip to Storage Policy Selection. |
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". |
13. |
Type a network TCP port number for the Communications Service (CVD) and press Enter.
Type a network TCP port number for the Client Event Manager Service (EvMgrC) and press Enter. NOTES
|
Every instance of Calypso 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] |
Firewall Configuration |
||
14. |
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] |
15. |
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). 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] |
16. |
Enter the number corresponding to the option you wish to perform. NOTES
|
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 ports3) Continue with the firewalled host setup Your choice: [3] |
17. | 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 |
18. |
Choose the option associated with type of firewall configuration based on the
firewall setup in your environment.
NOTES
|
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] |
19. |
Enter the number corresponding to the option you wish to perform. NOTES
|
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 |
20. |
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. Keep-alive interval, minutes [5] |
21. |
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] |
22. |
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] |
23. |
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] |
24. |
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) |
||
25. |
Type the name of the CommServe computer and press Enter to continue.
NOTES
|
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: |
26. |
Enter the username and password information for an external
domain user account or a CommCell user account. This authorizes the installation
of an agent on the CommCell.
NOTES
Click Enter to continue. |
Enter your CommCell user name and password: User Name : Password : Press <ENTER> to continue ... |
27. |
Specify the location of the job results directory. NOTES
Press Enter to accept the default path and continue, or |
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 |
||
28. |
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] |
29. |
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 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) Do you want us to apply these changes now? [no] Changes saved into /etc/system.gal.1744 Press <ENTER> to continue. |
30. |
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
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 |
Storage Policy Selection |
||
31. |
Enter the number corresponding to the storage policy through which you want to back up
the File System iDataAgent and then press Enter to continue.
NOTES
|
Please select one storage policy for this IDA from the list
below:
1) SP_StandAloneLibrary2_2 Storage Policy: [3] |
Enable Global Filters |
||
32. |
Type the appropriate number for configuring Global Filters for the default
subclient and press Enter to continue.
NOTES
|
Commcell Level Global Filters are set
through Calypso 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.
1) Use Cell level policy Please select how to set the Global Filters for the default subclient? [1] |
Client Group Selection |
||
33. |
Type the number of a Client Group and press Enter.
A confirmation screen will mark your choice with an "X". Type the number for Done with the Selection, and press Enter to continue. NOTES
|
Client Group(s) is currently configured on CommServe
cs.company.com.
Please choose the group(s) that you want to add this client
client.company.com to. The selected group(s) will be marked (X) and can be
deselected if you enter the same number again. After you are finished with the
selection, select "Done with the Selection". 1) Unix 2) DR 3) DKS 4) Done with the selection Please enter a number to select/deselect: [1] |
Setup Complete |
||
34. |
Press Enter to continue.
NOTES
|
+---------------------+
IMPORTANT: In addition to installing Calypso on this computer, you will also need to create a Job Schedule for each iDataAgent that has been installed on this client computer. Job Schedules are required to allow the Calypso iDataAgents to perform automated backup and restore operations. Job Schedule creation can be accomplished through the Calypso CommCell Console administration interface. +---------------------+ Successfully installed CVGxIDA. |
35. |
Installation of the QR Agent is now complete. You are warned to install the Oracle iDataAgent if you intend to run Oracle log backups. Press Enter to continue. |
Updating registry tree under /etc/CommVaultRegistry
... done. Preconfiguring CVGxQRA on the CommServe ... done. WARNING! If you plan to run Oracle log backups along with QRA incremental updates, you will have to install Calypso Oracle iDataAgent (CVGxOrIDA) to perform successful restores. If this is the case, we suggest that you install CVGxOrIDA now. Adjusting modes and permissions of Calypso files Successfully installed CVGxQRA. Press <ENTER> to proceed |
36. |
This menu may be displayed only when you are installing on HP-UX, Linux,
or Solaris computers.
If this is the last package that you wish to install/upgrade, enter the number
corresponding to the Return option and then press Enter to
continue.
NOTES
|
Select the Calypso module that
you would like to install. 1) Proxy FileSystem iDataAgent <= CVGxProxyIDA Module number: [1] |
37. |
Enter Yes to download and install the latest service packs and post packs from the software provider. NOTES
Press Enter to continue. |
Download and Install Latest Service Pack If you choose to download the latest service pack from the software provider website now, please make sure you have internet connectivity at this time. This process may take some time depending on the internet connectivity. Do you want to download the latest service pack now ? [no] Press <ENTER> to continue ... |
38. |
This prompt is displayed only when you are installing on HP-UX, Linux, or
Solaris computers.
Enter the number
corresponding to the Exit option and then press Enter to
continue.
The installation is now complete. |
Certain Calypso 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 Calypso installed on physical node stone.company.com. Now you have a choice of either adding another package to the existing installation or configure Calypso on a virtual machine for use in a cluster. 1) Add another package to
stone.company.com Your choice: [1] |
Post-Install Considerations |
||
General
The software provides many more features that you will find useful. See the Index for a complete list of supported features. Agent Specific
Disaster Recovery Considerations
|