Customizing UTBackup Client Installers

Customizing UTBackup Client Installers

 

Information

How Customizing Works - A Process Overview

This is a high level overview of what customizing and creating an installer involves. The detailed steps for each platform are explained after the overview.

Customizing the PRO Client involves:

  1. Downloading the installer files for your version and your platform

  2. Opening and copying installer resources

  3. Editing the installer files

  4. Preparing the installers for distribution, see Creating Installers


Preparing to Edit Installer Files





Editing Installer Files

Specifying Default Settings

In the in the Custom/conf/default.service.xml file you can build the following information into the installer:

  • PRO Server host name

  • Default organization

  • Username for whom software is being installed

  • Password for user

Property

Description

Property

Description

config.servicePeerConfig.authority

By supplying the address, registrationKey, username and password, the user will bypass the registration / login screen. The following tables describe authority attributes that you can specify and their corresponding parameters.

Authority Attributes

Attributes

Description

Attributes

Description

address

the primary address and port to the server that manages the accounts and issues licenses. If you are running multiple PRO Server, enter the address for the Master PRO Server.

secondaryAddress

(optional) the secondary address and port to the authority that manages the accounts and issues licenses. Note: This is an advanced setting. Use only if you are familiar with its use and results.

registrationKey

a valid Registration Key for an organization within your Master PRO Server. Hides the Registration Key field on the register screen if a value is given.

username

the username to use when authorizing the computer, can use params listed below

password

the password used when authorizing the computer, can use params listed below

hideAddress

(true/false) do not prompt or allow user to change the address (default is false)

locked

(true/false) allow user to change the server address on the Settings > Account page. (do not set if hideAddress=“true”)

Authority Parameters

Parameter

Description

Parameter

Description

\${username}

determined from the CP_USER_NAME command-line argument, the CP_USER_NAME environment variable, or “user.name” Java system property from the user interface once it launches.

${computername}

system computer name

${generated}

random 8 characters, typically used for password

${uniqueId}

GUID

${deferred}

for LDAP and Auto register only! This allows clients to register without manually entering a password and requiring user to login to desktop the first time.

servicePeerConfig.listenForBackup

Set to false to turn off the inbound backup listener by default.

Sample Usage


All of these samples are for larger installations where you know the address of the PRO Server and want to specify a Registration Key for your users.

Please note that NONE of these schemes require you to create the user accounts on your PRO Server ahead of time.

Random Password


Your users will end up with a random 8-character password. In order to access their account they will have to use the Reset My Password feature OR have their password reset by an admin.

default.service.xml <authority address="192.168.0.1:4282" registrationKey="AAAA-BBBB-CCCC-DDDD"
username="$

{username}@acme.org" password="${generated}"/>