App Volumes Install Guide 401
App Volumes Install Guide 401
Installation Guide
Update 1
12 MAR 2020
VMware App Volumes 4
VMware App Volumes Installation Guide
You can find the most up-to-date technical documentation on the VMware website at:
https://docs.vmware.com/
VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
©
Copyright 2019, 2020, VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc. 2
Contents
3 System Requirements 8
Software Requirements 8
Infrastructure and Networking Requirements 9
VMware, Inc. 3
About This Book
1
The VMware App Volumes Installation Guide provides information on how to install, deploy, and
®
upgrade VMware App Volumes
Intended Audience
This information is intended for experienced IT system administrators who are familiar with virtual
machine technology and datacenter operations.
VMware, Inc. 4
Introduction to VMware App
Volumes 2
VMware App Volumes provides a system to deliver applications to desktops through virtual
disks. Applications delivered by attaching a standard VMDK file to a virtual machine. You can
centrally manage the applications with the App Volumes Manager and there is no need to modify
the desktops or individual applications. Applications delivered using App Volumes look and feel
natively installed and you can update or replace the applications in real time.
All Programs are packaged during login time and App Volumes users have a persistent user
experience wherein they can install their own applications and have them persist across sessions.
A typical App Volumes environment consists of a few key components that interact with each
other and an external infrastructure.
Component Description
App Volumes Administrator or User Active Directory (AD) or organizational unit (OU) account
to which Application Packages and Writable Volumes are
assigned. User must have local administrator privileges.
VMware, Inc. 5
VMware App Volumes Installation Guide
Component Description
VMware, Inc. 6
VMware App Volumes Installation Guide
Component Description
VMware, Inc. 7
System Requirements
3
You must verify that your system meets the requirements before you install VMware App
Volumes.
n Software Requirements
Software Requirements
Ensure that your system meets certain database and browser requirements when working with
App Volumes.
Database Requirements
App Volumes Manager supports different versions of the Microsoft SQL database.
For High Availability, App Volumes supports the following database features :
Browser Requirements
Use App Volumes Manager on one of the following supported browsers:
n Safari 7 or later
VMware, Inc. 8
VMware App Volumes Installation Guide
Component Details
App Volumes Agent (client OS) n Microsoft Windows 10 version 1909 Enterprise and Pro
n Microsoft Windows 10 version 1903 Enterprise and Pro
n Microsoft Windows 10 version 1809 Enterprise and Pro
n Microsoft Windows 10 version 1803 Enterprise and Pro
n Microsoft Windows 10 Enterprise LTSC 2019
n Microsoft Windows 7 SP1 Professional and Enterprise
editions (Microsoft KB 3033929)
n Microsoft Windows Server 2019 Datacenter and
Standard
n Microsoft Windows Server 2016 Datacenter and
Standard
n 64-bit versions of OS are supported
n 1 GB RAM
n 1 vCPU
n 12 MB disk space
Hypervisor (if using VMDK) n VMware ESXi and vCenter Server 6.5 or later (ESXi
and vCenter Server must be the same version)
VMware, Inc. 9
Installing App Volumes
4
Installing App Volumes involves installing the App Volumes Manager, App Volumes agents, and
related components.
Before installing App Volumes, ensure that you have created and set up the requisite user
accounts and Active Directory credentials.
n Verify License
User Accounts
You can create user accounts and grant privileges for different roles. User names must contain
only ASCII characters:
n To integrate App Volumes with vCenter Server, you must create a service account within a
vCenter Server with administrator privileges. Optionally, you can create a service account with
privileges granted by a custom user role.
n If you plan to use a direct connection to the ESXi host or plan to use the Mount to Host option
with a vCenter Server connection, you must have administrator privileges on all ESXi hosts.
VMware, Inc. 10
VMware App Volumes Installation Guide
n Provides read access to the Active Directory domain. Administrator privileges are not
required.
If your environment contains domains that are configured for one-way or two-way trust, you
can configure separate credentials to access these domains. These credentials are used when
connecting to any trust instead of the primary domain credentials.
Administrators Group
Access to the App Volumes Manager is restricted to the App Volumes administrators group.
When you perform the initial configuration, you must provide the name of the Active Directory
security group that will have access to the App Volumes Manager.
Note The Active Directory service account user is not required to be an administrator.
Prerequisites
n Ensure that you have the SQL Server authentication details with you.
n Verify that your environment meets the system requirements. See Infrastructure and
Networking Requirements and Software Requirements.
n Verify that your account has local administrator privileges on the target server.
Procedure
2 Read and accept the End-User License Agreement and click Next.
VMware, Inc. 11
VMware App Volumes Installation Guide
Option Description
Option Description
Windows Integrated Authentication Provide owner permissions on the new database to the App Volumes
Manager server.
SQL authentication Create a user and provide owner permissions to the user on the new
database.
Note Ensure that the Overwrite existing database (if any) check box is deselected when you
upgrade App Volumes or install an additional instance of App Volumes Manager.
8 If you do not have the relevant certificate to validate the SSL connection to SQL server,
deselect the Enable SQL Server certificate validation check box and click Next.
9 Select the ports on which App Volumes Manager can listen for incoming connections.
By default, communication occurs over SSL and the default value of the port is 443. Specify the
port value as 80 (or equivalent) for App Volumes Manager to listen on a HTTP port.
If you have specified the App Volumes Manager to listen on a HTTP port in Step 7, you must
check this box. Checking this box disables SSL and all communication with App Volumes
Manager becomes insecure .
11 Click Next and enter the path where App Volumes Manager should be installed..
What to do next
Log in to App Volumes Manager and configure the Active Directory, vCenter Server, Machine
Managers, and Storage as soon as you have installed App Volumes Manager. Configure the
VMware, Inc. 12
VMware App Volumes Installation Guide
connection to the SQL database and SSL for App Volumes Manager. See the App Volumes
administration guide for detailed information.
You might want to perform a silent installation when you want to run the installation unattended.
Prerequisites
n You must have administrator privileges on the machine where you want to perform the silent
installation.
n Ensure that your Windows Server has the latest OS security updates. See the Microsoft KB
https://support.microsoft.com/en-us/kb/2919355 for more information.
n You must have access to the msodbcsql_17.2.0.1_x64.msi which will install the ODBC 17.2
driver.
n Access vc_redist.x64.exe executable from the App Volumes Manager folder and run the
executable.
Procedure
1 Open a command prompt and run the following command to install the ODBC driver:
msodbcsql_17.2.0.1_x64.msi /qn IACCEPTMSODBCSQLLICENSETERMS=YES /norestart
VMware, Inc. 13
VMware App Volumes Installation Guide
For improved security when using the App Volumes agent, disable weak ciphers in SSL and TLS
to ensure that Windows-based machines running the agent do not use weak ciphers when they
communicate using SSL/TLS protocol. See Disable Weak Ciphers in SSL and TLS in the Horizon 7
documentation.
Important Do not install the agent on the same machine where the App Volumes Manager is
installed.
You can also install the agent silently using the Microsoft Windows Installer (MSI). See Install App
Volumes Agent Silently for more information.
Prerequisites
n Ensure that you have installed the App Volumes Manager and you have the host IP address
and port number.
n Verify that your environment meets the system requirements. See Chapter 3 System
Requirements.
n Verify that your account has local administrator privileges on the target computer.
n Install Windows Updates from January 2016 onwards on the target computer.
n If you intend to use this virtual machine as a packaging computer, create a clean snapshot or
take a backup of this machine. Revert to this snapshot or the backup before packaging new
Application Packages.
Procedure
The same installer is used to install App Volumes Manager and the agent.
2 Read and accept the End User License Agreement and click Next.
The default port number for App Volumes Manager is 443. Enter 80 for the port number if you
have configured App Volumes Manager to listen on an HTTP port.
5 (Optional) Check the Disable Certificate Validation with App Volumes Manager box if you do
not want the agent to validate the App Volumes Manager certificate.
VMware, Inc. 14
VMware App Volumes Installation Guide
What to do next
Configure SSL certificates for the agent. You can also disable SSL communication and certificate
validation between App Volumes Manager and agent. For more information, see the VMware App
Volumes Administration Guide on VMware Docs.
You perform a silent install using the command line and you do not need to use the App Volumes
installer. You can also upgrade the agent silently. See Upgrade App Volumes Agent Silently.
For App Volumes agent to validate the App Volumes Manager certificate, you can use the
EnforceSSLCertificateValidation parameter.
Prerequisites
n Ensure that you have installed the App Volumes Manager and you have the host IP address
and port number.
n Verify that your environment meets the system requirements. See Chapter 3 System
Requirements.
n Verify that your account has local administrator privileges on the target computer.
n Install Windows Updates from January 2016 onwards on the target computer.
n If you intend to use this virtual machine as a packaging computer, create a clean snapshot or
take a backup of this machine. Revert to this snapshot or back up before you package new
Application Packages.
Procedure
2 In the command prompt, access the App Volumes Agent.msi file location.
VMware, Inc. 15
VMware App Volumes Installation Guide
Option Description
Verify License
You must enter the App Volumes license information before configuring other components. A
valid license is required to activate and use App Volumes.
Prerequisites
Ensure that you have downloaded and installed the App Volumes license file. The production
license file can be downloaded from the VMware App Volumes product download page.
Procedure
1 From the App Volumes Manager console, click CONFIGURATION > License.
If you have an evaluation license, you can use App Volumes until the expiration date.
3 (Optional) To apply a different license, click Edit and browse to the location of the license you
want to upload.
Multiple App Volumes Manager instances can be load balanced by a hardware load balancer.
Alternatively, you can configure the App Volumes agent to communicate with multiple App
Volumes Manager servers.
VMware, Inc. 16
VMware App Volumes Installation Guide
Procedure
1 To install additional App Volumes Manager instances, follow standard installation procedures
and point a new instance to the existing SQL database.
Important In the installation wizard, ensure that you have deselected the Create a new
database or overwrite the existing database check box.
You can specify the load balanced FQDN of the App Volumes Manager.
3 In the registry key, add string value named ManagerN and value data App Volumes Manager
FQDN, colon, and port number.
N ranges between 0 to 9.
For example, to add the data for the additional App Volumes Manager instance whose IP
address is 192.168.127.53 and port 443, perform the following:
a Open regedit.exe.
c Right click on the registry key and select New > String Value.
4 Click OK.
What to do next
Restart the virtual machine on which you have installed the App Volumes agent.
VMware, Inc. 17
Upgrading App Volumes
Components 5
You can upgrade the different components of App Volumes by using the installer.
If you have App Volumes 2.18 installed on your system, you can upgrade to the latest version
without uninstalling your currently installed version.
If you have installed an App Volumes version earlier than 2.18, you must first upgrade to 2.18 and
then upgrade to the latest version.
If you want to upgrade multiple App Volumes Managers which point to a central database, open
services.msc and stop the App Volumes Manager service on each server. You must then run the
installer on each server to upgrade App Volumes.
For minor and maintainance upgrades, see Considerations for Performing Rolling Upgrades.
Prerequisites
n Schedule a maintenance window to ensure that there is no service degradation during the
upgrade process.
n In the Windows Start menu, open Control Panel and click Administrative Tools > ODBC
data source. Note down the database and server name defined in the system ODBC source
svmanager.
n Back up the App Volumes database using SQL Server tools.
n Create a full server back up or snapshot of the App Volumes Manager server.
VMware, Inc. 18
VMware App Volumes Installation Guide
n If you are using App Volumes Manager earlier than 2.18, you must first upgrade to App
Volumes Manager 2.18 or later.
Important Before upgrading from App Volumes Manager 2.x, you must stop all instances of App
Volumes Manager service.
Procedure
2 Locate the App Volumes installer that you downloaded and double-click the setup.msi file.
A Status Bar shows the progress of the installation. The installation process takes 5 to 10
minutes to complete. During this time, configuration information is first backed-up, new files
are installed, and the configuration information is restored.
Results
Note All certificates that you had previously configured are retained and you do not need to
reconfigure them.
What to do next
n After you have upgraded App Volumes to the latest version, you can activate registration
security. You must also register any additional App Volumes Manager servers if you have a
multi-manager setup.
For details, see the Register App Volumes Manager Server section in the VMware App
Volumes Administration Guide at VMware Docs.
VMware, Inc. 19
VMware App Volumes Installation Guide
Important Before upgrading from App Volumes 2.x, you must stop all instances of App Volumes
Manager service.
You must be aware of the following considerations while planning for rolling upgrades:
n A full server backup or snapshot of the App Volumes Manager server must be taken.
n Administrators cannot use the new functionality of the App Volumes Manager console until all
App Volumes Manager instances within the cluster are upgraded to the desired version.
n Before performing a rolling upgrade, all App Volumes Manager instances must be on the same
version.
n After upgrading the App Volumes Manager to the desired version, rolling back the upgrade
might result in loss of new data that was created or updated in the database during the
upgrade process.
To upgrade your App Volumes Manager, see Upgrade App Volumes Manager.
If AppStacks and Writable Volumes (2.x) are not in use, you can disable the VOLUMES (2.X) tab
and other 2.x-related features in the App Volumes Manager UI by using the Enable Volumes (2.x)
toggle switch. For example, this switch can be used to turn off 2.x-related features after migrating
the AppStacks and Writable Volumes (2.x) from App Volumes Manager 2.x.
Note If you are upgrading from App Volumes Manager 2.x, the Enable Volumes (2.x) toggle
switch is on by default.
For information about how to use the toggle switch, see Configuring visibility and management of
App Volumes Manager 2.x UI.
VMware, Inc. 20
VMware App Volumes Installation Guide
For more information, read the Limiting AppStack Attachments section in the VMware App
Volumes 2.18 Admin Guide.
n Option to limit attachment of a particular AppStack to a specific computer (computer prefix).
For more information, read the Assign an AppStack to a User section in the VMware App
Volumes 2.18 Admin Guide.
n Option to attach an AppStack immediately.
For more information, read the Assign an AppStack to a User section in the VMware App
Volumes 2.18 Admin Guide.
n Option to edit the type of Operating System to which an AppStack is attached.
For more information, read the Edit an AppStack section in the VMware App Volumes 2.18
Admin Guide.
n AppStacks precedence
For more information, read the AppStacks Precedence section in the VMware App Volumes
2.18 Admin Guide.
n Reassign a Computer Writable Volume
For more information, read the Reassign a Writable Volume to a Computer section in the
VMware App Volumes 2.18 Admin Guide.
You can access the VMware App Volumes 2.18 Admin Guide at VMware Docs.
Prerequisites
If you have decided to disable the 2.x-related UI features, ensure the following:
n You have migrated AppStacks and Writable Volumes (2.x) to the latest version of App
Volumes template format.
Procedure
VMware, Inc. 21
VMware App Volumes Installation Guide
3 To disable the VOLUMES (2.X) tab and other 2.x-related information, click the Enable
Volumes (2.x) toggle switch.
VOLUMES (2.X) tab and other 2.x-related features are disabled from the UI.
You can also upgrade the agent silently. See Upgrade App Volumes Agent Silently.
Prerequisites
n Schedule a maintenance window to ensure that there is no service degradation during the
uninstall and subsequent upgrade process.
n Upgrade the App Volumes Manager. See Upgrade App Volumes Manager.
n Unassign all AppStacks and writable volumes from the target computer where you plan to
upgrade the agent.
n If you are using App Volumes Agent earlier than 2.18, you must first upgrade to App Volumes
Agent 2.18 or later.
Procedure
1 Log in as administrator on the machine where the App Volumes agent is installed.
2 Locate the App Volumes installer you have downloaded and run the setup.msi file.
3 Select the App Volumes agent component in the Installer window and click Install.
You perform a silent upgrade using the command line and you do not need to use the App
Volumes installer.
For App Volumes agent to validate the App Volumes Manager certificate, you can use the
EnforceSSLCertificateValidation parameter.
VMware, Inc. 22
VMware App Volumes Installation Guide
Prerequisites
n Schedule a maintenance window to ensure that there is no service degradation during the
uninstall and subsequent upgrade process.
n Upgrade the App Volumes Manager. See Upgrade App Volumes Manager.
n Unassign all AppStacks from the target computer where you plan to upgrade the agent.
Procedure
2 In the command prompt, access the App Volumes Agent.msi file location.
Option Description
VMware, Inc. 23