Silent Upgrade - Unix Agents


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

Overview

The silent upgrade feature allows you to enter installation parameters into a file that is read in by the installation program instead of typing them in response to each installation prompt. This section explains how to install the Base software (and/or iDataAgent) using the silent upgrade feature. You can use this feature to install both software packages with one command line execution.

The procedure on this page describes the steps involved in using a silent upgrade to upgrade the following iDataAgents:

  • AIX
  • FreeBSD
  • HP-UX
  • IRIX
  • Linux
  • Macintosh
  • SAP for Oracle
  • Solaris
  • Tru64

Verify that each computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements - MediaAgent and System Requirements - Unix File System iDataAgent or 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.

  • The CommServe must be upgraded before performing silent upgrades on any of the clients in the CommCell.
  • If the CommServe, MediaAgent, and/or clients are communicating across one or more firewalls, ensure that ports 8400 through 8403 are allowed connections through the firewall for these computers.

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.
  • For Macintosh File System, ensure that the hashed form of the login password (for example, AK4yMgoTZCWYQ) will be used.  To this purpose, follow these steps:
  1. From the client computer, enter a command that allows you to check if the root password is in hashed form (alternatively, you can use the Mac NetInfo GUI utility). For example:

root# nireport / /users name passwd | grep root

If the password is not in hashed form, go to the next step.

  1. Get the hashed password.  For example:

root# openssl passwd -crypt -salt value cv_slam

where value can be any alphanumeric value (e.g. yz)

  1. Replace the root password with the hashed form of this password (e.g., yzijgGETFnb/E) in the NetInfo database (alternatively, you can use the Mac NetInfo GUI utility). For example:

root# niutil -createprop / /users/root passwd yzijgGETFnb/E

  • For Macintosh File System, enable the rexec protocol before starting the remote install. For systems running on Mac OSX 10.4.x version, you need to create a file called "exec" under /etc/xinetd.d with the following content:

service exec

{

disable = no

socket_type = stream

wait = no

user = root

server = /usr/libexec/rexecd

groups = yes

flags = REUSE

log_type = SYSLOG daemon debug

}

Remote Install using rexec protocol will not work without this file being present. Once this file is created, xinetd may automatically start up on the system. If this does not happen, either start the xinetd service manually or, if necessary, reboot the machine.

  • For Macintosh File System, if the CommCell Console is already installed along with the iDataAgent on the "remote" client being upgraded, the upgrade will fail with a message similar to the following:

    "Unable to upgrade Calypso on remote host dunk.company.com. There are some Calypso SubSystems installed there which cannot be upgraded via push (or silent) install (CVGxGUI)"

    As a workaround, do the following:

    1. Uninstall the CommCell Console.
    2. Perform the upgrade.
    3. Reinstall the CommCell Console.

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 and mount the installation disc.
2. Run the following command:

silent_install -upgrade <inst>[-log<log_file>]

where:

  • -upgrade <inst> specifies the instance that you want to upgrade. If you are upgrading 6.0, set this to Instance001. No file or module names are needed for silent upgrade. Even they are specified, they will be silently ignored.
  • <log_file> specifies the custom log file name that you should create as a temporary log file. This file is displayed only if the installation fails.

For example:

silent_install -upgrade Instance001

3. The upgrade has completed when a message appears, similar to the example. Installation of CVGxBase CVGxIDA completed successfully

Post-Upgrade Considerations

All Agents

  • Review the Post-Upgrade Considerations specific to the components that were upgraded using this procedure. (See Upgrades for a list of all Upgrade procedures.)

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.