Connector I: Empirum Connector

+ More

Table of Contents

Connect Empirum API Empirum API Install and Configure Services Add your Empirum API Settings Add your Empirum Web Console (Optional) Empirum Inventory and Service Provisioning Install and Configure the Empirum Inventory Data Provider Install and Configure the Empirum Service Provisioning Data Provider Next Steps

Connect Empirum API

Empirum API

Install and Configure Services

  • Open DBUtil
  • Log in with your Database User 
  • Select your Location
  • Select Actions
  • Choose Install/configure Services
  • Select Empirum-API
  • Configure additional settings (optional)
  • Perform a right click
  • Click Install 
  • Wait until the process is finished
  • Confirm with OK

Add your Empirum API Settings

  • Log in to Unified Endpoint Management with Administrator credentials
  • Click on the Launcher icon on the top right
  • Navigate to Unified Endpoint Management
  • Click Settings
  • Click Edit
  • Provide the following information Empirum API Settings
Setting Example Description
Protocol
  • net.tcp
  • http
  • https
 Please specify the protocol type of your Empirum API Service installation is configured and running at. You can select either net.tcp, http or https in the drop down menu, depending on your Empirum-API configuration on your Empirum Server.
IP Address e.g. 10.0.0.10 Please specify the name or the IP address of your Empirum API Service (Empirum Server).
Port e.g. 9100 Please specify the port number on which your Empirum API is configured to listen. The default port for TCP is 9100. You can find these information at your Empirum Server. Start Empirum DBUtil and navigate to Install/Configure Services > Empirum-API.
Username e.g. sa Please specify an Empirum user to access the Empirum-Database.
Password e.g. Pa$$w0rd

Please enter the password of the specified Empirum user. The password will not be shown in the UI and will be saved encrypted.

In order to verify the settings please first save any changes and then use TEST API SETTINGS to verify connection.
Time Zone (Server) e.g. (UTC+01:00) To cover the time zones e.g. different time zones in the company, you have the option under Time Zone to select the corresponding time zone set on the Empirum server. The default setting is (UTC) Coordinated Universal Time.
Adjust for daylight saving time automatically Enabled or Disabled Check the box if you want to change the time to summer/winter time automatically. For the summer time applies: The time change takes place on the last Sunday in March. At 2 o'clock the clock will be set an hour ahead. For the winter time (normal time) applies: The time change takes place on the last Sunday in October. At 3:00, the clock will be turn back by one hour.
  • Press Save
  • Navigate back to Settings
  • Click Edit again
  • Click TEST API Settings
  • When your connection is successful Empirum Endpoint could be reached will be shown. 

Add your Empirum Web Console (Optional)

In this section, you can configure a connection to an Empirum Web Console instance that can be set up for your UEM Environment. For further information on how to set up an Empirum Web Console, please read this article.

Setting Example Description
Protocol
  • http
  • https
 Here you can specify the protocol being used for the Empirum Web Console. You can either choose http or https. The protocol must match the used protocol of the service management server. If the console uses https the EWC must also use https. 
Path to EWC e.g empirum.imagoverum.com/WebConsole/ Here you can specify the IP Adress with Port to your Empirum Web Console (Example: 11.1.31.123:8443/empirum)
Location e.g. EmpImagoverum Here you can specify the Instance Location ( Empirum Database Name) that should be used.
Domain e.g. imagoverum Domain
Username e.g. sa Here you can specify the Username for logging into Empirum
Password Style
  • Encrypted
  • Unencrypted
 Here you can specify the Password for logging into Empirum
Password e.g. Pa$$w0rd The Password used for your target Empirum Instance.
  • Press Save.
  • Click Close.
  • Click Done.

Empirum Inventory and Service Provisioning

Please start with the following guides and proceed afterwards with the next chapter.

Install and Configure the Empirum Inventory Data Provider

Install and Configure the Empirum Service Provisioning Data Provider

Next Steps

Related Articles