Everything you need to know about Installing the uPerform Editor – Product Manuals

Installation Parameters and Properties

Parameter Name

Usage Example/Description

/s : silent mode

uPerform_AutoUpdate.exe /s /f1"[locationofSetup.iss]"

Running the install executable in silent mode suppresses the initialization dialog and launches any needed pre-requisites in silent mode.

/l : install in different location

uPerform_AutoUpdate.exe /l"[location]"

For example: uPerform_AutoUpdate.exe /l"C:\uPerform"

/allusers : install for multiple users

uPerform_AutoUpdate.exe /l"[location]" /allusers

Use this when implementing with Citrix.

For example: uPerform_AutoUpdate.exe /l"C:\uPerform" /allusers

NOTE: Auto-Update will not automatically update the Editor, only an administrator can update the Editor.

Overview of the Editor Installation

Auto-Update Client enables you to download the Editor installation directly from the Server. When the install is executed, a check is performed to ensure that the required prerequisites are installed on the computer.

NOTE:

For more information, refer to the Technical Specifications.

If a prerequisite is not present on the target computer, the installation extracts the pertinent Microsoft redistributable package to a local source folder and executes the package automatically.

After all prerequisite conditions are met; the Editor Microsoft Installer package is extracted to a temporary folder and executed.

During the Auto-Update installation, any old install files are removed, and a new install directory is created in C:\Users\[username]\AppData\Roaming\[applicationdirectory]\. Any customizations are copied over to this new directory. Two manifest files are created, one on the Server and one on the computer on which the Editor is installed. When the Editor is launched and connected to the Server, the manifest files are compared to determine if there are any available updates to the Editor based on the Server version. If updates are available, you will be prompted to update the Editor or delay the update and work offline.

Installing the Editor Software

Log into the Server to access the Auto-Update installer.

NOTE:

For the initial install, Administrator privileges on the operating system is required.
Click Support on the navigation bar of the Management Center.
Click Download Authoring Client Installer.
Open the uPerform_AutoUpdate.zip file and double-click on the .exe file to begin the installation.
Click Run.

Follow the prompts to complete the installation.

NOTE:

Any old install files are removed. A new install directory is created in C:\Users\[username]\AppData\Roaming\[applicationdirectory]\, and any customizations are copied over to this new directory.

NOTE:

Shortcuts to the Resources folder and to Uninstall are added to the Start menu. If the Editor is installed for all users, only an administrator can uninstall.

Implementing with Citrix

If you are planning to use the application in a Citrix environment, perform the following procedure to ensure a smooth implementation:

NOTE:

In order to optimize recording in a Citrix environment, uPerform and the target application must be presented to the user from the same server and contain the same settings.

1. Install the Editor for all users.
2. Make sure the Server setting to enable client auto-update is not selected.
  
  NOTE:
  
  Refer to Configuring Global Settings.
3. If you need to change the resources directory due to Citrix restrictions, complete the following steps:
  1. Close the Editor.
  2. Locate your current uPerform > Resources directory using the START menu.
  3. Note the templates directory.
    
    NOTE:
    
    The default location is C:\Users\[username]\AppData\Roaming\[applicationdirectory]\version [X.xx]\templates.
  4. Navigate to the client install directory.
    
    NOTE:
    
    The default location is C:\Program Files\[applicationdirectory]\client.
  5. Create a backup copy of the install.config file.
  6. Edit the install.config file to add the new location for the resources directory you want to create. The area to be edited is displayed in bold below:
    (Example using D: drive:
    <?xml version="1.0" encoding=UTF-8?>
    <InstallConfig>
    <BaseAppData>D:\Resources</BaseAppData>
    <CompanyName>ANCILE</CompanyName>
    <Language>en-US</Language>
    <ProductId>XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX-XXXXXX</ProductId>
    </InstallConfig>
  7. Save and close the install.config file.
  8. Start the Editor software.
    
    NOTE:
    
    The new resources directory will display similar to C:\[username]\[applicationdirectory]\version [X.xx].
  9. Right-click on the Editor shortcut and update the Target field with the new location for the resources directory you entered in Step 6.
  10. Copy the templates from the directory you noted in Step 3 into the new resources directory you entered in Step 6.
  NOTE:
  
  These steps will need to be performed after upgrading to a new version of Editor from a previous version that has been configured to work with Citrix.