Running Setup

The software product comes normally as a self-extracting archive file that contains the package installation files.

The installation procedure consists of two steps:

1. Extracting the package installation files into a temporary distributive directory



2. Running Setup from the distributive directory.

You can run Setup manually in the default mode or use the "silent" installation mode of Setup to simplify multiple secondary installations.

Extracting Package Installation Files

This section describes how to extract the package installation files from the self-extracting file (compressed and created by WinZip).

To extract the package installation files, you should do the following:

1. Download the self-extracting archive file to your hard disk



2. Execute the file and select OK.

In the dialog box that appears, you can enter a name for a temporary distributive directory in the Unzip to folder edit field or use the Browse button to select it. By default, the installation files will be extracted to the distributive directory shown in the field.

Later (after successful installation), you can remove the temporary distributive directory or use it to start Setup for multiple secondary installations.

3. Choose Unzip to start extracting the files and then installing the package automatically. The archive file will be uncompressed and the installation files will be placed in the specified distributive directory.



4. After extracting the package installation files, choose OK in the following box:

The installation procedure (i.e. running Setup) will start automatically from the temporary distributive directory if you enable the When done unzipping open: .\setup.exe check box.

Running Setup

As soon as you start the installation process, you will see a number of dialog boxes with instructions for each installation step. These boxes have three buttons. The Cancel button quits the installation process. The Back button returns you to the previous step. When you press the Next button, the Setup program proceeds to the next installation step.

At any step of installation, you can use the Cancel button. The Exit Setup window appears.

You can confirm exiting or choose to continue installing.

For the first installation of the package, the procedure steps are as follows (with the dialog's names):

Welcome

At this step, it is strongly recommended that you exit all MS Windows programs before running Setup.

Software License Agreement

At this step, you must choose whether you accept all the terms of the Software License Agreement shown within the window or not before running Setup.

User Information

In this box, you should enter the Person name, the Company name, and the product serial number (for registration purposes).

Choose Destination Location

In this box, you should specify the folder where the package will be installed in (i.e. the home directory for the package). You can use the default folder name, enter your destination folder name, or select another folder using the Browse button.

To install to the specified folder, click Next. If the folder does not exist, Setup will create it. If Setup detects the package in the directory you specified, then it will prompt you to upgrade the package. (See section Upgrading WinaXe Plus below.)

Setup Type

At this step, you can choose components of the package you want Setup to install.

There are three Setup types: Typical, Compact, and Custom.

For the Typical type, Setup installs all the components of the package (the most common options).

For the Compact type, Setup installs the package without On-Line Help Files (the minimum required options).

For the Custom type, the Select Components dialog box appears on your display. Choose components that you wish to install (clicking on the checkmark positions).

At the bottom of the window, you can see how much Space Required will be used to install the components you choose and Space Available on your disk.

Select Program Folder

At this step, you should specify the Program Folder to contain shortcuts for the components being installed. In the Select Program Folder dialog box, you can use the default folder name, enter a new folder name, or select another folder from within the Existing Folders list.

Setup will add program icons to the Program Folder specified.

Setup

With the data specified, Setup begins to install the package. It shows how files of the components are being installed into the destination directory. Finally, Setup creates the WinaXe Plus Program folder with shortcuts for the package components. It also adds the WinaXe Plus item to the Programs menu.

Setup complete

At this step, Setup informs you that the package is ready to run. In the Setup complete dialog box, click Finish to complete Setup.

You may run the installed programs by clicking program's icons from the WinaXe Plus Programs' folder.

The Silent Installation Mode

The "silent" installation mode of Setup may be used for multiple secondary installations on different computers working with similar package installation environment (i.e. drive letters, installation directory name, presence of the package, etc).

The "silent" installation process consists of the following two steps:

1. Normal first installing of the package with creating a script file
   
   
2. Using the script file for multiple secondary installations.

1) To install the package with creating the script file, setup.iss, run Setup with the options:

setup -r -f1PATH\setup.iss

The -f1 option enables you to specify an alternative file location and script file name. It is recommended to specify the absolute PATH for the option.

