From OpenNMS

Current Status: 1.0.0 has been accepted to the app store, and is purchasable.

1.0.1 has been submitted to the app store, and is awaiting review.

Contents 1 Features 1.1 1.0.x 1.2 1.1.x 1.3 Future 2 Installation 3 Configuration 3.1 Using SSL 4 Version History 4.1 1.0.1 4.2 1.0.0 5 Building 5.1 Source Code 5.2 Building the Project

Features

1.0.x

The OpenNMS iPhone app started with a few basic goals:

• be able to view outages
• be able to view nodes
• be able to view and acknowledge alarms
• be able to add an interface

1.0 meets these goals, with a basic outage list (with a link to the outage node's node detail page), an alarm list (with an alarm detail page), and a node search.

1.1.x

The current plans for version 1.1 are as follows:

• support resource graphs
• view event details
• view IP and SNMP interface details
• automatically refresh the UI to show new outages/events/alarms if that particular view of the app is open
• be able to view all, or just acknowledged, alarms (rocker switch)

Future

We've had a number of great suggestions for future releases of the iPhone app. Feel free to add your own here.  :)

• support/enforce any ACL filtered views so that varying levels of user access are possible depending on who logs in
• "cached" mode. Eg: when internet access is available and the opennms host is up, then make calls directly to opennms host. But when the link isn't there, maybe provide the ability for a user to view a locally stored cache of some recent data eg: outages, notifications etc - just for recent down stuff. Something like say twitter local caching, or say Bloomberg iphone app etc..... (some of this already works, but it's not well-supported)
• ability to have a user click on notification emails, firing up a mobile link to your app to open up the relevant node for further review within the app
• Be able to edit/view notes for nodes
• be able to take a photo of the device from Iphone app and upload to opennms (would be cool)
• geolocating a node using iphone current position information
• acknowledge notifications from iphone App (partially implemented; alarm acknowledgement will acknowledge associated notifications as well)
• be able to set/define tones/alarms for certain events
• split pane view on iPad (outage/alarm/node list on left, node or alarm details on right)

Installation

Installation occurs just like any other iPhone app. If you're a beta tester, you will receive binaries in e-mail which you can drag to your iTunes library. If you have purchased it through the iTunes App Store, you manage your installation through the "Apps" tab and the "DEVICES" section of iTunes.

Configuration

The first time you open the OpenNMS application for iPhone, it will ask you for the settings to reach your OpenNMS installation. If you need to reach the configuration again, tap the "About" tab, and then the "Settings" button.

Using SSL

If you have configured OpenNMS to use SSL, you must use a valid certificate, or import your SSL certificate into your phone if not. For example, if you are using a self-signed cert, the easiest way to get it onto your phone is to e-mail it to yourself. Once you view the mail on the phone, you should be able to click on the certificate to import it to your phone.

Version History

1.0.1

• fix crash in iOS devices < 3.2
• display IP address in IP interface list if no node label exists
• don't display ifSpeed in SNMP interface list if it is empty
• sort IP and SNMP interfaces in the node detail view

1.0.0

• Initial Release

Building

Source Code

The source is in git like any other OpenNMS source. To download the source, just run:

 git clone git://opennms.git.sourceforge.net/gitroot/opennms/iphone opennms-iphone
 cd opennms-iphone
 git submodule init
 git submodule update

To update, run:

 cd opennms-iphone
 git pull
 git submodule update

For details on working with Git in general, see the Developing with Git instructions.

Building the Project

Requirements:

1. You will need to be an iPhone Developer with an active account.
2. You must have your certificates, devices, and provisioning profiles configured.
3. You must create your own Application ID in the developer portal for the OpenNMS app.

Once you have XCode configured for your developer account and you have the OpenNMS iPhone app cloned from the Git repository, open the project (OpenNMS.xcodeproj) and browse to the Resources/OpenNMS_Client-Info.plist and edit the Bundle identifier to match the Application ID you created, here:

Then, go to: Project -> Edit Project Settings, select the "Build" tab, set the "Configuration:" selector to "All Configurations," and change the "Code Signing Identity" to your developer distribution key.

Also, make sure to edit the target as well: Project -> Edit Active Target "OpenNMS", select the "Build" tab, set the "Configuration:" selector to "All Configurations," and change the "Code Signing Identity" to your developer distribution key.