home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 17 / amigaformatcd17.iso / -look_here_1st!- / nc_demon_lite / amitcp / readmefirst < prev    next >
Text File  |  1997-06-16  |  13KB  |  334 lines
  1. AmiTCP/IP DialUp 4.5 Demo "Read Me First" File
  2. ==============================================
  3.  
  4. This file contains notes on changes that didn't make to other documentation.
  5. Please read this through if you encounter any problems configuring AmiTCP/IP
  6. DialUp 4.5 Demo.
  7.  
  8. Contents:
  9.  
  10.  1. Summary of new features and improvements
  11.  2. Upgrading from earlier versions
  12.  3. Changes in the AmiTCP/IP setup
  13.     3.1 User information
  14.     3.2 IP provider setup
  15.     3.3 Serial line setup
  16.     3.4 Modem setup
  17.  4. Miscellaneous
  18.     4.1 db/User-Stopnet
  19.     4.2 ifconfig changes
  20.     4.3 Configuring without Domain Name Service
  21.  
  22. 1. Summary of The New Features and Improvements
  23. ===============================================
  24.  
  25.   This is the AmiTCP/IP DialUp Demo Release 4.5 released 28-Jul-96.  
  26.   This release contains new features, minor bug fixes and performance 
  27.   improvements over previous versions.
  28.  
  29.   New features in 4.5:
  30.  
  31.     * New appp.device
  32.  
  33.   Fixed bugs in 4.5:
  34.  
  35.     * BOOTP now works (again)
  36.  
  37.     * Configuration difficulties caused by small buffer sizes fixed
  38.  
  39.     * Maximum MTU raised to 1524 (was 1500).
  40.  
  41.   New features in 4.3:
  42.  
  43.     * Improved and simplified configuration with IP provider profiles
  44.  
  45.     * Direct Dial-Up support with BootPConfig
  46.             
  47.     * New improved SLIP device (aslip.device)
  48.  
  49.     * New API interface with Intelligent Priority Boosting
  50.  
  51.     * Improved Napsaterm Telnet/Rlogin tool, added WB-icons
  52.  
  53.     * Improved command line utilities (bootpconfig, ifconfig)
  54.  
  55.     * Improved Arexx interface
  56.  
  57.     * Default values shown in db/AmiTCP.config
  58.  
  59.     * socket.library for AS225 compatibility
  60.  
  61.  
  62. 2. Upgrading from Earlier Versions
  63. ==================================
  64.  
  65. The `Install AmiTCP' on the installation disk supports upgrading from
  66. earlier AmiTCP/IP versions.  To make use of the new features generally
  67. requires your to reconfigure AmiTCP/IP, though.
  68.  
  69. Although `Install AmiTCP' can copy existing AmiTCP/IP configuration files,
  70. there might be other files (configuration files, program files) that you
  71. have installed on top of the earlier AmiTCP/IP.  These files are NOT copied
  72. over automatically, and you must either copy the files manually, or
  73. reinstall the software in question.
  74.  
  75.  
  76. 3. Changes in The AmiTCP/IP Setup
  77. =================================
  78.  
  79. The way the configuration information is stored has been changed.  The main
  80. motivation has been to allow configuration programs to recognize existing
  81. setup, and provide proper default values to allow configuration changes
  82. without requiring to re-enter *any* value, that does not need to be
  83. changed.
  84.  
  85. Also, the configuration information is divided into several independent
  86. categories:
  87.  
  88.   1) User information
  89.   2) IP provider setup
  90.   3) Serial line setup
  91.   4) Modem setup
  92.  
  93. These are handled in following subsections. 
  94.  
  95. 3.1 User Information
  96. --------------------
  97.  
  98. The default user name is stored in ENVARC:LOGNAME and ENV:LOGNAME.  LOGNAME
  99. variable is also set up by the login command, which means that when startnet
  100. is run, the user will not be changed.  However, the configured default user
  101. is restored when the ENV: is initialized from ENVARC: during a reboot.
  102.  
  103. The `login' command has been changed so that with usage "Login -f" it reads
  104. the user name to login from ENV:LOGNAME.
  105.  
  106. The password setting during configuration has been made optional.  Other user
  107. information (real name, home directory etc.) is asked as before.
  108.  
  109. 3.2 IP Provider Setup
  110. ---------------------
  111.  
  112. This release introduces "Provider profiles".  These files collect all IP
  113. provider specific information into one place.  In other words, switching
  114. providers just means replacing the existing profile with a new one!
  115.  
  116. This release contains few ready made profiles, but you should ask your
  117. provider whether they already have a profile for the AmiTCP/IP.  If they do,
  118. fine, that's all you need.  But if they do not, then you need to create one.
  119.  
  120. The information needed to make the profile is not dependent on the computer
  121. platform, and exact instructions for some other platform will be of great
  122. help in making the profile for the AmiTCP/IP.
  123.  
  124. If you provide the information from your provider, we can help you to
  125. complete the script (via email to AmiTCP-Support@nsdi.fi).  We also intend
  126. to make the scripts available via our WWW service <http://www.nsdi.fi/>.
  127.  
  128. Profiles are stored in directory `AmiTCP:Providers'.  The currently used
  129. profile is stored in `AmiTCP:db/Provider.conf'.  The profiles in
  130. `AmiTCP:Providers' include:
  131.  
  132.   FIN_Kolumbus             - Kolumbus Internet Finland (static SLIP)        
  133.   FIN_PersonalEunet        - Eunet Finland (PPP)
  134.   FIN_TeleInetOpen        - Telecom Finland InetOpen (SLIP, BOOTP)
  135.   GER_T-Online             - German T-Online (dynamic SLIP)
  136.   Other                - Template for DialUp IP providers
  137.  
  138. If the profile does not set the name server information, then they are
  139. stored into `db/resolv.conf' by the configuration program .  This file will 
  140. be overwritten by some provider profiles (see NSDynamic below).
  141.  
  142. The provider profile contains two parts.  The first part starts from the
  143. first line with "/*", and ends with the line starting with "*/".  This part
  144. contains configuration information, which configuration program interprets 
  145. and modifies.  Bootpconfig also uses this information when configuring
  146. AmiTCP/IP.
  147.  
  148. Fields in this section are:
  149.  
  150.     Name        Name for this profile
  151.     DialUp        1 if modem is needed.  This is how configuration 
  152.             program knows to ask modem configuration.
  153.     Interface    Network interface name to be configured
  154.     InterfaceConfig Provider specific Sana2 options.  Appended to serial
  155.             configuration from db/autointerfaces to form a
  156.             Sana2 device configuration file.
  157.             Only provider specific options should be set here.
  158.     NeedSerial    1 if a serial line is needed.  This is how
  159.             configuration program  knows to ask serial line 
  160.             related    options.
  161.     IPDynamic    1 if IP address is dynamic, 0 otherwise
  162.     IPAddr        IP-address if static, leave blank if not known.
  163.             configuration program will ask this if necessary.
  164.             Bootpconfig can ask this at startup time also.
  165.     DestIP        Destination IP address.  This is NOT needed for
  166.             dialup configurations.
  167.     Gateway        Default Gateway address.  This is NOT needed for
  168.             dialup configurations.
  169.     Netmask        Netmask of the interface.  This is NOT needed for
  170.             dialup configurations.
  171.     NSDynamic    1 if name server configuration is dynamic.  In this
  172.             case the dial script should set the name server
  173.             addresses ("Set NS1 x.x.x.x"). 0 otherwise.
  174.             Bootpconfig will create db/resolv.conf and 
  175.             db/netdb-myhost (for compatibility with old email
  176.             programs) at startup time if name server configuration
  177.             is dynamic.
  178.     UseBootP    1 if BOOTP protocol should be used to configure
  179.             dynamic IP address, 0 otherwise.  Your IP provider
  180.             must support BOOTP for you to be able to use it.
  181.     MTU        Maximum transmit unit (in bytes) to use.  The maximum
  182.             receive unit size is set in Sana2 configuration and
  183.             is set to maximum by configuration program.
  184.             0 represents the default maximum value, which should 
  185.             be used on all LAN configurations.
  186.     Phone        Provider phone number(s).  Dial script command "Dial"
  187.             (in AmiTCP:ssrx/Dial.ssrx) will get this through
  188.             bootpconfig.  It is in this section for
  189.             configuration program to be able to configure it.
  190.             Multiple phone numbers are separated with spaces.
  191.  
  192. The rest of the file is used as a dial-up script.  As you see, the script
  193. language is ARexx.  Scripts can contain AmiTCP/IP scripting commands in
  194. addition to normal ARexx commands.  The command set is documented in
  195. AmiTCP documentation.
  196.  
  197. If you use the "Other" profile, then a default manual login script is
  198. appended to your profile.  You can use this script to test the login
  199. procedure, and then automate it when you need what kind of conversation is
  200. needed with the IP provider service.
  201.  
  202. An example provider profile:
  203.  
  204. ---8<---8<---8<---8<--->8--->8--->8--->8---
  205. /* Provider Configuration Follows:
  206. Name        Other        ; Name for this configuration
  207. DialUp        1        ; This configuration needs a modem
  208. Interface    slip        ; Interface name
  209. InterfaceConfig ""        ; Provider specific Sana2 options
  210. NeedSerial    1        ; This configuration needs a serial line
  211. IPDynamic    0         ; 1 = YES, 0 = NO
  212. IPAddr                ; IP-address if static
  213. NSDynamic    0        ; 1 = YES, 0 = NO
  214. UseBootP    0        ; 1 = YES, 0 = NO
  215. MTU        576        ; Provider specific
  216. Phone                ; Provider phone number (without spaces)
  217. */
  218. /* The rest is the Dialer script for this provider */
  219. options results
  220. signal on error
  221.  
  222. Say "Entering Manual Console Mode."
  223. Status "Please log in"
  224. ManualConsole
  225.  
  226. exit 0; /* Successful exit */
  227.  
  228. error:
  229. Say "Command on line" SIGL "returned" RC ":" SerScript.LASTERROR
  230. Exit 10
  231. ---8<---8<---8<---8<--->8--->8--->8--->8---
  232.  
  233. 3.3 Serial Line Setup
  234. ---------------------
  235.  
  236. The serial line configuration is stored in db/autointerfaces.  You
  237. should not manually modify the db/autointerfaces file, but use the
  238. configuration program to manage it.
  239.  
  240. The `Shared mode' is offered as the default.  If Shared mode is used, the
  241. dialup can be done without setting the modem to the ignore DTR mode (AT&D0).
  242. This allows the modem connection to be dropped automatically when AmiTCP/IP
  243. is terminated.
  244.  
  245. The EOF-mode setting is automated by both aslip.device and the newest
  246. version of the ppp.device.  These devices use the EOF-mode on only on devices
  247. known to support it.  You can enforce EOF-mode on or off by giving an
  248. additional serial option, EOFMode or NoEOFMode, respectively, with
  249. configuration program.
  250.  
  251. EOF mode is a technical detail in serial device usage that affects the CPU
  252. usage of the serial traffic.  EOF mode should be used if possible, but
  253. unfortunately some add-on serial boards and replacement serial drivers do
  254. not implement it.  If you are using the normal AmigaOS serial.device with the
  255. internal serial port, then you do NOT need to bother about the EOF-mode at
  256. all.
  257.  
  258. The MTU value stored in db/autointerfaces is used as `MRU', i.e. `Maximum
  259. Receive Unit', the maximum size allowed for an incoming packet.  This is
  260. always kept at maximum by the configuration program , and should NOT be
  261. modified. This version of AmiTCP/IP allows MTU (Maximum Transmit Unit, the
  262. maximum size of sent packets) to be set independently.  This value is asked
  263. in `IP provider options' and is stored in the IP provider profile.  This
  264. value can also be changed and viewed at the run time with `ifconfig'
  265. utility.
  266.  
  267. The DoOffline option included into SLIP and PPP configuration in the
  268. file `db/autointerfaces' instructs AmiTCP/IP to put the Sana2 device
  269. offline when AmiTCP/IP is stopped.  Putting SLIP or PPP device offline
  270. will cause the modem connection to be dropped, if DTR is not ignored
  271. by th modem (AT&D0 is not configured in modem init string).
  272.  
  273. 3.4 Modem Setup
  274. ---------------
  275.  
  276. Configuration program also asks for the modem configuration.  This includes
  277. modem initialization string, and the dialing prefix.  These are stored in
  278. ENV:ModemInitString and ENV:ModemDialPrefix, respectively (also in ENVARC:).
  279.  
  280. The modem initialization string is dependent of the modem you have.  If you
  281. are using a terminal program, you probably have a modem initialization
  282. sting configured for it.  This can be used as is with AmiTCP/IP as well.
  283.  
  284. Generally the modem initialization string should contain the following:
  285.  
  286.   1) The command introducer    "AT"  (for Hayes compatible modems)
  287.   2) Reset to factory defaults:    "&F" 
  288.   3) Sense carrier:        "&C1"
  289.   4) Disconnect on DTR drop:    "&D2"
  290.   5) Hardware handshake:    "&R1" (7Wire mode, need 7 wire cable)
  291.  
  292. You need to confirm the actual values from the manual of your modem.  The
  293. scripts using the ModemInitString assume it to return OK, so at least the
  294. command introducer must be given.
  295.  
  296. The modem dial prefix is usually "ATDT" (touch tone dial).
  297.  
  298.  
  299. 4. Miscellaneous
  300. ================
  301.  
  302. 4.1 `db/User-Stopnet'
  303. ---------------------
  304.  
  305. The `stopnet' script has been modified to execute `db/User-Stopnet', if it
  306. exists and AmiTCP/IP is running.
  307.  
  308. 4.2 `ifconfig' Changes
  309. ----------------------
  310.  
  311. Ifconfig now supports new usage, `ifconfig' without any arguments.  It shows
  312. the currently configured interface.
  313.  
  314. Ifconfig also gives textual presentations to all interface flags that are
  315. set.  It also reports the set MTU, hardware type and hardware address, if
  316. applicable.  The MTU can also be set, for example:
  317.  
  318.     ifconfig slip mtu 296
  319.  
  320. will set the MTU of the interface `slip' to 296 (`slip' is assumed to be
  321. configured already).
  322.  
  323. 4.3 Configuring AmiTCP/IP without Domain Name Service
  324. -----------------------------------------------------
  325.  
  326. If you run AmiTCP/IP without a connection to the Internet, the Domain Name
  327. Service might not be available.  AmiTCP/IP configuration expects that it can
  328. find out the host name from the IP address of your Amiga.  If the domain
  329. name service is not available, you should add a suitable IP-address-to-
  330. host-name mapping to the `AmiTCP:db/hosts' file.  See the existing `hosts'
  331. file for the format of the file.
  332.  
  333. EOF
  334.