With these arguments, Setup performs normal installation of the package and creates the script file you specified in the command in the directory according to the specified PATH. The file contains data you specified for Setup to install the package. (See section Running Setup above.)

Setup performs secondary installations using the script file, so you have to specify no input data (you only watch "silently" how Setup works automatically).

2) To perform secondary installation, make sure that the script file created at the first step is located in the distributive directory (where the setup.exe file exists). If not, then copy the script file to the distributive directory, and then run Setup with the following command line:

setup -s -wauto

With this argument (and without the -f1 option), Setup will install the package according to the setup.iss script file. Setup will search for the file in the distributive directory.

Also, you can use the following command line to perform secondary installation:

setup -s

This is the same as the "-wauto" option with the only difference: the Finish dialog message is suppressed in this case.

When running an InstallScript MSI or InstallScript installation in silent mode (i.e., using the -s option), the log file, setup.log, is by default created in the same directory and with the same name (except for the extension) as the response file. The -f2 option enables you to specify an alternative file location and log file name. It is recommended to specify the absolute path for the option as in the following example:

.\PackInstall\Setup.exe -s -f1C:\PackInstall\Setup.iss -f2C:\PackInstall\Setup.log

After Setup has finished (successfully or not) you can find the ASCII tracing file, mkltrace.out, in the distributive directory and look it through for error messages. Note that the "silent" installation may require interactive actions if Setup detects serious problems.

Installation Notes

LPR printer driver

The LPR printer driver for MS Windows NT4 is manually installed by running the self-extracting archive file, lprd.exe. This file can be found in the distributive directory with uncompressed package installation files.

NFS-Client for MS Windows 9x/ME

NFS-Client for MS Windows 9x/ME can be installed manually after installation of the main package. You can do this from the XWPNFS32.W95 subdirectory in the home directory (see the XWPNFS32.W95\readme file for more information). NFS-Client should only be installed using the Custom installation type of Setup. You must restart your PC after installation of NFS-Client to activate its driver. Also, you must restart your PC after you change the license file, xwpdllid.dll.

To install NFS-Client for MS Windows 9x/ME:

1. Copy the files from the XWPNFS32.W95 subdirectory in the home directory into a separate directory on your floppy or hard disk
   
   
2. On the DESKTOP, choose My Computer, Control Panel, and Network; then click on the Add button
   
   
3. Select Client and press Add
   
   
4. From within the Select Network Client window, press the Have disk button
   
   
5. In the Install From Disk window, specify the full path defined in step 1 and press OK
   
   
6. From within the Select Network Client window, select XWPNFS32 Client for NFS Networks and press OK to start installing.

The XWPNFS32 Client installation will result in including the XWPNFS32 Client for NFS Networks into the list of network components installed on your system. To finish installation, press OK.

NFS-Client for MS Windows NT4/2000/XP

NFS-Client for MS Windows NT4/2000/XP can only be installed by using the Custom installation type of Setup. You must restart your PC after installation of NFS-Client to activate its driver.

Exporting XServer's Settings During Installation

You can port XServer's settings on other PCs by creating and using the xsetup.ini file as follows:

1. Install the package and save its distributive directory
   
   
2. Make desired XServer's settings (resulting in the "[XSETUP]" section in the xwp.ini file under the home directory)
   
   
3. Copy the "[XSETUP]" section from the xwp.ini file into the xsetup.ini file except line "FontPath"
   
   
4. Put the xsetup.ini file into the distributive directory of the package
   
   
5. Use your new distributive directory (with the xsetup.ini file) as a distributive directory for the secondary "silent" installations on other PCs. The resulting home directory of the package will contain the xwp.ini file with your "[XSETUP]" section in it.

NFS-Client

The Installation procedure (Setup) can read in a file you prepared beforehand to contain your settings for NFS-Client. The file must have the nfsclnt.cpr name and locate in the package distributive directory (where the setup.exe file is located). The settings will be placed in the xwp.ini file. This is especially useful for "silent" installations.

Telnet

The Installation procedure (Setup) can read in a file you prepared beforehand to contain your settings for Telnet. The file must have the prosets.ini name and locate in the package distributive directory (where the setup.exe file is located). The settings will be placed in the xwp.ini file. This is especially useful for "silent" installations.