Step 1: First-Time Login

This section describes the first-time login to OpenNMS Horizon, how to change the admin account password, and how to create a user account.

For additional information and procedures on user management, including user groups, user configuration, and security roles, see User Management in the Deep Dive section.

First-time login and data choices

Access the Horizon web application at http://<ip-or-fqdn-of-your-server>:8980/opennms.

The default user login is admin with the password admin.

The first time you log in, we prompt for permission to allow the Data Choices module to collect and publish anonymous usage statistics to https://stats.opennms.org. The OpenNMS Group uses this anonymized information to help determine product usage and to improve the Horizon software. We do not share it with third parties.

prompt

Click Show me what is being sent to see what information we collect. Statistics collection and publication happen only if an admin user opts in.

Admin users can enable or disable usage statistics collection at any time.

Admin user setup

After logging in for the first time, make sure to change the default admin account password to a secure one:

  1. On the top menu bar, click admin  Change Password.

  2. Type the current and new passwords in the appropriate fields.

  3. Confirm the new password and click Submit.

We recommend that you do not use the default admin user account, but instead create specific users with the Admin role and other permissions. This helps to keep track of who has performed tasks such as clearing alarms or creating notifications.

Create a new user

For the purpose of this Quick Start guide, create one new user account for yourself, assign it the Admin role, and configure your email address and any other relevant contact information:

  1. Click the Gear symbol at the top-right of the screen.

  2. Under OpenNMS System, click Configure Users, Groups and On-Call Roles.

  3. On the Users and Groups screen, click Configure Users.

  4. Click Add New User, specify a user ID and password, confirm the password, and click OK.

  5. Enter your information:

    • In the User Information section, type your name in the Full Name box.

    • In the Security Roles section, select ROLE_ADMIN in the Available Roles list and click Add >> to add it to your account.

    • In the Notification Information section, add your email address in the Email box.

      • (Optional) Add other contact information (for example, a mobile phone number).

  6. Click Finish at the bottom of the screen to create the account.

You will need this user account for the next step: Turn on Default Notifications.

Do not delete the default admin and rtc user accounts. The rtc user account is used for the communication of the Real-Time Console on the start page to calculate the node and service availability. You should still change the password of the admin user to be more secure.