products:cockpit:1.0:userguide:orgs_onboarding
Table of Contents
Organization onboarding
You need to register a new organization with all its underlying systems and components
Prerequisites
- You must have the creation permissions for Organizations, Groups, Systems, Connectors and Users
- You must have the View all and Edit all permissions, or request those persmissions after having created the Organization
- You need to have connection parameters of at least a subset of devices (host, credentials, etc…)
Before you start
Short names
- Certain configuration elements necessitate the specification of a short name
- This short name serves as a user-friendly, distinctive ID, connecting all underlying components and data.
- Once created, they can never be changed.
- Therefore, it is crucial to thoughtfully determine the approach for defining these short names at each level, and we highly recommend establishing a naming convention in advance.
- Short names will be employed to form a resource locator that uniquely identifies a device, such as:
/my_org/this_group/this_system
Collectors
- The cockpit cannot directly connect to the devices and systems
- It uses one or several collectors as proxies to access those devices (see collectors)
- You must have at least one collector capable of reaching your devices if you want to be able to monitor them
- Only admin users can manage collectors, get back to them if you are not admin yourself
Configuration of monitored systems
- The monitoring section allows defining the relationship between the monitored components:
- Organizations: Holds groups of systems of a given company
- Groups: A group of systems
- Systems: A logical SAP system
- Connectors: The connection means to a system
Systems definition
Systems are organized within Organizations and Groups, this is where the configuration starts
- Navigate to the
Organizationsmenu and create new one.- The organization item will be used to identify a company owning the underlying devices
- Pay attention to carefully set its shortname
- Once created, use the plus button to create a group
- Groups can be used to organize your devices into sets of arbitrary groups (By country, by role, etc…)
- Systems within a group must be reachable from the same collector, keep that in mind when defining your groups
- Once at least a group is created, navigate to the
Groupsmenu to start creating your devices - You can also ask an admin to assign a collector to your groups
- Click on the plus button to create a System
- Choose the appropriate type of system
- Set a meaningfull title, try avoiding using too long title for the sake of display
- Carefully choose its shortname (System Id for SAP system is recommended)
- Once you have created your systems, navigate to
Systemsmenu and use the Add connnector button to start creating your connectors - For each system, you need to create at least one connector
- Each connector will have specific settings and prerequisites, refere to the dedicated documentation.
- Once a connector is created, you can test its connectivity by using the test button (Its group must be associated to a collector first)
Monitoring configuration
Once your connectors are defined, you can start to activate the monitoring. This is done in two steps:
- Create and configure Monitoring profiles
- Assign profiles to connectors
Configuration steps:
- Navigate to
Profilesmenu: - create or import the necessary profiles for your use case
- Navigate to
Connectorsmenu: - Select a connector by clicking on its name, it will open the monitoring configuration menu on the right.
- Select assign and choose one or several profiles
- You can optionnaly customize the monitors associated to each collector
- you can also test each monitor (Its group must be associated to a collector first)
- To start monitoring the system associated to a connector, Activate the connector by selecting its checkbox and press Activate selection button.
Collector association
- As soon as a group is created, it can be associated to one or several collectors
- This is a mandatory step if you want to be able to test connectors and monitors
- This operation can only be done by an admin user
Usage
Once configuration step is complete for a system, you can start visualizing and interacting with it via menus from the Applications section.
products/cockpit/1.0/userguide/orgs_onboarding.txt · Last modified: by 127.0.0.1

