Experienced User Quick Start Notes This file is for experienced users. If you have any questions or require greater detail to complete you Foray PPP Client, please consult the step by step installation guides, LWPINSL.TXT for LAN WorkPlace users or MSINSL.TXT for MS TCP/IP user, or the product manual, 4APPPCLN.DOC. The following sections provide brief overviews of the various hardware and software requirements for installing and configuring your Foray PPP Client package. Foray PPP Client Workstation Requirements The Foray PPP Client requires the following hardware and software on the workstation: * For acceptable performance under Windows, the workstation PC should have at least a 386SX 20MHz CPU and 4 MB of RAM. * The workstation PC must be running MS DOS or PC DOS 5.0 or above. Foray PPP Client does not support alternative operating systems such as DR-DOS. * The command shell must be COMMAND.COM. Foray PPP Client will not run with any other DOS command shell replacements or enhancers like NDOS.COM, 4DOS.COM. * Windows 3.1 or above, or Windows for Workgroups 3.11 or above, must be installed on the workstation PC. * A serial port with a 16550A UART is highly recommended for optimal performance with Foray PPP Client. For internal modems, the serial UART is part of the modem card. To assist you in determining your UART status, we have included a UART diagnostic utility, CHK16550.EXE. Foray PPP Client Modem Requirements * Foray PPP Client will perform best if you use high-speed V.32 V.32bis or V.42 V.42bis modems on both the LAN -based server and the workstation. * Foray PPP Client requires at least a 2400 bps modem with an effective throughput of 2400-4800 bps. This minimum level of performance will not be satisfactory with some applications. Overview of the Installation Process Please review the following overview of the steps involved in the Foray PPP Client installation process. * Determine which of the supported protocols you will be using; IPX, TCP/IP or a combination of the two. * If applicable, ensure you have installed your network stacks and Novell Netware on your workstation. * Run the installation program from the directory in which your Foray PPP Client software is located. * If applicable, install Microsoft TCP/IP, LAN Workplace -- or another supported TCP/IP stack -- on your workstation before you configure and run Foray PPP Client for the first time. Installation Tips: Ensuring Your Network Drivers are Installed In order to properly install the Foray PPP Client, you must also set up the appropriate network drivers. The drivers you use will be determined by the network protocol(s) you intend to support. The Foray PPP Client supports IPX, TCP/IP or a combination of the two. Novell Netware Driver (IPX) * If you have not already done so, you should set up your Novell Netware driver before you proceed with the installing Foray PPP Client. * When you set up Novell Netware, your choice of drivers will be irrelevant. Foray PPP Client will replace the driver you have chosen during its set up process. TCP/IP Stack * If you have not already done so, you should also setup your LAN Workplace stack before you proceed with the installation of Foray PPP Client. * If you are installing the Microsoft TCP/IP stack (instead of using LAN Workplace), you must do it before you proceed with the configuration process outlined in Chapter 3. Microsoft Networking * If you are running Windows for Workgroups and Netware, you must install Novell Netware drivers before you run the Windows Network Setup. * When you run Windows Network Setup, you may see the error message, "Unable to get the ODI Driver Name" during setup. This message occurs when the ODI drivers are not in memory. You can ignore this message. Foray PPP Client will provide the appropriate ODI driver when you run driver set up. Running the Foray PPP Client's Setup Program Foray PPP Client comes with an installation program which will automatically copy its files into a directory. To begin this program, you will need to access it through your Windows Program Manager. * Using the File menu from your Program Manager, choose the Run option. * Run the SETUP.EXE from the drive and directory in which your Foray PPP Client software resides. For example, in the Run dialogue box, you would type the following: C:\TEMP\SETUP.EXE (Hard drive, TEMP directory) or A:SETUP.EXE (Floppy drive) * Select OK. Overview of the Configuration Process The following is an overview which will help you perform tasks in sequence and gather useful information in order to set up your workstation. * Starting the configuration process. The configuration process will begin automatically when you select the Foray PPP Client icon for the first time. The Foray PPP Client Control Panel will automatically initiate the configuration process based on the settings it finds. Before you can proceed, the Control Panel will ask you to verify that your network drivers and your protocol stack(s) are in place. * Setting up your modem. Choose the model, speed and location of your workstation modem from the list which TechSmith provides under Setup/Modem options. * Select the protocol stack your remote workstation will use. This step will initiate automatic changes to your workstation configuration files. * Implement Permanent Virtual Memory Swap. If you are not currently using a Permanent Swap File, the Foray PPP Client setup program will lead you through the steps of creating one in Windows Setup. * System reboot. Reboot your system to implement the changes which Foray PPP Client has made to your configuration files. * Entering information about your workstation. This is where you have the option of entering the workstation name, i.e., "Bill's Laptop". You will also be asked to provide the phone number and name of your dial in server. When all of this information is entered, you can go ahead and make your first dial-up connection using Foray PPP Client. Special Tips for Performing the Modem Setup Prior to setting up your modem, we would like to make the following recommendations. These have been developed as a result of interactive modem testing with the Foray PPP Client software. * Foray PPP Client expects to find your modem on COM port 2. This is done to accommodate the majority of Windows users who have installed their mouse on COM port 1. If your modem is not on COM port 2, Foray PPP Client will not function properly. * If you do not find your modem on the list provided in the Select Modem screen and you are using a Hayes compatible modem, choose the Generic Modem option. * If you do not choose one of the modems from our list, you will need to write your own modem configuration and string. Performing the Modem Setup TechSmith Corporation has tested and developed setup strings for many modems. * A list of those modems is provided in the Foray PPP Client Control Panel program under the Setup/Modem menu option. * If you click on the Select Modem... button on the Modem Setup dialogue box (or press ALT+M), you will see a list of the modems for which TechSmith Technical Support has developed strings. When you select a modem from the list, the strings associated with this modem will appear in the Modem Setup box. Modem Configuration * The modems that appear in the Select Modem dialogue box are those for which TechSmith has developed workstation strings. * If the modem you will be using appears in this list, select it and click on the OK button. * If your modem does not appear in this list, press the Cancel button to return to the Modem Setup box, where you will need to enter your modem name and an init string. * The default dial prefix string is ATDT and the default dial suffix string is ^M. * If your prefix and suffix are different, you will need to enter those as well. In Foray PPP Client workstation modem strings, you can use the following special commands: * A caret followed by the letter M (^M) causes a carriage return, followed by a one second pause. * A tilde (~) causes a one-half second pause. These commands are used for indicating the length of a pause to a device, like a modem. Placed at the end of a modem string, the special characters, ~ and ^M, tell the device how much time it has to respond to a message sent by another device. A one second pause is standard. Only special hardware requirements would warrant the use of a tilde. Refer to the following section, Modem Setup Strings, for information about preparing modem strings for use with the Foray PPP Client workstation software. Modem Setup Strings The Foray PPP Client Control Panel reads the list of modems and associated strings from the EWMODEM.INI file in the PPP Client workstation directory. * If you are using a modem that does not appear in Foray PPP Client Control Panel list or need to customize an existing string, do so in the Modem Setup box of the Foray PPP Client Control Panel. Your customized settings will be saved to the EWUSER.INI file, which contains all of the Foray PPP Client workstation defaults. * Do not edit the EWMODEM.INI file to include additional or custom modem strings. TechSmith replaces this file with an updated version as a part of every future release, and any changes you have made to the file will be lost. If you have problems setting up your modem, contact Technical Support as outlined in the Manual's Preface under Foray PPP Client Technical Support. Typical support issues include: * You have a problem using any of the modem strings supplied for use with Foray PPP Client. * You wish to use a modem which is not listed with Foray PPP Client. Special Tips for Performing the Driver Setup TechSmith would like you to know about special situations which we have discovered in testing before you attempt to configure your Foray PPP Client workstation. The following tips will increase your understanding of software and memory requirements that apply to the Foray PPP Client. * Know your TCP/IP stack. In its first release, Foray PPP Client supports the LAN Workplace and Microsoft TCP/IP stacks. If you are using another stack, you should know your IP address before you start the Driver Setup process. * Preserve Conventional Memory. Before entering Windows, you must have 480K of conventional memory free to use the Foray PPP Client. For information on optimizing your use of workstation memory, please refer to TechSmith's FAQ on Loading High. * Use only the Microsoft Windows communications drivers. Foray PPP Client requires the original Microsoft Windows communications drivers. Some PCMCIA vendors (PC Card vendors) reconfigure Windows to load their own drivers in SYSTEM.INI instead of the Microsoft drivers. In general, these drivers are not 100% compatible with Microsoft's drivers. The Foray PPP Client driver setup process removes those substitute drivers it recognizes, but vendors may release new drivers at any time. If a substitute driver is inadvertently left in, Windows will give a 'Virtual device ID conflict' message at startup. To solve the conflict, you must hand edit your SYSTEM. INI FILE and remove the reference to the PCMCIA driver listed as causing the conflict. Performing the Driver Setup The Foray PPP Client Driver Setup prepares your workstation's configuration files to work with Foray PPP Client. When you perform Driver Setup, it modifies all the network drivers, adapters and protocols. This process, called the driver configuration, will add lines to the contents of your DOS, Windows and network configuration files. The Foray PPP Client will automatically back up these files prior to changing them. The Driver Setup process also makes it possible for other communications programs to use your workstation modifies. TCP/IP Configuration The Driver Setup asks you to specify the type of IP configuration which your TCP/IP stack uses to communicate with your remote server. * From the IP Configuration list provided, choose the TCP/IP stack installed on your workstation. Foray PPP Client has been tested with the LAN Workplace and Microsoft TCP/IP stacks. If you are using any other alternative TCP/IP stack, choose the Other option. If you are not using a TCP/IP stack, choose the None option. * Choose the Automatic option from the Address Assignment box, unless you know that your network administrator has assigned a specific address to your workstation. If you are using an alternative TCP/IP stack, you must obtain a specific IP address (from your network administrator) before you proceed. Advanced Driver Settings The Advanced Driver Settings allow you to change some of the data transfer functions which Foray PPP Client performs automatically. Unless you have specific reason to change these settings, you should not do so. The TCP/IP Compression box allows you turn Van Jacobson Header Compression on or off. * If your workstation is having trouble negotiating with the remote server, it may help to turn Van Jacobson Header Compression off. Doing this will slow your transmission times, but may resolve the issue. * Van Jacobson Header Compression compares packets to a previous transmissions. You can change how many packets are compared by changing the number in the Slots box. The IPX Compression box allows you turn IPX Header Compression on or off. * Again, if your workstation is having trouble negotiating with the remote server, it may help to turn IPX Header Compression off. * IPX Header Compression compares packets to a previous transmissions. You can change how many packets are compared by changing the number in the Slots box. The PPP box specifies the parameters for Point to Point Protocol on your workstation. * The Maximum Receive Unit limits the size of the packet (in bytes) your workstation can receive from the remote server. The default is 1500 Bauds, the size of one Ethernet Packet. * The Character Map limits the type of characters which can be sent to the remote server. Configuration File Changes Based on your choice of protocol stacks, the Foray PPP Client Control Panel will make changes to your workstation configuration files. * Your AUTOEXEC.BAT file will have lines added to it, so that Foray PPP Client specifications can be initiated when you power up your machine. * Your SYSTEM.INI and PROTOCOL.INI files will be reconfigured, so Windows operates effectively with your network setup. * Your NET.CFG file will be changed to suit the network drivers which Foray PPP Client uses. The Foray PPP Client Control Panel will allow you to view these changes and compare the new file Foray PPP Client has created with your old ones, if you wish. Permanent Virtual Swap File If you do not have a permanent swapfile, the Foray PPP Client Control Panel prompts you to create a Permanent Virtual Swap File. Since the Foray PPP Client uses the Permanent Swap File to work with the Windows communication driver, we strongly recommend that you respond by clicking on the Yes option. * If you click on Yes, the Foray PPP Client Control Panel will initiate the Windows Control Panel and take you into the Enhanced memory screen. * In the Enhanced memory screen, click on the Virtual Memory button. * In the Virtual Memory screen, click on the Change button. * The Virtual Memory screen will extend and allow you to select New Swapfile Settings. * From New Swapfile Settings, choose the Drive that you would like to create the swapfile on. This drive (C: is the default) should probably be the one you are installing Foray PPP Client on. * From the New Swapfile Settings, choose Permanent from the Type options. (The default is Temporary.) Click OK. * When the Virtual Memory pop up box asks you to verify the changes to your virtual memory settings, click Yes. * Click OK when you return to the Enhanced memory box. Before you proceed with setting up your User Information, you should reboot your workstation, so the changes to your workstation configuration files can take effect. Special Tips for Entering User Information The Foray PPP Client has the following restrictions with regard to its Phonebook User Information and User Setup utilities. * Use a comma between special digits in your Phone number. If you must put a "9" in front of your phone number to dial-out of a switchboard, you should put a comma between the "9" and the phone number e. g. 9,7638348. * Check the "Allow passwords to be saved in setup file" box. Using the save option will ensure that your password is automatically saved in the Foray PPP Client setup file. * Change your User Setup when you are dialing to a new remote server. You can only input one user name and password in User Setup. If you are dialing into different remote servers which each require a different user name and password, you will need to change your User Setup-- either in the User Setup or the Connection box -- before attempting a connection. Entering User Information Preparing your workstation for connecting to a remote server involves giving it specific user information, i.e., a phone number and user name. Here we guide you through this final stage of setting up your Foray PPP Client workstation. Phonebook Maintenance The Foray PPP Client Control Panel will prompt you to input Phonebook information. Click on the Yes option, and the Control Panel will present the Phonebook Maintenance box. * In the LAN Gateway box you can enter the name of the remote server which you will be dialing-in to. The name you enter is for your reference only. * In the Phone number box, enter the phone number which Foray PPP Client must dial to establish a connection. a company switchboard, these digits can be included in this number. * In the Dial Timeout box, you can specify, in seconds, how long the Foray PPP Client will wait before it terminates a connection if the server does not respond. The default is 60 seconds. * In the Scriptfile box, you can give the name of a Foray PPP Client scriptfile which you would like the Phonebook to use when it negotiates with the remote server. * You can turn on the Automatic dial option by clicking on its checkbox. The Automatic dial option allows you to work off-line until you open a network application. If you have turned on the Automatic dial option, the Foray PPP Client will automatically call the remote server when you open a network application. When you activate an Automatic dial process, the Foray PPP Client will use the number you have entered in the Default LAN Gateway option. * The Default LAN Gateway option allows you to specify a phonebook entry as the default. If you do not indicate which number you would like to dial, Foray PPP Client will use the Default option. User Setup The Foray PPP Client Control Panel will prompt you to input User (Setup) information. Click on the Yes option, and the Control Panel will present the User Setup box. * In the User ID box, you must enter the user identification which allows you to logon to the remote network server. * In the Password box, you must enter the password which you use to logon onto the remote network server. The password itself will not appear in the box. You will only see asterisks (*) indicating how many characters are in the password. * In the User Location box, you can indicate the location you are calling from, so the network administrator knows where your remote workstation is located, i.e. Coastal Office in Los Angeles. This entry is optional. * In the Scriptfile Password box, you can enter the password which you would like a Foray PPP Client Scriptfile to use. If you are not using a scriptfile or a scriptfile which does not require a password, this entry is optional. * The ALLOW PASSWORDS TO BE SAVED IN SETUP FILE option lets you choose whether you want to save your password in a setup file or not. If you choose to have your password saved, you will not have to type it every time you dial-into the remote server. Making Your First Remote Connection with Foray PPP Client When you are finished entering your user information, the Foray PPP Client will present the Connection box which shows all the Phonebook and User Setup information, just as you have typed it in. To make your first connection, click on the Dial button.