Install Software from the CommCell Console (Remote Install)

Advanced

How Does Install From CommCell Console Work

Install Software from the CommCell Console works in conjunction with Custom Packages and Multi-Cache features, where WAN bandwidth can be drastically reduced during remote site installations.

Once the installation job starts, the CommServe pushes the required software packages to the selected computers sequentially. Once the CommServe receives notification from the client computer that the software package has been successfully delivered to the computer, it pushes the software packages to the next computer, and so on. In the meantime, the silent installation automatically begins for a computer once the packages are successfully delivered.

Configuring The CommServe Cache Directory

Verify that you have adequate space in the CommServe cache directory for the latest service pack.
From the CommCell Browser, click Control Panel and then click the Add/Remove Software Configuration.
Click the CommServe Software Cache tab.
From the Cache Details, perform the following:
- Click to select Use Local Drive option.
  In the Cache Directory box, type the path or click Browse [...] button to select the path to store the software packages.
- Click to select Use Network Share option to store software packages on network share.
  In the Cache Directory box, type the path or click Browse [...] button to select the path to store the software packages.
  
  Click User Name/Password button to enter the user account information of network share.
Click OK.

Copy Software Packages

Configure Copy Software from the CommCell Console to copy the software packages from a DVD-Rom or Local Drive to the CommServe Cache directory.

From the CommCell Browser, right-click on the CommServe node, and click All Tasks, point to Add/Remove Software and then click Copy Software.
Click to select Copy Packages option to copy the software packages.
Select Overwrite Newer Content to overwrite the installed software that are newer than the versions that were downloaded for distribution.
In the Copy Software From Location box, type or browse to the folder from which the software packages should be copied. This directory must reside on a local drive.
Provide windows impersonate user account detail of local drive by clicking User Name/Password.
Click OK.
From the Job Initiation tab select Immediate to run the job now.
Click OK to run the job immediately.

CopyToCache Tool

CopyToCache is a stand-alone tool residing on the CommServe computer that provides you with the ability to push the software from a network share that contains the packages downloaded from the customer support Web site to the designated CommServe Cache directory. This can be especially useful if a connection cannot be made to the FTP source site for downloading packages.

Do not use the CopyToCache utility to copy tar files directly to the CommServe Cache for Unix clients. For more information, see Service Pack Installs on Unix Clients using CopyToCache.

Use the following steps to run the CopyToCache tool:

Log on to CommServe computer.
From Windows Explorer, navigate to <Software_Installation_directory>/Base folder and run CopyToCache.exe.

In the Update Location box, type the path to the software package, updates or service pack file (.exe or .tar) that should be copied to the CommServe Software Cache directory.

Depending upon the Copy Option, provide the following paths in the Update Location:

For Packages - navigate to Software Installation Package (For example, Disc 1).

You should copy Disc 1 (for Windows) and Disc 3 (for Unix). These are the only Discs that must be copied to the CommServe software cache location; do not copy any other Disc to this location.

For Service Pack or Updates - type the path to the service pack or update file (.exe or .tar) that you want to copy.

The current CommServe Software Cache directory location is displayed in the Cache Location box.

From Copy Options, select one of the following options:
- Copy Updates - to copy updates or service pack
- Copy Packages - to copy the software packages
Click Copy.
The status of the Copy process is displayed in the Status.

Once the copy process is complete, you can navigate to the CommServe Software Cache directory to verify the latest packages or updates that are copied.

Install on Clients in a Domain using Auto Discovery

Installing software from the CommCell Console using the auto discovery method indicates that you will identify a domain or multiple domains, which comprises the computers that should receive the software packages for installation. The auto discovery method of installation is useful when it is necessary to push software to all the computers within an entire domain.

Prerequisites

You will be prompted to provide an user account that will be used to install the software in all the clients in the domain. Make sure that this user account has the following rights:

Administrative rights to each of the client in which the software will be installed.
Read-access in the computer from which the software is installed. (For example, if you have the source downloaded or available in a central location.)

From the CommCell Browser, select Tools -> Add/Remove Software -> Install Software.

Install Wizard Welcome screen is launched. Click Next.

