Decoupled Install - How To

Topics | How To | Support | Related Topics

Decoupled Install on Windows

Silent Decoupled Install on Windows

Decoupled Install on Unix

Silent Decoupled Install on Unix

Register a Client Computer

Decoupled Install on Windows

Selected agents can be installed on a computer that is not part of a CommCell and the computer can subsequently be added to the CommCell as a Client and/or MediaAgent.

Before You Begin

• Read Decoupled Install before installing Agents.

To perform a decoupled install on Windows:

1. Verify that the selected computer does not already have Agent and/or MediaAgent software installed and meets the necessary System Requirements. Refer to System Requirements, and select the page for the software you are installing.
2. Configure the bPreImageMode registry key. (When the software install completes, this registry key is automatically cleared -- its value is set to "0" -- so that any future installations of software are performed in the normal manner, not as Decoupled Installs.)
3. Install Agent and/or MediaAgent software on the computer that will be a Client and/or MediaAgent. Refer to Installation, and select the applicable software installation procedure. Note that some of the screens shown in the installation procedure will not be displayed during a Decoupled Install.
4. During the install, the PreImageModeFile.xml file is created in the \<install_path>\Base\ directory. This file will be required when you perform the Register a Client Computer procedure in the CommCell Console. See XML Input File for Decoupled Install for details.
5. When you are ready to register the computer in the CommCell as a Client and/or MediaAgent, perform the procedure to Register a Client Computer.

Installation is not complete and the client is not functional until you register this client with the CommServe computer.

Silent Decoupled Install on Windows

Selected agents can be silently installed on a computer that is not part of a CommCell and the computer can subsequently be added to the CommCell as a Client and/or MediaAgent. The computer that is used to record the install does not have to be the machine where the decoupled install will take place.

Before You Begin

• Read Silent Install - Windows Agents and Decoupled Install before installing Agents.

To perform a silent decoupled install on Windows:

1. Verify that the selected computer does not already have Agent and/or MediaAgent software installed and meets the necessary System Requirements. Refer to System Requirements, and select the page for the software you are installing.
2. Configure the bPreImageMode registry key. (When the software install completes, this registry key is automatically cleared -- its value is set to "0" -- so that any future installations of software are performed in the normal manner, not as Decoupled Installs.)

3. To start the recording of the install, navigate to the folder where QInstaller.exe resides and type the following command:

   QInstaller.exe /record <fully qualified filename>

   For example, if you type QInstaller.exe /record c:\silent\exmpl.ini, the install options will be recorded to a file called exmpl.ini which will be located in the c:\silent folder.

4. Select Agent and/or MediaAgent software on the computer that will be a Client and/or MediaAgent. During the recording, software is not actually installed. Refer to Installation, and select the applicable software installation procedure. Note that some of the screens shown in the installation procedure will not be displayed while recording a decoupled install.

5. To start the installation, navigate to the folder where QInstaller.exe resides and type the following command:

   QInstaller.exe /play <fully qualified filename>

   For example, if you type QInstaller.exe /play c:\silent\exmpl.ini, the file called exmpl.ini located in the c:\silent folder will be played back, installing the software with all the recorded options to the local computer. To see progress windows, you can append the command with /info.

   Because the computer where the installation is played back may be different than the computer on which the installation was recorded, ensure that you have configured the bPreImageMode registry key.

6. During the install, the PreImageModeFile.xml file is created in the \<install_path>\Base\ directory. This file will be required when you perform the Register a Client Computer procedure in the CommCell Console. See XML Input File for Decoupled Install for details.
7. When you are ready to register the computer in the CommCell as a Client and/or MediaAgent, perform the procedure to Register a Client Computer.

Installation is not complete and the client is not functional until you register this client with the CommServe computer.

Decoupled Install on Unix

Selected agents can be installed on a computer that is not part of a CommCell and the computer can subsequently be added to the CommCell as a Client and/or MediaAgent.

Before You Begin

• Read Decoupled Install before installing Agents.

To perform a decoupled install on Unix:

1. Verify that the selected computer does not already have Agent and/or MediaAgent software installed and meets the necessary System Requirements. Refer to System Requirements, and select the page for the software you are installing.
2. Install Agent and/or MediaAgent software on the computer that will be a Client and/or MediaAgent. Refer to Installation, and select the applicable software installation procedure. To start the install, issue the  cvpkgadd -decouple command.
3. During the install, the preimage.xml file is created in the /<install_path>/calypso/ directory. This file will be required when you perform the Register a Client Computer procedure in the CommCell Console.
4. When you are ready to register the computer in the CommCell as a Client and/or MediaAgent, perform the procedure to Register a Client Computer.

Installation is not complete and the client is not functional until you register this client with the CommServe computer.

Silent Decoupled Install on Unix

Selected agents can be installed on a computer that is not part of a CommCell and the computer can subsequently be added to the CommCell as a Client and/or MediaAgent.

Before You Begin

• Read Silent Installs - Unix Agents and Decoupled Install before installing Agents.

To perform a silent decoupled install on Unix:

