user_guide.md

July 24, 2023 · View on GitHub

User Guide

User Guide

User Management

Create User

You can create a user by click the button “CREATE A USER”

Three default roles have been created.

Admin: The system administrator role
User: Role for general User to access Flowgate through UI
API: role for user who want to access Flowgate through API

Select one or multiple roles for the new user.

Create Role

Admin can create new role according to the permission requirement.

Select privileges for the new role

Click Next to enter new role name.

Click finish to create the role.

Click “SHOW MORE” to view the role privileges.

Datacenter Facility System Integration

Flowgate itself doesn’t have any data. Before IT users can use it. Flowgate Administrator need to integrate Facility systems first. Currently it supports integrate with Nlyte, PowerIQ, Infoblox and Labsdb by default. More facility systems will be supported later. As far as Flowgate is an opensource project, user can develop their system adapter easily when needed.

Integrate with Nlyte

Navigate to Data Center Facility->DCIM click the “ADD NEW INTEGRATION” button.

Select the “Type” as Nlyte.
Input the Nlyte server address, it can be either an IP or a FQDN address.
Input other fields value accordingly
For the VerifyCert option. If your Nlyte use a self-signed certificate, you should choose “no” which means not verify the certificate, otherwise Flowgate will not be able to connect to the server.
Click “SUBMIT” to save the setting. If any error happens, please update the input fields according to the error message.

If you have multiple Nlyte server then repeat the steps in 1~6.

If the metric unit in your Nlyte is different with the default ones. Please modify it accordingly. You can contact your Nlyte administrator for the default metric unit.

Integrate with PowerIQ

Navigate to “Data Center Facility->DCIM” click the “ADD NEW INTEGRATION” button.
Select Type as "PowerIQ"
Input Server IP (Or FQDN), Name, Username, Password and other fields.
For the VerifyCert option. If your PowerIQ use a self-signed certificate, you should choose “no” which means not verify the certificate, otherwise Flowgate will not be able to connect to the server.
Click “SUBMIT” to save the setting. If any error happens, please update the related fields according to the error message.

If you have multiple PowerIQ servers, repeat step 1-5.

Click the “Advance Setting” to check the default metric unit for your PowerIQ server. Please contact to your PowerIQ administrator to get the correct unit.

Integrate with Openmanage

Navigate to “Data Center Facility->DCIM” click the “ADD NEW INTEGRATION” button.
Select Type as "Openmanage"
Input Server IP (Or FQDN), Name, Username, Password and other fields.
For the VerifyCert option. If your Openmanage use a self-signed certificate, you should choose “no” which means not verify the certificate, otherwise Flowgate will not be able to connect to the server.
Click “SUBMIT” to save the setting. If any error happens, please update the related fields according to the error message.

If you have multiple Openmanage servers, repeat step 1-5.

Integrate with Infoblox

Navigate to “Data Center Facility -> CMDB” click the “ADD NEW INTEGRATION” button.
Select Type as “InfoBlox”
Input Server IP (Or FQDN), Name, Username, Password and other fields.
For the VerifyCert option. If your Infoblox use a self-signed certificate, you should choose “no” which means not verify the certificate. Otherwise Flowgate will not be able to connect to the server.
Click “SUBMIT” to save the setting. If any error happens, please update the related fields according to the error message.

If you have multiple Infoblox servers, repeat step 1-5.

Data Center Facility Systems management

Navigate to “Data Center Facility->DCIM”

Edit

Administrator can update the Facility system information when required.

Delete

Administrator can delete a facility system integration.

Sync Data

Administrator can force to sync data for each facility system with “Sync Data” button. This will trigger a job to pull all the data from related facility system immediately. Please Note we have backend jobs to sync the data in different frequency. E.g. static data will be synced daily. Sensor data will sync every 5 minutes. For most of the case you don’t need to sync the data manually.

Pending/Resume Data syncing

Administrator can stop a system’s data syncing by click the “Pending” button. You can re-active a pending integration by click the “Active” button.

Status Monitor

The facility systems’ status can be monitored by the “Status” column. When error happens click the red “!” flag will show the detail information. Follow the instruction to fix the issue. After you fix the issue, you need to click the “Active” button to re-active the integration.

Setting

Summary page

View Facility information by system

Click on 'SYSTEM' card, the Data Center Facility System page will show up.

The facility information will be displayed group by system. If a facility items showed up in different systems, it will only count once in the total number.

View Sensor summary

Click the ‘SENSORS’ card will show the sensor summary.

Currently it only counts the humidity, temperature, airflow, smoke and water sensors. More sensor type will be supported later.

View Asset Topology by vCenter

Click “System Setting -> Asset Topology”, select a vCenter server. It will display the asset topology for the vCenter

Servers, PDU and switch connection information. Take host 10.192.76.21 for example from the topology diagram we can see that it connects to network switch “switch02” on port 02. It also connects to PDU sc1-g03-pdu-red on port 23 and PDU sc1-g07-pdu on port 18 as the follow figure shows.

