ICE.TCP Pro Installation Notes

Important Note:  These instructions for installation supersede the instructions in the printed manual. For early users of ICE.TCP Pro, these installation instructions are significantly different. Please read carefully.

Overview of the Install Procedure

ICE.TCP Pro provides a new network install procedure as well as improved installation for machines not on a Windows network. The network install enables you to deliver pre-configured installations to your client PCs. It also provides centralized information about the PCs on which the software is installed.

There are two components to the ICE.TCP Pro installation: Server Install and User Install. One Windows 200x/XP/Vista/Windows 7 machine on your network must be used as the "Server" (see definition below). PCs that require ICE.TCP Pro can install it over the network from this Server PC. Alternatively, they may install from the CD and configure from the Server PC or from removable media (see Advanced/Remote Installation below).

The administrator performs the Server Install on a Windows 200x/XP/Vista/Windows 7 machine from the ICE.TCP Pro CD. After installation, a valid license key must be entered into the LicenseAdmin program. User installs can then be performed on the Server PC and the other machines on your network.

If you perform a user install on the Server PC, you can customize our program for your network and save those settings as the defaults for all subsequent user installs. The remainder of this document gives step-by-step details of how to install ICE.TCP Pro.

Server Installation
Definition: The "Server", also referred to as the "Admin PC”, is a Windows 200x/XP/Vista/WIndows 7 machine on your network, which can share ICE.TCP Pro files with the "User" PCs on which you will install the end-user copies of ICE.TCP Pro. It is a "software" server on a shared drive, and NOT a hardware or UNIX server. License and other configuration information are centrally managed on this server.

Step 1: Obtain a License Key (Activation Key)

In order to use ICE.TCP Pro, you must obtain a license key, also called an activation key. This key can be obtained from our web page at http://portage.jriver.com or by fax.  Please refer to the document "Activation Instructions" that is shipped with your CD. The serial number that is required to obtain an activation key can be found on the License Certificate included with the CD.  Once the registration form is submitted, an activation key will be e-mailed to you at the address you provide.

Step 2: Perform the Server Install (Any Windows 200x/XP/Vista/Windows 7 machine accessible to other network users can be used as the ICE.TCP Pro Server.)

When you insert the ICE.TCP Pro CD, the autorun feature (if enabled on your CD drive) will start and may take up to 30 seconds. Alternatively, you may start it from Windows by choosing Start, Run, and then [CD-ROM drive letter]:\Setup.

Choose Server Install and accept the defaults. This sets up folders and copies files to the ICE.TCP Pro Server.

The Server Install procedure provides optional components (Internet Explorer and Adobe Acrobat). If you select these optional components, these programs are placed in the \Program Files\J River\ICETCP5 Server\TCP5_User directory from where they can be installed on other PCs.

Note:  A web browser is required to access the online help of ICE.TCP Pro. Internet Explorer 7 is the latest version of Microsoft’s web browser. Adobe Acrobat allows you to access files that are in PDF format. We include both PDF and HTML versions of our manual with each user installation of ICE.TCP Pro.

When the ICE.TCP Pro Server software is installed, two folders are created: TCP5 Admin, containing administrative programs (LicenseAdmin and IPAdmin), and TCP5_User, containing the folders and files needed for installation on client PCs.

Step 3: Enter Licensing Information

Using the Windows 200x/XP/Vista/Winows 7 Start command, go to (All) Programs, ICE.TCP Admin, and select LicenseAdmin. In the LicenseAdmin dialog box, enter the name of your organization, using the exact name as it appears in the e-mail or fax that you received from J. River, Inc.  Next, enter the Activation Key (also called the License Key) provided by J. River, Inc. exactly as it appears, using the same combination of uppercase and lowercase letters (Note: there are never any numbers in the Activation Key). The spaces and dash are not optional. Click OK to save. LicenseAdmin can be used later to add additional Activation Keys or to view user information for those PCs that have installed ICE.TCP Pro.

Step 4: Configure IPAdmin (Optional, for 16 bit installs only) -- If the PC's on your network already have TCP/IP configured, you may go to Step 5.

IPAdmin is an optional program that provides a way of automating the configuration of Microsoft TCP/IP and centrally managing the network's addressing.

If the client PC’s on your network already have TCP/IP configured, and you do not wish to centrally manage the addresses, you may choose not to use IPAdmin.