Select the Client Computer's operating system, Windows or Unix and Linux.

Select Automatically Discover Computers for how the computers should be identified for installation.

Click Next.

Click Add to configure the Active Directory Server Configuration.

In the Add Active Directory Server dialog box, provide the following:

From the Select Directory Service list select directory service.
In the Server Name box, type the fully qualified domain name.
Specify the UserName and Password if applicable.

Optionally, you can use LDAP Filters for the following if external domain has been configured:

To install only on the client computers that are displayed in the filtered container.
For example, you have a mycompany as your filter with purple.company.com, maroon.company.com and red.company.com of client computers. Enter mycompany in the LDAP filter, the software will be installed on the list of computers available in the mycompany filter.
To perform a wildcard character search within the Active Directory.
For example, the following query string will search for all objects of type mycomputer with a name that begins with dev.

&(objectCategory=mycomputer)(name=dev*))

For more information on query filters, refer to Microsoft article at http://msdn.microsoft.com/en-us/library/ms675768(VS.85).aspx

To perform an Organizational Unit (OU) based search, use # as the delimiter for the query.

For example, the following query string lists all the computers in the Sales unit starting with 's'.

OU=Sales#(&(objectClass=computer)(name=s*))

Where:

OU=Sales - This will list all computers under Sales unit.

name=s* - This will list all computers starting with 's'.

If your filter query contain the letters ou then you need to use # at the start of the filter query.

For example, userAccountControl contains the letter ou, so the filter query will be:

#(& (!userAccountControl:1.2.840.113556.1.4.803:=2) (name=a*))

Click OK.

Click Next.

Click Next.

Reuse Active Directory credentials check box is selected by default to reuse the account information specified during the Active Directory Server Configuration. Click Next.
If the external domain has been configured, deselect the Reuse Active Directory credentials and enter the Account Information and then click Next.
This user account must have administrative rights to the computer to which the software will be installed, and read-access to the computer from which the software will be retrieved.

Select the Software Packages to Install on the selected computers and then click Next.

If the computer meets the requirements for the agent software, the agent software will be installed, it if does not meet the requirements, the software will not be installed on the computer, but skipped. For example, if you selected Exchange Database iDataAgent as a component for installation, this will only be installed on systems where the Exchange database is present.

For an explanation of the options and their possible values, refer to each component's interactive installation procedure in Deployment.

Select Client Group from Available and click Add.
Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information.
Select Storage Policy from Storage Policy to use drop-down list.
Click Next.

10.

Select and configure the Additional Install Options associated with the software packages that will be installed or leave the Additional Install Options at their default values and then click Next.

11.

Select Immediate to run the job now and then click Next.

To schedule the job for a specific time, perform the following steps:

Select the Schedule option.
Click Configure button.
Select the appropriate scheduling options.
For example, use the following steps to create a weekly schedule:
- Type a name for the schedule in the Schedule Name box.
- Click Weekly.
- In the Start Time box type or select the schedule start time.
- Click and select the days to run the schedule.
- Click OK.
Click OK.
The install job will be executed as scheduled.

12..

The Summary dialog will display the options configured for the install operation.

Click Finish.

13.

Review the Post-Install Considerations specific to the components that were installed using this procedure. (See Install Considerations for a list of all Install procedures.)

The software packages that are pushed to the selected client computer(s) to run the install operations are automatically deleted from the client computer(s) after the install operations have completed.

Install Software on Specific Clients

The software can be installed on specific clients by:

Importing From File

Use the following steps to install software by retrieving clients name information from existing text file.

Note that the file must list the client name as a fully qualified domain name (e.g., mycomputer.mydomain.mycompany.com) and list each client name in one line.

Verify that your client computer cache directories have adequate space for the software packages.
From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Software.
Install Wizard Welcome screen is launched. Click Next.
Select Windows and then click Next.
Select Manually Select Computers and then click Next.
Click Import From File button to import the names of the computers from a text file.
Select the file from which to retrieve the data and then click Next.
In the Select Software Cache dialog box, click Next.

In the Enter Account Information dialog box, specify the UserName and Password of the computer and then click Next.

