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.

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.
   
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. 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, validated, and the credentials were stored in the database.
3. Select the Source(s) tab.
   
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