Deploying an Alchemy Compatibility Package to a User

Save to PDF

Applies to: Alchemy

20/06/2022 Cliff Hobbs   ID: 266741

Use the User option when you need to deploy a Cloudhouse Alchemy Compatibility Package to a specific folder for a single user, which copies all of the files to the specified directory and installs each component.

For example, a physical or virtual desktop/laptop.

Delete

Note

Your source Compatibility Package is not modified when it is deployed.

Prerequisites

To deploy a Compatibility Package to a user, you need:

  • An account with access to the target computer.
  • A valid Licensing Token within the Compatibility Package.

Process to Deploy a Compatibility Package to a User

  1. Start a Command Prompt.
  2. Run the following command:
<path_to_package>\Cloudhouse.Container.Deployment.Exe /deploydir <target_path> /accepteula /deploytype user

where:

  • <path_to_packageis the path to the source Compatibility Package you want to deploy.
  • <target_path> is the path to the folder on the destination computer you want to deploy the Compatibility Package to.
  • <switches> are any optional command-line switches you wish to specify.
Delete

Important

The following command-line switches are required to deploy a Compatibility Package to a User:

  • /deploydir
  • /accepteula
  • /deploytype user

See Alchemy Compatibility Package Deployment Command-Line Options for details of the switches supported for deploying a Compatibility Package.

For example:

C:\Packages\ERP-v2\Cloudhouse.Container.Deployment.Exe /deploydir "C:\Program Files (x86)" /accepteula /deploytype user
Delete

Note

Commands can be run manually, as part of a build script executed by the Administrator, or a 3rd-party electronic software deployment (ESD) tool.

What happens during a User Deployment?

When a Compatibility Package is deployed to a User, the following occur:

  • The application is installed without Administrator rights and the Compatibility Package is registered for only a single user.
  • Any file associations specified in FileAssociations.xml are created in the HKCU registry hive, to be accessible by a single user on the machine.
  • Any shortcuts specified in Shortcuts.xml are registered for a single user on the machine. Any shortcuts with a path pointing to the All Users Desktop are translated to the Users Desktop and any shortcuts with a path pointing to the All Users Start Menu are translated to the Users Start Menu, to be accessible by a single user on the machine.
  • Any Com servers specified in ComDeployment.xml are registered in the HKCU registry hive, to be accessible by only a single user. 
Delete

Note

Any services specified in Services.xml are unable to be registered as this requires Administrator access. This will result in the following log message:
Services have been found but can not be installed in user deployment.

Validation

When a Compatibility Package is deployed in the User context, validations are performed to ensure that:

  • A valid licensing token exists at the top level of the Compatibility Package.
  • The AAV binaries exist in the Compatibility Package and all have the same version.
  • The Compatibility Package binaries exist within the Compatibility Package and all have the same version.
  • All required components exist in the Compatibility package.
  • All XML files are valid.
Source:
Was this article helpful?

Table of Contents

    Can't find what you're looking for?

    Contact Support