Skip to main content
Matrix42 Self-Service Help Center

Connector I: Empirum Connector

Connect Empirum API

Empirum API

Install and Configure Services

  • Open DBUtil
  • Login 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 which 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 Username for logging into Empirum
Password w.g. Pa$$w0rd The Password used for your target Empirum Instance.
  • Press Save
  • Click Close
  • Click Done

Empirum Connector

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

Configure Empirum Connector

  • Log in to Unified Endpoint Management with Administrator credentials
  • Click on the Launcher icon on the top right
  • Navigate to Administration
  • Select Integration
  • Choose Connectors
  • Double Click Empirum
  • Select Locations from the left pane
  • Click +
  • Enable Encrypt WCF communication
    • Enter as Name e.g. your Location Name
    • Select your Version 
    • Enter your Server Name, e.g.
      • the IP Address
      • empirum.imagoverum.com
    • Enter as User account your Database User
  • Under Option for full computer inventors
    • Uncheck Login to Empirum Web Console under Web Service User Account
  • Under Import Options
    • Enable import inventory data
  • Click OK
  • Enable the checkbox next to your Location Name
  • Press Save
  • Press Done
  • Select again Empirum
  • Press Enable

Next Steps

  • Was this article helpful?