Skip to content

Service Setup & Manager Manual

mihai-stfc edited this page Mar 3, 2021 · 3 revisions

HLM Service & Manager Instructions

Installing the service

  • Make sure the service executable is named "HlmService.exe"
  • Run/Double click "service_setup.bat", grant admin privileges when requested
  • Confirm the service has been installed and is running (in Services or CMD with sc query HlmPvImport)

Starting the HLM Manager

  • Please make sure to start the HLM Manager in Administrator Mode (Right Click -> Run as Administrator), otherwise some functions will not be available (e.g. service control, DB connection settings)
  • On first start, service directory will be requested. Enter the path, or browse for the directory, then press OK. Note: The service directory is the folder containing the HlmService.exe
  • The manager's main window should now be shown, displaying the Service Status & Details, PV Configurations and Service Log.

Manager Setup

  • Settings can be viewed and changed at any time from the menu bar.
    • General Settings - the HLM Manager general settings
    • Channel Access - EPICS CA Address List, PV prefix & domain, connection timeout etc.
    • DB Settings - Database Connection settings & credentials (host, DB name, user, password)
    • Service Directory - can be updated at any time
  • Please ensure the settings are correct (e.g. DB is connected) before continuing.
    • If the EPICS CA Address List is not provided, the service will not be able to connect to PVs.

Service Control

  • The service name, status and details will be displayed on the top of the main window (e.g. HLMPVImport is STOPPED).
    • If "Service not found" is displayed, please make sure the service directory is correct, and the service has been installed.
  • The service can be started, stopped and restarted from the buttons. Note that without admin privileges the buttons are disabled.
  • When changing settings or updating the PV configuration, the SERVICE MUST BE RESTARTED FOR ANY CHANGES TO TAKE EFFECT.

Adding a new PV configuration

  • Each object in the database, such as a gas bladder, can have one PV configuration. The object will be regularly updated with new measurements storing the PV values.
  • To add a configuration, an existing object from the database can be selected, or the name of a new one (to be created) can be entered. For an existing object, the Type and Comment fields will be updated from the database.
    • In case of a new one, they must be selected/entered (comment is optional).
  • For both cases, an update interval must be given (default is 60 minutes). This is how often the object will be updated with new PV values through measurements.
  • Up to 5 PVs can be added. On the right of each PV name field, the object's class measurement type should be displayed (e.g. for a Gas Bladder, measurement #4 represents Temperature in K, while #3 is Battery %).
    • Depending on the object type/class, some measurements do not have a type, in which case the HZB app may not be able to read the values from its measurement.
  • Note: Vessels, Cryostats and Gas Counters receive measurements through SDL (Software Level Device) objects. The creation of SDLs and their relation with the object is handled automatically by the manager.