Automatic Updates - How To

From the CommCell Browser, right-click the CommServe icon, click Control Panel, and select Automatic Update Configuration.
Select the Automatic Update Configuration (Download) tab, and enter the FTP site from which you need to download updates in the FTP Site field. A default FTP site and user account are provided.
Click the Change button to change the user account information of your host computer in the User name and password dialog box, and click OK.
Select the Automatic Update Configuration (CommServe Update Cache) tab.
From the CommServe Cache and Share For Windows Clients pane, specify or browse to either a local or network drive to use as a cache directory to store updates in the Cache Directory field.
For a network share, click User Name/Password and enter the user account information in the Change User Account dialog box. Click OK.
Click OK from the Automatic Update Configuration dialog box.

Configure an FTP Proxy Server

Required Capability: Capabilities and Permitted Actions

To configure an FTP Proxy Server:

From the CommCell Browser, right-click the CommServe icon, click Control Panel, and then click Automatic Update Configuration.
Select the Automatic Update Configuration (Download) tab, and select the Use FTP Proxy for Operations option.
Click the FTP Proxy Settings button to configure the proxy server.
From the FTP Proxy Configuration Dialog box, enter the name of the FTP Proxy Server in the FTP Proxy Hostname field box.
If permissions are needed, select Use Username and password, and then type a user name and password in the User name and password boxes.
Enter the location of the FTP Site in the Location field.
Click OK.
Click OK from the Automatic Update Configuration dialog box.

Configure an HTTP Proxy Server

Required Capability: Capabilities and Permitted Actions

To configure an HTTP Proxy Server:

From the CommCell Browser, right-click the CommServe icon, click Control Panel, and then click Automatic Update Configuration.
Select the Automatic Update Configuration (Download) tab, and select the Use HTTP Proxy for FTP Operations option.
Click the HTTP Proxy Settings button to configure the proxy server.
From the HTTP Proxy configuration dialog, enter the name of the HTTP Proxy Server in the HTTP Proxy Hostname field box.
Select the port number in the Proxy Port box.
If permissions are needed, select Use Username and password, and then type a user name and password in the User name and password boxes.
Click OK.
Click OK from the Automatic Update Configuration dialog box.

Download Updates From the FTP Site for Downloading Updates to a CommServe Computer

Before You Begin

Do not schedule an FTP download at the same time an automatic update job is scheduled to run.
Verify that you have adequate space for the latest service pack.
If the Sync Update Caches is enabled, the downloaded updates will be automatically pushed to the designated client computer update caches to keep them in synch with the CommServe Update Cache.

Required Capability: Capabilities and Permitted Actions

To download updates from the FTP site for downloading updates to a cache directory on a CommServe Computer:

From the CommCell Browser, right-click the CommServe icon, click All Tasks -> Download Automatic Updates.
From the Download Updates Job Options dialog box, click Run Immediately or Schedule.
If you click Schedule:
- From the Schedule Details tab, select the necessary schedule options.
- To view the job summary for the FTP Download job that you have scheduled, click the Job Summary tab of the Schedule Details dialog box.
- Click OK to save the schedule.
Click OK from the Download Updates Job Options dialog box.

Run CopyToCache

Before You Begin

SQL service should be running when utilizing this tool.
The CommServe Cache directory location can only be configured from the Automatic Update Configuration (Download) window via the CommCell Console’s Control Panel. For more information, see Configure an FTP Site and CommServe Cache Directory.

Required Capability: Capabilities and Permitted Actions

To run CopyToCache:

Initiate Windows Explorer on your CommServe (or 1-Touch Server) and run the following program: <software_install_directory>/Base/CopyToCache.exe.
Enter or use the Browse button to navigate to the directory pointing to the <updatename>.exe to be copied to the CommServe Update Cache directory in the Update Location field box. Note the the current CommServe Update Cache directory location is displayed in the Cache Location field. The CommServe Update Cache directory location can only be configured from the Automatic Update Configuration (Download) window via the CommCell Console’s Control Panel. For more information, see Configure an FTP Site and CommServe Update Cache Directory.

1-Touch Only: Select the appropriate Copy Option. Refer to the following table.

