WILI-CORE Skin User Guide
From wiliGear wiki
Contents |
WILI-CORE Skin
The main Web management menu is displayed after successfully login into the system (see the figure below). From this menu all essential configuration pages are accessed.
By default the Statistics | Status menu is activated and the main WILI device system information is displayed. The active menu is displayed in a different color.
The web management menu has the following structure:
Statistics
- System Information – displays general information of the WILI device.
- Interfaces – displays main network statistics of the WILI device.
- Wireless – displays wireless statistics of the WILI device.
- Routes – displays routes table of the WILI device.
- ARP Tables – displays ARP table of the WILI device.
Configuration
- Configuration – configuration file manual editing and management.
System
- Administrative Account – change administrator’s password.
- License – license file upload on the WILI device.
- Certificate – upload certificates on the WILI device.
- Maintenance – upgrade with a new firmware, reboot or reset to factory defaults the WILI device.
- Skin – activate and upload new skins on the WILI device.
Tools
- Command Line – perform standard Linux/Unix commands on the WILI device.
- Site Survey – perform a site evaluation to show overview information for other wireless networks in the local geography.
- Antenna Alignment – measures signal quality between wireless devices.
- Traffic Monitor – display the connection tracking data.
In the following sections, short references for all menu items are presented.
Statistics
Use the Statistics menu to check the WILI device current status (this is the default page when accessing the device web management interface). There are five sections of the status information:
System Information
System Information menu displays general devices status (device name, firmware version, hardware revision, uptime, system memory, average load), license status and short information about current skin.
Uptime – displays the time, expressed in days, hours and minutes since the system was last rebooted.
Hardware version – displays the device hardware version.
Device name – displays the device type.
Firmware version – displays current version of the firmware [<PRODUCT>.<HW>.<VERSION>.<CPU>.<RADIO>.<SKIN>.<BUILD-NO>.<BUILD-TIME>]
Averagesystem load – displays the average load of the device processor in the period of the last 1minute, 5 minutes and 15 minutes (a larger value means a larger average load on the processor).
- <1.0 – System is idle
- =1.0 – Normal load
- >1.0 – Processor is busy.
System memory – displays total and free system memory [kB].
License status – displays a status of the current license.
Active skin – displays the name and the version of current skin
Refresh – click to renew system information page.
Interfaces
The Network Statistics page displays the main network configuration and receive/transmit statistics of all interfaces.
Network statistics – displays detailed receive and transmit statistics of each interface.
Network configuration – displays the main parameters of the interfaces (MAC address, IP address, Netmask).
Refresh – click to renew network statistics information.
Wireless
The Wireless Statistics page displays the main statistics of wireless interfaces.
Wireless Statistics – displays detailed statistics of each wireless interface.
Wireless Configuration – displays the main information of the each WILI-S device radio interfaces state.
Stations/Access-Points – displays detailed information about the associated stations (in master mode) or information about the device associated with a particular WILI-S device (in managed mode). The status of the wireless interface is displayed in the Wireless Statistics table.
Refresh – click to renew wireless statistics information.
Routes
The Routes page displays the routing table for each interface.
Refresh – click to renew information in table of routes.
ARP Table
The ARP table lists the devices that have communicated with current WILI device via TCP.
Refresh – click to renew information in ARP table.
Configuration
Use Configuration File Management section to download/upload a configuration file or edit the device configuration file manually.
Upload new configuration file – use Browse… to specify the system configuration file you want to upload and click the Upload button. The system configuration is uploaded on the system, but does not take affect until the device is rebooted.
Download running configuration file – click to download current device configuration file to your local PC. When needed, that device configuration file could be uploaded to device to have identical configuration that had on configuration download date.
Use the Edit Configuration section for editing the configuration file manually. The configuration file entry field is active and ready for editing.
 | Refer to the respective document WILI-S Configuration Reference Manual for detailed information about the syntax of the configuration file. |
Save – click to save a modified configuration file to the device flash memory. Modified WILI-S system configuration will become active after device reboot. The system information massage appears with direction to reboot the device. Use the Reboot button next to LOGOUT button on the main menu, to reboot the device and apply device configuration changes.
 | Incorrect configuration file modifications (keys and values) may cause the WILI device to stop working. In this case try to upload a known good configuration file or perform a reset to factory defaults (please refer to the respective sections Configuration and Maintenance). |