To run IPAdmin use the Windows Start command, go to Programs /ICE.TCP Admin and select IPAdmin. IPAdmin lets you configure the following network information: Domain Name, Subnet Mask, Low-Range IP Address, High-Range IP Address, Name Servers, WIN Servers, Gateways, and Reserved IP Addresses.

Be sure to reserve IP addresses currently in use on UNIX servers and other servers or addresses in use by users who dial in to the network with Slip or PPP connections, or addresses used by any other computers that will not be running ICE.TCP Pro. If you do not reserve the addresses, Windows PC's that install ICE.TCP Pro will use them.

For multiple subnets, use the Save As button to save network information for each subnet in a different file. As each user runs ConfigWizard, they must select the file that applies to their subnet. After configuring and saving network information, exit the IPAdmin Program.

Step 5: Perform a User Install on the Server PC

Run Setup.exe from the \Program Files\J River\ICETCP5 Server\TCP5_User directory. Setup will provide the option of installing either Telnet Pro version 5.1 or the DejaWinT version 4.4.  By default, Setup installs the ICE.TCP programs in the C:\Program Files\J River\ICETCP5 directory, and then automatically runs the configuration program ConfigWizard. ConfigWizard performs the following functions:

• Obtains a sequence number (user license) from LicenseAdmin
• Selects a default configuration profile
• Allows you to configure TCP/IP using the settings from IPAdmin

Checkboxes are provided to activate or deactivate each task. For this initial user install, the first two options must be selected. Select Configure Microsoft TCP/IP only if you chose the optional Configure IPAdmin in Step 4. Next, select the defaults for the following screens. You must select the profile labeled default to complete the installation. (Note: Versions older than 5.1.27 require an entry in the Comments field.)  Reboot the computer when prompted to do so.

Step 6: Customize ICE.TCP Pro for the Users on your Network

Open Telnet Pro and select organize profiles from the profiles menu. Use the add button to make a new profile. Double-click on the new profile and modify the terminal type, color combinations, and other options that are required on you network. Click OK to save the profile.

Next, click on Save to File. This customized file will be used during all subsequent installs. Give it an appropriate name (such as Sales, Marketing or Operations) and save it in \Program Files\J River\ICETCP5 Server\TCP5_User\Data\. The files that are located in this directory are the configuration profile options that will be presented as options in ConfigWizard for all subsequent user installs. You may save multiple profiles with different names.

Step 7: Share the TCP5_User Folder

To make the TCP5_User folder accessible for network client installation, it must be shared. In the Windows Explorer, find the TCP5_User folder — the default location is C:\Program Files\JRiver\ICETCP5 Server\TCP5_User — and right click on it. In the pop-up menu, select Sharing (and Security), which displays a properties dialog box for configuring a shared folder.

Click on the Shared As radiobutton to share the directory, or select “Share this folder on the network”. Use the default Share Name, TCP5_User that is assigned to the directory. The Shared Name is the name other network users will see when they access the directory during the network client install procedure. For the Access Type setting, select Full, or Allow network users to change my files. Assign a password for the shared folder. Network users will be required to enter the password when accessing the folder during the network client install procedure. Close the properties dialog box.

When the TCP5_User folder is shared, it displays the name entered in the Share Name field. The User version of ICE.TCP Pro can now be installed on machines on your network by following the user install outlined below.

User Installation - Networking Available
This is recommended for PCs on the same network. Please see the sample user instructions at the end of this document.

Step 1: Install ICE.TCP Pro From the Server PC

Using the Network Neighborhood, Places, or the Find Computer command, double-click on the icon representing the Server PC. Double-click on the folder named TCP5_User.  When the folder opens, run the Setup program.  The Setup program prompts you to select either Version 5.1 Telnet Pro (the preferred choice) or Version 4.4 DejaWinT (Classic).

By default, Setup installs the ICE.TCP programs in either the C:\Program Files\J River\ICETCP5 directory (Version 5.1) or the C:\Program Files\J River\ICETCP4 directory (Version 4.4), and then automatically runs the configuration program ConfigWizard.

Step 2: Configure ICE.TCP Pro using ConfigWizard