If your computer (from which you are running CopyToCache) is:	And you select the following copy option(s):	The results are as follows:
CommServe (not 1-Touch)	Copy to cache	Updates will be copied to the designated CommServe Update Cache directory.
	Copy to 1-Touch	Updates will not be copied to the designated CommServe Update Cache directory.
	Copy to cache and Copy to 1-Touch	Updates will be copied to the designated CommServe Update Cache directory.
1-Touch (CommServe)	Copy to cache	Updates will be copied to the designated CommServe Update Cache directory.
	Copy to 1-Touch	1-Touch Updates will be copied to the default cache directory. See notes, 1-Touch for Windows.
	Copy to cache and Copy to 1-Touch	Updates will be copied to designated CommServe Update Cache, and 1-Touch Updates will be copied to the default cache directory. See notes, 1-Touch for Windows.
1-Touch (not CommServe)	Copy to cache	1-Touch updates will be copied to the default cache directory. See notes, 1-Touch for Windows.
	Copy to 1-Touch	1-Touch updates will be copied to the default cache directory. See notes, 1-Touch for Windows.
	Copy to cache and Copy to 1-Touch	1-Touch updates will be copied to the default cache directory. See notes, 1-Touch for Windows.

CopyToCache Copy Options are only enabled when a 1-Touch computer is detected in the CommCell environment.

Click the Copy Updates To Cache button to begin the copying process.
Click Exit.

To run CopyToCache in silent mode:

Launch the Command Line Prompt.
From the prompt, enter the following: CopyToCache.exe –f <directory path of patch to be copied>. Upon completion, status of the copy operation will be displayed; 0 for success, 1 for failure. If job failed, details regarding the reason for failure will be provided.
Note the following commands for the tool:
–c disables the Copy to cache option

–t disables the Copy to 1-Touch option

Refer to previous table to determine when it is suitable to disable/enable these options.

To copy and install a service pack, refer to:

Install a Windows or NetWare Service Pack using Automatic Updates
Install a UNIX Service Pack using Automatic Updates.

1-Touch for Windows:

The \config\update.ini file for the selected update should include the following entry: [ONETOUCH]=Yes. Any Windows File System patch with this entry will be copied to the 1-Touch Server cache.
The location of the cache is determined by the following entry in the registry:
HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\Galaxy\Instance\SystemRecoveryServer\sZIMAGESSHARENAME=Images

The default Images is used by other processes and should not be changed.
Once copytocache is run successfully, it creates a CVUpdates folder and stores the update in the following directory: <software_install_directory>\SystemRecovery\Images\CVUpdates.

Configure an Update Cache

Before You Begin

Verify that you have adequate space in the client computer's update cache directory for the latest service pack.
Multicache Configuration requires all associated computers to have the current software version installed. Clients with software released prior to the current version cannot be associated to an update cache.
NetWare client computers can not be designated as update cache computers.

Required Capability: Capabilities and Permitted Actions

To configure a CommServe cache directory:

From the CommCell Browser, right-click the CommServe icon, click Control Panel, and select Automatic Update Configuration.
Select the Automatic Update Configuration (Update Caches) tab.
Click the Add button to configure the update cache.
From the Configure UpdateCache dialog box, select the client that should be designated as the Update Cache.
Click the option to Enable UpdateCache. This will enable the feature to push out the latest update packages it holds to the clients within the CommCell that are selected to receive their updates from this update cache, the clients will no longer receive their updates from the CommServe Update Cache, and their baseline will be in reference to the designated update cache.
Click the option to AutoSyncup With CS Cache to have the Update Cache automatically receive the latest updates and service packs from the CommServe Cache. The Update Agent cache will be automatically synchronized with the CommServe update cache when updates are downloaded to the CommServe.
NOTE
Do not select this option if you want to manually control the updates of the computers that are associated with the Update Cache.
Specify or browse to either a local or network drive to use as a cache directory to store updates in the Cache Directory field. Note that you cannot choose a network drive as an update cache for computers that have only Workstation Backup Agent installed.
Click User Name/Password and enter the user account information in the Change User Account dialog box. Click OK.
Click Add/Remove Clients/Client Groups to associate client computers to this update cache; the selected client computers will receive their updates and service packs from this configured update cache.
NOTE
The baseline for these clients will be determined by the designated update cache, not the CommServe Update Cache.
Click OK from the Configure UpdateCache dialog box.
Click OK from the Automatic Update Configuration dialog box.

