You can configure some of the settings directly from the CONFIGURATION > Settings page in the App Volumes Manager admin UI, and others through the environment variables.
Configuration Settings
To view and edit the settings, go to CONFIGURATION > Settings.
| Type | Value | Description |
|---|---|---|
| General Settings | UI Session Timeout | The duration for which App Volumes Manager remains active after the user logs in. The default value is 30 minutes.This general setting is set through the SESSION_TIMEOUT system environment variable. |
| General Settings | Certificate Authority File | Path of the certificate file used by machine managers. This general setting is set through the SSL_CERT_FILE system environment variable. |
| Volume Mounting | API Mounting | Allow the user to log in even if a Writable Volume cannot be attached to the user at the time of login. |
| Writable Volumes | Delete Protection | Protect volumes from getting deleted directly from storage. This setting is set through the AVM_NO_PROTECT (or CV_NO_PROTECT) system environment variable. |
| Writable Volumes | Force Reboot on Error | If a Writable Volume is assigned to a user, and the volume does not get attached to the user, the user has the option to reboot the machine. This setting is set through the AVM_WRITABLE_REBOOT system environment variable.Note: The AVM_WRITABLE_REBOOT does not apply to Writable Volumes conflicts. Writable Volumes conflicts are handled by the Block user login setting. For more information about Block user login setting, see Create a Writable Volume in App Volumes. |
| Writable Volume Backups | Regular backups | Toggle the slider to activate or deactivate regular backups for Writable Volumes. If enabled, Writable Volumes are backed up regularly based on the recurrent interval. For example: Consider that the recurrent interval is set to 7 days. A Writable Volume is backed up if 7 days have elapsed since the last backup. Backup is only performed for Writable Volumes that have been used at least once since the last backup. Note: This setting is available for vCenter Server and ESXi(Single Host) machine manager types.By default, this toggle is deactivated. |
| Writable Volume Backups | Storage Location | The location where the volumes are backed up. For example: [xxx]AV-LUN. Note: This setting is available only when the Regular backups setting is activated. |
| Writable Volume Backups | Storage Path | Name and path of the folder where the volumes are backed up. For example: cloudvolumes/writable_volumes_backup Note: This setting is available only when the Regular backups setting is activated. |
| Active Directory | Non-Domain Entities | App Volumes Manager expects Computer and User accounts to be members of a registered Active Directory domain. Computer start ups and user logins using local accounts are normally ignored. Use this setting to allow or not allow non-domain entities to be listed in the Directory tab in App Volumes Manager. If Allow is selected in the drop-down, then non-domain entities are allowed. App Volumes Manager creates a record for local entities when they are first detected. The local entity gets listed in the Directory tab and can have application packages assigned to itself from within the tab.If the setting is later changed to Disallow, the local entities stop getting listed in the Online tab, but continue getting listed in the other Entity tabs.By default, this setting is configured to Disallow. |
| [VHD] In-Guest Services | Dynamic File Permissions | Use this check box to dynamically control the permissions given to the App Volumes agent machines to access Writable Volumes when App Volumes is configured in the VHD in-guest mode.
|
| [VHD] In-Guest Services | Generate MSI when creating VHD package | Toggle the slider to activate the setting. When the setting is active, during packaging, an MSI-wrapped VHD package is also created in addition to a VHD package. As a result, two packages are created for the same application. However, it is considered as a single application package and represented as VHD + MSI.Note:
MSI-wrapped VHD is preferred when delivering an application to a Windows endpoint in the Local Copy package access mode. If the MSI-wrapped VHD is unavailable, the VHD package gets delivered to the endpoint. Local Copy and Shared Storage are package access mode settings in App Volumes. These modes are available when App Volumes Manager is used for application delivery.
|
| Agent Dialogs Configuration |
| Use these toggle buttons to customize the user feedback dialog box title, feedback dialog text box, and version selection dialog text box which are displayed to the end user on the agent computer. The Customize User Feedback Dialog toggle button controls the text displayed in the User Feedback Dialog Title and User Feedback Dialog Text text boxes. These text boxes are displayed to the end user when the Prompt for Feedback toggle is turned on. For information about this toggle, see Seek App Volumes Application Usage Feedback from Users. The Customize Version Selection Dialog toggle button controls the text displayed to the end user when multiple package versions of the application are available for selection. For information about assigning applications with multiple package versions to an entity, see Understanding Multiple Assignments. Note: For any change in the agent dialog box text to become effective for the end user, it might take a maximum of 10 minutes. |
| Smartcard Configuration | Enable Smartcard Authentication | Use this toggle to enable smart card authentication in App Volumes Manager. Smart card authentication strengthens the security of your App Volumes Manager environment by allowing users to log in using physical smart card credentials. Traditional username and password authentication continues to be available. By default, the toggle is turned off. When the toggle is turned on, two additional fields are available. For more information about these fields and how smart card authentication works in App Volumes Manager, see Use Smart Card Authentication for App Volumes Manager. |
| Advanced Settings | Agent Session Cookie | Toggle the slider to activate or deactivate Agent Session Cookie. By default, this toggle is activated. App Volumes uses a session cookie to optimize the communication between the App Volumes Manager and App Volumes Agent. If you have Agent session issues, you can use this setting to deactivate the session cookies. |
| Advanced Settings | Agent Sync Interval | This advanced setting specifies how frequently a Windows endpoint device synchronizes with App Volumes Manager to retrieve the latest change in entitlements and ensure that the locally cached application packages are up to date. By default, the value of this setting is 5 minutes. It is also the minimum value which can be configured for this setting. Anything lesser than 5 minutes is not allowed and overridden to the default value. You can use the minimum, default value when there are limited number of user sessions. If you have more number of user sessions, then you can configure this interval to a higher value as per your requirement.After synchronization, depending on changes in entitlements, the packages get downloaded locally or deleted on the endpoint accordingly. Packages get virtualized and applications get delivered to end users even when the endpoint is offline. Note:
If you are troubleshooting or testing the local copy package access mode and want to immediately trigger synchronization instead of waiting for the configured sync interval to lapse, you can use the perform-sync command. For more information about this option, see Manually Trigger a Sync Between a Windows Endpoint (Local Copy Mode) and App Volumes Manager.
|
| Advanced Settings | Volume Cache | Toggle the slider to activate or deactivate volume cache. App Volumes caches assigned application objects to improve performance. However, if you experience increased memory usage, consider deactivating volume caching. Note:
|
| Advanced Settings | Token AD query | Toggle the slider to activate or deactivate token AD query. By default, this toggle is activated. App Volumes queries for Active Directory group membership using cached object SIDs. Previous versions of App Volumes performed group membership queries against Active Directory domains directly and recursively. Deactivate token AD query to revert to the previous implementation. |
| Advanced Settings | VMDK Package Attachment Resiliency | If this setting is turned on, any VMDK attachment failures are skipped and the remaining VMDK packages are attached.
If this setting is turned off, no packages are attached during failures.
When the setting is turned on, for package attachment resiliency to occur, ensure that you have the following system requirements:
|
| Advanced Settings | API Reference UI | Controls whether the REST API Reference UI for App Volumes APIs is available in the
App Volumes Manager server. When this setting is enabled, the API Reference UI is available at https://App_Volumes_Manager_server_address/rest/swagger-ui.Administrators can browse and run the App Volumes REST APIs directly from the browser. Before running the APIs, it is essential to create an authorized API session. When the setting is deactivated, the UI is not accessible and an HTTP 404 (Not Found) response is seen. By default, the setting is deactivated. Changes to this setting take effect immediately. You do not need to restart App Volumes Manager service. For more information about using the REST API Reference UI hosted in App Volumes Manager server, see Access App Volumes API Reference UI hosted in App Volumes Manager. |
| Advanced Settings | Show Writable Volumes | Use this toggle to control the visibility of UI elements related to Writable Volumes in the App Volumes Manager console. Note: Turning on the toggle does not affect the functionality of Writable Volumes. All related virtualization, backup functions, and APIs continue working normally. For a fresh install of App Volumes, this toggle is turned off by default. As a result, all Writable Volumes related UI elements such as the Inventory > Writables tab, Writable Templates at Configuration > Storage > Upload Templates, and so on remain hidden in the App Volumes Manager console. To make these UI elements visible, the toggle must be turned on. For more information about this toggle and its behavior during upgrade, see Control the Visibility of Writable Volumes UI. |
| Advanced Setting | PII Logging | By default, Personally Identifiable Information (PII) data is not obfuscated in App Volumes Manager log files and the PII Logging toggle button is turned on. To obfuscate PII data when the log level is INFO, turn off the toggle. When the toggle is turned off, the following information is obfuscated: username, user ID, IP address, host name, machine name, email address (if present), MAC address (if logged), and any domain-specific identifier that allows user identification.If you change the log level to DEBUG, PII data is not obfuscated in the logs even when the toggle is turned off. By default, the log level is INFO.Here are some considerations:
This toggle is available only after configuring App Volumes Manager. Therefore, PII data can be obfuscated using the toggle only after configuration. To obfuscate PII data before installing or upgrading App Volumes Manager, EnablePIILogging, a system environment variable can be used. If this environment variable is set to 0, then the default status of the PII Logging toggle in the UI is off after install or upgrade. As a result, PII data is obfuscated when the log level is INFO.Note: Enabling obfuscation either before or after an upgrade does not apply to the existing PII data which is already logged in an earlier version. The existing PII data remains visible in the logs. Obfuscation is applied only to newly logged PII data. PII data can also be obfuscated in the nginx.conf. For more information about how to obfuscate PII data in this configuration file, see Obfuscate PII Data in nginx Configuration File. |
| Advanced Settings | Join the Omnissa CEIP | App Volumes participates in the Customer Experience Improvement Program (CEIP). Use this toggle to choose to participate or leave the CEIP program. To join the CEIP program, turn on the toggle. You can leave the program anytime. To leave the program, turn off the toggle. By default, the toggle is turned on. For more information about this program, see Join the Customer Experience Improvement Program (CEIP) for App Volumes. |
Was this page helpful?