Installation:Windows

From OpenNMS

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 2000 and up.

Install the JDK

Download the Java 6 (1.6), Java 5 (1.5) or higher Java SE JDK from java.sun.com 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.

http://www.postgresql.org/download/windows

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\8.2\bin)
Initialize the database with the following command:
- initdb -E UTF-8 -U postgres ..\data

Adding PL/PGSQL to the postgres database

Add PL/PGSQL Language

When you initialize the database manually, it does not add PL/PGSQL automatically, so you will need to do so yourself. The easiest way to do this is with the pgAdmin tool which is provided with the PostgreSQL binaries.

start PostgreSQL: from the Start bar, go to the "PostgreSQL X.X" menu and run "Start service"
run pgAdmin: from the Start bar, go to the "PostgreSQL X.X" menu and run "pgAdmin III"
connect to the database: double-click on "PostgreSQL Database Server X.X (localhost:5432)"
browse to the postgres database (Databases -> postgres)
go to File --> Options and activate the Languages option under the Display tab
Navigate back to your database and open right click on now available Languages item
Add the PL/pgsql language, accepting all defaults.
exit pgAdmin

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 opennms-installer-X.X.X.jar 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 it in Explorer, and it will start installation.

If Internet Explorer saves the installer as a ZIP file (which contains several folders called "com", "img", "langpacks", "META-INF" and so on, this means that you have not installed a Java SDK. See above.

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: