2.1. Powering Up

To get started with the WRAP Access Server, connect it to your local area network (LAN) using an Ethernet cable and connect the power adapter. The Access Server will power up and retrieve the network settings from your network's DHCP server.

The WRAP Access Server will also use Zeroconf (also known as Zero Configuration Networking or Automatic Private IP Addressing) to get an unique IP address in the 169.254.x.x network. Most operating systems also support this. So, you can connect your controlling laptop with a cross-over Ethernet cable to the WRAP Access Server, then power up the Access Server, and the devices will automatically have unique IP addresses in 169.254.x.x network.

Locations of the physical interfaces of the Access Server are described in Figure 2-1 and Figure 2-2.

All the blue status LEDs are turned off when the boot procedure is finished and the Access Server is ready to be connected.

2.2. WWW Interface

Most WRAP Access Server functionality can be controlled via the WWW interface using any standard WWW browser.

The wrapfinder application (see Figure 2-3), available for Windows operating system from Bluegiga Techforum (https://www.bluegiga.com/techforum/) provides easy-to-use interface for finding the WRAP Access Servers (with SW version 2.1.0 or later) in the local area network.

The wrapfinder automatically identifies the broadcast address of the network it runs in and shows the IP addresses, serial numbers and WRAP Access Server device types it could find using UDP broadcast when it was launched.

You can change the broadcast address used for finding the Access Servers. A new scan can be done by clicking Rescan.

Select an Access Server (by clicking its IP address) and click Details to see more information (like the Bluetooth addresses and friendly names) of the Access Server. See Figure 2-4 for details.

Click Connect or double-click an IP address to connect to the selected Access Server using a WWW browser.

Click Exit to close the program.

The WWW interface is accessed at http://wrap-ip/, where wrap-ip is the IP address of the WRAP Access Server (see Figure 2-5).

From the top-level page, click Setup to log in to the configuration interface. The default username is root and the default password is buffy (see Figure 2-6).

After logging in, you can configure several WRAP Access Server settings (see Figure 2-7). These are discussed in detail in Section 2.4.

2.3. Shell Prompt Access

Shell prompt access may be needed for advanced controlling operations that cannot be performed using the WWW interface.

You can get to the shell prompt using either SSH or the management console. The management console over a serial cable should only be needed to change the network configuration settings in the case were the network configuration using DHCP or Zeroconf is not possible. All further controlling activities can be performed remotely using SSH sessions over Ethernet or Bluetooth LAN/PAN connection.

If you can make SSH connection from a device that has Bluetooth LAN Access or PAN profile support, you don't need the management console. Just connect to the Access Server using LAN Access or PAN profile. The Access Server can be seen in Bluetooth inquiries as "Wserialno_n", where "serialno" is the serial number of the device and "n" is the number of the Bluetooth radio in question (model 2293 has three Bluetooth radios, any of which can be connected). After you have connected (no PIN code, username or password needed), connect using SSH to the device in the other end of the connection, typically 192.168.160.1. You can also use the wrapfinder application to find the IP address (see Section 2.2 for details).

        [root@wrap /]$ ifconfig nap
        nap      Link encap:Ethernet  HWaddr 00:07:80:00:BF:01
                 inet addr:192.168.42.3  Bcast:192.168.42.255  Mask:255.255.255.0
                 inet6 addr: fe80::207:80ff:fe00:bf01/64 Scope:Link
                 UP BROADCAST MULTICAST  MTU:1500  Metric:1
                 RX packets:12635 errors:0 dropped:0 overruns:0 frame:0
                 TX packets:8 errors:0 dropped:0 overruns:0 carrier:0
                 collisions:0 txqueuelen:100
                 RX bytes:1686246 (1.6 MiB)  TX bytes:1640 (1.6 KiB)
                 Interrupt:24 Base address:0xc000
      

2.4. Introduction to Configuration

When the WRAP Access Server is installed and powered up for the first time, the default configuration settings are being used. With these settings, the Access Server automatically configures its network settings assuming that the board is connected to a LAN network with a DHCP server running. Additionally, the Access Server also uses Zero Configuration Networking (also known as Automatic Private IP Addressing) to connect to the 169.254.x.x network, which can be used if the network has no DHCP server.

After booting, the only Bluetooth profiles enabled are the Object Push and File Transfer Profiles, used to send files to/from the Access Server.

More Bluetooth profiles can be enabled and most of the settings of the WRAP Access Server can be configured using the setup application. It has a WWW interface at http://wrap-ip/setup but it can also be run at the command line.

All configurable settings in the setup application are listed in Appendix B with their short help text.

2.5. Using the Setup WWW Interface

The easiest way to change the Access Server settings is to use the WWW interface. Accessing the WWW interface is instructed in Section 2.2.

Typical WWW configuration page example is shown in Figure 2-8 (This page can be found at Setup → Security settings)

The different parts of a WWW Setup page are discussed in the following:

• Changes have been saved. -line

  This line comes visible when the user saves the changes by clicking the Save button (or by clicking a toggling Yes/No link). It confirms that the changes have been saved into permanent storage.

  If invalid values were entered into one or more fields, an error message is shown at this line (see Figure 2-9).

  Figure 2-9. Trying to Save an Invalid Input

  Note: Rebooting of the Access Server is typically necessary to take changes into use. This can be done via the WWW interface (Advanced settings menu).

• Number or text entry fields

  Most of the configurable settings are text (or number) entry fields. For some fields (like IP address or netmask), there are restrictions on the input format. Setup validates the input at save time and accepts only valid data. The fields with errors are shown to the user so that mistakes can be fixed (see Figure 2-9).

• Help -link

  Clicking the Help link will retrieve the setup page again with requested help information displayed, like in like in Figure 2-10.

  Figure 2-10. Help Links in WWW Setup

  Note: If you have made changes to settings on the page before clicking Help and not saved them yet, they are lost.

• Yes and No radio buttons

  These buttons are used to configure typically a setting that can be either enabled or disabled, but that is not connected to another setting that would be hidden or shown according to the value of this one.

• Link to a configuration file

  Some of the configurable settings are actually editable configuration files, like /etc/httpd.conf for WWW passwords. Clicking the link will retrieve the file for editing in the browser window, or create a new file, if it does not exist. See Figure 2-11.

  Figure 2-11. Editing Files in WWW Setup

  Note: Any file can be edited via the WWW Setup, in page Setup → Advanced setting → Edit other configuration files.

• Reset -button

  Reset -button resets the fields to the values currently in use by the Access Server, i.e. it discards the changes that have not been saved yet.

  Note: This does not make a "factory reset".

• Save -button

  Save -button sends the WWW page for the setup application for validation. If the values in the fields are valid, they are saved to permanent storage and the page is refreshed with Changes have been saved. message at top and the accepted values in the fields.

  If there were errors in the fields, these are shown as in Figure 2-9.

  Note: Rebooting of the Access Server is typically necessary to take changes into use. This can be done via the WWW interface (Advanced settings menu).

• Back -link

  Returns to the previous level of the Setup menu hierarchy.

  Note: This does not save changes in the fields at the current page.

• Exit -link

  Quits the setup application and returns to the WRAP Access Server's main WWW page.

  Note: This does not save changes in the fields at the current page.

• Toggling Yes/No and on/off links

  Clicking Yes/No link (see Figure 2-12) immediately changes the setting and saves the change. Typically this is used with settings that require some other settings to come visible or to hide according to this setting.

  Figure 2-12. Yes / No links in WWW Setup

  The on/off links in Setup → Applications → Default bootup applications behave in a same way, making and saving the change immediately (see Figure 2-13).

  Figure 2-13. Selecting Default Bootup Applications in WWW Setup

  Note: To configure the default bootup applications from the command line, use the chkconfig command.

• Upload links

  WWW Setup has settings that allow user to upload files to the Access Server, for example Setup → Advanced → Upload a software update (see Figure 2-14).

  Figure 2-14. Uploading files via WWW Setup

  Use Browse... button to select a file to be uploaded, and send it to the Access Server by clicking Upload.

• Browsing files

  Some WWW Setup pages allow users to browse the WRAP Access Server filesystem or part of it, like Setup → Advanced → Browse files (see Figure 2-15).

  Figure 2-15. Browsing files via WWW Setup

  Click the directory names to navigate in the filesystem.

  Click del to delete a file or an empty directory.

  Warning

  Deletion is not confirmed.

The WWW Setup has also menu items that run commands in the Access Server and then show the output in the browser window. Some commands, like rebooting the Access Server, are confirmed before execution.

2.6. Using the setup Command Line Application

The basic configuration settings can also be changed using the setup application at command line interface.

The setup application displays the settings in a hierarchical menu (see Figure 2-16). Navigating the menu is accomplished by entering the number or letter corresponding to the setting to be viewed and/or changed and pressing Enter. Pressing only Enter either accepts the previous value of the setting or returns to the previous level in the menu hierarchy.

2.7. Resetting Configuration

You can restore the default configuration with setup application and rebooting the board. When the system starts up, the default configuration settings are restored. If you have only changed the configuration by using the setup application, the following commands at the Access Server's command prompt will suffice:

      [root@wrap /]$ setup -r
      [root@wrap /]$ reboot
    

2.8. Exporting and Importing Configuration

You can export configuration settings (expect passwords and the list of the default bootup applications) with the following command:

      [root@wrap /root]$ setup -o > settings.bak
    

The saved settings can later be restored with the following commands:

      [root@wrap /root]$ setup -m settings.bak
      [root@wrap /root]$ reboot