Get Started V2.0

From OneCMDB

Contents

Install and Uninstall

On Windows platforms

To install:

  1. Download the setup file
  2. Note that you must have Administrator's rights to perform the installation
  3. Double-click the downloaded setup file
  4. Follow the instructions in the setup windows

Note that the installer stores information regarding the installation in the following registry key:

HKLM\SOFTWARE\Lokomo OneCMDB V2.x.x

To uninstall:

  1. Shutdown OneCMDB, if it is running.
  2. Run the Uninstall program in the OneCMDB Windows Program Start Menu:
Start>Programs>Lokomo OneCMDB>Uninstall

If you, for some reason, prefer to uninstall the software manually, just delete the installation folder, the shortcuts on the start menu, and the registry key mentioned above.

On Linux platforms

To install:

  1. Download the setup file to the directory on your system where you want OneCMBD installed.
  2. Uncompress (with zip/unzip) and extract (with tar/untar) the setup file using the following command:

tar -xfz <name of setup file>

(Note that a GNU compatible tar utility is required (standard on most Linux platforms))
  1. All files will be stored in a subdirectory named onecmdb
  2. OneCMDB is now installed and the subdirectory contains all files needed to run OneCMDB.

To uninstall, simply delete all files in the OneCMDB directory.

Startup and Shutdown

On Windows platforms

To start:

Start>Programs>Lokomo OneCMDB>Startup

Image:V2_winstartmenu.jpg

Note that OneCMDB requires free ports 8080 and 8009 (used by local web server)

  1. A command window is launched and you are requested to hit a key to start a local web server (Tomcat) and a local database (default is HSQL).
  2. Two new command console windows now open up. Tomcat may take 1-2 minutes before everything is loaded. Tomcat is ready when you see the log line "INFO: Server startup in xxx ms" in the Tomcat console window.
  3. Hit a key in the first command console window again, this will open up a web browser. It will take a few more seconds before the browser presents the OneCMDB Desktop (GUI) for the first time.


To stop:

Start>Programs>Lokomo OneCMDB>Shutdown

Shutdown closes the command console windows.

On Linux platforms

To start, use the following shell command:

$ bin/onecmdb.sh start

It will start the required programs neeeded; HSQLDB for data storage, Apache Tomcat driving the business logic and the Desktop (GUI).

To open the OneCMDB Desktop (GUI), use a browser and open:

To stop OneCMDB:

$ bin/onecmdb.sh stop

It shuts down the database and the Apache Tomcat in a controlled manner.


Quick Start

Here we describe how to perform a few basic tasks in OneCMDB without reading all the documentation.

  • Start the Software
  • Import a Model
  • View your Model
  • Discover your Network
  • View your content in the CMDB

Start the Software

Install the software and ensure that the system have ports 8080 and 8009 free/open in the firewall.

Start OneCMDB:

Windows: Select OneCMDB/Startup in the Windows Start Menu
Linux: $ bin/onecmdb.sh start

If the OneCMDB Desktop does not appear, start it manually in your browser:

http://localhost:8080
NOTE: Default login credentials are:
  • username=admin
  • password=123

Import a Model

Click on the shortcut Import Model.

Expand the left pane: Press the "+"-button.

Select all Model Files and press Open.

Note: If you do not want to import any dummy/demo data, do not select anything in folder Demo Instances.

Wait for the Comparison Result window to appear and press Commit to CMDB.

Exit Model Import by pressing Close.

View your Model

Click on the shortcut Model Overview.

Browse and study your model.

Exit Model Overview by clicking x in the upper right corner.

Discover your Network

If your network starts with IP address 192.168.1.0

Click on the shortcut MDR (Management Data Repository).

Select NMAP Discovery and press Execute.

Wait for the "Execute selected..." window to appear and press Start.

Wait for the text "Execution Completed" at the bottom of the progress window and press Close.

Select NMAP Discovery again and press Open.

Wait for the "Compare selected" window to appear and press Commit to CMDB.

Click Ok.

Your discovered data is now inside the CMDB, in the NMAP model.

If your network does NOT start with IP address 192.168.1.0

Click on the shortcut MDR (Management Data Repository).

Select the tab MDR Details.

Select network-1.

Double-click on 192.168.1.0/24 and change to your IP range, for example 123.456.789.0-255.

Click on Save.

Select network-1 again.

Click on Execute.

Wait for the "Execute selected..." window to appear and press Start.

Wait for the text "Execution Completed" at the bottom of the progress window and press Close.

Select the row with status READY in the lower table and press Open.

Wait for the "Compare selected" window to appear and press Commit to CMDB.

Click Ok.

Your discovered data is now inside the CMDB, in the NMAP model.

Move discovered data to the Basic Model

Click on the MDR Overview tab.

Select NMAP2BasicModel and press Execute.

Wait for the "Execute selected..." window to appear and press Start.

Wait for the text "Execution Completed" at the bottom of the progress window and press Close.

Select NMAP2BasicModel again and press Open.

Wait for the "Compare selected" window to appear and press Commit to CMDB.

Click Ok.

Exit MDR by pressing Close.

You discovered data has now been copied inside the CMDB, from the NMAP model structure to the Basic Model structure.

View your content in the CMDB

Click on the shortcut CMDB View.

In the left pane, click on the arrow in front of CI

Continue to click on arrows until you have come to a CI type you like view.

Click on that CI.

View the content in the right pane. Switch between Table, Tree or Graph.

Exit CMDB View by clicking Close.

Done!

Community and support