Welcome to the Termite TCP If you have any questions please feel free to contact us at: Oregon Research 16200 SW Pacific Hwy, Suite 162 Tigard, OR 97224 Phone: 503-620-4919 Fax: 503-624-2940 E-Mail: orders@orres.com info@orres.com WWW: www.orres.com/~orres QuickStart ********** This quick start assumes that you already have a PPP account with an Internet Service Provider(ISP) that supports PAP automated login and already know the following information: * Your ISP's phone number * Your ISP's DNS IP address * Your User Name and Password If your ISP does not support PAP, then a Login Script will need to be recorderd. The following constitutes the minimum steps to configure and use Termite TCP. * Run Termite TCP from either WorkBench or the Shell. * Open the Connection Settings window from the Settings menu. * Enter the modem initialization string required for your modem * Enter your ISP's phone number in the ISP Phone Number gadget. * Enter the name of your serial device driver and unit number in the Device and Unit string gadgets if they are different from serial.device unit 0. * Select the handshaking mode you want to use. Note that you cannot use RTS/CTS if you only have a seven line serial cable. * Select Use. * Open the NetworkSettings window from the Settings menu. * Enter your ISP's DNS IP address in the Name Server (DNS) gadget. * Enter your ISP's domain name in the Default Domain gadget. * Select Use. * Select PAP Username/Password from the Settings|Login menu * Enter your User Name and Password in the appropriate gadgets. It is important to note that user names and passwords ARE case sensitive. So BiGfIsH is not the same as BIGFISH * Select Use * Select Save Settings from the Settings menu. * Click on Connect button from the Termite TCP main window. Termite TCP will dial your ISP and automatically login. After successful login the PPP driver and the TCP/IP stack will be initialized. On successful initiation of network communications, Termite TCP will display the message Connected in the Termite TCP main window status gadget. * You may now run any Termite TCP client software. AmiTCP clients are only supported in the full version. * To end your Termite TCP session and terminate the network driver click onthe Disconnect button. Using Termite TCP ***************** Your Internet Service Provider ****************************** Before you can begin to use Termite TCP, you must have a dialup PPP account with an Internet Service Provider(ISP). These accounts are available from a wide variety of commercial and non-commercial sources. You should spend some time researching the different providers in your area before opening an account. A good source for locating an ISP in your area is your local newspaper's business section or contacting your local Amiga user group(or any computer user group). The type of account that you acquire and the services provided are entirely up to you and should be based on your individual needs. The options generally include different amounts of connect time per month, different e-mailing options, and the amount of disk space on the ISP's machine that you are allowed to use. The more options you select, the more it will generally cost. You want to be sure that you are actually going to use a given level of service before you sign up. You can always upgrade you account if you find you need more features. However, you can't get money back for services you agree to but don't fully utilize. At a minimum your account must support PPP dialup access. Your ISP may call this a PPP account or an IP account. You must ensure that it is for PPP access and not SLIP. When you obtain your account, you will need to obtain the following information from your ISP: * Your account name * Your account Password * Your e-mail address ( usually AccountName@ISPdomainName) * Your ISP's phone number * Your ISP's Domain Name Server (DNS) IP address * Your ISP's domain name * Your net mask (usually 255.255.255.0) * Any specific instructions or commands that you are required to follow in order to connect to their system using PPP. Including any recommended modem init string settings. Connection Settings ******************* The Connection Settings Window has been broken into two windows with the minimum required information on the basic screen and addtional options accessed through the More button gadget. Init Command This string instructs your modem how to talk to and how to respond to your ISP's modem. Different modems support different features that can be turned on or off and therefore there is no one init command that will work with all modems. Also different modems use different commands to enable or disable the same features. The Hayes command set used to be a standard that all modems used for configuration. However, with the development of new high speed modems with unique features, you can no longer count on every modem supporting the same features or every modem configuring the same features with the same commands. In short, outside of the basic Hayes command set, there is noeffective standard. You will need to ask your ISP if they have any recommended modem configuration or init string commands that you should set. Your modem performance can be significantly influenced by it's configuration. Please refer to your Modem Owners Manual for more information on the available commands for your modem. The following modem options, if available, should either be explicitly specified in the Modem Init String gadget or active in a stored configuration specified by ATZ or ATZ1 or factory default configuration specified by AT&F1 or AT&F2. E1 Tells the modem to echo typed characters V1 Tells the modem to report in verbal codes M1 Turns the modem speaker on &C1 Enables Carrier detection, this option must be on for Termite TCP's auto-reconnect feature to work. &D2 This tells the modem to hang up when we close the serial.device (hang up when DTR is dropped) /N3 guarantees error correction, if available If you have your favorite modem setup stored, then you can enter: ATZ or ATZ1 in the Modem Init String gadget to access these configurations. Factory defualt configurations are accessed using &F commands. Please refer to your Modem Owners Manual for more information on the available commands for your modem. ISP Phone Number This is the number that Termite TCP must dial in order to connect with your Internet Service Provider. If you want to make a direct serial connection, say to a machine running Linix that has a PPP daemon running, then you can leave the phone number blank. When you click on Connect from the status window, you will be asked if you want to make a direct connection. Serial Device This is the name of the serial device you wish to use. If you are using your Amiga's built in serial port, CommodoreĠs standard driver is called serial.device. Some modem vendors include their own drivers, and several third party devices are available. Be aware that not all serial devices are created equal, and some do not offer complete functionality or compatibility. If you have your modem attached to a serial port other than the built in serial port on your Amiga, then you must specify the serial device driver for the serial card you are using. Your serial port card manufacturer will supply you with the proper device name in their documentation. Unit The unit refers to "what serial port do you want to use?" If you are using your Amiga's built in serial port and serial.device, then 0 means use the first available serial port. If you are using a third party serial card, then follow the manufacturers documentation for unit number. Baud This is the speed at which the computer talks to the modem, in bytes-per-second (bps). Note that this is different than the speed of the connection between your modem and your ISP. The baud rate you choose is dependent on your machine configuration. If you have an unaccelerated machine with no fast ram, then you should use 19,200. If you have an accelerated machine with fast ram, then you can probably set your baud rate to 38,400 or possibly 57,600(see important note). If you experience slower than expected performance at a particular baud rate, then you should try switching to the next lower baud rate or reducing the CPU loiad on the machine. It is likely that your machine configuration is not fast enough to handle that data rate along with all of the other things the machine must do(screen io, disk io, TSR tasks, etc.). The slowdown is a result of the machine falling behind in reading the serial port resulting in data drop out. Data drop out causes the PPP packet checksum to fail, which in turn causes the PPP driver to issue a resend request. The host machine then has to resend the data and your machine has to reprocess it. In short, if you operate at a baud rate higher that your machine capability, the machine is doing a lot more work than necessary to get the data under the pretense of speed. You are much better off using a lower baud rate with no serial errors requiring data retransmittal. VERY IMPORTANT NOTE ON BAUD RATE You should not try to use a baud rate of 57,600 unless you have a high speed serial card and/or an extremely fast Amiga(68040 or 68060) and Fast Ram. Very few Amiga's are capable of reliable operation at this rate. Handshaking Handshaking, or flow control is how modems prevent themselves from talking over each other. One modem acknowledges it is ready to receive, and the other modem sends until the first modem says it is no longer accepting data. None means use no handshaking. Communications are generally very reliable, but there is a possibility for error. You should only use this option if: * Your modem does not support hardware handshaking(RTS/CTS) * Your serial cable does not have enough lines to support hardware handshaking. If this is the case we highly recommend that you purchase a serial cable capable of supporting hardware flow control. The first form of handshaking developed was known as Software Flow Control or XON/XOFF. This uses to control characters sent as data for flow control. One side sends an XOFF, and the other side cannot send any more data until it is XONĠed once again. This is an obsolete method of flow control that is slower and more prone to errors than hardware handshaking. Hardware flow control known as RTS/CTS handshaking is only available on high speed modems. They use serial cabling with seven wires instead of three, giving them more control over the communications process. RTS (Ready To Send) and CTS (Clear To Send) are two of these new control lines. If you have a high-speed modem and appropriate cabling, use RTS/CTS handshaking. It is very important that your modem uses the same flow control that you specify here. This is accomplished with the modem's Init string. Refer to your modem manual for the command to turn on your chosen handshaking method. MTU This option specifies the largest number of bytes to be transfered at once. MTU stands for Maximum Transfer Unit. The default size is 1500. Some ISP's will request/require a MTU other than 1500 and this value will be negotiated during login with your ISP. In general the default will yeild the best overall TCP performance. However, there are some circumstances, like an interactive telnet session where large numbers of small packets are exchanged, where a smaller MTU can result in better performance. Verification Interval This new option specifies the time interval that TermiteTCP will test your ISP connection. After the specified number of minutes has elapsed, TermiteTCP will test the connection. If the connection has failed for some reason(phone line dropped, etc.), then TermiteTCP will automatically redial the phone and reconnect to your ISP. Network Settings **************** Without correct network information, Termite TCP will not be able to connect you to the Internet. Your ISP will provide you with all of this information when you sign up for an account. It is important to remember that the periods in IP addresses and net masks ARE important. Name Server (DNS) IP Address This is your ISP's official numeric IP address in the Domain Name System(DNS). It is a set of four numbers separated by periods. Your ISP will give you this number when you obtain your account. This Address MUST be specified. Net Mask This is your ISP's subnet mask for interpreting IP addresses within it's IP network. It sounds complicated, and well..., it is. However, it is nothing that you really need to worry about(except that you need to get it right). For most ISP's this will be 255.255.255.0 but be sure to confirm this. Default Domain This is the "human readable" domain name of your ISP. This is usually expressed in the form of InternetServiceProvider.com Your ISP will provide you with this information. Email Address This is the address that you will use for sending and receiving electronic mail. This is generally in the form of AccountName@InternetServiceProvider.com Your ISP will provide you with this information. Selecting More Options displays the expanded Network Settings Window. This allows access to additional Network settings. These options are generally kept hidden because most users will never have to enter any information into these additional gadgets. To return to the basic Network Settings window select Fewer Options. It is important to note that togging between the two window views acts as an implicit Use on any changes to any options. So, if you select More Options and edit the Local IP Address, then selecting Fewer options accepts your edited value for the local IP address as if you had selected Use. To cancel any edit mistakes, you must select Cancel before switching window views. Local IP Address Most modern ISPs issue accounts with Dynamic IP Addresses. This means that your machine is not "permanently" attached to the Internet and you get a different IP address every time you call in and connect to the network. Users with Dynamic IP Accounts MUST leave the Local IP address as 0.0.0.0 A Local IP Address of 0.0.0.0 tells Termite TCP to negotiate with your ISP for your IP address. This is part of the standard PPP negotiation that occurs when you call your ISP. Some people will accounts with a Static IP Address. This means that your IP address never changes. Even if you have a Static IP address, you usually can leave your Local IP Address as 0.0.0.0 and allow Termite TCP to negotiate your address with your ISP. A very few ISPs issue Static IP accounts and have machines that will not negotiate a local address. If you have difficulty logging in and receive the message Local IP Address 0.0.0.0 in the status window after a Network Login error, then you should enter your Static IP address in the Local IP Address gadget. Remote IP Address You will use this address even less than the Local IP Address. This is used only if the remote machine operated by your ISP will not do ANY address negotiation. This will only occur in very old implementations or very high security systems. If necessary, enter your ISP's IP Address in the Remote IP Address gadget. Note this address is generally different then the Name Server DNS IP Address. A few new PC based ISP's require the remote IP address be something other than 0.0.0.0 at the start of the address negotiation phase. If the message in the status window says LCP: Up and then proceeds to cycle through IPCP: CONFREQ and IPCP: CONFREJ followed by a Termite TCP message saying that we were unable to negotiate with your host, try setting the remote IP address to something other than 0.0.0.0 (1.1.1.1 for example). Alternate DNS IP Address This filed hold the IP address of an alternate Name Server (DNS) machine. This is sometimes useful if your primary Name Server is susceptible to occasional "downtime". Without access to a Name Server, you cannot make connections in by specifying domain names .i.e. you could not telnet to teleport.com you would have to telnet to 192.108.254.64. Not the kind of information everyone keeps handy. If this occurs to you, ask your ISP for the IP address of an alternate Name Server. Login Settings ************** PAP/CHAP User Authentication **************************** Many systems offer(and some require) the use of automated user authentication protocols. TermiteTCP offers support for PAP(User/Password Authentication Protocol also known as UPAP) and the less common CHAP(Crytographic Handshake Authentication Protocol). If available, you should use PAP because your logins will generally be faster using PAP than though a script based login. To use PAP or CHAP, select the PAP Username/Password submenu option from the Settings|Login menu. If using PAP, then enter your user name and password in the PAP UserName and PAP/CHAP Password gadgets. CHAP only requires a password in the PAP/CHAP Password gadget. For security, your password is obscured while you are typing, so please type carefully. Also, remember that usernames and passwords are CaSe SeNsItIvE. Select Use to accept your entries. To connect with PAP/CHAP all you need to do now is click on the Connect gadget of the status window. No login script is required when using PAP or CHAP (except possibly for a delay command after connect) and you do not have to execute the Record Login Script procedure. Recording a Login Script ************************ If your ISP does not support PAP or CHAP logins, then a Login Script will need to be generated. You can manually edit the login script or use the Record Login Script feature to have Termite TCP do it for you. Needless to say, letting the script writer do the work for you is the easiest and recommend option. If you make a mistake you can always go back and edit the resulting login script in the script editor. Record Login Script Based on the configuration information you have entered, Termite TCP will: * Configure your modem based on your specified Init Command * Dial your ISP's phone number * Connect with your ISP's modem and initiate communication If successful communication is established, then a Terminal window will be opened. How you proceed from this point depends on the login procedure requirements for the ISP you have chosen. Most systems will display some system information followed by the prompt login:. Some systems may require you to enter a series of PPP commands or a keystroke to wakeup the system before you are presented with the login: prompt. Your ISP will inform you if you need to take any special action. When you see the login: prompt, type in your account name followed by the return key. You will see a password: prompt asking you to enter your account password. Type in your account password followed by the return key. After your Password has been accepted by your ISP, it will start talking PPP to Termite TCP. The words Packet mode enabled (or something similar) will be displayed followed by a series of seemingly random characters. This means that your system has agreed to talk to Termite TCP in language of networks. The gibberish characters are your ISP sending a configuration request packet to Termite TCP to attempt to negotiate a common set of rules that will be followed. The record login procedure is now complete. Close the terminal window by clicking on the close window gadget in the upper left corner of the window. Termite TCP will now hang up the modem, close the window, and display the Edit Login Script window. Login Script Editor This allows you to fine tune the information recorded during your login and allows you to remove any typing errors from the script. Or you may also choose to enter your login script by hand or you may want to review and change the information. After reviewing the script and making any changes necessary , click on Use. A login script consists of a series of Wait and Send instructions. A Wait instruction tells Termite TCP to sit and watch the serial port until the listed string is received. When the listed string is received through the serial port, Termite TCP continues to the next line of the login script. You typically use Wait instructions to wait for strings like login: and password: to be received. It is important to note that a Wait instruction is case sensitive and only an exact match will cause the script to continue executing. So waiting for Login: is different than waiting for login: A Send instruction tells Termite TCP to send the listed string to the modem. You will typically use Send commands to send your Account Name and Password. The carriage return you type to send your account name or password is implied and you do not have to explicitly enter it in the Send instruction. Special commands recognized by the Send command are useful for ISP's that require special characters to be sent to wake up the service. CR This will cause a single carriage return to be sent. CONTROL-C This will cause a the Control-C to be sent. ESCAPE This will cause the Escape to be sent. To change a line from a Wait to a Send(or vice versa), click on the cycle gadget for that line. Termite TCP continues to Wait for strings or Send strings until the first blank line in the script is encountered. Presumably all of the actions necessary to login have been executed before the first blank line and you have successfully logged into to your Internet account. Some ISPs are slow in responding to certain actions. The DELAY command is prevents login script commands from executing too quickly. For instance, many systems require a slight delay after connection but before a wakeup character is sent. The argument is the number of seconds to delay before executing the next script command. A DELAY 0 command is automatically generated as the first line of the script when using the R ecord Login Script procedure. Save Settings ************* You have now completed all of the steps necessary to connect and automatically log into your Internet account. It is important to save your settings so Termite TCP remembers them the next time you run TermiteTCP. The full version of Termite TCP supports saving mutliple configurations for those with more than one Internet account. Connecting to your ISP ********************** Now that you have completed all of the steps necessary to connect and automatically log into your Internet account. To accomplish this, all you have to do is click on the Connect gadget in the main Termite TCP status window. After you click on Connect, you will see the following messages displayed in the Termite TCP status window: * Setting up modem... while sending the init string to the modem. * Dialing... while dialing your ISP * If your are running a login script you will see Waiting for "string" will be displayed during the execution of each Wait command contained in the login script. * Starting Network Driver... while Termite TCP is initiating the Network driver and negotiating with your ISP on the network protocol options. * Connected. is displayed when the network connection is successfully established. You are now "on the Internet" and ready to use client software. You may abort the connection process at any time by clicking on the close window gadget of the Termite TCP status window. After you have successfully configured Termite TCP remember to use the Save Settings option of the Settings manu to have Termite TCP remember your connection, network, and Login script settings. The next time you run Termite TCP allyou have to do is click on the Connect button and you will automatically be connect to the Internet! Disconnecting from your ISP When you are finished with your Internet session you may disconnect from the network in one of three ways: * Selecting Disconnect from the Termite TCP status window will disconnect you from the network, but leave Termite TCP running. * Closing the Termite TCP status window using the close window gadget will disconnect you from the network and quit Termite TCP. * And finally selecting Quit from the Termite TCP menu will disconnect you from the network, close the status window and exit the program. Status Window Close Window Gadget serves several functions depending on the current state of your network connection. * If you are not connected to the network, then the Connect button will be enabled and the Disconnect button will be disabled. In this case clicking the Close Window Gadget will quit the Termite TCP application. * If you are connected to the network, then the Connect button will be disabled and the Disconnect button will be enabled. In this case clicking the Close Window Gadget will disconnect you from the network and quit the Termite TCP application. * If you are in the process of establishing a network connection, then both the Connect and Disconnect buttons will be disabled. In this case, clicking on the Close Window Gadget will abort the network connection attempt and return the program to a disconnected state. The Status window will not be closed and the program will not terminate. This is useful if it is obvious that something went wrong with the network connection attempt and you do not feel like waiting for Termite TCP connection timer to timeout normally. Other Menu Options Two other menu options of interest are: Selecting About from the Termite TCP menu will display information about the authors. This is also where you should look to find out the version number of the program should you need technical support. Selecting Iconify from the Termite TCP menu will "hide" the Termite TCP application by removing the application menu and status window and replacing it with an i con that resides on your WorkBench. Double click on the icon to restore the menu bar and status window. Tooltype support **************** Tooltype support is included for specifying configuration information via tooltypes specified in the TermiteTCP program icon. To edit the tooltype settings, click on the TermiteTCP icon and select Information from the WorkBench Icon menu. The following Tooltypes are currently recognized: AUTOCONNECT TermiteTCP will automatically connect to your ISP when the program is launched if this tooltype is set to TRUE. AUTOICONIFY TermiteTCP will automatically iconify to your WorkBench after network connection if this tooltype is set to TRUE. NULLMODEM If this tool type is set to TRUE, it will supresses the warning message if you attempt to connect with no phone number entered in the Connection settings. This is useful if you are intentionally making a direct serial connection to a local host via the serial port.