Upgrade the Unix and Macintosh File System iDataAgents

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

The procedure on this page describes the steps involved in upgrading the following iDataAgents in a non-clustered environment:
  • AIX
  • FreeBSD
  • HP-UX
  • IRIX
  • Linux
  • Macintosh
  • Solaris
  • Tru64
This procedure provides steps for upgrading these iDataAgents only.

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 - Unix File System iDataAgent and System Requirements - Macintosh File System 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.

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.

Macintosh

  • For Macintosh, before installing/upgrading the product, log on to the client as a valid user. In the terminal window, issue the su - root command to substitute your user identity with that for the root user. Then enter the valid root user password.
  • 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.

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. Do you accept the terms of this license agreement? y
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 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]
9. 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]
10 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.
11. 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

12. 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 ...
13. 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.

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.