Click on a link below to go to a specific section:
The procedure
on this page describes the steps involved in upgrading the ProxyHost
iDataAgent on Unix in a
clustered environment. This
procedure provides steps for upgrading the ProxyHost
iDataAgent only.
Upgrade the active node first and then upgrade all the passive
nodes. The upgrade program will identify the physical node if it is present and
prompt you to identify the name of the physical node during the upgrade process.
If multiple components are installed on a computer, then ensure that all applicable components are selected for upgrade. In such a situation, the upgrade sequence may vary. Refer to the appropriate procedures for upgrade requirements and steps specific to the component. Verify that the computer in which you wish to upgrade the software satisfies the minimum requirements specified in System Requirements - ProxyHost iDataAgent. |
|||||||||||||||||
Supported Upgrade Paths |
|||||||||||||||||
The following table provides a list of supported upgrade paths for the current software version. If the version currently installed on your computer is not listed here, contact your software provider for more information.
|
|||||||||||||||||
Upgrade Requirements |
|||||||||||||||||
Review the following before upgrading the software:General
Agent Specific
|
|||||||||||||||||
Before You Begin |
|||||||||||||||||
|
|||||||||||||||||
Upgrade Procedure |
|||||||||||||||||
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. |
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 ... |
|||||||||||||||
5. |
Note the directives provided. Some directives will require action on your
part post-upgrade. Type YES and then press Enter. NOTES
|
We have detected old version of Calypso
installation on this machine that have to be upgraded to version 8.0.0 before
you can install new packages or configure new virtual machines.
Please read the following carefully before moving on. 1.If there are existing cxbf devices configured and mounted on linux machine, please make sure all of them are removed from the /etc/fstab file before reboot (after upgrade). You can mount them back after reboot by redetecting in the volume explorer first. 2. If a driver is upgraded, the machine must be rebooted after the upgrade is finished to ensure the new driver is correctly loaded. 3. If you are upgrading a subsystem (except MA) that is installed on Virtual Machine only, make sure you also install CVGxIDA (or CVGxOES for CVGxOES upgrade) on its Physical Machine. Please type YES to indicate you read and understood the above warnings: YES |
|||||||||||||||
6. |
Specify the network interface that you want to associate
with the physical machine and press Enter. NOTES
|
Even though it is a virtual
machine that you are installing now, we still have to ask you to provide
hostname and client name for the physical node.
Network interfaces with the following IPs are available on your system. Please select the one that you want to be associated with Calypso physical machine. The interface should be static, and should not get disabled in case of cluster failover. 1) mackrel71 2) mackrel 3) mackrel1 Interface number: [1] 2 |
|||||||||||||||
7. |
Verify the name of the physical interface and make any
required changes. Then press Enter.
NOTES
|
Please verify the physical
interface name below. Make it as complete (with fully qualified domain name)
as possible.
Physical Hostname: [mackrel] |
|||||||||||||||
8. |
Enter a node name for the physical machine and press
Enter.
NOTES
|
Even though you are installing
Calypso on a machine, we still need to ask you to provide a node name for
the physical 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 Node Name: [mackrel] |
|||||||||||||||
9. | Enter the number corresponding to the CVGxIDA module.
NOTES
Press Enter to continue. |
Upgrade Calypso on
Physical machine client.company.com Select the Calypso module that you would like to upgrade. Please note that you won't be able to install new packages or configure new virtual machines until you complete the upgrade.
1) FileSystem iDataAgent Module number: [1] |
|||||||||||||||
10. |
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] |
|||||||||||||||
11. |
The program automatically exits after successfully upgrading the software.
NOTES
|
+----------------------------------------------------------+ IMPORTANT: Now that you have successfully upgraded CVGxIDA, you must proceed upgrading other packages that depend on it (such as CVGxOrIDA, or CVGxIfIDA)! +----------------------------------------------------------+ Adjusting modes and permissions of Calypso files Successfully installed CVGxIDA. |
|||||||||||||||
12. |
Enter the number corresponding Exit option to continue. 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 Module number: [1] 14 |
|||||||||||||||
13. |
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 ... |
|||||||||||||||
14. | This prompt is displayed only when you are upgrading 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-Upgrade Considerations |
|||||||||||||||||
General
ClusterThe cvclusternotify.sh script should be added as part of the normal cluster startup/shutdown procedure. The script is provided as a generic template, and it must be run whenever the current node shuts down during failover and as the new active node comes online. In both cases, data protection services must be up and running. The script works as follows:
Usage: cvclusternotify - Program to notify Calypso of cluster failovers cvclusternotify -inst <Instance> -cn <Client Name> -start|-shutdown \[-fs <dir1>] [-fs <dir2>] ... This command notifies Calypso that the specified client from the specified instance is going up or down because of a cluster failover. The optional "-fs <dir>" parameters can be provided to notify File Archiver for Unix that certain file systems are disappearing or becoming available during the failover. For each of these file systems, the CDR/File Archiver for UNIX driver will be instructed to stop or begin file system monitoring. Example: Suppose you have a two-node cluster where the virtual machine client name is "virtual". (Physical node names are not needed.) Suppose that the application instance in this case is "Instance001" and that the archived data currently exists on two shared file system directories as follows: /share1/filesystem1
For the node shutdown, the following command is issued: cvclusternotify -inst Instance001 -cn "virtual" -shutdown -fs /share1/filesystem1 -fs /share2/filesystem2 This will stop File Archiver for Unix from monitoring the indicated file systems on the node that is shutting down. For the node (active) startup, the following command is issued: cvclusternotify -inst Instance001 -cn "virtual" -start -fs /share1/filesystem1 -fs /share2/filesystem2 This will enable File Archiver for Unix to start monitoring the indicated file systems on the node that is starting up. |