Decoupled Install - Windows

The following sections describe the steps involved in installing the components using the Decoupled Installation package:

  1. Create Decoupled Installation Package

  2. Install Using the Decoupled Installation Package

  3. Register the Client Computer

  4. Restart the Services

Create Decoupled Installation Package

Use the following steps to create the Decoupled install package

  1. Log on to the client computer as an Administrator or as a member of the Administrator group on that computer.
  2. Run SetupAll.exe from the installation package that was created using the Download Manager.
  3. Click I accept the terms in the license agreement.

    Click Next.

  4. Click Custom.

    Click Next.

  5. Click Create a custom package to install on a different computer and click Next.

  6. Click Create a Recording of Packages.

  7. Click Next.

    • Base Client will be installed as Instance001 if you are creating the custom package for the first time on this computer.
    • If SnapProtect is already installed on this computer, this screen will not be displayed and the existing instance available on the client computer will be used for creating the custom package.

  8. Verify the default location for software installation.

    Click Next.

    If necessary, click Browse... to change the default location.

    • Do not install the software to a mapped network drive
    • Do not use the following characters when specifying the destination path: / : * ? " < > | #
    • It is recommended that you use alphanumeric characters only

  9. Click Next.

  10. Specify the location where you wish to create the custom package. By default the custom package is created at C:\CustomInstallPackageName.

    Specify a folder under any drive. If the folder does not exist, it is automatically created.
    Do not use the following characters when specifying the destination path:
    / : * ? " < > |
    It is recommended that you use alphanumeric characters only.

    Click Browse to change directories.

    Click Next to continue.

  11. Select one of the following:
    • Select Create a new instance option to install the Agents as a new instance.

      If you select this option and create a custom package, later when you install the Agents using this custom package, the Agents will always be installed as a new instance irrespective of the existence of any other instances on the client computer.

    • Select Install to existing instance to install the Agents to a specific instance existing on the client computer.

      From the Select an instance drop-down list, select the instance name to which you want the agents to be added at the time of installation.

      Make sure that the instance name that you select here exists on the client computers on which you would install the agents using this custom package. Once you specify the instance name and create a custom package, later when you install the Agents using this custom package on a client computer, the Agents will always be installed to the instance that you specify in this step. If the installer does not find any matching instance name on the client computer, then a new instance with this name will be created and the Agents will be installed to this instance

    Click Next.

  12.  Select the components that you want to install.

    If you have plans to create a De-coupled custom package, the components that you select here will be included in the De-coupled custom package.
    Click Next.

  13. Click Next.

    • If you want to include .NET Framework 4.0 Installer in the custom package, select Include .NET Framework 4.0 Installer.
    • If you want to create an answer file without creating the package, select Create answer file (without packages). If you select this option, the self-extracting executable is not created.

      For example, you should create an answer file if the client on which you plan to install the software is behind a firewall. For firewall environments, it is also required to specify the CommServe name in the upcoming steps.

  14. Select one of the following:

    • If firewall configuration is not required, click Next.
    • If this computer and the CommServe is separated by a firewall, click Configure firewall services.

    For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

    If you want this screen to be displayed while installing the components from the custom package, select the Show to user check box.

  15. The CommServe name can be specified later.

    If you do not specify the CommServe name in this step, and if you choose not to display this step during the package installation, then you will need to Register a Client Using the CommCell Console or through the command line. Registration using Register Me will not be supported.

    Click Next.

    If you want this screen to be displayed while installing the components from the custom package, select the Show to user check box.

  16. The default port numbers used for CommCell communication is displayed. If necessary, you can modify the port numbers.

    Click Next.

    This screen will not appear if the default port numbers are not used for CommCell communication.

    If you want this screen to be displayed while installing the components from the custom package, select the Show to user check box.

  17. Verify the default location for software installation.

    Click Next.

    If necessary, click Browse... to change the default location.

    • Do not install the software to a mapped network drive
    • Do not use the following characters when specifying the destination path: / : * ? " < > | #
    • It is recommended that you use alphanumeric characters only

    If you want this screen to be displayed while installing the components from the custom package, select the Show to user check box.

  18. Skip this step if you did not specify the CommServe name. Select one of the following:
    • Click Use Cell level Policy to inherit the global filter policy configuration set for the CommCell.
    • Click Always use Global Filters to apply the global filters policy to the default subclient regardless of the policy set for the CommCell.
    • Select Do not use Global Filters if you plan to define specific filters for the Agent.

    Click Next.

    If you want this screen to be displayed while installing the components from the custom package, select the Show to user check box.

  19. Skip this step if you did not specify the CommServe name.

    Select the Configure for Laptop or Desktop Backup option to install Backup Monitor utility. This utility allows you to view the backup job summary from the client computer without opening the CommCell Console. See Monitor - Laptop User for more information.

    Select the Contact the master CommServe to perform automatic registration option if you have plans to deploy this installation package to multiple client computers and want each client computer to to be automatically registered to the appropriate CommServe of your choice.

    Click Next.

    If you want this screen to be displayed while installing the components from the custom package, select the Show to user check box.

  20. Click Finish.

    This screen will reflect the components you selected for install, and may look different from the example shown.

Install Using the Decoupled Installation Package