This user account must have administrative rights to the computer to which the software will be installed, and read-access to the computer from which the software will be retrieved.

Select the software Package(s) to install on the selected computers and then click Next.
In the Enter Recommended Settings for the selected Software, select the following:
- Select Client Group from Available and click Add.
- Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information.
- Select Storage Policy from Storage Policy to use drop-down list.
- Click Next.
Select and configure the Additional Install Options associated with the software packages that will be installed or leave the Additional Install Options at their default values and click Next.
Select Immediate to run the job now and then click OK.

Click Finish.

Review the Post-Install Considerations specific to the components that were installed using this procedure.
The software packages that are pushed to the selected client computer(s) to run the install operations are automatically deleted from the client computer(s) after the install operations have completed.

Importing From Active Directory

Verify that your client computer cache directories have adequate space for the software packages.
From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Software.
Install Wizard Welcome screen is launched. Click Next.
Select Windows and then click Next.
Select Manually Select Computers and then click Next.
Click Import from Active Directory to select the computers from a list of all computers in a specific domain.
Enter the domain account credentials in the Active Directory Server Information dialog box.

The computers found in the domain specified will be listed in the Discovered Computers windowpane.

Click Next.
In the Select Software Cache dialog box, click Next.

In the Enter Account Information dialog box, specify the UserName and Password of the computer and then click Next.

This user account must have administrative rights to the computer to which the software will be installed, and read-access to the computer from which the software will be retrieved.

Select the software Package(s) to install on the selected computers and then click Next.
In the Enter Recommended Settings for the selected Software, select the following:
- Select Client Group from Available and click Add.
- Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information.
- Select Storage Policy from Storage Policy to use drop-down list.
- Click Next.
Select and configure the Additional Install Options associated with the software packages that will be installed or leave the Additional Install Options at their default values and click Next.
Select Immediate to run the job now and then click OK.

Click Finish.

Review the Post-Install Considerations specific to the components that were installed using this procedure.
The software packages that are pushed to the selected client computer(s) to run the install operations are automatically deleted from the client computer(s) after the install operations have completed.

Selecting from Existing Clients

Use the following steps to install the software on the existing clients:

Verify that your client computer cache directories have adequate space for the software packages.
From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Software.
Install Wizard Welcome screen is launched. Click Next.
Select Windows and then click Next.
Select Manually Select Computers and then click Next.
Click Select from existing clients to select the clients from the list of clients available in the CommServe.
Click Next.
In the Select Software Cache dialog box, click Next.

In the Enter Account Information dialog box, specify the UserName and Password of the computer and then click Next.

This user account must have administrative rights to the computer to which the software will be installed, and read-access to the computer from which the software will be retrieved.

Select the software Package(s) to install on the selected computers and then click Next.
In the Enter Recommended Settings for the selected Software, select the following:
- Select Client Group from Available and click Add.
- Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information.
- Select Storage Policy from Storage Policy to use drop-down list.
- Click Next.
Select and configure the Additional Install Options associated with the software packages that will be installed or leave the Additional Install Options at their default values and click Next.
Select Immediate to run the job now and then click OK.

Click Finish.

Review the Post-Install Considerations specific to the components that were installed using this procedure.
The software packages that are pushed to the selected client computer(s) to run the install operations are automatically deleted from the client computer(s) after the install operations have completed.

Install Software - Unix

Use the following steps to install software on Unix Clients:

For sudo users, Service Pack 4B (or higher) must be available in the CommServe cache before performing the install.

From the CommCell Browser, select Tools | Add/Remove Software | Install Software.

Click Next.

Select Unix and Linux.

Click Next.

Select Manually Select Computers.

Click Next.

Enter the fully qualified domain name of the computer in which you wish to install.

For example: apple.domain.company.com

Click Next.

Specify UserName and Password of client computer who has administrator or sudo privileges.

Click Next.

If a SUDO user has been created for root access then use visudo to change /etc/sudoers, so this user can SUDO into ssh without being prompted for the password.

For SuSE Linux comment the following lines:

Defaults targetpw # ask for the password of the target user i.e. root
ALL ALL=(ALL) ALL # WARNING! Only use this together with 'Defaults targetpw'!

