workbench/network/stacks/AROSTCP/README

   1 Below are brief instructions on how to configure and run AROSTCP under
   2 native AROS. It is assumed that AROS has already been installed onto
   3 hard disk.
   4
   5
   6 Configuration
   7 =============
   8
   9
  10 ENVARC:SYS/Packages/AROSTCP
  11 ----------------------------
  12 The first thing to be aware of is the AROS package file.  It allows AROS to
  13 perform startup operations for software packages in a friendly manner.
  14 The main file is ENVARC:SYS/Packages/AROSTCP which points to the installed
  15 location of the AROSTCP package.
  16
  17 During boot AROS will call the file s/Package-Startup in the directory pointed
  18 to by the AROSTCP package file to add its own path variables, etc.
  19
  20 If you have AROSTCP installled to a different location than
  21 SYS:System/Network/AROSTCP you will need to alter this file.
  22
  23   SetEnv SAVE SYS/Packages/AROSTCP <Installed location>
  24
  25 ENVARC:AROSTCP/AutoRun
  26 ----------------------
  27
  28 Set to "True" to enable AROSTCP to launch during boot - i.e when its Package-Startup script is executed.
  29
  30 ENVARC:AROSTCP/Config
  31 ----------------------
  32 If The ENV Variable "AROSTCP/Config" is specified - it is used to find
  33 the location of the database files that will configure AROSTCP.  If not
  34 specified AROSTCP will default to it's 'db' subdirectory. From here
  35 on this dir will be refered to as the AROSTCP-CONFIG dir.
  36
  37 This option is mostly of use to systems which boot from read only media,
  38 or environments where a number of differing network configs may be
  39 necessary.
  40
  41 DB/*
  42 ----
  43 There are a number of files in the AROSTCP-CONFIG that need to
  44 be changed using a text editor (eg. 'Editor', found in AROS's Tools
  45 directory):
  46
  47 * static-routes: Change the IP address for "DEFAULT GATEWAY" to
  48 that of your actual gateway, eg. your router.
  49
  50 * netdb-myhost: In the 'HOST' line, change the IP address to the real
  51 IP address of your computer. You will likely need to change the DOMAIN
  52 entry to your own networks address (ie 192.168.0.) and also the NAMESERVER
  53 entry to that of your real DNS server.  Multiple NAMESERVER lines can be
  54 specified for networks which use them.
  55
  56 * interfaces: At the end of the file, there are configuration entries
  57 for different network cards. Enable the entry for your network card by
  58 removing the '#' from the start of one of the lines that begin with
  59 "#eth0".  You will need to alter the IP address to the correct one for
  60 your card, and optionaly specify a NETMASK.
  61
  62  N.B. - You must specify different names if you network has more than one
  63         NIC - ie eth0, eth1, etc.
  64
  65 If you're using a home network, and you don't know what values to use in
  66 the 'hosts' and 'netdb-myhost' files, try running AROSTCP without
  67 changing them. The default values might work in a lot of cases.
  68
  69
  70 Usage
  71 =====
  72
  73 ###
  74 To start AROSTCP, open a shell and type the following two commands:
  75
  76  CD SYS:System/Network/AROSTCP
  77  Execute s/startnet
  78
  79 ###
  80 To stop AROSTCP, run the Status command in a shell to get its process
  81 number, and then enter
  82
  83  Break N
  84
  85 where N is the process number.
  86
  87 ###
  88 If you have configured your db files in a differing location to the default (ie not the /db/ subfolder) then use
  89
  90    SetEnv AROSTCP/Config <path to modified files>
  91
  92 to enable AROSTCP to use it.  Please note that this must be done before launching AROSTCP.
  93
  94 ie.
  95
  96    CD SYS:System/Network/AROSTCP
  97    Copy db SYS:NetConfig ALL
  98    SetEnv SAVE AROSTCP/Config SYS:NetConfig/
  99
 100  ..
 101  edit the files in SYS:NetConfig/ to suit your network
 102  ..
 103
 104    Execute s/startnet
 105
 106 And AROSTCP will use your configuration on subsequent reboots (with no worry of it being overwritten during an update of your installation - unless ofcourse you reformat the partition ;P)