You can set various options for the Omnissa Access Desktop application when you run its installer program using the command line or a deployment script.
Available Command-Line Options for the Omnissa Access Desktop Installer
After you download the .exe file for the client application's installer to a Windows system, you can see a list of the installation options by running the following command:
*Please contact Support for this command.*
where n.n.n-nnnnnnn represents the file's version and build number. A dialog box appears that lists the available installation options for installing the client application using the command line or a deployment script.
Installer Command-Line Options
| Installer Option | Value | Description |
|---|---|---|
| /? | Displays the installer command-line options. | |
| /a | Performs an administrative installation. For more information, see the Windows Installer documentation. | |
| /a | full path to existing administrative installation | Patches an existing administrative installation. |
| /s | Hides the initialization dialog box during installation.
To install in silent mode, use /s /v/qn.
In silent mode, no messages, dialog boxes, or prompts are displayed during installation You typically use this option when creating a deployment script to run the installer. | |
| /v | key-value pairs | A set of parameters to pass to the installer, specified as key-value pairs. Use the format key=value. These arguments configure runtime options for the ThinApp packages and for the Omnissa Access Desktop in general. |
| /c | Cleans out installation registration information. | |
| /l | [full path to log file] | Performs detailed logging and saves to the specified log file.
If you don't specify a log file, a default log in |
| /x | Unpacks the installer into the %TEMP% folder. |
Key-Value Pairs for the /v Option
You can use the following key-value pairs for the /v installer option.
Keys for the /v Installer Command-Line Option
| Key | Value | Description |
|---|---|---|
| WORKSPACE_SERVER | Host name or URL of the Omnissa Access service |
Provides the Omnissa Access service host name or URL, to allow the Omnissa Access Desktop application to communicate with the service. HTTPS is the required protocol. Enclose the value in quotation marks. Use the following format:
or
For example: |
| INSTALL_MODE | One of the following:
COPY_TO_LOCAL
HTTP_DOWNLOAD
RUN_FROM_SHARE |
Sets the deployment mode for how the Omnissa Access Desktop application obtains ThinApp packages at runtime. ThinApp packages are virtualized Windows applications. The ThinApp packages reside on a network share that is integrated with Omnissa Access.
For all of the modes, the network share must have the appropriate file and sharing permissions configured. Important: When installing Omnissa Access Desktop in floating Horizon desktops, use the RUN_FROM_SHARE option to avoid copying the ThinApp packages into those stateless Horizon desktop systems. When the Omnissa Access Desktop application is installed with one of the following configurations, the user account that logs into the Windows system must have the appropriate file and sharing permissions on the network share to be able to obtain the ThinApp packages:
|
| POLLING_INTERVAL | Frequency in seconds | Sets the frequency, in seconds, of synchronization between the installed Omnissa Access Desktop application and Omnissa Access to check for new ThinApp packages or entitlements. If unspecified, the default value of 300 seconds (5 minutes) applies.
For example:
|
| ENABLE_AUTOUPDATE | 0 or 1 |
Turns on or turns off the automatic update check and download activity. If enabled, the installed Omnissa Access Desktop application automatically checks if a newer application is available for download. If a newer version is available, the Omnissa Access Desktop application automatically downloads and updates itself to the newer version. This option is enabled by default. Set the value of this variable to 0 to turn off automatic update. If unspecified, the default value of 1 applies. Installation of automatic updates requires administrator privileges. |
| SHARED_CACHE | 0 or 1 |
Determines whether the ThinApp package cache is located in a common folder in the Windows system to which the client application is being installed. Set the value of this variable to 1 to specify that all user accounts on the Windows system share a common cache location. If unspecified, the default value of 0 applies, and each Windows user account gets its own cache. Note: If you specify a shared cache, the Omnissa Access Desktop application does not automatically delete ThinApp packages from this shared cache. Because SHARED_CACHE=1 indicates that all user accounts on the Windows system share the same location, the packages must remain in the shared location so that entitled users can use them, even when you unentitle one user. When you unentitle a user from a ThinApp package, the Omnissa Access Desktop application unregisters that package for that user. Other entitled users on that Windows system can continue to use the ThinApp package. You can delete the common cache manually to reclaim the space if no user accounts on that Windows system are entitled to use the ThinApp packages. Each ThinApp package has its own folder under the cache location. |
| CACHE_DIR | Path to folder | Sets the location where ThinApp packages will be cached locally if the HTTP_DOWNLOAD or COPY_TO_LOCAL install modes are used. This value is set per system, not per user, so you must use environment variables, such as %LOCALAPPDATA%, to select user-specific locations. Be sure to escape the % character on the command-line to prevent immediate expansion. For example:
CACHE_DIR=^%LOCALAPPDATA^%\cache |
| AUTO_TRY_HTTP | 0 or 1 | When the Omnissa Access Desktop application is installed with the COPY_TO_LOCAL option, the AUTO_TRY_HTTP option determines whether the client should automatically try downloading the user's entitled ThinApp packages using the HTTP protocol, similar to the HTTP_DOWNLOAD option, if the first download attempt fails. This option is turned on by default. To turn off the option, set the value to 0. |
| INSTALL_MODULES | thinapp | A comma-separated list specifying which modules to install. Currently, only the thinapp module is available. |
Using the Omnissa Access Desktop Command-Line Installer Options
If your Omnissa Access instance has a URL of https
- The ThinApp install option set to HTTP_DOWNLOAD, because you expect these Windows systems will not be likely to join the domain.
- The clients check for new packages and entitlements with Omnissa Access every 60 seconds.
You would create a script that invokes the following command:
*Please contact Support for this command.*
where you replace the n.n.n-nnnnnnn portion of the file name to match the name of your downloaded Omnissa Access Desktop installer.
Was this page helpful?