The CORE HL7 Listener Windows Services
You have done everything and now you are ready to run your system. You have:
•Activated a license of some type.
•Configured your Global Settings.
•Created and Enabled 1 or more Listener Profiles.
NEW! Something really special. Starting with version 1.5 you can create Private Windows Services which will run a single Listener profile. See Private Services for more information!
•So now you want to run your CORE HL7 TCP/IP Listener and start using it to receive HL7 messages. Before you run a profile in your Windows Services you might want to test it first by Running It Locally. If needed try out our FREE CORE HL7 TCP/IP Simulator to deliver messages to your Listener(s).
Step 1. Installing Your Services
Step 1. Install Your Windows Services
At this point you need to click Install Services to register your CORE HL7 Listener services in the Microsoft Windows Services list. Installing the services just means registering your CORE HL7 Listener services in the MS Windows Services list as shown below.
After Installation with 4 services installed
IMPORTANT: For the Install Services or Remove Services buttons to work properly the CORE HL7 Listener Configuration program (CoreHL7ListenerConfig.exe) must be running as a user who is also an Administrator for the local machine. The software will tell you if there's a problem when you click the buttons. If this is not you then you may need to contact your network or security administrators to log in and do this for you. You / They can also install the services from a Windows Admin Command Prompt. Just click to show the services report and it will show you the necessary command lines needed to install or remove each service.
HINT: Anytime that the Install Services button is enabled you should click it. The installation operation will install any of your services that need installing, for instance, if you create a new profile and assign it to a service instance which has not been registered yet. It will also remove any services which need removing, for instance, if a service IS installed but no longer has any enabled listener profiles assigned to it.
Step 1a. Removing Your Services
IMPORTANT. You will want to remove your services FIRST if you ever need to uninstall the software. Uninstalling the software will not remove the services from the Windows Services list. Just make sure that your services are stopped and click Remove Services.
Step 2. Starting and Stopping Your Services
Step 2: Start Your Services
Click Start on the toolbar which issues a Service Start command for all installed services.
HINT: If you click Start and don't see a change in the status click refresh ().
Step 2: Start Your Services (Continued)
To stop your services just click Stop which issues a Service Stop command for all running services.
You can see a complete breakdown of the toolbar and what the buttons do in The Main Window.
It is very important to remember that running a profile locally is NOT the same as running a profile in a Windows Service. The most common support contact we have EVER had for our server products is because people misunderstand this issue.
When you run locally the program is executing as YOU (the Windows User) and (unless YOU changed it) the Windows Service is NOT. By default the Windows Service will run as the built-in Windows account LocalSystem.
This means that IF when you created your listener profile(s) you selected a data folder which resides on a network share, mapped drive, or NAS (Network Attached Storage) device, you may have an issue when your CORE HL7 Listener services try to run. This is because when running locally YOU have access to these network resources while the service, running as LocalSystem, likely does NOT.
Luckily, if you encounter this scenario, there are a couple of easy fixes to resolve.
1.Change your listener profile and select a data folder which resides on a local HDD and share that folder on your network so that other applications can access it.
2.If #1 is not an option, you will need to modify your CORE HL7 Service(s) and have them run as a Domain User which DOES have access to the network resource you are trying to use. To this just click on the toolbar to open the MS Windows Services, then RIGHT CLICK on the preferred service and select Properties. In the Service Properties go to the Log On tab and enter the domain user you (or your network admin) have created to run the service(s).