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
[email protected].
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
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 "signalgw20090921.log".
7.4 Getting information about you operating system To get information about your operating system, use the uname command: $ uname -a
This document contains proprietary and confidential material of Hypermedia System Ltd. and/or its affiliates and partners.