Use the following procedure to install the De-Coupled package:

  1. Locate the custom package and double-click the .exe file to start the installation. For example:
    For a Windows X64 system using default paths, this file can be located at  C:\CustomPackageName\CustomPackageName_WinX64

    If you want to install this de-coupled package on a different computer, you must copy the executable file to the desired client computer and double-click the .exe file.

  2. Custom Installation Package screen will be displayed. Click Next to continue.

  3. Provide a path for the installer to extract the installation package and then click Next.

    The installation proceeds silently. This may take several minutes to complete.

  4. In the Installer popup window, click OK.

  5. Click Finish. The Administrative Console dialog box is displayed.
  6. In the Register Me tab of the Administrative Console dialog box, specify the Username and Password, and then click Register to register the client with the CommServe database.

    • The Administrative Console dialog box is displayed only when you select the create de-coupled installation package option while creating the decoupled install package.
    • If the options in the Register Me tab are disabled, then it means that the CommServe name was not preset in the de-coupled package. In such a case, you need to Register a Client Using the CommCell Console or through the command line.

Register the Client Computer

Use one of the following methods to register your client computer:

Method 1: Register a Client Using the CommCell Console

Method 2: Register a Client from the Command Line

Register a Client Using the CommCell Console

Choose the procedure that is applicable to your CommCell environment configuration:

On a Non-Firewall Environment

  1. From the CommCell Browser, right-click the Client Computers node, and then click New Client > File System > Windows.

  2. In the Host Name box, type the host name of the client computer.

    Click the Fetch the configuration information from the client that is already installed in decoupled mode check box and select Connect to a client and get its configuration button. In the CVD port on client box, specify the CVD port number that was entered during the decoupled installation on the client computer.

    Click Next.

  3. Click Next.

    If you want to override the client name, select the Overrides the Client name checkbox and then specify the client name in the Client name box. This name will be displayed in the CommCell Console.

  4. Click Finish.

Once the client registration is complete, the client computer will be listed under the Client Computers in the CommCell Console.

On a Firewall Environment

  1. Add the client to the CommCell Console by using the following steps:

    Note: You can repeat this operation to add more clients.

    1. From the CommCell Browser, right-click the Client Computers node, and then click New Client > File System > Windows.

      The New Windows Client dialog box is displayed.

    2. On the Configure Client page, enter a Client Name and Host Name of the computer where you installed the SnapProtect software and click Next.
    3. On the Optional Data page, click Next.
    4. On the Summary page, click Finish.
  2. Configure the appropriate SnapProtect firewall settings on the client (or clients) that you added to the CommCell Console.

    For instructions, see Configuring Firewall Using Proxy for Laptop Backup. For more information on firewall configurations, see Firewall: Overview.

  3. Configure the nDisable_CVFWD registry key on the client and set it to 0.

    This key enables the client to establish communications with the CommServe computer. To configure the key, use the Windows Registry Editor.

    Tip: If you have multiple clients, use a script or a third-party application to push the additional setting to all the clients.

  4. On the CommServe computer, run the command to register the clients.
    1. On the command line, go to the Software_Installation_Directory/Base folder and run the qlogin command to access the CommServe database.
    2. Run the registration command for each of the clients that you configured.

      qoperation register -hn clientName -dock yes -roaming yes

    Tip: If you need to register multiple clients, use a script or a third-party application to run the registration command on all the clients.

Register a Client from the Command Line

 Use the following steps to register client computers with the CommServe after a Decoupled Install.

  1. Logon to a client computer.
  2. Execute the following command from the <Software_Installation_Directory>/Base folder after substituting the parameter values.

    SIMCallWrapper.exe -OpType 1000 -CSHost <CS Host Name> -clientname <client name> -output <Location for XML File>

    Usage of the command is:

    SIMCallWrapper -OpType 1000 [-instance <instance name>] [-user <User Name>] [-password <User password>] [-passwordEncrypted]] [-CSName <CS Name>] [-CSHost <CS Host Name>] [-ClientName <Client Name>] [-ClientHostName <Client Host Name>] [-ClientGroup <Client Group>] [-subclientPolicy <Subclient Policy>] [-StoragePolicy <Storage Policy>] [-overwriteClientInfo] [-resetNetworkPassword] [-regPath <alternative registry path>] [-instanceFor1Touch <instance>] -output <xmlFileName> [-Instance <Instance Name>] [-skipCertificateRevoke] [-registerme]

  3. Available Parameters

    The following table displays all the parameters you can use with the commands mentioned above:

    Parameter Description of Parameter Values
    -opType 1000 * Name of the operation type to register the client to the CommServe.
    -clientName * Name of the client computer
    -output * Location for xml file
    -instance Instance of the CommServe on which the command is run.
    -user Name of a CommCell user account with sufficient permissions to install clients. This parameter is required if user authentication is enabled in the CommCell.

    Note: If the user is part of a domain, specify the user name as 'domain\user'.

    -password Password for the user account provided.
    -CSName Name of the CommServe
    -CSHost * Host name of the CommServe
    -clientHostName Host name of the client computer
    -clientGroup Name of the client group
    -subclientPolicy Nam of the subclient policy
    -storagePolicy Name of the storage policy
    -overwriteClientInfo It overwrites client name or host name if there is a mismatch between the two. It's either ON or OFF.
    -regPath Name of the alternative registry path
    -instanceFor1Touch Name of the instance for 1-Touch
    -Instance Name of the instance

    * marked parameters are mandatory to run the command. Other parameters are optional.

Restart the Services

Skip this Section If you are not installing MediaAgent

Use the following steps to restart the services:

  1. Click Start and point to All Programs.
  2. Click NetApp, Inc. | SnapProtect and click Process Manager.
  3. Under the Services tab, right-click All Services and then click Restart.