Suggested Outline

[lonnie]

The starting outline is courtesy of Butch Evans. Please add to this outline by posting. I will amend this post and delete your post , in the interest of keeping the size down.

If you wish to tackle the actual writing of one of the sections, then just create a new topic and post away. If somebody asks a question in the topic or adds some relevant points, then the main post should be updated to reflect the additional material. As before I will delete the secondary posts, as the pertinent info should be added to the main post.

Eventually this will be complete and up to date, and it will be the manual. We will collect everything from here and generate a PDF and an htm file for online.

Time to sift through the existing topics and start condensing infomation to this area.

***************************************
General Overview/Introduction
Minimum Requirements
Router
Server
Supported Hardware
Installation
Initial Installation
Upgrading/Updating
User Interface
First Login
Registration/Key Installation
Setting/Changing the Admin Password
Keyboard Commands/Meta Keys
Application Examples
Point to Point (WDS)
AP Mode
Wireless Client Mode
Routing/Routing Protocols
Basic Intro to Routing Protocols
Configuring RIP
Configuring OSPF
Configuring BGP
Firewall
CBQ functionality
Nat/Masquerading
PPPoE
Hotspot Support
License Agreement

[funkywizard]

for registration/key installation i have a question.

i have a pc with onboard nic, and i currently have another nic in it too. which nic does it key to? if i key to one nic, then add another, will it be ok? ive tried enabling disabling my nics and for each combination i get a different auth code im told to use to generate my key.

[WISP]

Network Address Translation (or NAT) allows users to share one public, routable IP address that has been assigned on the "outside" network with all of the computers "inside" on the network. Below is an example of how to do a basic installation of NAT with your StarOS server when using it as a client on you wireless network.

There are a few items assumed to have been already setup on your client. It is assumed that you have already established a wireless link with your Access Point, if not please read the section on establishing a wireless link. It is assumed that you have assigned an IP address to your wireless interface "WLAN1" and are able to ping the outside world. It is also assumed that you have assigned a private IP address to your "Inside" interface "ether1" such as 192.168.0.1, if not, please do so.

Example:

Click Advanced, Scripts, NAT and Static NAT.
Enter the following line by line.

net = "wlan1"
client = "ether1"
masq from any to dev $net

Click Syntax Check, Save, Close.
Click Advanced, Scripts, Activate Script Changes
Click File, Activate Changes
Click File, Save Changes
Click File, Reboot

Wayne

[WISP]

Your license key is registered to whichever NIC you choose. If you have both NICs enabled then you can choose whether to license the software to the onboard NIC or the add-on NIC. Just remember that if you license the software to the removable NIC and you take it out, the license will follow that NIC and you will have to relicense the original system with another key. So choose wisely as to which NIC you license it to. It may be better to license the software to the removable NIC if you are deciding on upgrading the system at a later date to support more users.

Wayne

[WISP]

Dynamic Host Configuration Protocol or "DHCP" is an easy way to setup users with IP addresses so you don't have to configure each one by hand. Here is a basic example on how to setup DHCP to assign IP addresses on the 192.168.0.0/24 subnet with a router of 192.168.0.1 and dns servers at 192.168.0.11 and 192.168.0.12.

Example:

Click Services, DHCP Server, Bootup Settings.
Click Load services on boot.
Click Services, DHCP Server, Modify Configuration File
Enter the following:

option domain-name "local.lan";

option domain-name-servers 192.168.0.11, 192.168.0.12;

subnet 192.168.0.0 netmask 255.255.255.0 {
range 192.168.0.50 192.168.0.100;
option routers 192.168.0.1;
}


Click Save, Close
Click Services, DHCP Server, Service Activation, Start

Click File, Activate Changes
Click File, Save Changes


Wayne

[Steve]

Explanation of starutil would probably be useful.

[WISP]

StarUtil 1.5 - At any time type starutil15.exe in the correct folder at a DOS prompt to receive the following help.

starutil : a configuration backup and restore utiltity v1.5
usage: starutil ip password [options ...]

where valid options are:

options:
GENERAL OPTIONS:
-s or -silent Silent operation - only show critical errors.
-a or -apply Apply changes after the specified action.
-r or -reboot Reboot the server after the specified action.

CONFIGURATION ACTIONS:
-d <ofile> Download the server's configuration.
-u <ifile> Upload a saved configuration.

SCRIPT ACTIONS:
[<scr> can be: cbq, fw, nat, proxy, dhcpd, rad_users or rad_nas]
-dscr <scr> <ofile> Download the specified script.
-uscr <scr> <ifile> Upload the specified script.

