The X-Bone

 

X-Bone 3.1.1 - May 2004

                                                                                            
Source
FreeBSD Ports
 

Linux+Perl 5.8.0
(Redhat 9)

Linux+Perl 5.8.3
(Fedora Core 2)

Patch »

Readme »

QuickInstall »

Changes »

Requirements »

Installation Instructions »

Archived Versions »

Installation Instructions

Install from:

  1. FreeBSD Ports
  2. Linux
  3. Source

NOTE: Please refer to Installation instructions for more details. This (online) copy is more recent than the one included in the distribution.

FreeBSD [port installation]

    1. Check your OS versions, kernel configurations, & apply necessary kernel patches.
    2. Update your FreeBSD port collection.
    3. Uninstall previous versions of X-Bone.
    4. Download and unpack X-Bone port tarball:
      % cd /usr/tmp && tar xvfz xbone-3.1.1-port.tar.gz
    5. Download and unpack X-Bone GUI port:
      % cd /usr/tmp && tar xvfz xbone-gui-3.1.1-port.tar.gz
    6. Install X-Bone Node Daemon on multiple hosts:
      %cd /tmp/xbone-3.1.1-port && make install
    7. Install X-Bone GUI on one host:
      %cd /tmp/xbone-gui-3.1.1-port && make install
    8. On the GUI host, configure and start apache (use sample configuration provided, if necessary)
    9. Post install operations at any time:
      1. for X-Bone Node Daemon:
        %xb-config
      2. for X-Bone GUI:
        %xb-gui-config

Linux [RPM installation]

    1. Check your OS versions, kernel configurations, & apply necessary kernel patches.
    2. Obtain and install the perl modules
      (You might want to use this simple shell script)
    3. Uninstall previous versions of X-Bone.
    4. Install the X-Bone RPM for Node Daemon on multiple hosts:
      % rpm -i XBone-3.1.1-1.i386.rpm
    5. Install the X-Bone RPM for GUI on one host:
      % rpm -i XBone-GUI-3.1.1-1.i386.rpm
    6. On the GUI host, configure and start apache. (use sample configuration provided, if necessary)
    7. Post install operations at any time:
      1. for X-Bone Node Daemon:
        %xb-config
      2. for X-Bone GUI:
        %xb-gui-config

Installation from Source

    1. Check your OS versions, kernel configurations, & apply necessary kernel patches.
    2. Download source
    3. Extract the sources
      % tar zxvf XBone-3.1.1.tar.gz
      % cd XBone-3.1.1
    4. Install Node Daemon on multiple hosts:
      % make node
      % xb-config (in case you would like to configure the node daemon)
    5. Install X-Bone GUI on multiple hosts:
      % make gui
      % xb-gui-config (in case you would like to configure the GUI)
    6. On the GUI host, install and configure Apache (use sample configuration provided, if necessary)
    7. Post install operations at any time:
      1. for X-Bone Node Daemon:
        %xb-config
      2. for X-Bone GUI:
        %xb-gui-config

Back to Top»

Starting X-Bone

Preparation

  • Obtain or create your X.509 certificates for all X-Bone nodes (OM and RDs) and users.
  • Copy your host certificate and key files to /usr/local/etc/xbone/cert/.

On GUI host

  1. Check the following configurations:
    Apache-SSL configuration
  2. (Re)start Apache-SSL
    % apachectl startssl

On all hosts

  1. Check the following configurations:
    X-Bone daemon configure file
    /etc/resolv.conf points to nameserver
  2. (Re)Start Node Daemon:
    %xb-node-daemon

On Name server

  1. (Re)Start name server
    %named

 

Back to Top »

Required Software

This is a list of the software required by X-Bone. Each package may have additional software dependencies not shown. Check each individual software for details.

Perl 5.8.0 or above http://www.cpan.org
Perl Modules

Mail::Sendmail
Parse::RecDescent
AppConfig
Graph
IO::Socket::Multicast
IO::Socket::SSL
LWP::Simple
Net::DNS
Net::IP
Net::Netmask
NetAddr::IP
Parallel::ForkManager
XML::LibXML
XML::Simple
INET6
Socket6
Net::SSH::Perl

http://www.cpan.org
OpenSSL 0.9.5a or above [All] http://www.openssl.org
Apache-SSL apache_2.0.46 or above [GUI] http://www.apache-ssl.org
DNS Server named (bind 9.2.3/above) [DNS SERVER] http://www.isc.org/products/BIND
Routing Software [1]

Quagga 0.96.3 or above (formerly called Zebra)

http://www.quagga.net
nistnet [2] 2.0.12 or above [Linux only] http://snad.ncsl.nist.gov/nistnet/

1. Only needed if you want Dynamic Routing support. Please refer to "xbone-dynamic-routing.txt" for more details.
2. Only needed if you want QoS support.

Back to Top »