Versions Compared

Old Version 12

changes.mady.by.user Josune Cordoba

Saved on

compared with

New Version 13

changes.mady.by.user Josune Cordoba

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

Opmantek System Configuration is a new admin tool to edit all the NMIS and Opmantek configuration and to manage all nodes from a unified, centralised and easy to use GUI. 

Image Removed

This is available under the following link:

Image Removed

In a opHA environment, it is also possible to manage remote nodes. Even relocate the nodes from one poller to another. 

Image Removed

Info
titleURL

http://myserver.domain.com/en/omk/admin

Custom role types

...

Table of Contents

Introduction

Opmantek System Configuration is a new admin tool to edit all the NMIS and Opmantek configuration and to manage all nodes from a unified, centralised and easy to use GUI. 

Image Added


This is available under the following link:

Image Added


In a opHA environment, it is also possible to manage remote nodes. Even relocate the nodes from one poller to another. 

Image Added

Info
titleURL

http://myserver.domain.com/en/omk/admin

Custom role types


Info

If we have custom net types, nodes or custom role types in any poller, we also add this types into our nmis configuration file (nmis9/conf/Config.nmis) in the master: 

"roletype_list" => "default,core,distribution,access",
"nettype_list" => "default,wan,lan,vpn,man,san,voice",
"nodetype_list" => "default,generic,switch,router,firewall,server",

...

OperationMethodURLExample
AuthenticatePOSThttp://host/en/omk/admin/login

http://uburnto.opmantek.net/en/omk/opHA/login


Code Block
{"username": "username",
"password": "password"}


We should receive a 200 response and a cookie, that we can reuse for next API calls. 

...

Create a remote

...

Node

If we want to create or update a node in a remove remote cluster, we should indicate the remote cluster id in configuration.pollers: Cluster_id. 

E.x.

Create RemotePOSThttp://host/en/omk/admin/api/v2/nodes

http://uburnto.opmantek.net/en/omk/admin/api/v2/nodes


Code Block
{"configuration":{"pollers":"configuration":{"pollers": "a515c63a-0d11-4bcb-a402-39a4600aebb9", "netType":"default","polling_policy":"default","port":"161","collect":1,"threshold":1,"roleType":"default","ping":1,"group":"NMIS9","host":"asgard.opmantek.net","location":null,"customer":null,"businessService":null,"notes":"","host_backup":"","active":null,"community":"","wmiusername":"","wmipassword":"","username":"","context":"","authpassword":"","authkey":"","authprotocol":null,"privpassword":"","privkey":"","privprotocol":null,"serviceStatus":null,"nettype":null,"roletype":null,"node_context_name":"","node_context_url":"","remote_connection_name":"","remote_connection_url":""},"activated":{"opEvents":"1","opConfig":"0","NMIS":"1"},"uuid":null,"current_user_privileges":{"update":true,"delete":true},"name":"test","friendly_addresses":"","friendly_aliases":""}


It will return: 

Code Block
{
    "activated": {
        "NMIS": 1,
        "opConfig": "0",
        "opEvents": "1"
    },
    "cluster_id": "a515c63a-0d11-4bcb-a402-39a4600aebb9",
    "

...

configuration": {
        "active": 1,
        "aliases": [],
        "authkey": "",
        "authpassword": "",
        "authprotocol": null,
        "businessService": null,
        "collect": 1,
        "community": "",
        "context": "",
        "customer": null,
        "group": "NMIS9",
        "host": "asgard.opmantek.net",
        "host_backup": "",
        "location": null,
        "max_msg_size": 65535,
        "max_repetitions": 0,
        "netType": "default",
        "nettype": null,
        "node_context_name": "",
        "node_context_url": "",
        "notes": "",

...

It will return: 

Code Block
{
        "ping": 1,
        "pollers": "a515c63a-0d11-4bcb-a402-39a4600aebb9",
        "polling_policy": "default",
        "port": "161",
        "privkey": "",
        "privpassword": "",
        "privprotocol": null,
        "remote_connection_name": "",
        "remote_connection_url": "",
        "roleType": "default",
        "activatedroletype": {null,
        "NMISserviceStatus": 1null,
        "opConfigthreshold": "0"1,
        "opEventsusername": "1"
,
   },     "cluster_idwmipassword": "a515c63a-0d11-4bcb-a402-39a4600aebb9",
        "configurationwmiusername": {""
    },
    "activefriendly_addresses": 1,
    "",
    "friendly_aliases": []"",

       "authkeyname": "test",
    "uuid":    "authpassword": "",
        "authprotocol": null,
        "businessService": null,
        "collect": 1,
        "community": "",
        "context": "",
        "customer": null,
        "group": "NMIS9",
        "host": "asgard.opmantek.net",
        "host_backup": "",
        "location": null,
        "max_msg_size": 65535,
        "max_repetitions": 0,
        "netType": "default",
        "nettype": null,
        "node_context_name": "",
        "node_context_url": "",
        "notes": "",
        "ping": 1,
        "pollers": "a515c63a-0d11-4bcb-a402-39a4600aebb9",
        "polling_policy": "default",
        "port": "161",
        "privkey": "",
        "privpassword": "",
        "privprotocol": null,
        "remote_connection_name": "",
        "remote_connection_url": "",
        "roleType": "default",
        "roletype": null,
        "serviceStatus": null,
        "threshold": 1,
        "username": "",
        "wmipassword": "",
        "wmiusername": ""
    },
    "friendly_addresses": "",
    "friendly_aliases": "",
    "name": "test",
    "uuid": "6ce5fd5c-d703-4d03-b36c-b8e01439a9f2"
}

...

"6ce5fd5c-d703-4d03-b36c-b8e01439a9f2"
}

Update a remote Node

If we want to create a node in a remote cluster, we just need to indicate the remote cluster id in cluster_id:

E.x.

Create RemotePUThttp://host/en/omk/admin/api/v2/nodes/node_uuid

http://volla.opmantek.net:6042/en/omk/admin/api/v2/nodes/6ce5fd5c-d703-4d03-b36c-b8e01439a9f2 


Code Block
{"cluster_id": "a515c63a-0d11-4bcb-a402-39a4600aebb9", "configuration":{"netType":"default","polling_policy":"default","port":"161","collect":1,"threshold":1,"roleType":"default","ping":1,"group":"NMIS9","host":"asgard.opmantek.net","location":null,"customer":null,"businessService":null,"notes":"","host_backup":"","active":null,"community":"","wmiusername":"","wmipassword":"","username":"","context":"","authpassword":"","authkey":"","authprotocol":null,"privpassword":"","privkey":"","privprotocol":null,"serviceStatus":null,"nettype":null,"roletype":null,"node_context_name":"","node_context_url":"","remote_connection_name":"","remote_connection_url":""},"activated":{"opEvents":"1","opConfig":"0","NMIS":"1"},"uuid":null,"current_user_privileges":{"update":true,"delete":true},"name":"test","friendly_addresses":"","friendly_aliases":""}


It will return the json node, the same structure that the CREATE. 

Remote Nodes Error

If any operation has a remote cluster id, the API will try to edit in the remote server. If this operation is not possible, it will fail. 

...