As detailed in the User Manual the software included in each Opengear's console server and management gateways contains copyrighted software that is licensed under the GPL.
You may obtain the latest release source code package on a CD by sending a money order or check for $5 to Opengear Support (630 West 9560 South, Suite A, Sandy, UT 84070, USA).
Alternately if you would like the source code for an earlier release than the current release please write "Source for firmware version x.y.z" in a memo included with your payment. The complete source code corresponding to each released firmware version is available from Opengear for a period of three years after its last shipment.
Components of the software are licensed under the GPL include:
- Most firmware is built on uClinux kernel and embodies a selection of busybox utilities
- The console server and management gateways use U-Boot boot loader code
- SDT Connector builds from the sdtcon tool (which Opengear sponsors)
- All console server and management gateways are built upon the okvm console management software (which Opengear sponsors)
- The power management is built on the Network UPS Tools, Powerman and ipmitool software
- The Lighthouse central management solution embeds nagios monitoring software
- The console server and management gateways embed security software - OpenSSH, stunnel, Openswan, OpenVPN and OpenSSL
Creating an executable firmware image
- You can create a firmware image for the range of Opengear products using the source code. The full source snapshot is some 200MB so is generally provided on a disk rather than downloaded.
- Download build tools:
- uClinux tool chain for ARM - use this for most Opengear console servers and management gateways - arm-linux-tools-20061213.tar.gz binary distribution (source available here)
- Generally speaking the tool chains consists of at least the binutils, gcc, gdb (from www.gnu.org)
Some targets also require additional tools for generating FLAT format binaries (uClinux targets), filesystem creation tools (genromfs, genext2fs, etc) or checksumming utilities. Original source, patches and build scripts for all binaries are available using the source links above. You can browse the tools directory here.
- Ensure you have sufficient privileges, then install the relevant toolchain(s):
- cd /
- tar zxvf /path/to/downloaded/arm-linux-tools-20061213.tar.gz
- Build the firmware with the following procedure:
- cd /path/to/opengear-source
- make config
- select OpenGear
- select the product you want to build for (SD4002 for example)
- select the linux-2.6.x kernel (although earlier releases were built on the linux-2.4.x kernel
- select uClibc
- answer 'Y' to Default all settings
- answer 'N' to any following questions
Alternative custom images
- If you are using the source code to build a custom firmware image then you might also consider using the Custom Development Kit (CDK).
Opengear provides a CDK which allows changes to be made to the software in console server firmware image. The CDK is essentially a snapshot of the Opengear build process. It is taken after the programs have been compiled and copied to a temporary directory (romfs) just before the compressed file systems are generated.
You can obtain a copy of the CDK for the particular Opengear console server you are working with from ftp://ftp.opengear.com/cdk.
This will be a gzipped tarball and you can obtain details on using the CDK from faq 284.
- All Opengear console servers and management gateways also run the GNU bash shell, enabling you to write custom scripts. These custom scripts can be run manually or run automatically on boot or on particular alert events or whenever a particular configurator runs. See faq 255.