Administer your appliance using the Web Administration Interface

This topic describes how to administer your API Gateway Appliance using the Web Administration Interface (WAI).

To connect to the WAI, see Connect to consoles and user interfaces. You can log in using the administrator user. The connection to the WAI is over HTTPS, however, the certificate is self-signed, which might result in an untrusted connection message when connecting from a web browser. This message indicates that the certificate is not in the web browser's trusted store, but the browser should provide an option to proceed with the connection anyway.

Caution   The server-side SSL certificate used here is only intended as a temporary certificate and is not recommended for use in a production environment. For more information on how to change this certificate, see Configure WAI settings.

The following table lists the settings that can be configured in the WAI, and provides shortcuts to the relevant sections in the documentation.

WAI page Description
Bootup and Shutdown

Start and stop services, reboot the system, and shutdown the system.

See Start and stop services, reboot, and shut down. For command-line alternatives, see Start and stop services using service and chkconfig.

Change Passwords

Change user passwords.

See Change passwords. To change the root password using the command line, see Change the root password on the command line.

Filesystem Backup

Backup and restore the system.

See Back up the system.

IP Access Control

Allow or restrict IP address access to the Web Administration Interface.

See Manage IP access.

RAID Status

View the status of RAID volumes on the appliance.

See Manage RAID volumes.

System Logs NG

Configure the syslog-NG daemon on the appliance.

See Manage system logs (syslog-ng).

User Access Control

Manage WAI users and user groups.

See Manage users and groups.

SNMP Server

Configure the SNMP server, including SNMP V1/V2C communities and SNMP V3 users.

See Manage SNMP.

SSH Server

Configure the SSH server, including networking and authentication settings, and client host options.

See Manage SSH. To log on to the appliance using SSH, see Use SSH to log in to the appliance command line. To allow root access over SSH, see Allow root SSH access.

Traces and Logs

View trace and log files.

See View traces and logs.

Upload and Download

Upload and download files to or from the appliance.

See Upload and download files.

Linux Firewall

Configure the Linux firewall, including editing existing firewall rules and opening new ports in the firewall.

See Configure the Linux firewall. For alternative ways of opening ports, see Configure the firewall on the command line (iptables).

Network Configuration

Configure the network settings, including network interfaces, API Gateways and routes, host names and DNS clients, and host addresses. You can also configure virtual IP addresses.

See Configure network settings. For command-line alternatives, see Configure network settings on the command line.

Administration Interface Settings

Configure the ports and addresses the Web Administration Interface listens on, and enable SSL encryption for WAI connections.

See Configure WAI settings.


Configure keepalived to provide high availability clustering.

See High availability clustering with keepalived.

Network Time Protocol

Configure NTP servers and synchronize the system time with an NTP server.

See Manage NTP.

Software Update Management

Manage updates to system software and API Gateway software.

See Manage software updates. For command-line alternatives, such as zypper, see Update your appliance using zypper.

System Time

Set the system time, hardware time, and time zone.

See Set the system time and time zone.

Command-line alternatives

The Web Administration Interface is a useful tool, however, advanced users can also change the system configuration using the command-line interface (CLI). The base operating system for the appliance is SuSE Linux Enterprise 11, and as such, you have full access to the system using the command line. BASH is the default shell, but TCSH is also installed and can be used if preferred.

If you are unfamiliar with the Linux/UNIX command line, exercise caution when executing commands (especially as the root user), as these can have potentially hazardous and irreversible effects on your system. You should also exercise caution when deleting or modifying system files. Backup your system regularly so that you can restore the system easily if necessary.

Related Links