Desktop Virtualization › Upgrade UNIX Agents Using Software Delivery and the Individual Agent Plug-in Package › Configure Software Reinstallation › Configure the Pool Settings to Run Compose.bat on the Virtual Desktops

Configure the Pool Settings to Run Compose.bat on the Virtual Desktops

Specify the following command in the post synchronization script under Guest Customizations when you create the pool:

Compose.bat [ISDBPath=<Path>] [Run=<Run>] [ISDBUser=<User> ISDBPassword=<Password>]

ISDBPATH

Specifies the path where the instance software database is stored. The path can be local or network depending on the pool type. Specify a network path for nonpersistent pools and local or network path for persistent pools. Environment variables and predefined macros like {SCALABILITY_SERVER} and {POOL_NAME} are allowed as part of the path.

Example: \\{SCALABILITY_SERVER}\%COMPUTERNAME%

Important! On Windows 7, if the path parameter contains the %USERNAME% environment variable, do not pass this parameter as a command line parameter to Compose.bat. Instead, include all the parameters inside the Compose.bat file (for VMware View only).

{SCALABILITY_SERVER}

Returns the scalability server to which the virtual desktop reports to. By default, virtual desktops report to the same scalability server that the golden template reports to. If you have changed the scalability server assignment explicitly, the macro returns the new scalability server name.

{POOL_NAME}

Returns the pool name of the virtual desktop. This macro is applicable for VMware View only.

Persistent Use

Environment variables, like %COMPUTERNAME% can be used as part of the ISDB path.

Example: \\MachineName\{POOL_NAME}\%COMPUTERNAME%

This option results in a path unique for a user (because a persistent virtual desktop is always assigned to the same user).

Non Persistent Use

The user-specific environment variables, %USERNAME% and %USERDOMAIN%, can be included to identify uniquely the software state database for a particular user.

Example: \\MachineName\{POOL_NAME}\%USERNAME%

Note: Be careful to select the location in the case of network share paths when multiple desktop pools assigned to a single user. You must ensure that the software state of the virtual desktop used by a user in one pool is not overwritten by the data of another virtual desktop used by the same user in another pool. For example, given that “User1” is entitled to nonpersistent pools, poolA and poolB. if the path for both pools is specified as “//<machine-name>/<share-name>/Database/%USERNAME%”, the software state of “User1” can be overwritten if the user logs on and uses both virtual desktops in both pools. Hence, ensure that you define different paths as follows:

• “/<machine-mname>/<share-name>/PoolA/%USERNAME%”
• “/<machine-mname>/<share-name>/PoolB/%USERNAME%”

ISDBUSER

Specifies the user name to connect to the instance software database path in a network share. The user name must be encrypted using sd_acmd encrypt command.

ISDBPASSWORD

Specifies the password to connect to the instance software database path in a network share. The password must be encrypted using sd_acmd encrypt command.

RUN

Specifies when to execute the Offline RAC process. Valid values are OnRecompose and OnLogon.

OnRecompose

Specifies that the Offline RAC is initiated when the desktop starts after a refresh or recompose. Use this option for desktop groups where the desktop assignment to users is fixed, such as persistent linked clones.

OnLogon

Specifies that Offline RAC is initiated on user logon.

Use this option for desktop groups where the desktop assignment to the users varies from session to session such as nonpersistent desktops.

Examples:

• Persistent Use: Compose.bat "ISDBPath=<Path>" "Run=OnRecompose"
• Nonpersistent Use: Compose.bat "ISDBPath=<Path>" "Run=OnLogon"

Back to Top