Upgrade the Unix File System iDataAgent - Clustered Environment

Click on a link below to go to a specific section:

The procedure on this page describes the steps involved in upgrading Unix File System iDataAgent in a clustered environment. 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 the appropriate system requirements. See System Requirements - Unix File System iDataAgent for more information.

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.

Installed Version

Upgrade to Version 8.0.0

Information
     
6.1.0 Supported Perform a direct upgrade to Version 8.0.0.
     
7.0.0 Supported Perform a direct upgrade to Version 8.0.0.

Upgrade Requirements
Review the following before upgrading the software:

General

  • Review the Upgrade Strategy before upgrading the software.
  • Verify that no jobs are in progress or scheduled to occur while the software is being upgraded on the client. If jobs are scheduled, either perform the upgrade at another time or disable all jobs in the client using the Activity Control tab from the Client Computer Properties dialog box in the CommCell Console.

    Once the upgrade is completed, you can enable the jobs from this dialog box.

  • Verify that the CommServe computer is accessible and all services on the CommServe and the MediaAgent in which you wish to perform the upgrade are running.
  • Verify that the SQL Server instance used by the CommServe is running on the CommServe computer.
  • Verify that all applications (CommCell Console, Service Control Manager) are closed.
  • Close all applications and disable any programs that run automatically, including antivirus, screen savers and system utilities. Some programs, including antivirus software, may be running as a service. Stop and disable all non-essential services before you begin. You can re-enable them after the upgrade.
  • The files and folders associated with CommCell components should not be opened by other applications (for example, Windows Explorer, FTP, etc.) on this computer or from other computers during the upgrade.
  • 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 the software. If you are not sure, contact your software provider.

Agent Specific

  • The install package requires super-user permissions to execute.
  • If you are installing/upgrading on a HP-UX computer, you must manually mount the installation disc as described in Mount the Software Installation Disc.

Before You Begin
  • Ensure that you are logged on as root.

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.

  • On Solaris, double-click the cvpkgadd program from the File Manager window.
  • On other Unix platforms, 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. 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

  • This is only displayed when the Authentication for Agent feature is enabled in the CommCell Properties. Users must belong to a User Group with Agent Management capabilities to enable this feature. For more information, see Authentication for Agent Installs.

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

  • The directives that are displayed may vary. Therefore, the contents of your screen may be different from what is shown here.
  • Additional screens with directives may be displayed after you press Enter. Be sure to complete the suggested actions.
 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

  • This prompt will be displayed only when you have multiple network interfaces.
 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

  • This prompt will be displayed only when you have multiple network interfaces.
 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

  • This prompt will be displayed if the upgrade program detects the binaries for the physical node in the computer.
 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

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

 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   
2) Exit

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

  • This screen will be displayed only if Client Groups are configured for the CommCell. For more information, see Client Computer Groups.
 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

  • The list of components that were upgraded depends on the components installed on the computer, and may look different from the example shown.
 +----------------------------------------------------------+
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

  • 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.
  • If you wish to install a module enter the number corresponding to the module and continue the upgrade process after the installation.

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
 2) Proxy FileSystem IDA
 3) Oracle IDA
 4) Oracle SAP IDA
 5) SAPMAXDB IDA
 6) Informix IDA
 7) Sybase IDA
 8) DB2 IDA
 9) MySQL IDA
10) Quick Recovery Agent
11) Recovery Directory for UNIX
12) SRM File System Agent
13) Media Explorer
14) Exit

Module number: [1] 14

13. Enter Yes to download and install the latest service packs and post packs from the software provider.

NOTES

  • Internet connectivity is required to download updates.
  • This step is applicable for multi instancing.

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
2) Install Calypso on a virtual machine
3) Exit

Your choice: [1]

Post-Upgrade 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.
  • If Activity Control was disabled on the client prior to the upgrade, enable it after the upgrade using the Activity Control tab from the Client Computer Properties dialog box in the CommCell Console.

Cluster

The 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:

  • During node shutdown, the script notifies File Archiver for Unix and the CommServe that the listed file systems will no longer be monitored on this node.
  • During node startup, the script notifies File Archiver for Unix and the CommServe that the listed file systems will now be monitored on this node.

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
/share2/filesystem2

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.

If you are upgrading the software from 7.0.0 to 8.0.0

  • After upgrade, the service commands of the previous release software are no longer valid. For more information on the current release service commands, see Service Control for Unix.