Remote Installs - MSI Packages Using SMS - File Share Archiver Client

A DataArchiver remote install requires that you use either SMS or Active Directory to remote the installation out to remote clients. For Active Directory, see Remote Installs - MSI Packages Using Active Directory Group Policies for the step-by-step procedure. For SMS, you will need to set up a batch file that contains the install command string for the component and any desired override property parameters. Remote installs using SMS are run in silent mode, which requires you to specify the install options ahead of time by selecting the default or override property parameters and including them in the batch file. See Rules and Parameters for more information.

For SMS, once you have set up the batch file, it can be run as a scheduled task on remote machines. This procedure will show you how to set up the batch file for silent remote installs using SMS.

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements - File Archiver for Windows.

The following procedure describes the steps involved in installing the File Share Archiver Client. If you choose to install multiple components simultaneously, refer to the appropriate procedures for installation requirements and steps specific to the component.

In order to use the File Share Archiver Client component, you must install the File Archiver for Windows Agent. See Deployment - File Archiver for Windows Agent for procedures on installing the File Archiver for Windows Agent. Do not install the File Share Archiver Client and the File Archiver for Windows Agent on the same computer.

Review the following Install Requirements before installing the software:

General

• This version of the software is intended to be installed in a CommCell where the CommServe and MediaAgent(s) version is 8.0.0.
• Close all applications and disable any programs that run automatically, including anti-virus, screen savers and operating system utilities. Some of the programs, including many anti-virus programs, may be running as a service. Stop and disable such services before you begin. You can re-enable them after the installation.
• 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.

Remote Install

Rules and Parameters

Before setting up a batch file to be remote installed through SMS, review the rules and parameters listed below to specify the installation options:

Rules:

• The syntax is PROPERTY="value".
• The property names must consist of all uppercase letters.
• The value part of the PROPERTY="value" pair is not case sensitive and should always be enclosed in double quotes.
• The PROPERTY="value" pairs should not have any white space characters (spaces, tabs) on either side of the "=" character.
• The PROPERTY="value" pairs should be placed at the end of the command line.
• If more than one PROPERTY="value" pair is specified, each PROPERTY="value" pair should be separated by at least one space or tab character.

Override Property Parameters:

• DESTINATION_PATH

  Overrides the default value used for the installation folder, which is <local path>\Program Files\<default software installation path>. Where <local_path> is set by Windows Installer to the path or drive letter containing the Program Files folder. Set this property to either a fully qualified directory or UNC path.

Uninstalling Previous Versions

• If you have a previous version of the File Share Archiver Client installed on the computer, then you have the option of either, first uninstalling the existing version before installing the newer version, or install the new version as an upgrade over the existing version. To uninstall the File Share Archiver Client set up a batch file that contains the following uninstall command and then run it as a scheduled task on remote clients:

  msiexec.exe /x {ProductCode GUID} /qn /L*v "%TEMP%\NetworkStorage_DM_Client_Uninstall.log"

  Replace {ProductCode GUID} with one of the following appropriate ProductCode GUIDs.

  Version 6.1.0 {8D896DFD-421A-4A99-B2B4-9289A3955727}

  Please contact your software vendor for ProductCode GUIDs for versions later than those listed above.

  Note that the /L*v "%TEMP%\NetworkStorage_DM_Client_Uninstall.log" portion of the above command line is optional and is only used for generating a detailed log file of the uninstallation process.

  In the event that the uninstallation process does not complete successfully, add the following to the end of the above command, to bypass QUninstaller.exe, which may leave unused registry entries under "HKEY_LOCAL_MACHINE\SOFTWARE\CommVault Systems\...":

  EXECUTEQUNINSTALLER="FALSE"

  WARNING: The above command line will permanently delete the following system driver files: (Windows System32 Folder)\Drivers\GXHSMNTAP.sys on Windows 2000 (Windows System32 Folder)\Drivers\GXHSMXPNTAP.sys on Windows XP If you include EXECUTEQUNINSTALLER="FALSE" on the command line, you must manually remove any registry entries that reference these system driver files before rebooting your computer. Failure to remove any registry entries that reference these system driver files before rebooting, may prevent your computer's operating system from restarting successfully.

• Log on to a workstation, as local Administrator or as a member of the Administrators group, that is connected to the clients to be remote installed.

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.
• You can override the stub file port number by using the EVMGRC_REMOTE_PORT_OVERRIDE registry key.  Use this key when the port number changes. Keep in mind that using this key defeats the benefit of being able to recall data using different port numbers for multiple Agents.

Remote Install

• After installing the File Share Archiver Client, if you set up your install batch file to generate a log of the installation process, you may want to review the log now to make sure that the installs completed successfully.