ConfigWizard is run automatically at the end of the install. The user must select the first two options available: obtain a sequence number and select a configuration profile. Note:  Versions older than 5.1.27 require an entry in the Comments field.  Reboot the computer when prompted to do so.

If TCP/IP networking already exists, deselect the TCP/IP configuration function in ConfigWizard. A method exists to disable TCP/IP configuration and to automate the use of ConfigWizard. For more information, see www.icetcp.com/support.

Note on Sequence Numbers: ICE.TCP Pro’s administrative programs automatically assign and keep track of sequence numbers for User PCs. ConfigWizard uses LicenseAdmin’s configuration files to obtain an available sequence number.

User Installation - Networking Not Available
This is recommended when Windows networking is unavailable.

Overview of the Install Procedure

The installation procedure described above requires that each user PC has network access to the Server PC. If this is not the case, the following steps illustrate how to install Pro on remote PCs, that is, PCs without network access to the ICE.TCP Pro server.

Step 1: Disable Network Installation Capability

Disable the ICE.TCP Pro server by unsharing the TCP5_User folder.  In this instance, all of your configuration and licensing information will be on the removable media.  This means that you may NOT also use the network installation at the same time or you will duplicate licenses and IP information on multiple PCs.

Step 2: Export License and Configuration (Sequence Numbers) Information from Server.

From the ICE.TCP Pro server, copy the Licenses and Data folders onto removable media.  The default location is C:\Program Files\J River\ICETCP5 Server\TCP5_User.

Also copy ConfigWizard to the removable media.  The default location for version 5.1 Telnet Pro is C:\Program Files\J River\ICETCP5 Server\TCP5_User\TCP-PRO\ConfigWizard.exe; the default location for version 4.4 DejaWinT (Classic) is C:\Program Files\J River\ICETCP5 Server\TCP5_User\TCP4-32\ConfigWizard44.exe.

Step 3: Install ICE.TCP Pro on Remote PCs

Insert the ICE.TCP Pro CD into the CD drive of the remote PC and run the Setup program, located in the User Install Files folder on the CD.  Follow the instructions that appear.  When prompted for the location of the configuration program ConfigWizard, cancel out of ConfigWizard, insert the removable media into the disk drive, specify the removable media drive in the dialog box, and click on ConfigWizard.exe or ConfigWizard44.exe, depending on the version you installed.

ConfigWizard uses LicenseAdmin’s configuration files to obtain an available sequence number from the removable media.  The Name field displays the user’s name.  Additional information, such as phone numbers, can be entered in the Comments field.  Note:  Versions older than 5.1.27 require an entry in the Comments field.

Exit ConfigWizard by clicking the Exit button.  Repeat at each remote machine that needs a sequence number.

Step 4: Import License and Configuration Information Back to the Server

After installations are completed on the remote or non-network PCs, copy the Licenses and Data folders from the removable media back to the ICE.TCP Pro server – \Program Files\J River\ICETCP5 Server\TCP5_User – overwriting the Licenses and Data folders there.  At this point the LicenseAdmin program on the license server machine should show the remote client users (as well as any lan users that were there before).

Step 5: Restore Network Installation Capability

Restore the ability to perform user installations from the ICE.TCP Pro server by sharing the TCP5_User folder, as described in Step 7 of the Server Install instructions.

J. River Technical Support

Should you experience any problems or have questions regarding the ICE.TCP Pro installation procedures, please contact J. River Technical Support at +1.612.677.8200. Information is available in the ice support forums More information may also be available in the tech support section of our web page at www.icetcp.com.

Sample User Install Instructions

The User Install is easy enough that your users may install their own software if you provide them an appropriate version of the instructions below. These instructions may be E-mailed to your users or delivered on paper. Note: The instructions below are a guide -- you must edit them for your specific setup.

Installation from the Server to a PC

1. Quit all running Windows applications.
2. Find the ICE.TCP Pro Server computer named [Windows Computer Name] by performing Start, Find, Computer and entering [Windows Computer Name.]
3. Select [Windows Computer Name] by double clicking on the name. A folder called "TCP5_User" will appear.
4. Double click on the folder to open it.
5. Log in as yourself and use the password "[password]". Note: You may not be asked to do this.
6. Run setup.exe. When asked to choose a profile and group for TCP/IP, choose [enter the appropriate information here based on how you configured your ICE.TCP Pro Server.]