Configure a Remote Client or MediaAgent to Receive Automatic Updates

Before you Begin

A remote client or MediaAgent is not installed on the same computer as the CommServe.
Novell clients and MediaAgents are not supported.
If a computer is both a client and a MediaAgent, if the configuration of one entity is changed, the other entity is changed also.
If storing updates locally, verify that you have adequate space for the latest service pack.

Required Capability: Capabilities and Permitted Actions

To configure a remote client or MediaAgent to receive updates:

From the CommCell Browser, right-click a client or MediaAgent, click Properties, then click Version.
From the Version tab Cache Source, you can select the source for the updates. Select CommServe to receive updates from the CommServe Cache, or select Update Agent to receive updates directly from the specified Client designated as an Update Agent computer.
To store update packages locally before installation, specify a local folder in the Store Updates Locally field in which the updates must be stored. This serves as a temporary cache area. Note that you cannot specify a different folder to serve as the temporary cache area for NetWare clients; this field is disabled.
Click OK.

Store Automatic Update Packages Locally before Installation

To Store Update Packages Locally before Installation:

From the CommCell Browser, click the Client or MediaAgent for which you wish to configure the Update installation, and then click Properties.
Click the Version tab.
To store update packages locally before installation, specify a local folder in the Store Updates Locally field in which the updates must be stored. This serves as a temporary cache area. Note that you cannot specify a different folder to serve as the temporary cache area for NetWare clients; this field is disabled.
Click OK to save the information.

Initiate the Installation of Automatic Updates from the CommServe

Before You Begin

Do not run or schedule an automatic update job at the same time other jobs are running or are scheduled to run.
Do not run or schedule an automatic update job the same time an FTP download is running or is scheduled to run. Allow sufficient time for the FTP download job to finish before running or scheduling this job.
Suspend all jobs on the clients and MediaAgents that will be receiving updates in your CommCell.

Required Capability: Capabilities and Permitted Actions

To initiate the installation of updates from the CommServe:

From the CommCell Browser, right-click the CommServe icon, click All Tasks -> Install Updates.
From the Install Updates Job Options dialog box, select either All to install updates on all clients or click Select and then move a client(s) from Available Clients list to the Selected Clients list.

Select Reboot Client if Required to have the system automatically reboot the client and/or MediaAgent computers if a reboot is required.

In deduplication environments, for MediaAgents hosting the deduplication store, all the deduplication transactions in the memory must be completed before the reboot. See Rebooting a MediaAgent Hosting the Deduplication Store for instructions.

Select Continue with Install Updates even if jobs are running on the computer to allow updates to be installed on the selected clients/MediaAgents as per schedule even if jobs are currently running. Services will be stopped temporarily suspending the running jobs to allow the install to complete. Upon completion of the install, the restartable jobs will automatically resume, if configured to do so.
WARNING: When enabled, this option temporarily stops services, thereby suspending all running jobs including those that may not be restartable. Therefore, use caution if enabling this feature.
Click Schedule to schedule this operation or click OK to initiate this operation immediately. If you click Schedule:
- From the Schedule Details tab select the necessary schedule options.
- To view the job summary for the installation job that you have scheduled, click the Job Summary tab of the Schedule Details dialog box.
- Click OK to save the schedule.
Click OK from the Install Updates Job Options dialog box.

When installing/uninstalling updates, you might be prompted to reboot the system to complete the update install/uninstall process.

Initiate the Installation of Automatic Updates from a Client or MediaAgent Computer

Before You Begin

Do not run or schedule an automatic update job at the same time other jobs are running or are scheduled to run.
Do not run or schedule an automatic update job the same time an FTP download is running or is scheduled to run. Allow sufficient time for the FTP download job to finish before running or scheduling this job.
Suspend all jobs on the clients and MediaAgents that will be receiving updates in your CommCell.

Required Capability: Capabilities and Permitted Actions

To initiate the installation of updates from a client or MediaAgent computer:

From the CommCell Browser, right-click a client and then select All Tasks -> Install Updates, or right-click a MediaAgent, and then click Install Updates.
From the Install Updates Job Options dialog box, click Run Immediately or click Schedule to schedule this operation. If you click Schedule:
- From the Schedule Details tab select the necessary schedule options.
- To view the job summary for the update job that you have scheduled, click the Job Summary tab of the Schedule Details dialog box.
- Click OK to save the schedule.

Select Reboot Client if Required to have the system automatically reboot the client and/or MediaAgent computers if a reboot is required.

Select Continue with Install Updates even if jobs are running on the computer to allow updates to be installed on the selected client/MediaAgent as per schedule even if jobs are currently running. Services will be stopped, thereby suspending the running jobs to allow the install to complete. Upon completion of the install, the restartable jobs will automatically resume, if configured to do so.
WARNING: When enabled, this option temporarily stops services, thereby suspending all running jobs including those that may not be restartable. Therefore, use caution if enabling this feature.
Click OK from the Install Updates Job Options dialog box.

When installing/uninstalling updates, you might be prompted to reboot the system to complete the update install/uninstall process.

Initiate the Installation of Automatic Updates on a Cluster (CommServe on Virtual Node)

Before You Begin

Do not run or schedule an automatic update job at the same time other jobs are running or are scheduled to run.
Do not run or schedule an automatic update job the same time an FTP download is running or is scheduled to run. Allow sufficient time for the FTP download job to finish before running or scheduling this job.
Suspend all jobs on the clients and MediaAgents that will be receiving updates in your CommCell.

Required Capability: Capabilities and Permitted Actions

To initiate the installation of updates on a cluster with the CommServe installed on the virtual node:

From the CommCell Browser, right-click the CommServe icon, click All Tasks -> Install Updates.
From the Install Updates Job Options dialog box, select the name of the CommServe then move it from Available Clients list to the Selected Clients list.

Select Reboot Client if Required to have the system automatically reboot the the client and/or MediaAgent computers if a reboot is required.

Select Continue with Install Updates even if jobs are running on the computer to allow updates to be installed on the selected client/MediaAgent as per schedule even if jobs are currently running. Services will be stopped, thereby suspending the running jobs to allow the install to complete. Upon completion of the install, the restartable jobs will automatically resume, if configured to do so.
WARNING: When enabled, this option temporarily stops services, thereby suspending all running jobs including those that may not be restartable. Therefore, use caution if enabling this feature.
Click Schedule to schedule this operation or click OK to initiate this operation immediately. If you click Schedule:
- From the Schedule Details tab select the necessary schedule options.
- To view the job summary for the installation job that you have scheduled, click the Job Summary tab of the Schedule Details dialog box.
- Click OK to save the schedule.
Click OK from the Install Updates Job Options dialog box.
To install Automatic Updates on a passive node, fail over to the node and then repeat this procedure.

When installing/uninstalling updates, you might be prompted to reboot the system to complete the update install/uninstall process.

Initiate the Installation of Automatic Updates on a Cluster (No CommServe on Virtual Node)

Before You Begin

Do not run or schedule an automatic update job at the same time other jobs are running or are scheduled to run.
Do not run or schedule an automatic update job the same time an FTP download is running or is scheduled to run. Allow sufficient time for the FTP download job to finish before running or scheduling this job.
Suspend all jobs on the clients and MediaAgents that will be receiving updates in your CommCell.

Required Capability: Capabilities and Permitted Actions

To initiate the installation of updates on a cluster with no CommServe installed on the virtual node:

From the CommCell Browser, right-click a client and then select All Tasks -> Install Updates, or right-click a MediaAgent and then click Install Updates. For your first round of installs, be sure to start with the active node.
From the Install Updates Job Options dialog box, click Run Immediately or click Schedule to schedule this operation. If you click Schedule:
- From the Schedule Details tab select the necessary schedule options.
- To view the job summary for the update job that you have scheduled, click the Job Summary tab of the Schedule Details dialog box.
- Click OK to save the schedule.

Select Reboot Client if Required to have the system automatically reboot the client and/or MediaAgent computers if a reboot is required.