For RHEL/CentOS comment the following line:

Defaults requiretty

8.	Select Unix File System iDataAgent to install on the selected computers and then click Next.
9.	Select Client Group from Available and click Add. Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information. Select Storage Policy from Storage Policy to use drop-down list. Click Next.
10.	Click Next.
11.	Select Immediate. Click Next.
12.	Click Finish.
13.	You can track the progress of the job from the Job Controller or Event Viewer window.

Install Software on Client Using Save As Script

Use the following steps to install the software on multiple clients using Save As Script:

For Windows

From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Software.
Install Wizard Welcome screen is launched. Click Next.
Select Windows options and then click Next.
Select Manually Select Computers and then click Next.
Type the host names of the computers in the window pane manually to which you want to install the software and then click Next.
Computer names must be entered in the following format: <computer.domain.company.com>

Click Next.
Click Import From File button, to import the names of the computers from a text file. Select the file form which to retrieve the data and then click Next.
In the Select Software Cache dialog box, click Next.
In the User Name and Password box, specify the user account information and then click Next.
Select the Software Package(s) to install on the selected computers and then click Next.
Select Client Group from Available and click Add.
Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information.

Select Storage Policy from Storage Policy to use drop-down list and then click Next.
Select and configure the Additional Install Options associated with the software packages that will be installed.
Select Immediate to run the job now and then click OK.
Click Save As Script button.
From Save As Script dialog box, specify the following:
- From the Client list, select the client on which you want to save the script.
- In the Path box, type or Browse to a path and name for the .bat file to be saved e.g., E:\Install_Script\input_file.bat
- For Mode, by default Synchronous option is selected which exits only when the operation has completed.
  Select Asynchronous option, to submit the job to the CommServe and exit immediately, returning control to the calling program or script.
- Click OK to save the operation as a script file.
  This generates two files .xml and .bat.
  
  If you want to setup firewall configuration, perform additional steps described in Firewall Configuration.
To automatically login and install the software on the client, perform the following:
- From the command prompt, navigate to the location where the .bat and .xml files are located and then run the .bat file.
  Example
  
  E:Scripts>\input_file.bat
  
  Where
  The .bat file contains the following commands and performs the following operation.
  qlogin - to login to the session
  
  qoperation execute - to execute the xml script
  
  qlogout - to logout from the session
  
  The .xml file is the script file that contains information on the options selected from the CommCell Console. This .xml file is given as input to the qcommand execute in the batch file, see Sample XML File.
To install software using qoperation execute command, perform the following from the command prompt:
- Login to the CommServe using the qlogin command and commcell credentials:
  E:\Script\> qlogin -cs commserve_name -u user_name
- Run the following execute operation using qoperation
  USAGE:
  
  qoperation execute -af <xml_file>
  
  Example:
  
  qoperation execute -af input_file.xml
To override the client name specified in the .xml file or to install the same configuration to multiple clients, run the following command:
Usage:

<batch_file> -clientInstallOption/clientDetails/clientEntity/clientName <client_name> -clientAuthForJob/password <password>

Example:

input_file.bat -clientInstallOption/clientDetails/clientEntity/clientName purple.mydomain.mycompany.com -clientAuthForJob/password password1

For Unix

From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Software.
Install Wizard Welcome screen is launched. Click Next.
Select Unix and Linux options and then click Next.
Select Manually Select Computers and then click Next.
Type the host names of the computers in the window pane manually to which you want to install the software and then click Next.
Computer names must be entered in the following format: <computer.domain.company.com>
In the Select Software Cache dialog box, click Next.
In the User Name and Password box, specify the user account information and then click Next.
Select the Software Package(s) to install on the selected computers and then click Next.
Select Client Group from Available and click Add.
Select Configure For Laptop Backups option to install Backup Monitor utility. This utility allows you to view the backup job summary of your client computer. See Monitor - Laptop User for more information.

