From OpenNMS
Jump to: navigation, search

Warning.png Official Install Guide

With OpenNMS Horizon we have now a version controlled official install guide which can be found here: This wiki is going to be deprecated.

As of OpenNMS 1.3.8, there is initial support for running on Windows. There are a lot of rough edges, but it is possible to install and run on Windows XP and up.

Install the JDK

Download the Java 6 (1.6), Java 5 (1.5) or higher Java SE JDK from and install it. The JDK, not just a JRE, is required by the web UI, since JSP pages are dynamically compiled. You need the version labeled "Java SE" (for "standard edition"), not EE, ME, or FX.

Install PostgreSQL

Download the Installer

Download the one-click PostgreSQL for Windows installer.

Run the PostgreSQL Installer

Run the installer. For the most part, the defaults should be just fine. You should not need to run the Stack Builder for OpenNMS, although if you intend to use PostgreSQL for other things, it lets you install replication, web, and ODBC tools.

Initialize the Database

Create a Database in PostgreSQL_Root\data

If for some reason you don't have a default database initialized from the installer, you can create it yourself:

  • open a command prompt (Start -> Run -> cmd) and change to the bin directory of your PostgreSQL install (by default, C:\Program Files\PostgreSQL\X.X\bin)
  • Initialize the database with the following command:
    • initdb -E UTF-8 -U postgres ..\data
Adding PL/PGSQL to the postgres database

Install OpenNMS

If you did not start PostgreSQL already, start it by going to the "PostgreSQL X.X" menu in the Start bar, and click "Start service".

Then, all you need to do is download the latest standalone-'' from the opennms section on the OpenNMS download page. Once it is downloaded to your hard drive, you should be able to just double-click setup32.exe or setup64.exe it in Explorer, and it will start installation. Note that the setupXX.exe you run should match your JVM's arch, so if you're running a 32-bit JVM on 64-bit Windows, install using setup32.exe.

Follow the instructions and you should have a complete OpenNMS installation!

Run OpenNMS

OpenNMS can be run from the command-line, using opennms. bat in your %OPENNMS_HOME%\bin directory. Assuming you installed OpenNMS to C:\Program Files\OpenNMS, you would open a command-prompt, and cd to C:\Program Files\OpenNMS\bin. Then run:

 start.bat start

...and OpenNMS should start. Open your browser and point it at http://localhost:8980/opennms and log in as "admin" with the password "admin".