Empowering Business Communication Solutions

Hypermedia Systems Ltd.

Hypermedia Gateway Administration
Guide



Empowering Business Communication Solutions




Table of Contents
1 Preface: About This Guide
2 Logging in to the gateway
2.1 Logging in locally
2.2 Logging in from another computer
3 Using online help
3.1 Listing available commands
3.2 Getting help for specific command
4 Installing gateway software
4.1 Installing on CB based gateways
4.2 Installing a package from internal storage
4.3 Installing a package from external USB storage
5 Monitoring traffic in the network
5.1 Starting tcpdump
6 Using external USB storage
6.1 Mounting USB storage
6.2 Listing files in mounted USB storage
6.3 Unmounting USB storage
7 Troubleshooting your gateway
7.1 Restarting the gateway
7.2 Checking available storage
7.3 Deleting old log files
7.4 Getting information about you operating system


Empowering Business Communication Solutions



1 Preface: About This Guide
This user guide shows you how to install gateway software, monitor traffic in the network, use
external USB storage and troubleshoot your gateway.
2 Logging in to the gateway
Please use this username and password to login to the gateway:
Useranme
hgadmin
Password
limbo32/buss
2.1 Logging in locally
Basic administration is performed using the command line interface. If your gateway supports a VGA
adapter and USB socket, you can attach a keyboard and screen. You can also control the gateway
remotely from another computer.
2.2 Logging in from another computer
If your gateway does not support VGA adapter, you can log in to the gateway remotely from another
computer. On Windows you can use an SSH client such as PUTTY. On Mac OS X and GNU/Linux
you can use the ssh command line tool.
Example - using ssh on Linux:
$ ssh hgadmin@gateway-address
3 Using online help
Gateway administration is done through hgadmin help command. You can list available commands
or get help for a specific command.
3.1 Listing available commands
$ hgadmin help
3.2 Getting help for specific command
$ hgadmin help tcpdump
4 Installing gateway software
To install new software packages, or upgrade installed packages, use the hgadmin install command.
The package can be installed from internal storage or from an external USB storage device. To obtain
software packages, please contact support@hyperms.com.

Empowering Business Communication Solutions



4.1 Installing on CB based gateways
If you have physical access to the gateway, it is recommended to install from a USB external
storage device.
When installing a package from the internal storage, the package file is removed after the
installation. If you want to reinstall a package, you must copy it again to the gateway.
Do not keep software packages or other files on the internal storage - the available space is
limited.
4.2 Installing a package from internal storage
1. Copy the package to the gateway. On Windows you can use an SSH client such as WinSCP.
On Mac OS X and GNU/Linux you can use the scp command line tool:
$ scp pc-sip-1.77.2891.tar.gz hgadmin@gateway-address:
2. Log in to the gateway:
$ ssh hgadmin@gateway-address
3. Install the package using hgadmin install command:
$ hgadmin install pc-sip-1.77.2891.tar.gz
The gateway may reboot after the package is installed.
4.3 Installing a package from external USB storage
4. Copy the package to the USB storage device
5. Insert the device in the USB socket
6. Mount the device using the hgadmin mount command:
$ hgadmin mount usbdisk
7. Install the package using hgadmin install commnad:
$ hgadmin install usbdisk/pc-sip-1.77.2891.tar.gz
8. If the gateway does not reboot after installation, unmount the USB storage device:
$ hgadmin unmount usbdisk
5 Monitoring traffic in the network
To monitor traffic in the network, you can use the hgadmin tcpdump command. Tcpdump captures
packets on the local network and saves packet data to a file for subsequent analysis. The files are
saved in the /hyperms/log directory. You can download saved dumps through the HMC HGS Logs
page, and analyze them using WireShark.
5.1 Starting tcpdump
$ hgadmin tcpdump
To stop capturing, hold the CTRL key and press C key.

Empowering Business Communication Solutions



6 Using external USB storage
To access files on an external USB storage device, you have to insert the device into the USB socket,
and mount it using hgadmin mount command. USB storage is mounted at /media/usbdisk. You can
also access the storage device through the usbdisk symbolic link in your home directory. Before
removing a mounted USB storage, unmount it using the hgadmin unmount command.
6.1 Mounting USB storage
$ hgadmin mount usbdisk
6.2 Listing files in mounted USB storage
$ ls usbdisk/
6.3 Unmounting USB storage
$ hgadmin unmount usbdisk
7 Troubleshooting your gateway
This part contain rarely used commands.
7.1 Restarting the gateway
To restart the gateway safely, use the hgadmin reboot command:
$ hgadmin reboot
Note: do not reboot the gateway by shutting down the power - this may lead to data loss.
7.2 Checking available storage
On CB based gateways, the internal storage is limited. To check the available storage, use the df
command:
$ df -h /

Empowering Business Communication Solutions



This document contains proprietary and confidential material of Hypermedia System Ltd. and/or its affiliates and partners.
7.3 Deleting old log files
To list log files and the size each of them use, use the ls command:
$ ls -lht /hyperms/log
To delete log files, use the rm command:
$ rm /hyperms/log/signalgw-*.log
The example above would delete the files "signalgw-20090920.log" and "signalgw-
20090921.log".
7.4 Getting information about you operating system
To get information about your operating system, use the uname command:
$ uname -a