Select Storage Policy from Storage Policy to use drop-down list and then click Next.
Select and configure the Additional Install Options associated with the software packages that will be installed.
Select Immediate to run the job now and then click OK.
Click Save As Script button.
From Save As Script dialog box, specify the following:
- From the Client list, select the client on which you want to save the script.
- In the Path box, type or Browse to a path and name for the script file to be saved e.g., /Install_Script/input_file.
- For Mode, by default Synchronous option is selected which exits only when the operation has completed.
  Select Asynchronous option, to submit the job to the CommServe and exit immediately, returning control to the calling program or script.
- Click OK to save the operation as a script file.
  This generates two files input_file.xml and input_xml file.
  
  If you want to setup firewall configuration, perform additional steps described in Firewall Configuration.
To automatically login and install the software on the client, perform the following:
- From the command prompt, navigate to the location where the script files are located and then run the script file.
  Example
  
  [root@localhost Scripts]# ./input_file
  
  Where
  The script file contains the following commands and performs the following operation.
  qlogin - to login to the session
  
  qoperation execute - to execute the xml script
  
  qlogout - to logout from the session
  
  The .xml file is the script file that contains information on the options selected from the CommCell Console. This .xml file is given as input to the qcommand execute in the batch file, see Sample XML File.
To install software using qoperation execute command, perform the following from the command prompt:
- Login to the CommServe using the qlogin command and commcell credentials:
  [root@localhost Script]# ./qlogin -cs commserve_name -u user_name
- Run the following execute operation using qoperation:
  USAGE:
  
  ./qoperation execute <xml_file>
  
  Example:
  
  ./qoperation execute input_file.xml
To override the client name specified in the .xml file or to install the same configuration to multiple clients, run the following command:
Usage:

./<batch_file> -clientInstallOption/clientDetails/clientEntity/clientName <client_name> -clientAuthForJob/password <password>

Example:

./input_file -clientInstallOption/clientDetails/clientEntity/clientName purple.mydomain.mycompany.com -clientAuthForJob/password password1

Sample XML File

The following is a sample XML file that is generated while performing Save As Script operation for push install.

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> <TMMsg_CreateTaskReq> <taskInfo> <task>  <taskName></taskName> <taskFlags> <disabled>false</disabled> </taskFlags> <taskType>IMMEDIATE</taskType> <initiatedFrom>COMMANDLINE</initiatedFrom> </task> <associations/> <subTasks> <subTask> <subTaskType>ADMIN</subTaskType> <operationType>INSTALL_CLIENT</operationType> </subTask> <options> <adminOpts> <updateOption/> <clientInstallOption> <clientDetails> <clientEntity> <clientName>client1.mydomain.com</clientName> </clientEntity> </clientDetails> <clientDetails> <clientEntity> <clientName>client2.mydomain.com</clientName> </clientEntity> </clientDetails> <installOSType>WINDOWS</installOSType> <discoveryType>MANUAL</discoveryType> <installerOption> <RemoteClient>false</RemoteClient> <requestType>PRE_DECLARE_CLIENT</requestType> <User> <userName>admin</userName> </User> <Operationtype>INSTALL_CLIENT</Operationtype> <CommServeHostName>commdocs.idclab.loc</CommServeHostName> <CommServeInfo> <CommserveHostInfo> <hostName>commdocs.mydomain.com</hostName> </CommserveHostInfo> </CommServeInfo> <clientComposition> <overrideSoftwareCache>false</overrideSoftwareCache> <clientInfo> <client> <jobResulsDir> <path></path> </jobResulsDir> <cvdPort>8400</cvdPort> <evmgrcPort>8402</evmgrcPort> <installDirectory></installDirectory> </client> <clientProps> <logFilesLocation></logFilesLocation> </clientProps> </clientInfo> <components> <componentInfo> <ComponentName>Windows File System iDataAgent</ComponentName> <osType>Windows</osType> </componentInfo> <commonInfo> <globalFilters>UseCellLevelPolicy</globalFilters> <storagePolicyToUse> <storagePolicyName>cs_test</storagePolicyName> </storagePolicyToUse> </commonInfo> <fileSystem> <configureForLaptopBackups>false</configureForLaptopBackups> <selectedSubclientPolicy/> </fileSystem> </components> <packageDeliveryOption>CopyPackage</packageDeliveryOption> </clientComposition> <installFlags> <installLatestServicePack>true</installLatestServicePack> <forceReboot>false</forceReboot> <killBrowserProcesses>false</killBrowserProcesses> <ignoreJobsRunning>false</ignoreJobsRunning> <stopOracleServices>false</stopOracleServices> <skipClientsOfCS>false</skipClientsOfCS> <advancedOptions></advancedOptions> <deletePackagesAfterInstall>true</deletePackagesAfterInstall> <overrideClientInfo>true</overrideClientInfo> <installResultLogLocation></installResultLogLocation> <restoreOnlyAgents>false</restoreOnlyAgents> </installFlags> </installerOption> <clientAuthForJob> <userName>mydomain\administrator</userName> <password>||#4!MkdHbXpnZ216Z2dtemdnbXpnZ216Z2dtemdn </password> </clientAuthForJob> <reuseADCredentials>false</reuseADCredentials> </clientInstallOption> </adminOpts> </options> </subTasks> </taskInfo> </TMMsg_CreateTaskReq>