Reset – use this button to cancel recent changes of the configuration file text. This button is functional before using Save button.
Read active – load the last saved configuration file from device flash memory.
Read backup – load the next-to-last saved configuration file from device flash memory.
Adjust edit area height – choose the height of the edit area.
System
Use the System menu to define access settings to the device, or to use the following system utilities:
- Administrative Account – to change administrator password.
- License – to upload or download WILI device license.
- Skin – to activate, upload or download WILI device skins.
- Certificate – to upload or download certificates.
- Maintenance – to reboot, reset to factory defaults or update device with a new firmware.
Administrative Account
| | We recommend to change the default administrator password as soon as possible. |
The Administrative Account menu is for changing the existing administrators’ password.
Username – displays the username of the current connected administrator. This parameter is not changeable.
Old password – enter the old administrator password.
New password – enter the new administrator password for user authentication.
Verify password – re-enter the new password to verify its accuracy.
| | The only way to gain access to the web management if you forget the administrator password is to reset the WILI-S to factory default settings. |
| | Default administrator logon settings are:
|
License
When the device is installed and ready for use, the valid license file should be uploaded on the device to activate a full set of the device features. The license status is displayed on the device System Information page:
License status – displays the license validity status:
- valid – this license status means that devise has full functionality of the purchased WILI-S firmware release. With a valid license, you can get all service releases of the purchased FW version for free.
- not valid – this license status provides only a very limited functionality.
| | The license will be still valid after resetting the device to defaults. |
If the device has an invalid license uploaded, only very limited set of the device functionality is enabled:
- It runs only with a default configuration. Only a single BSSID is allowed; DHCP client runs on WAN interface, DHCP servers run on LAN and Wireless interfaces.
- It is impossible to change the configuration. All features are locked down until a valid license is presented. Any changes made in configuration will be stored in the flash memory of the device. Thus only a default setting will be used after the reboot.
To manage the license file, use the System | License menu:
License status – displays the validity status of current license.
Download current license file – click to download current device license file to your local PC.
License File Upload – click for the license file upload on the device.
To upload a new valid license file on the device use the Upload button under the Upload New License section:
Browse… – click to specify the license file you want to upload on the device.
Upload – click to upload the chosen license file on the device.
| | Be sure for certain you are uploading a valid license file. |
After the new license file is uploaded, the device must be rebooted for changes to take effect. For instructions how to reboot the device, refer to the section Reboot on the Maintenance page.
| | In case the fault license file has been uploaded, the device becomes inactive after reboot and the default configuration will be uploaded with the dynamic IP address given by the local DHCP server. |
Skin
The are two types of skins: build-in and custom. The build-in skins comes with a WILI device firmware and are undeletable so even after the device reset to factory defaults the build-in skins will remain. The custom skins are fully manageable - they can be uploaded and deleted from the system by the administrator.
Use the System | Skin page for skin upload, download or activation.
Skin name – displays the name of the particular skin.
Active – marks which skin is activated on the system.
Type – specifies the type of particular skin:
- build-in – skins that are built in device firmware and cannot be removed. The built-in skins will remain even after device reset to factory defaults.
- custom – skins developed under customers' needs and uploaded to the device manually.
Activate – load and activate selected skin on the system. After the selected skin will be activated, the new web interface appearance will be displayed.
| | Take a note that after activation of a new skin, the configuration file and parameter values will be reverted to the default values of the activated skin (including the IP address of the device and administrator's credentials). |
| | It is recommended to refresh your browser (Ctrl+F5) after the successful activation of a skin. |
Delete – remove the selected skins from the system. The build-in skins are not removable, only custom skins can be deleted.
Download – download the selected skin to your local PC.
Use the Upload New Skin section to upload custom skins on the WILI device system:
Browse… – click the button to select the new skin archive from a folder on the PC.
Upload – upload the new skin on the system. Successfully uploaded skin archive will appear on the Skin table under Device Skins section.
Certificate
You can download current or upload self-signed certificate files for HTTPS connections using the Certificate menu.
| | Only these format certificate files are accepted:
|
Certificate file – use Browse… button to choose the certificate file.
Private key file – use Browse… button to choose the private key file.
Private key password – type in the password for your certificate.
| | The certificate in .pem format is composed from two files: certificate file and private key file. These files should come in pair. Unrelated files will not be saved. The certificate in .p12 format uses only one private key file. Note that the certificate password may also be required using the .p12 private key. |
Upload – click to upload self-signed certificate files. The uploaded files will be saved in temporary memory. To finish the certificate file upload process and save the files to permanent memory, use apply & reboot button on the main menu to save information and reboot the device.
Download current certificate file – click to download current certificate file to your local PC. If the certificate of .p12 format is uploaded on the device, this button will be inactive.
Download current private key – click to download current private key file to your local PC.
Maintenance
Use the Maintenance menu to upgrade system firmware, reboot the device or set the device to factory default values. The WILI-S device system firmware upgrade is compatible with all configuration settings. When the device is upgraded with a newer version or the same version builds, all the system’s configuration will be preserved after the upgrade.
To update your device firmware use the Firmware upgrade section, select the firmware file and click the Upload button:
Current Firmware Version – displays version of the current firmware.
Browse… – click the button to select the new image from a folder on the PC.
Upload – upload the new firmware.
The new firmware image is uploaded to the controller’s temporary memory. It is necessary to save the firmware into the controller’s permanent memory. Click the Upgrade button:
Upgrade – upgrade device with the uploaded image and reboot the system.
| | Do not switch off and do not disconnect the device from the power supply during the firmware update process as the device could be damaged. |
If the uploaded firmware image requires a new license (changing device type (e.g. WILI-O to WILI-Mesh), changing hardware or when uploading firmware image with different version), you will be asked to upload a new license file before uploading a new firmware image:
Upload – use Browse… button to specify a new license file and upload on the device.
After the new license file is uploaded, the information with currently uploaded firmware image and license appears:
Upgrade – click to upgrade device with the new firmware image.
| | Do not switch off and do not disconnect the device from the power supply during the firmware update process as the device could be damaged. |
Use the Reboot section to reboot the device:
Reboot – reboot device with the last saved configuration.
After clicking the Reboot button, the confirmation message appears:
Reboot – click to finish the device reboot process.
Cancel – do not reboot the device.
Use the Factory Defaults menu to reset device parameters into factory defaults:
Reset – click to reset the device to factory default values.
After clicking the Reset button, the confirmation message appears:
Reset – click to reset the device to factory default values.
Cancel – click to cancel reset process.
| | Resetting the device is an irreversible process. Current configuration and the administrator password will be set back to the factory default. Nevertheless the device license will be still valid after resetting the device to defaults. |
WILI skin has an ability to generate a troubleshooting file that contains a valuable information about device configuration, routes, log files, command outputs and etc. Using the troubleshooting file the device itself gathers information instead of you. This is helpful for submitting problems to WILIBOX support team.
Download – click to download the troubleshooting file to your local PC.
Tools
Use the Tools menu to use the following WILI device applications:
- Command Line – to perform simply terminative command line commands.
- Site Survey – to view the list of wireless networks in local graphical area.
- Antenna Alignment – to align WILI device antenna.
- Traffic Monitor - to view the connection tracking data.
Command Line
Use Command Line menu for WILI device troubleshooting using standard Linux/Unix commands.
Command – type the terminal command you want to execute in the command prompt.
Execute – click to perform particular standard terminal Linux/Unix command.
For example if you want to ping a host, you should type the terminal ping command (with option –c), otherwise the device will not perform a command:
| | The command line is a direct access to a shell level access. It must be used with great carefulness since a wrong action may cause the failure of a device. |
Site Survey
The Site Survey test shows overview information for wireless networks in a local geographic area.
Using this test, an administrator can scan for working access points, check their operating channels, WEP encryption and see signal/noise levels. An administrator can use this feature to identify a clear channel to set the WILI-S based device to that will not receive interference from adjacent APs.
| | Note that Site Survey function can take several minutes to perform. |
A Site Survey test is performed every time on the startup of the device, therefore the results of the last performed Site Survey test and its time can be found on the page. Thus, to obtain the results, the initiation of the scan is not necessary.
To perform the Site Survey test currently, click the Scan
Choose wireless interface – choose the interface on which the Site Survey test will be performed form the drop-down list.
| | The Site Survey function is impossible if the selected wireless interface is disabled. |
Scan – click to perform the Site Survey test.
Antenna Alignment
The antenna alignment test measures signal quality between the bridge/access point and other wireless networking devices. For best results during the antenna alignment test, turn off all wireless networking devices within range of the device except the device(s) with which you are trying to align the antenna. Watch the constantly updated display in the Alignment Test window as you adjust the antenna.
Choose wireless interface – select the wireless interface on which the Antenna Alignment test will be performed.
The Antenna Alignment test results appear when you click the Start button, and finishes when you click Stop button.
Traffic Monitor
Use this tool for connection tracking, based on the IPtables 'conntrack' module. The traffic monitor table displays only those IP Conntrack table entries that are in [ASSURED] state.
To view traffic monitor data, the IP Conntrack module must be loaded using shell command:
# modprobe ip_conntrack
Once loaded the IP Conntrack module will remain until device reboot. Do not forget to disable IP Conntrack module, as it may influence on the WILI-O device performance. To disable this module use command on shell:
# rmmod ip_conntrack
To enable IP Conntrack module once for all, setup WILI device configuration file using the Configuration menu with the following System Modules configuration keys:
modules.status=enabled modules.1.status=enabled modules.1.name=ip_conntrack modules.1.arguments=hashsize=8192
| | Refer to the respective document WILI-S Configuration Reference Manual for detailed information about the syntax of the configuration file. |
Use the Refresh button to view the connection tracker’s file data:
The filter options will allow you to specify any of protocol, source IP or port ,and destination IP or port. There is an ability to filter data using multiple keywords by entering them separated by space, e.g. “tcp 200”. Enter these keywords, use Search button and table will be refreshed according the filter results:
| | Do not forget to disable IP Conntrack module, as it may influence on the WILI device performance. |
Logout
Click LOGOUT link on the top right corner of the main menu to leave the Web management interface:
Logout – click to leave the WILI-S Web management.
When the LOGOUT button is clicked, the administrator is redirected to the login page.