Select Continue with Install Updates even if jobs are running on the computer to allow updates to be installed on the selected client/MediaAgent as per schedule even if jobs are currently running. Services will be stopped, thereby suspending the running jobs to allow the install to complete. Upon completion of the install, the restartable jobs will automatically resume, if configured to do so.
WARNING: When enabled, this option temporarily stops services, thereby suspending all running jobs including those that may not be restartable. Therefore, use caution if enabling this feature.
Click OK from the Install Updates Job Options dialog box.
Repeat this procedure to install Automatic Updates on the passive node.

When installing/uninstalling updates, you might be prompted to reboot the system to complete the update install/uninstall process.

Configure a Client Computer Group for an Automatic Update Install

Before You Begin

Suspend all jobs on the clients and MediaAgents that will be receiving updates in your CommCell.

Required Capability: Capabilities and Permitted Actions

To configure a client computer group for an update install:

From the CommCell Browser, right-click the client computer group icon for which to install the updates, click All Tasks -> Install Updates.
From the Install Updates Job Options dialog box, select either All Clients on CommServe to install updates on all clients or move a client(s) from the Available Clients and Client Groups list to the Selected Clients and Client Groups list.
Click the Add Alert button to configure an alert for the update job. This is an optional step.

Select Reboot Client if Required to have the system automatically reboot the client and/or MediaAgent computers if a reboot is required.

Select Continue with Install Updates even if jobs are running on the computer to allow updates to be installed on the selected client/MediaAgent as per schedule even if jobs are currently running. Services will be stopped, thereby suspending the running jobs to allow the install to complete. Upon completion of the install, the restartable jobs will automatically resume, if configured to do so.
WARNING: When enabled, this option temporarily stops services, thereby suspending all running jobs including those that may not be restartable. Therefore, use caution if enabling this feature.
Click Schedule to schedule this operation or click OK to initiate this operation immediately. If you click Schedule:
- From the Schedule Details tab, select the necessary schedule options.
- To view the job summary for the installation job that you have scheduled, click the Job Summary tab of the Schedule Details dialog box.
- Click OK to save the schedule.
Click OK from the Install Updates Job Options dialog box.

Install a Windows or NetWare Service Pack using Automatic Updates

Before You Begin

SQL service should be running when utilizing this tool.

Required Capability: Capabilities and Permitted Actions

To install a Windows or NetWare Service Pack using Automatic Updates:

Insert the software installation disc containing the Windows or NetWare Service Pack into the disc drive on the CommServe computer.
From the Windows Explorer, navigate to the <software installation path>\Base directory and double-click CopyToCache.exe.
Enter the appropriate disc location and browse to the \Windows or \NetWare folder as appropriate. Click OK. Upon completion, you will be prompted with the following message: "Successfully copied updates."
Follows the steps in Initiate the Installation of Updates from the CommServe or Initiate the Installation of Updates from a Client or MediaAgent Computer.

When installing/uninstalling updates, you might be prompted to reboot the system to complete the update install/uninstall process.

Install a UNIX Service Pack using Automatic Updates

Before You Begin

SQL service should be running when utilizing this tool.

Required Capability: Capabilities and Permitted Actions

To install a UNIX Service Pack using Automatic Updates:

Insert the software installation disc containing the UNIX Service Pack into the disc drive on the CommServe computer.
Verify that the latest version of the Service Pack is installed on the CommServe computer.
From the Windows Explorer, navigate to the <software installation path>\Base directory and double-click CopyToCache.exe.
Enter the appropriate disc location, and click OK. Upon completion, you will be prompted with the following message: "Successfully copied updates."
Follows the steps in Initiate the Installation of Updates from the CommServe or Initiate the Installation of Updates from a Client or MediaAgent Computer.

When installing/uninstalling updates, you might be prompted to reboot the system to complete the update install/uninstall process.

Check for CommCell Console Updates

Required Capability: Capabilities and Permitted Actions

To check for CommCell Console Updates:

From CommCell Console, select the Help menu.
Click Check for Updates. If updates are available, you will be notified by a prompt indicating that an update is available and ready for install; if you opt to install the updates, they are applied immediately and visible upon the next login.
Click OK.