Arcserve® Backup Patch Manager For Windows: User Guide
Arcserve® Backup Patch Manager For Windows: User Guide
User Guide
r17
Contact Arcserve
The Arcserve Support team offers a rich set of resources for resolving your technical
issues and provides easy access to important product information.
https://www.arcserve.com/support
You can access other helpful resources appropriate for your Arcserve product.
Contents
Chapter 1: Understanding Arcserve Backup Patch Manager 7
Introduction ................................................................................................................................................................. 7
Arcserve Backup Patch Manager Components ............................................................................................................ 8
Patch Manager GUI ............................................................................................................................................... 9
Patch Manager Service.......................................................................................................................................... 9
Arcserve Backup Patch Manager Guidelines .............................................................................................................. 10
How Arcserve Backup Patch Manager Works ............................................................................................................ 11
Check for Available Patches ................................................................................................................................ 13
Download Patches............................................................................................................................................... 16
Install Patches ..................................................................................................................................................... 18
Import Patches .................................................................................................................................................... 20
Uninstall Patches ................................................................................................................................................. 20
Email Notifications .............................................................................................................................................. 21
Report Generation .............................................................................................................................................. 21
Contents 5
Manually Check for Available Patches ....................................................................................................................... 49
Manually Download a Patch....................................................................................................................................... 51
Manually Install a Patch ............................................................................................................................................. 54
Manually Uninstall a Patch ......................................................................................................................................... 57
Automatically Download and Install a Patch .............................................................................................................. 60
Glossary 75
Index 77
6 User Guide
Chapter 1: Understanding Arcserve Backup
Patch Manager
This section contains the following topics:
Introduction (see page 7)
Arcserve Backup Patch Manager Components (see page 8)
Arcserve Backup Patch Manager Guidelines (see page 10)
How Arcserve Backup Patch Manager Works (see page 11)
Introduction
A patch lets Arcserve deliver product improvements (published patches) to users.
Patches are used to deliver bug fixes, new hardware support, and performance and
security enhancements. (Service Pack releases are not delivered through Arcserve
Backup Patch Manager).
In the past, Arcserve Backup users needed to download and apply patches manually
when they were released. They also needed to access the Arcserve Support website
frequently to learn about the existence of a fix or a patch. Arcserve Backup Patch
Manager simplifies this process and provides a fast, easy, and reliable solution to
automatically keep your Arcserve Backup installations up-to-date with the latest patches
and updates. Arcserve Backup Patch Manager is your link between Arcserve and your
Arcserve Backup (and agents) running on Windows and should be installed on every
machine that has Arcserve Backup installed to get automatic updates.
■ The capability to generate reports to view the current state of Arcserve Backup
(patches installed) and also view a history of the patches that were downloaded,
installed, and uninstalled on a server. This comprehensive reporting allows you to
easily access reports to help understand the complete patch status on any machine.
■ The capability to display handy tool-tip references about specific patches (for
example: the patch download date, patch install date, patch type, and so on).
■ The capability to display "Alerts and Messages" in a quick and easy-to-see
information pane. These alerts and messages contain information such as the time
and date of the last check update, number of new patches, which patches are
classified as critical, security updates, device patches, and so on.
■ The capability to display the Readme of a patch published at the Arcserve Support
website. For more detailed description or additional information about a specific
patch, contact Arcserve Technical Support for online technical assistance.
■ The capability to display the Patch Manager Service status in the GUI.
■ The capability to configure the client and a staging server to connect to Arcserve
Support (either directly or through a proxy server).
■ The capability to use staging servers for data centers that have limited access to the
internet.
■ The capability for Arcserve Backup Patch Manager deployed as Staging Server to
refer to another Staging Server that is already existing.
■ The capability to use proxy servers.
■ The capability to manually uninstall a patch (if necessary).
■ The capability of the Arcserve Backup Patch Manager to update itself when
self-patches become available.
Note: Patches to the Arcserve Backup Patch Manager will not be displayed in the
Product drop down menu or the Patches Update pane. These self-patches are
always considered as critical patches and all actions (Check for Updates, Download,
and Install) will be performed automatically as scheduled.
8 User Guide
Arcserve Backup Patch Manager Components
10 User Guide
How Arcserve Backup Patch Manager Works
A Staging Server can be used as a temporary storage location for patch downloads
before they are installed into Arcserve Backup clients. You may not want to expose all
your production servers to internet to download patches from the Arcserve server. In
this case, you can first download patches to one local Staging Server and then allow
your other production servers to download the patches from that local Staging Server.
You can install the Arcserve Backup Patch Manager on a server that is exposed to
internet and download the patches to that server. You can then have Arcserve Backup
Patch Manager installed on your production servers where Arcserve Backup is installed
and point to this local Staging Server to download and install patches.
12 User Guide
How Arcserve Backup Patch Manager Works
When triggered, Arcserve Backup Patch Manager will contact Arcserve Support to check
a file that contains the available patch information. If it is determined that this available
patch information file has been modified since the last check, it will be downloaded
from the site for comparison. The available patch information is then compared to
another file containing the already downloaded patch information to determine which
available patches are new and have not been previously downloaded and successfully
installed.
■ If it is determined that the patch has not been previously downloaded, Arcserve
Backup Patch Manager will tag the patch as an available patch.
■ If it is determined that the patch has already been downloaded successfully with
the correct checksum value and file name, Arcserve Backup Patch Manager will
then verify the existence of the patch in the physical location.
– If the physical file does not exist and it is not installed, then the patch will be
tagged as an available patch.
– If the patch file exists in the patch repository (with the correct checksum,
digital signature, and file name), then the previous status (downloaded) will be
maintained.
– If the patch file exists, but the already downloaded patch information (file
name and checksum value) does not match the available patch information,
then that patch will be tagged as an available patch.
■ If configured, an email notification will be sent to inform you when new updates are
available.
If you have selected to initiate a check for available patches (instead of specifying a
scheduled check), the process for this task is as follows:
1. Select the product to check (Arcserve Backup).
2. Click the Check for Updates button for the selected product.
The available patch information is downloaded (if modified) from Arcserve Support
to either your client or to a staging server.
3. The available patch information is then compared to a locally residing file
containing the already downloaded patch information.
A listing of all the available Arcserve Backup patches for the selected product is
displayed.
4. If configured, an email notification is sent informing you when new Arcserve Backup
patches are available for downloading.
14 User Guide
How Arcserve Backup Patch Manager Works
If you have selected to schedule an automatic check for available patches (instead of
specifying a user-initiated check), the process for this task is as follows:
1. Based upon the configured time settings for automatic checks, Arcserve Backup
Patch Manager will trigger the Patch Scheduler to invoke the check for available
patches.
The available patch information is downloaded (if modified) from Arcserve Support
to either your client or to a staging server.
2. The available patch information is then compared with locally residing files
containing the already downloaded patch information and installed patch
information.
A listing of all the available Arcserve Backup patches for the selected product is
displayed.
3. If configured, an email notification is sent informing you when new Arcserve Backup
patches are available for downloading.
Download Patches
Arcserve Backup Patch Manager provides the capability to download available patches
and updates either directly from the Arcserve Support server (via HTTP) or from the
Staging Server configured locally which in turn connects to the Arcserve Support server.
This patch download function can be triggered by the user interface (GUI) or
automatically (for critical patches only) as specified by the Patch Scheduler.
Note: To obtain additional information about a specific Arcserve Backup patch listed in
the Patch Manager, contact Arcserve Technical Support.
When triggered, Arcserve Backup Patch Manager will contact Arcserve Support and
download the available patches (along with any available dependent patches) and place
them in a holding directory (on either the Staging Server or the Client) until directed to
proceed with the subsequent installation process. (The downloaded patches do not get
deleted after installation). In addition, Arcserve Backup Patch Manager will also update
the downloaded patch information report with the latest status.
If configured, an email notification will be sent to inform you that new patches have
been downloaded.
16 User Guide
How Arcserve Backup Patch Manager Works
Important! When you are specifying a scheduled day and time for automatic patch
downloads/installs, please make sure the schedule does not coincide or conflict with
other scheduled active Arcserve Backup jobs (backup, restore, scan, merge, tapecopy,
etc). The installation of some patches can cause the Arcserve Backup Services to be shut
down and possibly disrupt your job.
Note: Automatic patch download and installation is available for critical Arcserve
Backup patches only.
1. When triggered, downloads the new available patches (and any dependent
patches) either directly from the Arcserve Support site or through a proxy server (as
configured) to a holding directory.
The default location for the patch download folder is: X:\Program
Files\CA\SharedComponents\PatchesRoot.
Note: If the volume of the holding directory becomes full, a Disk Space not available
status will be displayed in the Errors tab informing you of this condition.
2. If configured, an email notification is sent informing you when new Arcserve Backup
patches have been downloaded.
3. Invokes the reporting task to generate an updated Patches Downloaded Report
with the latest status.
Install Patches
Arcserve Backup Patch Manager provides the capability to install the available and
successfully downloaded patches and updates. This install function can be triggered by
the user interface (GUI) or automatically (for critical patches only) as specified by the
internal Patch Scheduler. Patches for the Arcserve Backup Patch Manager will not be
displayed in the GUI. These self-patches are always considered critical patches and will
be automatically installed as scheduled.
Note: To obtain additional information about a specific Arcserve Backup patch listed in
the Patch Manager, contact Arcserve Technical Support.
When triggered, Arcserve Backup Patch Manager will first check if the specified patch
has any dependent patches that also need to be installed.
■ If all dependent patches have already been downloaded and installed, then the
installation process for the specified patch will continue. The patch will be installed
from the holding directory to the applicable Arcserve Backup component directory
of the corresponding client or staging server.
■ If the patch which is selected for install has any prerequisite patches that have not
been downloaded already, then the prerequisite patches will be downloaded first
and then the installation process will continue.
You cannot directly trigger the installation of the patches from a staging server to a
client. The patches will be downloaded to the client from the staging server, and then
the installation process will be triggered on the client.
18 User Guide
How Arcserve Backup Patch Manager Works
If configured, an email notification will be sent to inform you that new patches have
been installed. In addition, the Patches Installed Report will also be updated with the
latest status.
Note: Automatic patch download and installation is available for critical Arcserve
Backup patches only.
1. When triggered, installs successfully downloaded patches (along with any
dependent patches) either from your client or from a staging server.
2. If configured, an email notification is sent informing you that new Arcserve Backup
patches have been installed.
3. Invokes the reporting task to generate an updated Patches Installed Report with the
latest status.
Import Patches
Arcserve Backup Patch Manager provides the capability to import updated patch status
information for successfully installed patches. This function will import and update
patch information for Arcserve Backup patches into the file that contains the already
downloaded patch information. It will also import patch information for patches that
were not installed using Patch Manager. This Import Patch function will be triggered
automatically when the Patch Manager Service starts. On service start up, the Patch
Manager Service will send imported patch status information to the GUI and will be
displayed in the "Patch Updates" pane. If an imported patch is uninstalled, it will not be
displayed in the GUI because it is neither available nor downloaded.
Note: The patches which are manually installed or the patches whose installed status is
not returned to the Patch Manager Service will be imported.
Uninstall Patches
Arcserve Backup Patch Manager provides the capability to uninstall successfully
installed patches and updates for the product selected. This uninstall function can only
be triggered manually from the user interface (GUI), and not automatically scheduled.
When triggered, Arcserve Backup Patch Manager will first check if the specified patch
has any dependent patches that need to be uninstalled first. You can only uninstall a
patch that has no dependency to other installed patches.
■ If all dependent patches have already been uninstalled, then the uninstall process
will continue.
■ If a patch has dependency to another installed patch, an error message will be
displayed indicating that the dependency patch must first be uninstalled and the
uninstall process will not continue. Dependant patches are not force uninstalled.
The Patches Installed History Report will also be updated with the "Uninstalled" status.
If you have selected uninstall an installed patch, the process for this task is as follows:
1. When triggered, Arcserve Backup Patch Manager uninstalls the selected patch.
Note: If the selected patch is a prerequisite to any other patch (which is installed
already), the selected patch will not be uninstalled.
2. Invokes the reporting task to generate an updated Patches Installed Report.
20 User Guide
How Arcserve Backup Patch Manager Works
Email Notifications
Arcserve Backup Patch Manager provides the capability to send automatic email
notifications for the following events:
■ When a new patch is available
■ When a download of a patch has been completed
■ When an installation of a patch has been completed
Arcserve Backup Patch Manager will connect to an SMTP server (with appropriate
credentials) to enable sending these email notifications over the internet from Arcserve
to your server.
Note: By default, MX (Mail Exchange) will be used to deliver email notifications to users
on your domain if no service is specified.
Report Generation
Arcserve Backup Patch Manager provides the capability to generate reports for both the
current status and the history status. The reporting feature of Arcserve Backup Patch
Manager will help you track the updates and patches applied, as well as assist in
troubleshooting any problems that may occur.
22 User Guide
Chapter 2: Installing Arcserve Backup
Patch Manager
This section contains the following topics:
Installation Prerequisites (see page 23)
Install Arcserve Backup Patch Manager (see page 23)
Installation Options (see page 25)
Post Installation (see page 34)
Uninstall Arcserve Backup Patch Manager (see page 34)
Installation Prerequisites
Before installing Arcserve Backup Patch Manager, verify the following prerequisites:
■ Your local server can be used as a staging server. If Arcserve Backup Patch Manager
is installed locally as a staging server, you must also have Microsoft Internet
Information Services (IIS) 6.0 or later installed on your local server.
For the staging server, the IIS must also have the Default IIS Site available and
running.
■ For a client type installation, Arcserve Backup r12 SP2 or later components must be
previously installed on the client.
Remote Install
Allows you to install Arcserve Backup Patch Manager on remote computer(s).
Create a Response File
Allows you to create a response file which can be used to simplify the
installation process by storing various configuration and setup parameters for
the product being installed. After the response file is created you can perform a
silent install for similar installations on more than one computer.
By default, the response file (setup.icf) will be located at X:\Documents and
Settings\User Login ID\My Documents\Setup.icf. However you can use the
Browse button to specify a different location for the response file.
4. When the installation is complete, the product service will be registered with the
Windows Service Control Manager (SCM) as "Arcserve Backup Patch Manager".
Note: The first time Arcserve Backup Patch Manager is installed it automatically imports
the information about only published patches that were previously installed.
Local Install
The Local Install option allows you to install Arcserve Backup Patch Manager on your
local computer. As part of the local installation process, you will be prompted to specify
the following options:
■ Select the Server Option
■ Select the Update Option
■ Select the Email Notification Option
■ Select the Proxy Option
Remote Install
The Remote Install option allows you to install Arcserve Backup Patch Manager on your
remote computer(s). As part of the remote installation process, you will be prompted to
specify the following options:
■ Select Computer(s) for Remote Installation
■ Select the Server Option
■ Select the Update Option
■ Select the Email Notification Option
■ Select the Proxy Option
24 User Guide
Installation Options
To edit or change the values stored in an existing response file, you must relaunch
Arcserve Backup Patch Manager setup using the Create a Response File option and
select the new values to overwrite the previously created response file.
After the Arcserve Backup Patch Manager response file (setup.icf) is created, it will then
be used during a silent installation. Silent installation allows for unattended installation
based on the configuration values that were provided at the time that a silent
installation response file was created. However, a silent installation will not prompt you
for any input, but instead at run time will read the necessary information from the
created response file (setup.icf). Silent installations are used when there are similar
installations to be performed on more than one computer.
To launch the silent installation, you must run the following command:
>mastersetup.exe /I:"<path for the setup.icf response file>"
As part of the create a response file installation process, you will be prompted to specify
the following options:
■ Select the Server Option
■ Select the Update Option
■ Select the Email Notification Option
■ Select the Proxy Option
Installation Options
During the installation process, various wizard screens will be displayed requesting you
to specify some options. Depending upon the type of installation being performed,
different option screens will be displayed.
For both the Client and Staging Server options, the default download path for patches is
"X:\Program Files\CA\SharedComponents\PatchesRoot". After patches are downloaded,
you should be able to find the patches in this folder if there were any available for your
machine. You can click the Browse button to change the location for the "PatchesRoot"
folder. If you change the default download path, a new subfolder "PatchesRoot" will be
created automatically for the downloaded patches.
For example, if you change the default path to "c:\myPatches", the patches will be
downloaded to the "c:\myPatches\capm" folder.
26 User Guide
Installation Options
Client
Specifies that your local server will be used as a client and Arcserve Backup Patch
Manager will be installed directly on the client. Arcserve Backup Patch Manager can
be installed on one or more machines or servers and will communicate with either a
staging server or with the Arcserve Support server.
As a prerequisite for a Client install, Arcserve Backup Patch Manager must be
installed on a machine that already has Arcserve Backup installed.
■ If it is detected that Arcserve Backup r12 SP2 or later is already installed on
your client, this option will be available.
■ If it is detected that Arcserve Backup r12 SP2 or later is not already installed on
your client, this option will be disabled.
When you select the Client option, you can then specify the Arcserve Support
server name where the patches will be downloaded from.
■ If you select the Arcserve Server (default option), the patches will be
downloaded from the Arcserve Support server location.
■ If you select the Staging server location, you must also specify the host name or
IP address for the staging server.
Note: You cannot specify your same local host machine as this staging server. If
you attempt to use your local host machine as the staging server it will be an
invalid configuration because the staging server cannot connect to itself to get
and download the available patches from.
The patches will be downloaded from the Arcserve website to the specified
staging server location. After the patches are downloaded to the staging server,
you can then download the patches from the staging server to the client.
Staging Server
Specifies that your local server will be used as a staging server and Arcserve Backup
Patch Manager will be installed directly on the staging server.
As a prerequisite for a Staging server install, Arcserve Backup Patch Manager must
be installed on a machine that already has Microsoft Internet Information Services
(IIS) 6.0 or later installed
■ If it is detected that Microsoft Internet Information Services (IIS) 6.0 or later is
already installed on your staging server, this option will be available.
Note: For a staging server, the IIS must also have the Default IIS Site available
and running (with the "Allow anonymous connections" security option property
selected).
■ If it is detected that Microsoft Internet Information Services (IIS) 6.0 or later is
not already installed on your staging server, this option will be disabled.
The HTTP location directory (http://localhost/capm) will automatically be created
on your staging server and all patches will be downloaded to the "capm" folder in
this directory.
28 User Guide
Installation Options
Note: Automatic patch download and installation is available for critical Arcserve
Backup patches only.
You can select multiple options. You will also need to include an email address (or
multiple email addresses) with or without an SMTP address. To enter multiple email
addresses, each address must be separated by a semi-colon character.
30 User Guide
Installation Options
32 User Guide
Installation Options
When you specify a computer for remote installation, a Logon Information dialog
appears, requesting you to provide remote access authentication (user name and
password).
Post Installation
When the installation process is completed, the following conditions will exist:
■ Arcserve Backup Patch Manager will be created under the "Currently installed
programs" list in the Add or Remove Programs tool. If necessary, Arcserve Backup
Patch Manager can be uninstalled using the standard Add or Remove Programs
feature.
■ A program shortcut (Patch Manager) will be automatically created under the
Start/Arcserve/Arcserve Backup Patch Manager directory to allow you to manually
launch the Arcserve Backup Patch Manager to perform checks for available patches,
patch downloads, and patch installations as necessary.
■ For a staging server type deployment, a staging server website will be created
(http://localhost/capm) to host the available patches.
■ If a response file was created, the specified installation parameters will be stored in
the "setup.icf" file and will be used during a silent installation by running the
following command:
>mastersetup.exe /I:"<path for setup.icf response file>"
■ After installation, an entry in the registry will be created for Arcserve Backup Patch
Manager.
■ The Arcserve Backup Patch Manager Service will be created at the end of the
successful installation.
■ Only published patches that were installed prior to installation of Arcserve Backup
Patch Manager will be imported and displayed in the Patch Updates pane.
■ The folder structure for Arcserve Backup Patch Manager is as follows:
X:\Program Files\CA\SharedComponents\APM\PatchManager
Note: After Arcserve Backup Patch Manager is uninstalled, the patch status and patch
history files will remain in the APM folder. However, these files will be removed when
Arcserve Backup itself is uninstalled completely.
34 User Guide
Chapter 3: Using Arcserve Backup Patch
Manager with GUI
This section contains the following topics:
Understanding the Arcserve Backup Patch Manager GUI (see page 36)
Understanding the Preferences Dialog (see page 42)
Manually Check for Available Patches (see page 49)
Manually Download a Patch (see page 51)
Manually Install a Patch (see page 54)
Manually Uninstall a Patch (see page 57)
Automatically Download and Install a Patch (see page 60)
Note: Patches to the Arcserve Backup Patch Manager will not be displayed in the
Product drop down menu or the Patches Update pane. These self-patches are always
considered as critical patches and all actions (Check for Updates, Download, and Install)
will be performed automatically as scheduled.
Settings Menu
Allows you to access the Preferences dialog and specify Arcserve Backup Patch
Manager configuration settings for this individual job. The settings that you specify
in this Preferences dialog will override any settings previously specified either from
the installation wizard or by default.
For more information about the Preferences dialog, see Understanding the
Preferences Dialog (see page 42).
36 User Guide
Understanding the Arcserve Backup Patch Manager GUI
Reports Menu
Allows you to manually select and display patch status reports. From the Reports
menu you can specify to display patches that were installed (current or history) and
patches that were downloaded.
■ The Installed patch Current report will display all published patches and test
fixes that are currently installed on your local server.
■ The Installed patch History report will display all published patches and test
fixes that are currently installed on your local server, plus the history of any
patches that have been uninstalled.
■ The Downloaded patch report will display all patches that have been
downloaded to date.
Help Menu
Allows you to access the Arcserve Backup Patch Manager Help system.
Product Drop-Down Menu
Allows you to select which version of Arcserve Backup that you want to obtain
patch information for.
■ If Arcserve Backup Patch Manager is installed as a Staging Server, this
drop-down menu will display all supported products/releases.
38 User Guide
Understanding the Arcserve Backup Patch Manager GUI
If the patch number is displayed in blue text, it indicates that it is a link connection
to corresponding patch readme in the Arcserve Support Connect web site to obtain
more information. If there is no link connection available, the patch number will be
displayed in black text.
Note: Multiple patches can be selected for download or install by using the "CTRL"
or "SHIFT" key combinations. However, multiple patch selections will only function
if all selected patches have the same status (Available, Downloaded, or Installed).
Multiple downloads /installs will be performed sequentially (based upon
prerequisite patches), and not concurrently.
Errors Information Pane
When the Errors tab is selected, displays patch error information for the
corresponding selected patch.
Note: You can double click on a displayed patch to open a pop up window with
detailed information of the problem.
You can double click on a displayed patch to open a pop up Error Details window
with more detailed information of the problem.
■ If Arcserve Backup Patch Manager is installed as a Client, this pane will display
alerts and messages only for the product/release that is currently installed on
that machine.
This pane will also display imported patch information and self-updated status (i.e.
the updated status of the Arcserve Backup Patch Manager).
Note: For Arcserve Backup Patch Manager, the update information will be displayed
in the Alerts and Messages pane if any patch for the Arcserve Backup Patch
Manager is installed.
40 User Guide
Understanding the Arcserve Backup Patch Manager GUI
Patch Icons
The patches and messages listed in each pane will have icons reflecting the patch
type.
Uninstall Button
Allows you to initiate a manual uninstall of the selected patch. This Uninstall button
is only enabled when the status of the selected patch is Installed.
When triggered, Arcserve Backup Patch Manager will first check if the selected
patch has any dependent patches that need to be uninstalled first. You can only
uninstall a patch that has no dependency to other installed patches. When the
patch uninstall is complete, the status is changed to Downloaded.
The Uninstall button is only enabled when you select an "Installed" patch.
Status Indicator
Displays the current status of the action performed and the status of the Patch
Manager Service (Ready, Stopped, or Busy).
■ Ready - Patch Manager Service is running and ready to process the new
request.
■ Stopped - Patch Manager Service is stopped.
■ Busy - Patch Manager Service is busy processing a request, either manually
(from the GUI) or automatically (from the scheduler).
The Preferences dialog is accessed from Settings drop-down menu of the Arcserve
Backup Patch Manager GUI. The Preferences dialog is a three-pane dialog with tab
settings for General Settings, Email Settings, and Proxy Settings.
42 User Guide
Understanding the Preferences Dialog
Arcserve Server
Specifies the HTTP location directory on the Arcserve Support server. Arcserve
Backup Patch Manager will automatically connect to a pre-configured HTTP server
to download the new available patches either to the Staging Server or to the Client.
Note: Arcserve Backup Patch Manager only supports HTTP communication.
Staging Server
Specifies the HTTP location address for the server that will be used as a staging
server.
If you select this option, you must also specify the location (IP address or host
server name) for the staging server. All patch information and downloads will be
sent from this staging server to the client.
Note: You cannot specify your same local host machine as this staging server. If you
attempt to use your local host machine as the staging server it will be an invalid
configuration because the staging server cannot connect to itself to get and
download the available patches from.
Note: If a Staging Server cannot be configured, then you can directly attach to the
Arcserve Support site.
44 User Guide
Understanding the Preferences Dialog
OK Button
Saves settings specified on all three tabs and closes the Preferences dialog.
Reset Button
Resets any unapplied (not saved) settings on the corresponding Preferences dialog
tab. This button is only enabled when changes have been made to any of the
settings and not applied (saved).
Cancel Button
Cancels and resets all unapplied (not saved) settings on all three tabs and closes the
Preferences dialog.
Apply Button
Applies (saves) settings specified on the corresponding Preferences dialog tab.
When this button is clicked, the Reset button (and the Apply button) will be
disabled until a setting has been changed and not yet applied (saved).
You can select multiple options. You will also need to include an email address (or
multiple email addresses) with or without an SMTP address. To enter multiple email
addresses, each address must be separated by a semi-colon character.
46 User Guide
Understanding the Preferences Dialog
SMTP Server
Specifies the SMTP server address used for sending email notifications from
Arcserve to your server. If you select the "My SMTP Server requires Authentication"
option, you must also enter the authentication information (User ID and Password)
required to use the SMTP server.
By default, MX (Mail Exchange) will be used to deliver email notifications to users
on your domain if no service is specified.
Note: An MX record is a type of resource record in the Domain Name System (DNS)
that is used to specify how internet email should be routed and delivered by the
mail exchange server to the users within your domain using the Simple Mail
Transfer Protocol (SMTP).
48 User Guide
Manually Check for Available Patches
2. Click Check for Updates to manually initiate a check for available patches that are
not already listed.
Arcserve Backup Patch Manager will contact the Arcserve Support site and perform
a comparison check of all available Arcserve Backup patches to determine which
available patches are new and have not been previously downloaded.
Note: To obtain additional information about a specific Arcserve Backup patch
listed in the Patch Manager, contact Arcserve Technical Support.
■ If it is determined that the patch has not been previously downloaded,
Arcserve Backup Patch Manager will tag the patch as an Available patch.
■ If it is determined that the patch has already been downloaded successfully,
Arcserve Backup Patch Manager will then verify the existence of the patch in
the physical location.
– If the physical file does not exist and it is not installed, then the patch will
be tagged as a new or available patch.
– If the patch file exists in the physical location (with the correct checksum
and file name), then it will be tagged as an already Downloaded patch.
– If the patch file exists, but the file name and checksum value of the patch
does not match same file, then that patch will be tagged as an Available
patch.
50 User Guide
Manually Download a Patch
Download a Patch
1. Launch the Arcserve Backup Patch Manager GUI (Programs/APM/Arcserve Backup
Patch Manager/Patch Manager).
The Arcserve Backup Patch Manager GUI is displayed listing all patches that are
available for downloading. The Patch Updates pane displays the Patch ID,
Description, Date, Size (in KB), and Status of all listed patches.
Note: To obtain additional information about a specific Arcserve Backup patch
listed in the Patch Manager, contact Arcserve Technical Support.
2. Select the patch that you want to download and click Download.
Note: Multiple patches can be selected for download or install by using the "CTRL"
or "SHIFT" key combinations. However, multiple patch selections will only function
if all selected patches have the same status (Available, Downloaded, or Installed).
Multiple downloads /installs will be performed sequentially (based upon
prerequisite patches), and not concurrently.
Arcserve Backup Patch Manager will first check if the selected patch has any
dependent patches that also need to be downloaded. The purpose of the
dependency check at download time is to make sure that all dependant patches if
available are downloaded or already installed. (Arcserve Backup Patch Manager will
automatically select all dependant patches and download them if a patch is
selected for download, even though the dependant patches for it are not selected)
The Dependencies screen appears, listing the patch selected for download and any
dependent patches for the selected patch.
52 User Guide
Manually Download a Patch
Install a Patch
1. Launch the Arcserve Backup Patch Manager GUI (Programs/Arcserve/Arcserve
Backup Patch Manager/Patch Manager).
The Arcserve Backup Patch Manager GUI is displayed listing all Downloaded patches
that are available for install. The Patch Updates pane displays the Patch ID,
Description, Date, Size (in KB), and Status of all listed patches.
Note: To obtain additional information about a specific Arcserve Backup patch
listed in the Patch Manager, contact Arcserve Technical Support.
2. Select the patch that you want to install and click Install.
Note: Multiple patches can be selected for download or install by using the "CTRL"
or "SHIFT" key combinations. However, multiple patch selections will only function
if all selected patches have the same status (Available, Downloaded, or Installed).
Multiple downloads /installs will be performed sequentially (based upon
prerequisite patches), and not concurrently.
Arcserve Backup Patch Manager will first check if the selected patch has any
dependent patches that also need to be installed. The purpose of the dependency
check at patch install time is to make sure that the dependant patches if available
are installed or already downloaded successfully.
54 User Guide
Manually Install a Patch
The Dependencies screen appears, listing the patch selected for install and any
dependent patches for the selected patch.
■ If all dependent patches have already been downloaded and installed, then the
install process for the selected patch will continue.
■ If any dependent patch has not been downloaded already, an error message
will be displayed to indicate that dependency patch is required and the install
process will not continue.
56 User Guide
Manually Uninstall a Patch
Uninstall a Patch
1. Launch the Arcserve Backup Patch Manager GUI (Programs/Arcserve/Arcserve
Backup Patch Manager/Patch Manager).
The Arcserve Backup Patch Manager GUI is displayed listing all Installed patches
that are available for uninstallation.
2. Select the patch that you want to uninstall and click Uninstall.
Arcserve Backup Patch Manager will first check if the selected patch has any
dependent patches that also need to be uninstalled.
The Dependencies screen appears, listing the patch selected for uninstallation and
any dependent patches for the selected patch.
■ If all dependent patches have already been uninstalled, then the uninstallation
process for the selected patch will continue.
■ If any dependent patch has not been uninstalled already, an error message will
be displayed to indicate that dependency patch is still installed and the
uninstallation process will not continue.
58 User Guide
Manually Uninstall a Patch
Note: Automatic patch download and installation is available for critical Arcserve
Backup patches only.
Note: All patches for Arcserve Backup Patch Manager are considered critical.
The process for Arcserve Backup Patch Manager to automatically perform these tasks is
the same as for manually performing them, except all tasks will be triggered at
pre-configured days and times. The configuring of these automatic functions can be
specified during the Arcserve Backup Patch Manager installation process, or through the
Preferences dialog after Arcserve Backup Patch Manager installation. For more
information about the Preferences dialog, see Understanding the Preferences Dialog
(see page 42).
However, during the automatic patch download and install process, if a patch is for a
Arcserve Backup agent and the agent is not installed on the target machine, an install
error will occur. For example, if Arcserve Backup Patch Manager is set to automatically
download and install patches and a new Agent for Oracle patch becomes available in the
Arcserve Support site, then Arcserve Backup Patch Manager will try to automatically
download and install the Oracle patch on the target machines. It will report an error
about an install failure if the Oracle-related components are not installed on that target
machine.
If you have the Arcserve Backup Patch Manager configured to automatically download
and install patches, you will be prompted when a new patch becomes available to select
whether to Continue or Postpone to the next schedule. If you do not respond within five
minutes, the job will continue.
60 User Guide
Automatically Download and Install a Patch
If configured, an email notification will be sent informing you when the automatic patch
download and installation has been completed.
If a patch install requires a reboot to take effect, the following will occur:
■ If email notification is enabled, you will be informed of this condition in the email.
You will then need to manually reboot the machine after patch installation for the
patch to take effect.
■ If email notification is not enabled, you will need to check the status of the patch in
the APMLog.log. If a reboot is required, a message stating this patch requires
rebooting the machine will be included in the log. You will then need to manually
reboot the machine after patch installation for the patch to take effect.
64 User Guide
Patch Manager Troubleshooting
Network Errors
See Troubleshooting Network Errors (see page 63).
Service Errors
See Troubleshooting Service Errors (see page 63).
Configuration Errors
See Troubleshooting Configuration Errors (see page 64).
Network Errors
See Troubleshooting Network Errors (see page 63).
Service Errors
See Troubleshooting Service Errors (see page 63).
Configuration Errors
See Troubleshooting Configuration Errors (see page 64).
Service Errors
See Troubleshooting Service Errors (see page 63).
Patch install fails when automatically download and install option is selected
With the option to automatically download and install patches selected, Arcserve
Backup Patch Manager will attempt to install all downloaded patches. If one or more
patches are meant for specific components and those components are not installed on
the system, the patch installation will fail and return a failure status.
Important! When you are specifying a scheduled day and time for automatic patch
downloads/installs, please make sure the schedule does not coincide or conflict with
other scheduled active Arcserve Backup jobs (backup, restore, scan, merge, tapecopy,
etc). The installation of some patches can cause the Arcserve Backup Services to be shut
down and possibly disrupt your job.
■ Verify that scheduled Arcserve Backup jobs do not conflict with the Arcserve Backup
Patch Manager schedule for automatic installs. Arcserve Backup Patch Manager will
not check if there are any active jobs or other Arcserve Backup operations running
at the time of the automatic schedule to download and install patches.
■ If the problem persists, contact Arcserve support for online technical assistance and
a complete list of locations, primary service hours, and telephone numbers.
66 User Guide
Patch Manager Troubleshooting
The selected patch has not been uploaded to the Arcserve Support server. Arcserve
Backup Patch Manager checks to ensure that the patches received are authentic. If the
check fails for a particular patch, the modules are deleted and the download fails with
the problem cause reporting that an invalid signature was detected.
Do not know if Arcserve Backup Patch Manager is installed as a Staging Server or as a Client
From the Arcserve Backup Patch Manager GUI, access the Help menu and select About.
If you find a message that says "This is a Staging Server" then Arcserve Backup Patch
Manager is installed as a Staging Server. If this message is not there, it automatically
indicates that this is a Client.
Do not know if Arcserve Backup Patch Manager performed an auto update of itself
From the Arcserve Backup Patch Manager GUI, access the Help menu and select About.
You can verify the currently installed build number to determine if Arcserve Backup
Patch Manager has been updated.
If you installed patches manually and then installed Arcserve Backup Patch Manager, all
previously installed published patches will be listed in the Patch Manager GUI.
If during the Arcserve Backup Patch Manager upgrade your configuration settings were
not restored, you can manually copy (restore) the APMsettings.INI and PU.dat files back
to their original location as follows:
1. Copy the APMsettings.INI and PU.dat files from the following location:
"ProgramFiles\CA\SharedComponents\PatchesRoot\capmconfig.F86757112A4542d
aB576BC34469DBDD1"
2. Restore these copied APMsettings.INI and PU.dat files to the following location:
"ProgramFiles\CA\SharedComponents\PatchesRoot\PatchManager"
Note: For a 64-bit machine, "ProgramFiles" is replaced with "Program Files (x86)".
68 User Guide
Patch Manager Troubleshooting
If during the Arcserve Backup Patch Manager upgrade your patch information was not
restored, you can manually copy (restore) this patch information back to the original
location as follows:
1. Copy the AlreadyDownloadedPatchInfo.xml file from the following location:
"ProgramFiles\CA\SharedComponents\PatchesRoot\capmconfig.F86757112A4542d
aB576BC34469DBDD1"
2. Restore this copied AlreadyDownloadedPatchInfo.xml file to the following location:
"ProgramFiles\CA\SharedComponents\PatchesRoot\PatchManager\CA ARCserve
Backup"
3. Rename the folder "capm.F86757112A4542daB576BC34469DBDD1" to "capm"
located in the same path which is resolved from the following registry key:
"HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\CA ARCserve Backup
Patch Manager\PATCHESROOT"
For example: If the registry key value of
"HKEY_LOCAL_MACHINE\SOFTWARE\ComputerAssociates\CA ARCserve Backup
Patch Manager\PATCHESROOT" is C:\Program
Files\CA\SharedComponents\PatchesRoot, then rename the folder from
"C:\Program
Files\CA\SharedComponents\capm.F86757112A4542daB576BC34469DBDD1" to
"C:\Program Files\CA\SharedComponents\PatchesRoot"
Note: For a 64-bit machine, "ProgramFiles" is replaced with "Program Files (x86)".
Troubleshooting Overview
When a problem is detected, Arcserve Backup Patch Manager generates a message to
help you identify the problem and resolve the problem. These messages are contained
in the Patch Manager Activity Log (APMLog.log) or the Patch Manager UI Log
(CAPMUILog.log), which can be viewed at X:Program
Files\CA\SharedComponents\APM\Patch Manager.
When an incorrect action is attempted, Arcserve Backup Patch Manager will generally
display a pop-up message to help you identify and quickly resolve the problem.
In addition, from the Errors pane on the Arcserve Backup Patch Manager GUI, you can
also view any related errors for the corresponding patch.
70 User Guide
Pre-requisites to download patches from Patch Manager
New Code:
<pathonsource>/PatchesRoot/arcserve/</pathonsource>
b. For product "Arcserve Backup Patch Manager", replace the path in the
pathonsource tag.
Existing Code:
<pathonsource>/capm/PatchesRoot/patchmanager/</pathonsource>
New Code:
<pathonsource>/PatchesRoot/patchmanager/</pathonsource>
New Code:
<Server Name>downloads.arcserve.com</Server Name>
New Code:
<source>downloads.arcserve.com</source>
72 User Guide
Pre-requisites to download patches from Patch Manager
Replace Commandbase.dll file on all the Patch Manager Clients and Staging Server
Follow the steps below after editing the APMClient.xml file.
1. Click on the following link to download the new CommandBase.dll file.
http://arcserve.vo.llnwd.net/v1/PatchesRoot/arcserve/PatchManager.zip
https://arcserve.zendesk.com/hc/en-us/articles/204909389
2. Extract PatchManager.zip and navigate to the folder of the version of the Arcserve
Backup that you are using on your computer.
3. Rename CommandBase.dll.USA to CommandBase.dll from the appropriate folder of
Arcserve version you are running.
4. Stop the "Arcserve Backup Patch Manager" service from Windows Services.
5. Replace the old CommandBase.dll file with the new CommandBase.dll file that you
have renamed in Step 3 in the folder,
“%ProgramFiles(x86)%\CA\SharedComponents\APM\Patch Manager” (64-bit
machines) or “%ProgramFiles%\CA\SharedComponents\APM\Patch Manager"
(32-bit machines).
6. Restart the "Arcserve Backup Patch Manager" service.
Client
A Client is one that is deployed on one or more machines/servers and will communicate
either to a specified staging server or to the Arcserve server.
Critical Patch
A Critical Patch is a fix for high-impact or wide-spread problems. A Critical Patch is a
software correction that is critical to the operation of the product in most
environments. It is identical to Hyper-Patch in most cases.
Cumulative Patch
A Cumulative Patch is a means for delivering a group of individual patches that affect
multiple product elements or components that are integrated and published into one
patch and then applied to an existing environment. Cumulative Patches are included in
and superseded by the next applicable Cumulative Patch or Service Pack.
Device Patch
A Device Patch is a fix that is released to support new devices used with Arcserve
Backup.
Easy Update
Easy Update is the configuration section in the Patch Manager that allows you to
automate the patch download and install process for all critical patches published by
Arcserve.
Individual Patch
An Individual Patch is a fix for a confirmed problem and addresses only the product
defect that was addressed in the original confirmed test patch. Individual Patches are
included in and superseded by the next applicable Cumulative Patch or Service Pack.
Patch
A patch is a small set of files created to fix or enhance the functionality or security of a
product.
Glossary 75
Prerequisite Patch
A Prerequisite Patch is a fix which needs to be applied before another patch can be
applied. For example, if Patch A is a Prerequisite Patch for Patch B, then Patch A must be
installed before you can install Patch B.
Published Patch
A Published Patch (or published fix) is a classification for a patch that has been
confirmed to correct a reported product defect or problem and is generally available to
all users. Only Published Patches (not Test Fixes) are displayed in the Patch Updates
pane. Published Patches can be downloaded from the Arcserve Technical Support.
Security Patch
A Security Patch is a fix that resolves a critical security vulnerability issue reported for a
product.
Service Pack
A Service Pack is a means for delivering a product maintenance update and consists of
an accumulation of patches from the last official product release to a more recent point
in time. A Service Pack supersedes all previously issued patches and Service Packs.
Staging Server
A Staging Server is used as a temporary storage location for patch downloads before
they are installed into Arcserve Backup clients. A Staging Server provides you with the
ability to configure a server that can connect to the Arcserve server to download
patches locally. All other machines/servers that do not have access to the internet or do
not want to connect directly to the Arcserve server can connect to the locally configured
staging server to download patches. The staging server is a local repository for all Clients
that require patches and provides Clients with the ability to get patches quickly and
safely by attaching to a locally configured server.
Superseded Patch
A Superseded Patch is a fix which replaces another patch with a newer version.
Test Patch
A Test Patch (or test fix) is a classification for a patch that has been confirmed to correct
a reported product defect or problem. The distribution from Arcserve Technical Support
is limited to the users who reported the problem and is not generally available to all
existing users. Test Patches are not displayed on the Patch Updates pane of the Patch
Manager GUI. If necessary, contact Arcserve Technical Support to obtain a Test Patch.
76 User Guide
Index
A install patches
automatic install • 60
automatically download a patch • 60 overview • 18
automatically install a patch • 60 introduction • 7
C L
check for available patches local install • 24
overview • 13
scheduled process • 15 P
user-initiated process • 14
Patch Manager components
components
Patch Management Services • 9
Patch Manager Services • 9
Patch Manager Services • 9
D Patch Scheduler • 9
post install • 34
download patches Preferences dialog
automatic download • 60 Email Settings • 46
overview • 16 overview • 42
Proxy Settings • 47
E Proxy Settings • 47
Email Settings • 46
R
G remote install • 24
guidelines • 10 response file • 25
H S
how Patch Manager works silent install • 25
check for available patches • 13
download patches • 16 U
import patches • 20 uninstall Patch Manager • 34
install patches • 18 uninstall patches
overview • 11 overview • 20
uninstall patches • 20
I
import patches • 20
install Patch Manager
local install • 24
options • 25
post install • 34
prerequisites • 23
procedure • 23
remote install • 24
silent install • 25
uninstall • 34
Index 77