Click on a link below to go to a specific section of the software installation:
Install Requirements |
|
The MediaAgent can be installed on a
computer that satisfies the minimum requirements specified in
System Requirements - MediaAgent. The following procedure describes the steps involved in installing the MediaAgent software on a Solaris computer. If you choose to install multiple components simultaneously, refer to the appropriate procedures for installation requirements and steps specific to the component. Review the following Install Requirements before installing the software: General
Firewall
MediaAgent
NetApp NAS File Servers
Multi Instancing
|
|
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. |
ACSLS Server host name, if the library is attached to an ACSLS
Server.______________________________________
See Configure the ACSLS Libraries for more information. |
9. |
Index Cache directory
location:_____________________________________________________________ The default is /opt, but you may designate any location you want. See Configure Index Cache 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 CVGxMA 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. |
Select from the following:
|
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. |
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 |
Configure the ACSLS Libraries |
||
31. |
Type Yes and then press Enter if you wish to configure
StorageTek ACSLS libraries.
Press Enter if you do not wish to configure StorageTek ACSLS libraries. |
Would you like to configure StorageTek
ACSLS Enabled Libraries on this MediaAgent? Configure? [no] |
32. |
Press Enter to accept the default host name and continue, or Enter the name of the host in which the ACSLS server is installed and then press Enter to continue. If you are accessing the library using SN6000, enter the host name of SN6000 and then press Enter to continue. |
Please enter the name of the host running
the ACSLS daemon. ACSLS Server host name: |
33. | The install program now starts copying the software to the computer. The progress of the operation is displayed. |
..... ..... ..... ..... Successfully copied xx files |
Configure the Index Cache |
||
34. |
Specify the location for the MediaAgent's Index Cache.
NOTES
Press Enter to accept the default path and continue, or |
MediaAgent maintains a cache of indices for completed backups. Normally
they're stored in /test1/calypso/MediaAgent/IndexCache directory, but you can
keep them anywhere. You can even make an IndexCache directory shared by two or
more MediaAgents. Please specify where you want us to store the Index Cache. Cache Directory: |
35. |
Press Enter to continue. NOTES
|
Directory "/test1/calypso/MediaAgent/IndexCache"
does not exist. Are you sure you entered its name correctly? [yes] |
36. | Press Enter to acknowledge the successful completion of the MediaAgent software installation. |
Successfully installed CVGxMA.
Press ENTER to continue ... |
CVGxWA Installation |
||
37. |
Enter the number corresponding to the CVGxWA 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] |
![]() |
In order for the Solaris MediaAgent to utilize a tape library attached to this computer, you must install the WA SCSI driver after installing the MediaAgent. If you are using only a magnetic library, it is not required to install the CVGxWA package. If you do not want to install the WA SCSI driver, enter the number corresponding to Exit option and skip to Setup Complete. |
|
38. |
The install program now starts copying the software to the computer. The
progress of the operation is displayed.
Press Enter to continue. |
..... ..... ..... ..... Successfully copied xx files .......... Successfully installed <package_name>. Press ENTER to continue ... |
39. | Type Yes and press Enter to load the WA driver into the kernel and create the device nodes without rebooting the system. |
The loading of wa driver into the kernel may result in scanning of attached
devices on the system bus. This may take some time. Please answer yes if you
want to load driver into the kernel now, otherwise we will do soft load of the
driver into kernel which may require a reboot. Do you want us to load the driver into the kernel(yes/no)? [yes] |
Setup Complete |
||
40. |
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
MediaAgent Specific
|