This page is a part of VPortPro online Help Manual.
VPortPro-client with Com Port Control by Labtam.
VPortPro makes serial (RS232) data from your PC available on TCP/IP-based networks and makes TCP/IP data available on virtual serial ports of your PC. Visit Home of VPortPro for more information.



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, vpoplabp.exe, to your hard disk

  2. Execute vpoplabp.exe and select OK. The dialog box will appear:

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 distributive directory c:\vpoplabp.src.

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

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

  2. 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 VPortPro 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 VPortPro Program folder with shortcuts for the package components. It also adds the VPortPro 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.


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:

  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.




Home | Product | Download | Order Now | Upgrade | Support | Pricing | Company Information | Contact Us


Labtam Copyright 1999 - 2007 LabtamTM Inc.