OpenNMS How To

Step 1:
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.

Step 2:
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.

Step 3:
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

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

Step 5:
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!

Step 6:
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".

Step 7:
change Port from 8980 to 80.
Edit $Opennms_Home/etc.opennms.properties
vi /opt/opennms/etc/opennms.properties
Replace 8980 with 80.

Step 8:
Configure E-mail Alerts.

Step 9:
Configure Dashboard.

Step 10:
Configure Active directory Authentication.

Step 11:
Configure OTRS Integration.