The VPortPro 2.3/Release:20070119 Installation
Date: 12 February 2007
The software product comes normally as a self-extracting archive file that contains the package installation files.
The installation procedure consists of two steps:
- Extracting the package installation files into a temporary distributive directory
- 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:
- Download vpoplabp.exe (self extracting file) to your hard disk
- Execute vpoplabp.exe 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 c:\vpoplabp.src.
Later (after successful installation), you can remove the temporary distributive directory or use it to start Setup for multiple secondary installations.
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.
- 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.
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.
For the first installation of the package, the procedure steps are as follows (with the dialog's names):
At this step, it is strongly recommended that you exit all MS Windows programs before running Setup.
2. 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.
3. User Information
In this box, you should enter the Person name, the Company name, and the product serial number (for registration purposes).
4. 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 VPortPro below.)
5. 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.
6. 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.
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 VPortPro Program folder with shortcuts for the package components. It also adds the VPortPro item to the Programs menu.
8. 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.
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.
The VPortPro Programs' Folder
You may run the installed programs by clicking program's icons from the VPortPro Programs' folder.
The COM Port Redirector item brings up the COM Port Redirector window where you can manage a connection channels list, make settings for virtual serial ports and TCP/IP ports, and control activity of a selected connection channel. (Refer to chapter COM Port Redirector.)
The ComSetup item brings up the Communication Setup / Windows Sockets dialog box where you can make communication settings relating to the networking aspects of VPortPro that operate with the TCP/IP transport interface. (Refer to section Using ComSetup in chapter Configuring VPortPro.)
The Export Settings item is used to save all the settings made on the COM-TCP/IP connection channel list in the VCOM-TCP Primary Client and COM Port Redirector windows into the vppini.dat file. (Refer to chapter Export Settings.)
The On-Line Help item displays this manual.
The ReadmeFile item displays the Readme file (placed in the installation folder) that contains the latest information and product notes about the VPortPro package.
The Uninstall VPortPro item is used to uninstall the VPortPro package from your computer. (Refer to section Running UNINSTALL in chapter Installing VPortPro.)
The VCOM-TCP Primary Client item brings up the VCOM-TCP Primary Client window where you can manage a connection channels list, make settings for virtual serial ports and TCP/IP ports, and control activity of a selected connection channel in the Client mode. (Refer to chapter VCOM-TCP Primary Client.)
The XwpPeg item launches the XwpPeg utility that checks and displays the state of the package license accounts. (Refer to subsection The XwpPeg Utility in section Using ComSetup in chapter Configuring VPortPro.)
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:
- Normal first installing of the package and creating a script file
- Using the script file for multiple secondary installations.
To create a "silent installation" script file, run Setup with the two options:
setup -r -f1PATH\setup.iss
PATH specifies the path to a directory that will contain the setup.iss file (e.g., C:\aaa\bbb or C: or simply .).
With these arguments, Setup performs normal installation of the package and creates the setup.iss script file (i.e. the 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 setup.iss script file, so you have to specify no input data (you only watch "silently" how Setup works automatically).
To perform secondary installation, make sure that the setup.iss file you have created at the first step is in the distributive directory (where the setup.exe file exists; if not, then copy the setup.iss file to the distributive directory) and run Setup with the following command line:
setup -s -wauto
With this argument, 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:
This is the same as the "-wauto" option with the only difference: the Finish dialog message is suppressed in this case.
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.