Firewall Configuration

Depending upon the environment in which you are going to perform the installation, you can setup firewall configuration while performing the push installation.

Using the text editor, open the xml file that is generated while performing the save as script operation for push install.
Add the below firewall attributes before </installFlags>.For more information about attribute names and values, see XML File Parameters for Firewall Configuration.
<firewallInstall disableFirewall="0" firewallConnectionType="2" portNumber="7777" proxyClientName="pxs" proxyHostName="pxh"> </firewallInstall>
Save the xml file.

XML File Parameters for Firewall Configuration

Listed below are the required and optional fields related to Firewall configuration that can be added in XML file.

Attribute Name

Values

Description

disableFirewall	1	This is used to specify whether you want to configure firewall settings. Use value 0 to configure firewall settings. Value 1 to disable firewall settings.
firewallConnectionType	0	This is to specify the different types of firewall configurations. The following types of firewall can be configured: For Windows client: By default, the value is set to 0 where this client connects to the CommServe through a port forwarding gateway. Use value 101 where CommServe can reach the Client. Use value 102 where CommServe can be reached through a Proxy. For UNIX client: By default, the value is set to 0 where this client connects to the CommServe through a port forwarding gateway. Use value 1 where CommServe can reach the Client. Use value 2 where CommServe can be reached through a Proxy.
proxyClientName		This is the short name of the proxy through which the CommServe can be reached. If you have specified the value 2 in the firewallConnectionType attribute, specify the short name of the proxy client computer.
proxyHostName		This is the hostname of the proxy through which the CommServe can be reached. If you have specified the value 2 in the firewallConnectionType attribute, specify the host name or the IP address of the proxy computer. This is the hostname of the proxy through which the CommServe can be reached. If the proxy is behind a port-forwarding gateway, then provide the host name or the IP address of the port-forwarding gateway.
portNumber		This is the port number through which the CommServe can be reached. This number varies depending upon the firewallConnectionType. If you have specified value 0 for the firewallConnectionType, specify the CommServe HTTP/HTTPs tunnel port number. If the value is 1, specify local HTTP/HTTPS tunnel port number. If the value is 2, specify the proxy HTTP/HTTPS tunnel port number. See Firewall for more information.

Install Updates on Client Using Save As Script

Use the following steps to install the updates on multiple clients using Save As Script:

For Windows

From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Updates.
Select the Client Computer(s) on which you want to install the updates.

Select the Reboot Client check box to allow the computer to reboot after installing the updates.

When the Reboot Client check box is selected, the system automatically reboots the client and/or MediaAgent computers if a reboot is required.

If the install update or upgrade includes a driver update, all the updates required for the computer will not be installed if this option is cleared.

Click the Job Initiation tab.
Select Immediate.
Click Save As Script button.
From Save As Script dialog box, specify the following:
- From the Client list, select the client on which you want to save the script.
- In the Path box, type the path and name for the .bat file to be saved e.g., E:\Install_Script\input_file.bat
- For Mode, by default Synchronous option is selected which exits only when the operation has completed.
  Select Asynchronous option, to submit the job to the CommServe and exit immediately; returns the control to the calling program or script.