WIRELESS INFORMATION:
-ci <dev> Display card link information for selected device.
-ai <dev> [index] Display access point associations.

WIRELESS OPTIONS:
-da Display more information about associations (-ai).

THOUGHPUT TEST OPTIONS:
-rx Recieve throughput test
-tx Transmit throughput test

FIRMWARE ACTIONS:
-f <ifile> Upload the specified firmware to the server.

arguments:
ip Ip address or hostname of target server.
password The admin password as entered on the target server.

EXAMPLES:
Backup a server's configuration:
starutil 192.168.1.1 MyPass -d server.dat

Restore the previously backed up configuration, and activate changes:
starutil 192.168.1.1 MyPass -u server.dat -a

Download a CBQ script:
starutil 192.168.1.1 MyPass -dscr cbq cbq.txt

Upload a changed CBQ script, and activate it:
starutil 192.168.1.1 MyPass -uscr cbq cbq.txt -a

Upload a new firmware to the server:
starutil 192.168.1.1 MyPass -f strs-1.1x.x-xxxx.bin




To view AP info type: starutil15.exe 192.168.0.254 MyPass -ai wlan1
Client Name MAC Address IP Address Q S N R Idle

1 [Default Stat..] 00:02:2d:65:f3:0e 10.0.205.5 20 -58 -78 11 13s

2 [Default Stat..] 00:02:2d:90:88:eb 10.0.5.253 13 -66 -79 11 0s

3 [Default Stat..] 00:02:2d:90:89:a9 0.0.0.0 17 -63 -80 -- 1:51h



To view more info type: starutil15.exe 192.168.0.254 MyPass -ai wlan1 -da
Client Name MAC Address IP Address Q S N R Idle

1 [Default Stat..] 00:02:2d:65:f3:0e 10.0.205.5 39 -58 -97 11 6:20m

rx: 3146237 tx: 718446 client-side: 31 -67 -98

2 [Default Stat..] 00:02:2d:90:88:eb 10.0.5.253 14 -66 -80 11 0s

rx: 20970490 tx: 8826043 client-side: 21 -75 -96

3 [Default Stat..] 00:02:2d:90:89:a9 0.0.0.0 15 -64 -79 -- 1:57h

rx: 0 tx: 0 client-side: 22 -74 -96



To view card info type: starutil15.exe 192.168.0.254 1234 -ci wlan1

wlan1 ORiNOCO with firmware v8.42.1, link distance 12.00 miles
IEEE 802.11-DS ESSID: "MyESSID" Nickname: "MyNick"
Mode: Master AP Channel: 1 Access Point: 00:02:2d:90:88:e9
TX Rate: 11Mb/s Fixed-rate Link status: Master Clients: 3
Signal quality: 0 Signal level: -102dBm Signal noise: -102dBm



To run a transmit speed test type: starutil15.exe 192.168.0.254 1234 -tx
To run a receive speed test type: starutil15.exe 192.168.0.254 1234 -rx

[tim]

Performance tuning, to get optimal throughputs over the wireless cards.

Impacts of NAT, PPPoE, FW on performance
Selecting best radio speeds for different signal strengths
Expected speeds for different configurations & different SBCs
Using RTS
Using throughput testing/starutil15

etc etc

I am sure there is a lot that can be done here. This subject is probably a manual on its own.

Tim

[Willy Peake]

Any experts on Lighting Protection? Or possible links?

[lsf]

Howto dd in win32 (windows 2000 etc.)

Download dd for windows: http://uranus.it.swin.edu.au/~jn/linux/rawwrite/dd.htm

then place dd and raw file in same dir to make it simple.

type: dd --list (enter)

find a string that looks something like this D:\OS\Staros\1.13.3-3993\\.\Volume{6befc071-5b52-11d8-8b58-000c7626127f}\
Mounted on v:\ (v: = my usb CF reader)

then do:
dd if=strs-1.13.3-3993.raw of=\\.\Volume{the-string-you-found-for-your-CF-readers-driveletter} bs=128k

remeber to to remove the \ at the end of the volume path.

if everything went ok you should see something like:

D:\OS\Staros\1.13.3-3993\server>dd if=strs-1.13.3-3993.raw of=\\.\Volume{6befc071-5b52-11d8-8b58-000c7626127f} bs=128k
rawwrite dd for windows version 0.2. Written by John Newbigin <jn@it.swin.edu.au>

This program is covered by the GPL. See copying.txt for details
106+1 records in
106+1 records out

D:\OS\Staros\1.13.3-3993\server>_