|
|
Source Code
As detailed in the User Manual the software included in each Opengear console server 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 servers use U-Boot boot loader code
- SDT Connector builds from the sdtcon tool (which Opengear sponsors)
- All console servers 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
- Many products embed Nagios monitoring software and rdesktop or Real VNC communications software
- Opengear's console servers embed security software built on OpenSSH, stunnel, Openswan and OpenSSL
Creating an executable firmware image
-
You can create a firmware image for the range of Opengear console server 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:
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
Repeat for each toolchain as necessary.
- 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)
- for ACM and CMS family products, select the linux-2.6.x kernel, otherwise select the linux-2.4.x kernel
- for KCS and CMS family products, select glibc, otherwise select uClibc
- answer 'Y' to Default all settings
- answer 'N' to any following questions
- make dep
- make
- The resulting firmware will be placed in the images/ sub-directory. The resulting .bin file can be flashed into the Opengear console server using the web UI or netflash command line tool (see faq 253), or loaded temporarily into RAM using a BOOTP/TFTP network load (see faq 263).
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 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.
|