Sync Data

Aggregate Server Mapping job

This job is used for aggregate server mapping items between different IT systems. Administrator can run this job to reduce the mapping items.
This job will automatically be executed weekly. Administrator can trigger it manually anytime when required.
For example, if an ESXi host is managing by vCenter A and Aria Operations B. Both vCenter A and Aria Operations B registered to Flowgate. Flowgate will create two mapping items for the same ESXi host. When the job runs it will merge the two items into one.

Aggregate PDUs and Server Mapping job

“Setting->System Setting ->SyncData” Click the “TRIGGER” button for the “Trigger aggregate PDUs and Server Mapping job”

This Job is used to create the mappings between PDUs and Server.
After you trigger this job. You can find that PDUs filed in vCenter will be filled. Please NOTE this job will also be automatically executed hourly in the backend.
Before running the job, you will find the Asset.PDUs field in the Custom Attributes section is empty.

After running the job, the Asset.PDUs field is filled with value “sha1-r17-l, sha1-r17-r”. it means it connected to two PDU. “sha1-r17-l, sha1-r17-r" are the names of the two PDU.

Sync Server and Sensor Mapping Job

This job is used to create the mapping between the sensors in datacenter and servers. Flowgate will use some most possible algorithm to calculate the sensors that can indicate the servers' environment.
This job will also be running hourly in the backend automatically. But you can always trigger it mannully when required.

List UN-mapped servers

List out all the servers that not mapped to a facility asset yet. Usually this mean that Flowgate cannot automatically create the mapping between a host in IT system and a server in the facility system.

When this happened it usually mean there are some data mismatch between the facility systems. Facility system administrator can use this to check the related system.

Asset Name and IP Mapping

In Flowgate we use IP address and assetName to create the connections between IT system and Facility system. In case that we don’t have IPAM system(eg, Infoblox) , we can manully create the mapping relations here.

Create Mapping

Click ADD button.
Input a valid IP address.
Type the AssetName, select the right one from the dropdown list.
Click “Save” to save the mapping.

Search Mappings by IP

Input an IP address
Click “SEARCH” button

Edit Mapping

Select a mapping item.
Click “EDIT” button
Input the new mapping information.

Delete a mapping

Select a mapping item.
Click “DELETE” button

Batch add mappings

Click “BATCH ADD” button

Select a mapping file contains IP addresses and hostnames. Each line of the file should only contain one IP and AssetName pair, they should be separated by a whitespace, for example: IP1 assetName1 IP2 assetName2
Click “UPLOAD” button to import the mappings.
In case you see the follow screen, it means that some item in the file are not valid. Please check it accordingly and import the failed items again.

Asset Management

User can manage the assets created through the UI here. Other assets feed by DCIM adapters are not supported.

Add Asset

Click "ADD NEW ASSET" button
Fill in asset information
Add asset location and click "Submit" button
Then you can see it in the asset list

Edit Asset

Click and click "Edit" button
Edit your asset
You can also edit json directly through advanced function

Delete Asset

Click and click "delete" button
Click "OK" to delete asset

Custom Facility Adapter Management

Please refer to Custom Adapter Guide.

IT System Integration Management

IT system integration

IT System admin can integrate their IT systems to Flowgate, after that Flowgate will push facility data to IT system accordingly.

Integrate with Aria Operations

Navigate to IT Management -> VMware and click the “ADD NEW INTEGRATION” button
Select the server Type: Aria Operation Manager.
Input the server IP (or FQDN)
Give a name for this Integration
Input server username and password.
For the VerifyCert option. If your Aria Operation Manager use a self-signed certificate, you should choose “no” which means not verify the certificate. Otherwise Flowgate will not be able to connect to the server.
Click “SBUMIT” to finish the integration.

Repeat step 1-7 if you have more than one Aria Operation Manager servers.

Integrate with vCenter

Navigate to IT Management -> VMware and click the “ADD NEW INTEGRATION” button
Select the server Type: vCenter Server.
Input the server IP (or FQDN)
Give a name for this Integration
Input server username and password.
For the VerifyCert option. If your vCenter server use a self-signed certificate, you should choose “no” which means not verify the certificate. Otherwise Flowgate will not be able to connect to the server.
Click “SBUMIT” to finish the integration.

If you have more vCenter servers, then repeat the above step 1-7.

Click “ACTION” -> “Mapping Server asset”
Search the Server Asset by name.
Select the right server and click OK( you can identify the server by Location, SN, Tag, Cabinet information, etc)

Update server mapping

Click “ACTION” -> “Mapping Server asset”
Search the Server Asset By name.
Select the new Server Asset and click OK.

If you just want to cancel the mapping, you can uncheck the “check box” after the “SEARCH” button then click “OK”.

Mapping PDUs for Server

Click “ACTION” -> ”Mapping PDU asset”
Search the PDU by name.
Select the PDUs that connected to the Server. You need to contact you Datacenter Operator to get the correct PUD items.
Click “OK” to Save the mapping.