1. Verify that the selected computer does not already have Agent and/or MediaAgent software installed and meets the necessary System Requirements. Refer to System Requirements, and select the page for the software you are installing.
2. Edit the pkgenvinfo file, user-defined file, or cvsi.conf file as appropriate to modify the values of the following parameters for use in your site’s installation. Be sure to include the DECOUPLED_INSTALL parameter with value 1 in the parameter file. Also, remove or comment out the SERVER_HOSTNAME parameter. For complete details on the parameters, refer to Install Procedure. An example parameter file is as follows:
   
   INSTANCE=Instance001

   CLIENT_NAME="serpens"

   CLIENT_HOSTNAME="serpens.company.com"

   CVD_PORT="8500"

   EVMGRC_PORT="8502"

   INSDIR="/opt"

   LOGDIR="/var/log"

   JOBDIR="/opt"

   SP="my_mag"

   GROUP="mygroup"

   DECOUPLED_INSTALL="1"

3. Run the following command as appropriate:
   • Using the traditional parameters file:

     silent_install [-params <params_file>] [-log <log_file>]\ <module _1>...<module_n>

     where:

     • <params_file> specifies the name of the file with installation parameters. If you are using a user-defined file name, be sure to enter the entire path (e.g., /start/user_choice). If you are using the default file name, omit this parameter.
     • <log_file> specifies the custom log file name that you should create as a temporary log file. This file is displayed only if the installation fails.
     • <module_1..._n> specifies the name of the subsystem(s) to be installed. Values include CVGxBase (for the Base software) and CVGxIDA (for the iDataAgent). CVGxIDA is the only <module> parameter that you need to include in the command line to install both the iDataAgent and the Base software.

     Note that some of the screens shown in the installation procedure will not be displayed during a Decoupled Install. For more examples, refer to Install Procedure.

4. During the install, the preimage.xml file is created in the /<install_path>/calypso/ directory. This file will be required when you perform the Register a Client Computer procedure in the CommCell Console.
5. When you are ready to register the computer in the CommCell as a Client and/or MediaAgent, perform the procedure to Register a Client Computer.

Installation is not complete and the client is not functional until you register this client with the CommServe computer.

Register a Client Computer

Before you Begin

• A Product License(s) will be consumed when you perform this procedure, even if you have not yet performed an installation of software on the computer which will function as a Client and/or MediaAgent.
• When registering a computer by connecting with it, ensure the following:
  • The CommServe computer can communicate with the computer being registered.
  • The Client and/or MediaAgent software has been properly installed on the computer being registered. For more information and instructions, see Decoupled Install.
• To register a Client computer without connecting to it, ensure the following:
  • An XML input file containing the information needed to create the Client in the database is available on a local drive of the CommServe. (This XML input file is automatically created during a Decoupled Install, and does not need to be created if you have already performed that procedure.) For more information about the XML input file, see XML Input File for Decoupled Install.
• For Exchange-based and SharePoint-based agents, after running the Register a new Client Wizard, you need to finish the registration to specify account information, as explained below.

Required Capability: Capabilities and Permitted Actions

To register a client computer:

1. From the CommCell Browser, right-click the Client Computers icon, then select Register Client from the short-cut menu.
2. The Register a new Client wizard is displayed.
3. In the Select Configuration Source dialog, choose one of the following:
   • Select Connect to a client and get its configuration. Type the Host Name and the number of the CVD port on Client. (Select this option only if you have already pre-installed software on a client computer using a Decoupled Install.)

   Do not use spaces when specifying a new name for the Client.

   • Select Get Client configuration from an input file on CommServe. Type the path and name of the XML input file, or browse to it and select it.  (Select this option only if you have an XML input file available on the CommServe computer.)

   Click Next to continue.

4. In the Optional Data dialog, you can do the following:
   • Select Override the Client name to type a different Client name from the one specified in the XML input file or during the Decoupled Install.
   • Select Override the Host name to type a different Host name from the one specified in the XML input file or during the Decoupled Install. Ensure that the Host name you supply can be resolved from the CommServe.

   Click Next to continue.

5. The Summary screen is displayed. Verify that the information is correct, then click Finish.
6. The Progress screen is displayed until all the steps complete successfully.
7. Refresh the CommCell Console to see the newly registered Client and/or MediaAgent. (To refresh, select the View menu, then Refresh).
8. If you selected Get Client configuration from an input file on CommServe in Step 3, perform the following additional steps:
   1. Install the Client and/or MediaAgent software on the computer that will be a Client or MediaAgent. If that computer has connectivity to the CommServe, you can perform a regular install or a Decoupled Install; if it does not have connectivity, you can only perform a Decoupled Install. For more information and instructions, see Installation or Decoupled Install.
   2. To connect the Client or MediaAgent to the CommCell, right-click the Client or MediaAgent in the CommCell Browser and select Complete Registration. The CommServe will connect to the selected computer and complete the connection process. When finished, based on whether Agent or MediaAgent software, or both, were installed on the remote computer, it will appear in the browser as a Client, MediaAgent, or both.
9. For Exchange-based and SharePoint-based agents, you need to finish the registration to specify account information. The agent icon will have a check next to it, indicating that registration is still required.

1. Right-click the agent and select Register.
2. Click Yes to confirm registering the agent.
3. In the Register dialog, enter account information such as Server Name, Mailbox Name, Profile Name, Domain, Account Name, and Account Password.

10. Verify that Updates have been installed on the newly registered Client and/or MediaAgent. For more information, see Install Updates on CommCell Computers.

Back To Top