ProKnow DICOM Agent: Configuring Services

Viewing Configured Services

To view your service configurations, point your browser to http://localhost:8768 to open the Management Console.  For security purposes, the Management Console can only be opened from the machine on which ProKnow DICOM Agent is installed.

The ProKnow DICOM Agent service must first be running in order to customize your configurations. If ProKnow DICOM Agent is running, you should see a page that looks like this.

Main_Component.png

Starting or Restarting the Service

In some situations, the service may fail to start. In these situations, you may receive a failed connection message in the browser instead of the page shown in the screenshot above. Follow the instructions below to start or restart the service.

  1. Open the Task Manager.
  2. Switch to the Services tab.
  3. Find the ProKnowDICOMAgentService (description: ProKnow DICOM Agent Service).
  4. Start the service if it's not running, or restart it if it is running.
  5. Wait approximately 10 seconds.
  6. Reload http://localhost:8768 in the browser.

Select the Services module from the main navigation on the left to view the services. Services are listed in the Services sidebar. Each item denotes its Name, AE Title, Port, and Status (Running or Stopped). The toolbar for each service contains buttons for starting and stopping the service, editing the service, and deleting the service.

Creating a Service

  1. Press the Create button in the Services sidebar header to open the Create Service dialog.
    Create_Edit_SCP_Service-General.png
  2. The dialog opens with the General tab selected.  Please enter values for these fields.
    • Service Name: The name of the new service.
    • Base URL: The base URL for your ProKnow organization. This is the first part of the URL when you are signed into your ProKnow account. It should be of the form https://my_custom_domain.proknow.com (replace my_custom_domain with the specific domain used to login to ProKnow).
    • Credentials File: The path to your credentials file. Use the Browse button to select the file. The credentials file should be a JSON file containing an object with properties "id" and "secret." This file may be generated from your account profile in ProKnow and should be stored on the local host machine under %UserProfile% (ex. C:\Users\my_user_name). See Managing API Keys for more information.  Note that once the service is created, this field will display the text "Valid."  This indicates that the credentials file was read and validated.

      CAUTION: The credentials file is read by the DICOM Agent each time the service starts and should not be deleted unless no longer used.

  3. Select the Source(s) tab.
    Create_Edit_SCP_Service-Source_s_.png
  4. Enable one or both DICOM sources and enter values for these fields.
    • C-STORE Storage Class Provider (SCP)
      1. AE Title: Application Entity Title. An AE Title is used by an Application Entity (AE) to identify itself. The value for this field must be 16 characters or less.
      2. Port: A number between 1 to 65535. It is recommended that you choose a port value of 1024 and above to avoid ports that are typically used for network services or a port value of 49152 and above to avoid ports that may be registered. See List of TCP and UDP port numbers for a list of well-known port numbers you may want to avoid.
    • Folder Watcher
      1. Root Folder: Select an existing folder using the Browse button. Any files placed within this folder or any subfolder will be processed just as if they were received using the standard DICOM protocol. Each file will be deleted once it is successfully processed. When all files have been deleted from a subfolder, the subfolder will be deleted.
  5. Please enter values for the fields in the Configuration and ProKnow sections.

    Enable Anonymization, if desired. If Anonymization is enabled, you must select a Rules File from any of your customized anonymization configurations.

    Select the Download Example link to download an example rules file that you can use as a template to inspect, edit as desired, and save as one of your own.

    NOTE: You can create multiple rules files for different DICOM Agent services.

    CAUTION: Anonymization by ProKnow DICOM Agent is irreversible. It is possible, however, to save local copies of the original content of received DICOM objects. See the instructions for the Local Storage (Original) section below.

    CAUTION: It is critical that the Rules File be configured for the variety of DICOM content that may be transmitted to ProKnow DICOM Agent. See Configuring Anonymization for more detailed instructions.

    CAUTION: Do not re-transmit DICOM that has already been anonymized. This may prevent DICOM objects from being properly associated with the patient or other DICOM objects with which it was previously associated.

    Enable at least one of the  ProKnow Cloud Storage , Local Storage (Original), or Local Storage (Anonymized) sections. At least one section must be enabled.

    • If the ProKnow Cloud Storage section is enabled, you must select a Workspace. Services configured with this option will store received DICOM objects in ProKnow DS within the specified workspace. Either the anonymized content or original content will be uploaded to ProKnow DS, depending on whether or not Anonymization is enabled.
    • If the Local Storage (Original) section is enabled, you must provide a Root Folder location, which you can select using the Browse button. Services configured with this option will store the original content of received DICOM objects locally (in the Root Folder location).
    • If the Local Storage (Anonymized) section is enabled, you must provide a Root Folder location, which you can select using the Browse button. Services configured with this option and with Anonymization enabled will store the anonymized content of received DICOM objects locally (in the Root Folder location).

    Permissions and the Credentials File

    The API key that you create and download from ProKnow inherits the permissions of the user who created it. This user must be active for the credentials to be valid. In addition, to use the ProKnow Cloud Storage option, the user must have the View PHI, Upload DICOM, and Write Patients permissions on the specified workspace.

  6. Press the Create button.

Starting and Stopping a Service

The status of a service is displayed in the upper right hand corner of the service row. To start a stopped service, press the Start button from the service toolbar. To stop a running service, press the Stop button from the service toolbar and use the Stop Service dialog to confirm the operation.

Editing a Service

To edit a service, the service must be stopped. Once it has been stopped press the Edit button, use the Edit Service dialog to make changes to the service, and then press Save.

Deleting a Service

To delete a service, the service must be stopped. Once it has been stopped press the Delete button, and use the Delete Service dialog to confirm the operation.

Troubleshooting

Symptom Solution(s)
Creating a service fails Verify that the Base URL is correctly formatted as https://your-domain.proknow.com. This URL can be obtained from your browser's address bar when you are signed into ProKnow. It SHOULD include https://.
Ask your IT department to verify that the proxy and firewall settings for the workstation and network will allow access to your ProKnow domain. For more information, see the Whitelisting ProKnow DS Traffic support article.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.