Customizing the Installation Process. AccuSoft 7

PDF

Document

268 AccuTerm 7 Help

CSI

OSC

APC

ASCII 7-bit control char

SS3

DCS

PU1

PU2

STS

CCH

SPA

EPA

Decimal Hex

150

151

152

153

154

155

156

157

158

159

143

144

145

146

147

148

149

Key

ESC

[

ESC

3.7 Customizing the Installation Process

The AccuTerm 7 installation process can be customized in several ways: default values can be supplied for any of the installation wizard prompts, the installer can run in "silent mode", you can supply your own files to be installed along with the AccuTerm 7 program files, and the MSI can be extracted to facilitate deployment using Active Directory and Group Policy.

The AccuTerm 7 installer is distributed as a single EXE file. The installer can be placed in any folder that is accessible to the user's PC: local hard drive, portable drive such as a USB drive, network share, CD-

ROM, etc. The EXE wraps an MSI install file and launches the MSI installer (msiexec) with appropriate options based on the install type selected.

Supplying default values for installation prompts

To supply default values for installation prompts, you need to create a text file called 'setup.ini' and place it in the same directory that the AccuTerm 7 installation EXE file resides. A sample 'setup.ini' file is shown below:

; Custom setup for AccuTerm 7.1

;

; Use atw71.exe /silent or /verysilent for a "quiet" unattended installation

;

; Items which can be defined:

[Defaults]

;MAINDIR=Program Files\Atwin71

;HOMEDIR=My Documents

;DESKTOPSHORTCUT=Y

;ALLUSERS=Y

AccuTerm 7 Reference 269

;ACTIVATIONCODE=123456789-123456789

;AUTOACTIVATE=Y

;AUTOUPGRADE=Y or N or numeric value (see help)

;CUSTOMFEATURECODE=xxxx

;NAME=your name

;COMPANY=your company

;ADDRESS=your address

;LOCATION=your location

;CITY=your city

;STATE=your state

;ZIPCODE=zip or postal code

;COUNTRY=your country

;[email protected]

[CustomFiles]

;Main=folder containing extra files copied to the main program directory

;Images=folder containing extra image files copied to the Images sub directory

;Home=folder containing files to copy to the default “home” directory

[CustomShortcut]

;Name=name of shortcut

;Target=path to .exe, .atcf, .atly or .atsc file (can use %HOMEDIR% or %

MAINDIR% prefix for path)

;Icon=path to file containing icon (can use %HOMEDIR% or %MAINDIR% prefix for path)

;Index=n (index of icon, if icon is contained in an exe file with multiple icons)

;State=n (initial window state: 1=normal, 2=minimized, 3=maximized)

To use the 'setup.ini' sample shown above, remove the leading ';' from any items you need to define, and enter the value you want to use after the equal sign. Remove the comment text from any lines that you define. Any items that are not defined will use the default for that setting.

The MainDir entry may begin with the text "Program Files" which will be replaced during the installation with the appropriate directory for program files (usually C:\Program Files or C:\Program Files (x86) ).

The HomeDir entry may begin with the text "My Documents" which will be replaced during installation with the public Documents directory (Normal install) or the current user's Documents directory (Personal install). Subdirectories are allowed.

In the [CustomShortcut] section, the Target and Icon entries may begin with the tokens %MAINDIR% and %HOMEDIR%. These tokens will be replaced with the appropriate directory during installation.

The

AUTOUPGRADE

item is used to skip the "AccuTerm 7 Upgrade" dialog that is shown on first use of

AccuTerm 7 when an earlier version of AccuTerm is detected. Set this item to "N" to suppress the dialog and ignore all previous settings and files. Set to "Y" to migrate all possible preferences and files from the earlier AccuTerm version. Set this item to a numeric value (a bit mask) to specify which category of settings or files are to be automatically migrated from the earlier version of AccuTerm. The values for each desired category can be added together to form the bit mask.

1 - migrate user's personal custom menu

2 - migrate application custom menu

4 - migrate settings from the current atwin.ini file

8 - migrate preferences (stored in the HKEY_CURRENT_USER section of the registry)

16 - migrate SSH keys

270 AccuTerm 7 Help

32 - migrate custom settings from the atwin.ini file

64 - migrate session files from program directory to home directory

128 - migrate the phone book

256 - migrate cfg, lyt, atcf, atly, script and image files found in the old program directory

Unattended Installation

The AccuTerm 7 installer uses command-line options to perform an unattended installation. The "/

SILENT" command-line option bypasses all of the installation prompts, but does display a progress bar during installation: atw71a.exe /SILENT

The "/VERYSILENT" command-line option bypasses all of the prompts and does not display the progress bar: atw71a.exe /VERYSILENT

Installing user-supplied files

The AccuTerm 7 Installer can install user supplied files after installing the AccuTerm program files. To install user supplied files, create a sub-directory below the directory where the installation EXE resides called 'VARFILES'.

To copy user supplied files to the AccuTerm program directory, create a sub-directory under VARFILES called 'MAIN'. Place any files that need to be copied to the AccuTerm program directory in this directory.

Add the entry "Main=VARFILES\MAIN" in the [CustomFiles] section of setup.ini.

To copy user supplied image files to the AccuTerm program Images sub-directory, create a sub-directory under VARFILES called 'IMAGES' and place the image files in this sub-directory. Add the entry

"Images=VARFILES\IMAGES" in the [CustomFiles] section of setup.ini.

To copy user supplied files to the user's "home" directory (the directory where the session files are saved), create a sub-directory under VARFILES called 'HOME'. Place files to copy to the "home" directory in this directory. Add the entry "Home=VARFILES\HOME" in the [CustomFiles] section of setup.ini.

Note: in prior versions of AccuTerm, the VARFILES directory could contain a directory tree to copy to the program or home directories. Directory trees are no longer supported. Only individual files can be copied. Also, prior versions of AccuTerm allowed a user-specified secondary installation program to be executed during the install process. This is no longer supported.

Installing a pre-configured version of AccuTerm

It is possible to create a custom installation package that installs a pre-configured version of AccuTerm.

AccuTerm's initial state is defined by settings stored in the 'atwin71.ini' file in the AccuTerm program directory. Custom master menu/toolbar is defined by the 'menu71.ini' file in the AccuTerm program directory. Session settings are stored in session configuration files (.atcf files), stored in the user's (or public) "home" directory. By taking advantage of the ability of the AccuTerm installer to install user supplied files (see above) you can create a pre-configured installation package.

Here is a sample atwin71.ini file to use as a basis for your custom settings:

AccuTerm 7 Reference 271

[Atwin]

Version=7.1

[Options]

ToolBar=True

StatusLine=True

SessionBar=True

SingleInstance=True

AutoClose=False

NoCloseWarning=False

NoConnectWizard=False

NoWelcomePage=False

LargeIcons=False

TrackKeyboardState=False

FuncBar=False

FuncBarStyle=0

FuncBarPos=0

TitleFormat=4

RecentListSize=4

[Path]

Capture=""

[Xfer]

DefaultDir=""

[Custom]

Icon=""

Title=""

Splash=""

Most of the 'atwin71.ini' settings are obvious. For those values which are not True/False, please refer to the property of the same name in the AccuTerm object. The [Custom] Icon and Splash settings are file names. These files are usually stored in the AccuTerm program directory - in that case you do not need to include a full path. You can disable the splash screen by setting Splash=No.

Extracting the MSI file from the EXE installation file

To extract the MSI file from the EXE installer, run the EXE with the /EXTRACTMSI command line option: atw71a.exe /EXTRACTMSI

The EXE installer will prompt for a target directory where the MSI file will be stored.

Installing AccuTerm directly using MSI

Once the MSI file has been extracted from the EXE, you can use the msiexec command to install directly from the MSI file. You may specify certain MSI properties on the msiexec command line.

Common properties are INSTALLDIR, ALLUSERS, and MSIINSTALLPERUSER. In order to use setup.ini

as described above, specify the SETUPINI property on the command line (the value is the name of the setup.ini file). For example: msiexec /i atwin71.msi /ALLUSERS="1" /SETUPINI="setup.ini"

272 AccuTerm 7 Help

Top Level Intro

This page is printed before a new top-level chapter starts

Part