SellaNMS GUI v0.1.0 (03/17/05) - http://www.digitalgenesis.com

Documentation Notes:

  The documentation provided here is only a basic overview.


Detailed documentation is available at:

  http://www.digitalgenesis.com/software/sella_nms-gui/manual

  NOTE: At the time of release, the online documentation is not complete.


Additional information and install help can be found within our forums:

  http://www.digitalgenesis.com/support/forum


Quick Install (UN*X):

  0. Extract the distribution. It will create a sella_nms-gui-0.1.0 directory.
     Several examples follow:

     For .tar.gz files:
       tar xvzf sella_nms-gui-0.1.0.tar.gz
        -or-
       zcat sella_nms-0.1.0.tar.gz | tar xvf -

     For .tar.bz2 files:
       tar xvIf sella_nms-gui-0.1.0.tar.bz2
        -or-
       tar xvf sella_nms-gui-0.1.0.tar.bz2 --with-compress-program=bzip2
        -or-
       bzcat sella_nms-gui-0.1.0.tar.bz2 | tar xvf -

     For .zip files:
       unzip -x sella_nms-gui-0.1.0.zip
        -or-
       Use WinZip. You'll figure it out.

  1. Edit sella_nms-gui.sh, and set correct JAVA_HOME. (Optional Step)

     NOTE: This script will attempt to find a JVM if JAVA_HOME is not
     configured, however startup will take longer, since it has to search.

       cd sella_nms-gui-0.1.0

       vi sella_nms-gui.sh

     Uncomment JAVA_HOME (about 10-15 lines down) and provide the path to
     your JVM. If the full path to your JVM is "/usr/local/jre1.5.0/bin/java",
     then your JAVA_HOME will be set to:

       JAVA_HOME="/usr/local/jre1.5.0"

  2. Run sella_nms-gui.sh.
     
     ./sella_nms-gui.sh

     If all goes well, you will see the splash screen within a few seconds.
     If your JAVA_HOME is misconfigured and the script isn't able to locate
     a JVM, you will receive the error message:

     "Failed to locate java. Please set JAVA_HOME within this script."

     Go back to step 1 and correct your JAVA_HOME.

  3. Configure SellaNMS GUI to connect to your database.

     Click on View->Preferences. Select Plugins->Database.

     Provide the IP of the MySQL server used by SellaNMS, the database
     name (usually sella_nms), the username (usually sella_nms) and the
     password.

     Click "Connect" to commit your changes. "Status" should indicate a
     proper connection to the database. If it fails, verify your MySQL
     permissions are configured correctly and any firewall/packet filter
     is allowing the connection to establish.

  4. Use the GUI.

     To open an Event Tab:

       Click View->Event->Open Tab

     To open an Event Frame within your Event Tab:

       Click View->Event->Event->Open Frame

     To configure your Event Frame:

       Click View->Event->Frame->Configure

     You can open several Event Tabs and Event Frames within each Event Tab.


Quick Install (Winbloze):

  0. Extract the distribution. It will create a sella_nms-gui-0.1.0 directory.
     Several examples follow:

     For .zip files:
       unzip -x sella_nms-gui-0.1.0.zip
        -or-
       Use WinZip. You'll figure it out.

  1. Run sella_nms-gui.bat.
     
     If all goes well, you will see the splash screen within a few seconds.

     Make sure you have Java v1.4.2 or better installed correctly, if the
     application does not start up.

  3. Configure SellaNMS GUI to connect to your database.

     Click on View->Preferences. Select Plugins->Database.

     Provide the IP of the MySQL server used by SellaNMS, the database
     name (usually sella_nms), the username (usually sella_nms) and the
     password.

     Click "Connect" to commit your changes. "Status" should indicate a
     proper connection to the database. If it fails, verify your MySQL
     permissions are configured correctly and any firewall/packet filter
     is allowing the connection to establish.

  4. Use the GUI.

     To open an Event Tab:

       Click View->Event->Open Tab

     To open an Event Frame within your Event Tab:

       Click View->Event->Event->Open Frame

     To configure your Event Frame:

       Click View->Event->Frame->Configure

     You can open several Event Tabs and Event Frames within each Event Tab.


Configuration:

  Configuration data is stored within the file sella_nms-gui.conf.

Fini