- Click OK to save the operation as a script file.
  This generates a .xml file and a .bat file.
To automatically login and install updates on the client, use the the following steps:
- From the command prompt, navigate to the location where the .bat and .xml files are saved and then run the .bat file.
  Example
  
  E:Scripts>\input_file.bat
  
  Where
  The .bat file contains the following commands and performs the following operation:
  qlogin - to login to the session
  
  qoperation execute - to execute the xml script
  
  qlogout - to logout from the session
  
  The .xml file is the script file that contains information on the options selected from the CommCell Console. This .xml file is given as input to the qcommand execute in the batch file.
To install updates using qoperation execute command, perform the following from the command prompt:
- Login to the CommServe using the qlogin command and CommCell credentials:
  E:\Script\> qlogin -cs commserve_name -u user_name
- Run the following execute operation using qoperation:
  USAGE:
  
  qoperation execute -af <xml_file>
  
  Example:
  
  qoperation execute -af input_file.xml
To override the client name specified in the .xml file or to install the same updates to multiple clients, run the following command:
Usage:

<batch_file> -updateOption/clientAndClientGroups/clientName <client_name>

Example:

input_file.bat -updateOption/clientAndClientGroups/clientName purple.mydomain.mycompany.com

For Unix

From the CommCell Browser, click Tools, point to Add/Remove Software and then click Install Updates.
Select the Client Computer(s) on which you want to install the updates.
Select the Reboot Client check box to allow the computer to reboot after installing the updates.

Click the Job Initiation tab.
Select Immediate.
Click Save As Script button.
From Save As Script dialog box, specify the following:
- From the Client list, select the client on which you want to save the script.
- In the Path box, type the path and name for the .bat file to be saved e.g., /Install_Script/input_file
- For Mode, by default Synchronous option is selected which exits only when the operation has completed.
  Select Asynchronous option, to submit the job to the CommServe and exit immediately; returns the control to the calling program or script.
- Click OK to save the operation as a script file.
  This generates two files input_file.xml and input_xml file.

To login automatically and install updates on the client, perform the following:
- From the command prompt, navigate to the location where the script files are located and then run the script file.
  Example
  
  [root@localhost Scripts]# ./input_file
  
  Where
  The script file contains the following commands and performs the following operation.
  qlogin - to login to the session
  
  qoperation execute - to execute the xml script
  
  qlogout - to logout from the session
  
  The .xml file is the script file that contains information on the options selected from the CommCell Console. This .xml file is given as input to the qcommand execute in the batch file.
To install updates using qoperation execute command, perform the following from the command prompt:
- Login to the CommServe using the qlogin command and commcell credentials:
  [root@localhost Script]# ./qlogin -cs commserve_name -u user_name
- Run the following execute operation using qoperation
  USAGE:
  
  ./qoperation execute -af <xml_file>
  
  Example:
  
  ./qoperation execute-af input_file.xml
To override the client name specified in the .xml file or to install the updates to multiple clients, run the following command:
Usage:

./<batch_file> -updateOption/clientAndClientGroups/clientName <client_name>

Example:

./input_file -updateOption/clientAndClientGroups/clientName purple.mydomain.mycompany.com

Configuring Timeout Duration

The default timeout for software install from the CommCell Console is 30 minutes. To configure a different timeout value, use the following steps:

From the CommCell Browser, navigate to Client Computers.
Right-click the <CommServe_Client>, and then click Properties.
Click the Registry Key Settings tab.
Click Add.
In the Name field, type nPushInstallTimeoutInMin.
In the Location list, type UpdateFlags
In the Type list, select REG_DWORD.
In the Value field, type the value to specify in the minutes.
Click OK.

Delete Cache Contents

If there are any previous packages present in the cache directory, use the following steps to delete the contents from the cache directory:

From the CommCell Console, point to Add/Remove Software and then click Add/Remove Software Configuration.
Click the CommServe Software Cache tab.
Click the Delete Cache Contents button.
Select Delete Package Cache check box to delete the previous packages present in the cache directory and then click OK.
Click OK.

Commit Cache

Use the following steps to synchronize the CommServe Database with the cache directory. This is necessary when contents of the specified cache directory include updates and/or service packs that were manually copied to it and you want this cache directory to be the baseline for all other components.

From the CommCell Console, point to Add/Remove Software and then click Add/Remove Software Configuration.
Click the CommServe Software Cache tab.
Click the Commit Cache button.
Click OK.

Schedule Download Software

Use the following steps to schedule the download software jobs:

Do not schedule an FTP download at the same time an Install Software job is scheduled to run.

From the CommCell Browser, right-click on the CommServe node, point to All Tasks | Add/Remove Software and then click Download Software.
From the General tab, select the Download Packages option which automatically selects both Windows and Unix check boxes.
Click to select Windows to download Windows packages for clients running Windows based operating systems.
Click to select Unix to download Unix packages for clients running Unix based operating systems.
Click the Job Initiation tab.
Select the Schedule option.
Click Configure button.
Select the appropriate scheduling options.
For example, use the following steps to create a weekly schedule:
- Type a name for the schedule in the Schedule Name box.
- Click Weekly.
- In the Start Time box type or select the schedule start time.
- Click and select the days to run the schedule.
- Click OK.
Click OK.
The download software job will be executed as scheduled.

Schedule Copy Software

Use the following steps to schedule copy software job.

From the CommCell Browser, right-click on the CommServe node, point to All Tasks | Add/Remove Software and then click Copy Software.
Select Copy Packages option to copy the software packages.
Select Overwrite Newer Content to overwrite the installed software that are newer than the versions that were downloaded for distribution.
In the Copy Software From Location box, specify the location of cache directory which the software packages should be copied. This directory must reside on a local drive.
Provide windows impersonate user account detail of local drive by clicking User Name/Password.
Click the Job Initiation tab.
Select the Schedule option.
Click Configure button.
Select the appropriate scheduling options.
For example, use the following steps to create a weekly schedule:
- Type a name for the schedule in the Schedule Name box.
- Click Weekly.
- In the Start Time box type or select the schedule start time.
- Click and select the days to run the schedule.
- Click OK.
Click OK.
The copy software job will be executed as scheduled.

Viewing the Schedules for Client Installation

From the CommCell Browser, right-click the commserve and select View -> Schedules
Scroll to the bottom of the Schedules Windows and verify the newly created schedule for installation.

Discovering EDC/Agentless SRM/Virtual Server Clients

If you need install software packages on EDC Discovered, Agentless SRM or Virtual Server Discovered clients, you must configure the CommCell Browser to display these client types. To do this, access the User Preferences configuration from the CommCell Console's Control Panel, and enable the display options for the clients types you require.

Uninstall Software From CommCell Console

From the CommCell Browser, right-click the desired Client Computer and click All Tasks -> Add/Remove Programs and click Uninstall Software.
Uninstall Software Options dialog will appear.
In the Uninstall Software tab, select Uninstall All to uninstall all the software packages.
Enable the Force Uninstall if remote client is unreachable option so that if any client computer scheduled for uninstall in unreachable, the license will still be released from the CommServe database.
In the Job Initiation tab, select Immediate to run the job immediately.
You can track the progress of the job from the Job Controller or Event Viewer.

From the CommCell Browser, click Tools -> Reports...
From the Reports pane, click Job Summary.
From the General tab, click Administrative Jobs and then select Install/Upgrade/Remove Software option.
Click Run.
The report appears in your default Web browser.

CommCell Configuration Report

The following procedure provides the steps necessary to run a CommCell Configuration job summary report that displays a summary of the CommCell configuration.

From the CommCell Browser, click Tools -> Reports...
From the Reports pane, click Job Summary.
From the General tab, click CommCell Configuration and then select Remote Software Cache and Update Service Pack check boxes.
Click Run.
The report appears in your default Web browser.

Install Software from the CommCell Console (Remote Install)

Table of contents

Related Topics

Where:

For Windows

Example

Where

USAGE:

Example:

Usage:

Example:

For Unix

Example

Where

USAGE:

Example:

Usage:

Example:

For Windows

Example

Where

USAGE:

Example:

Usage:

Example:

For Unix

Example

Where

USAGE:

Example:

Usage:

Example: