Basic StarV3 Setup

From StarOS Community Wiki
Jump to navigation Jump to search

StarOS V3 software can be run on a variety of hardware, including Wireless Advanced Router (WAR) boards and PC Engines Wireless Router Application Platform (WRAP) boards. In addition, StarOS will run on a number of motherboard/CF combinations with the X86-PC edition. While there are some feature differences between the different firmware versions, all versions of StarOS software can be managed via an SSH interface. One of the most popular packages used to create an SSH session is PuTTY, which is available as a free download for Windows. A PuTTY port to Mac OS X is available at the Star-OS Download Page.

Logging into your StarV3 system

The defaults are: on ether1 on ether2 on wpci1 (the first atheros card)

Additionally, wpci1 has a default 802.11b/g access point enabled so you can associate to it with a wireless client (a laptop's wifi will work) and communicate with it on

The default login is admin and the default password is 1234.

You must use an ssh client to log in:

 * Windows: PuTTY is recommended.
 * Apple Mac:  Use ssh from within an xterm window.  (See below.)
 * Linux and FreeBSD: Just ssh from the default terminal window.

On the Apple Mac, the default Terminal window does not forward mouse information appropriately, so it cannot be used to ssh to a StarOS unit. Instead, you want to run ssh in an xterm window. The newer OS X releases come with X11 installed, whereas with older releases you have to download X11 to get a working xterm.

Configuration Screen

Menu Bar

The menu bar includes six different menus, each of which contains options necessary to customize the setup of your StarV3 equipment. Each menu is discussed in more details on its own page. These menus are the file menu, the interfaces menu, the routing menu, the advanced menu, the hotspot menu, and the system menu. In addition, the menu bar includes a menu for the credits, which will give you the opportunity to view software credits. The software credits will include version and license information for software used in the release in operation on your equipment, as well as some information regarding the release in use.

Information Display

Upon connecting to the SSH session of a StarV3 device, the main information part of the window will contain several different types of information summarizing the current operating state of the device. This information is organized in four main divisions.

In the top-left portion of the window, the System Information displays what network devices are detected, the current system time, uptime since last reset, and the used and available system memory.

In the top-right portion of the window, the system Serial Number is displayed. This serial number includes information that identifies what type of mainboard the system has (X86, WAR-2, WAR-4, etc).

In the middle portion of the window, the Service Summary displays what services are available and in use. Services that are in use will be lit yellow while available services that are not currently in use will be displayed in grey. The list of services will vary based upon the firmware type and device.

In the lower portion of the window, the Wireless Devices list will display summary information about any wireless devices detected and configured in the system. Each device will be identified by its system number (wpci1, wpci2, and so on) as well as what type of chipset the wireless card uses. In addition, wireless devices operating in Access Point mode will display their ESSID, operating frequency, country code, operating mode, and number of associated clients. Wireless devices operating in Station mode will display their current transmission quality, receive signal, noise floor, transmission rate, operating frequency, country code, operating mode, and the MAC address of their link partner.

Bottom Bar

The bottom bar of the SSH interface includes a button to exit the SSH session in the bottom left of the bar (the same as pressing Alt-X). In addition, the current CPU utilization load is displayed in the center of the bar. Finally, the bottom-right of the bar displays the active firmware type and version, as of the last restart of the system.