Get OpenNMS
Get Involved
Get to Know Us
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 XP and up.
Contents |
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 JICMP
For OpenNMS 1.3.6 or greater Install JICMP.
For 64-bit installations: Note that the OpenNMS installer includes 32-bit JICMP. Download 64-bit JICMP from SourceForge. Between Step 8 and Step 9 of the OpenNMS installation wizard below, copy the 64-bit jicmp.dll and msvc runtime dll to OpenNMS\lib, overwriting the 32-bit files.
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.
Note: the PostgreSQL Windows installer has a bug, it does not enable the PL/PGSQL language by default, even if you check the box which tells it to. See the instructions below for adding it.
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
-
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 (click "OK")
- click the "Refresh" button to be sure everything is being displayed
- Navigate back to the "postgres" database, you should now see a "Languages" item in the tree
- Right-click on "Languages" and select "New Language..."
- Select "plpgsql" from the "Name" drop-down, and click "OK" (accepting the 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 standalone-'opennms-installer-X.X.X.zip' 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:
opennms.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".
Version History/Availability
- This feature was added in version 1.3.8
