To register a client computer, a Decoupled Install creates an XML input file named PreImageModeFile.xml in the /<install_path>/calypso/Base/Temp folder.
This XML file contains all the required fields and some of the optional fields indicated below, and can be used without any changes to register the Client and/or MediaAgent on the CommServe. Optionally, the generated XML file can be edited to meet particular needs, such as using the generated file as a base, and customizing it for many different Client and/or MediaAgents.
The following is an example of the contents of a typical PreImageModeFile.xml input file generated during the Decoupled Install of a File System iDataAgent:
Below file is located in the /opt/calypso/Base/Temp
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<CVInstallManager_ClientSetup Focus="Instancexxx" LocaleID="0" Operationtype="0"
RemoteClient="1" requestType="1">
<CommServeInfo>
<CommserveHostInfo clientName="" hostName="(null)">
</CommserveHostInfo>
</CommServeInfo>
<clientComposition>
<clientInfo>
<client clientPassword="1eb121M1C" cvdPort="8400" evmgrcPort="8402" installDirectory="/opt/calypso">
<clientEntity clientName="172" hostName="sonic.company.com">
</clientEntity>
<jobResulsDir path="/opt/simpana/iDataAgent/jobResults">
</jobResulsDir>
<osInfo PlatformType="X86" SubType="Linux" Type="Unix" Version="glibc2.5">
<OsDisplayInfo OSBuild="2.6.18-194.el5" OSName="Linux" ProcessorType="i686">
</OsDisplayInfo>
</osInfo>
</client>
<clientProps BinarySetID="17" CPUCount="2" IsVirtualClient="0" byteOrder="Little-endian">
</clientProps>
</clientInfo>
<components>
<commonInfo globalFilters="" useExistingStoragePolicy="0">
<storagePolicyToUse storagePolicyId="1">
</storagePolicyToUse>
</commonInfo>
<componentInfo ComponentId="1002" ComponentName="Base Client" clientSidePackage="1"
consumeLicense="1" osType="Unix">
</componentInfo>
<componentInfo ComponentId="1003" ComponentName="Base0 Client" clientSidePackage="1"
consumeLicense="1" osType="Unix">
</componentInfo>
<componentInfo ComponentId="1101" ComponentName="UNIX File System iDataAgent" clientSidePackage="1"
consumeLicense="1" osType="Unix">
</componentInfo>
<fileSystem configureForLaptopBackups="0">
</fileSystem>
</components>
</clientComposition>
</CVInstallManager_ClientSetup>
Below file is located in the C:\Program Files\Company\calypso\Base\Temp
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<CVInstallManager_ClientSetup Focus="NEW" JobID="0" LocaleID="0" Operationtype="0"
RemoteClient="1" requestType="1">
<CommServeInfo>
<CommserveHostInfo clientName="" hostName=""/>
</CommServeInfo>
<clientComposition activateClient="1" packageDeliveryOption="0">
<clientInfo>
<client clientPassword="CpMCC" cvdPort="8615" evmgrcPort="8617" installDirectory="C:\Program
Files\Company\calypso\">
<clientEntity clientName="autumn_5" hostName="autumn"/>
<jobResulsDir path="C:\Program Files\Company\calypso\iDataAgent\JobResults"/>
</client>
</clientInfo>
<components>
<componentInfo ComponentId="1" ComponentName="Base Client" clientSidePackage="1"
consumeLicense="1" osType="Windows"/>
<componentInfo ComponentId="702" ComponentName="FileSystem iDA for Windows" clientSidePackage="1"
consumeLicense="1" osType="Windows"/>
<commonInfo globalFilters="2" apachePort="80" globalFilters="2" iisPort="80" iisSSLPort="443"
/>
<storagePolicyToUse storagePolicyId="1" storagePolicyName="DEFAULT"/>
</commonInfo>
</components>
</clientComposition>
<installFlags deletePackagesAfterInstall="1" forceReboot="0" ignoreJobsRunning="0"
installLatestServicePack="1" killBrowserProcesses="0" overrideClientInfo="0" showFirewallConfigDialogs="0"
stopOracleServices="0" upgradeMode="0" />
</CVInstallManager_ClientSetup>
Listed below are the required and optional fields in the XML file that the Register a Client Computer process requires.
| Attribute Name | Values | Description |
| Focus | New | This is the Instance number to which the software will be installed in a multi-instance environment. By default the attribute uses New as a values which automatically defines the existing instance number during install. For example, for first instance the value is defined as instance001, for multiple instance it is defined by the other instance numbers. |
| CommServeHostInfo | ||
| clientName | This attribute indicates the short name of the CommServe computer.
Example: mycomputer
Do not specify a value for this attribute if you are running a Decoupled Install of the software. |
|
| hostName | This attribute indicates the long name of the
CommServe computer. Example:
mycomputer.mycompany.com. Do not specify a value for this attribute if you are running a Decoupled Install of the software. |
|
| clientInfo | ||
| cvdPort | 8400 | Required. This is the TCP port number for the Communications Service (CVD). If the client computer has multiple instances of the Agent software installed, then each instance must be configured with a distinct port number. |
| evmgrcPort | 8402 | Required. This is the TCP port number for the Client Event Manager Service (EvMgrC). If the client computer has multiple instances of the Agent software installed, then each instance must be configured with a distinct port number. |
| installDirectory | C:\Program Files\Company\ | This value indicates the software installation path. The default location of install directory is C:\Program Files\Company. |
| clientName | This attribute indicates the local name of the client computer. | |
| hostName | This attribute indicates TCP/IP host name of the NIC that the client computer will use to communicate with the CommServe. | |
| jobResulsDir | ||
| path | C:\Program Files\Company\ iDataAgent\JobResults | This is the directory where you want the job results to reside. The default location of job results directory is C:\Program Files\Company\iDataAgent\JobResults. |
| ComponentInfo | ||
| ComponentId | 702 | Optional. These are the package Id(s) of the components (agents) to
be installed. See List of Package Ids for valid values (e.g., 702). One or more parameters can be specified (e.g., 702) |
| ComponentName | Windows File System iDataAgent | Required. Specify the name of the components (agents) to be installed. |
| osType | Windows | This attribute defines the type of the Operating System. By default
Windows is automatically defined for as
the value for this attribute for Windows Install.
For Unix install, by default Unix will be defined as a value for this attribute. |
| commonInfo | ||
| apachePort | 80 | This value is used for Web Search Client. It is important to know the port numbers used by iisPort services, and make sure that the same port number is not used by two services. |
| globalFilters | 0 | Optional. This value indicates the Global Filters options for the default subclient; a value of 0 to disable global filters for the default subclient, 1 to enable global filters for the default subclient and 2 to enable Cell level policy for global filters. |
| iisPort | 81 | This values specifies the port number for the Web Search Server. It is important to know the port numbers used by apache web services, and make sure that the same port number is not used by two services. |
| iisSSLPort | 443 | This values specifies the port number of IIS Secure Socket Layer for Web Search Server. |
| deletePackagesAfterInstall | 1 | This value indicated to delete the packages after silent install. |
| forceReboot | 0 | This value indicated to reboot the machine if required. For example, a reboot will be required after install to initialize the QSnap driver, before you can use this Agent. |
| ignoreJobsRunning | 0 | This value is used during Install Software from CommCell Console. This is used to ignore the job running during the software install from CommCell Console. Use value 1 to ignore the job. |
| installLatestServicePack | 1 | This is used to download and install the latest service pack. Use value 1 to download and install the service pack, value 0 to disable the download and install. |
| killBrowserProcesses | 0 | This is used to kill the Browser if any browsers are running during Console install. |
| overrideClientInfo | 0 | This value is used to override the Client name or Hostname in the CommCell Browser. |
| showFirewallConfigDialogs | 0 | This value indicates that the firewall dialog screens will not be displayed during the install; a value of 1 means they will be displayed. For more information about firewalls, see Firewall Considerations. Note that this attribute for firewall configuration is not supported for Decouple Silent Install. |
| stopOracleServices | 0 | This value indicates to stop the oracle services during Oracle iDataAgent install. Use value 0 to stop the services, value 1 to start the services. |
| upgradeMode | 0 | This value indicated that this is silent upgrade; a value 1 means this is upgrade. |