Installing Equator
Overview:
Provides a procedure to install and configure Medical-Objects Equator.
Install and Configure Equator Software
1. Download the latest Firebird 2.1 installer from: http://www.firebirdsql.org/
During the Firebird install ensure you choose to install as a "Classic" server and also to store firebird libraries in the System32 directory.
2. Download the latest Equator setup program from the site provided by Medical-Objects helpdesk. It is not listed on the main download web page.
Continue through the install until you get to the path to install to. The default path is C:\HL7Applications\<Equator name> So in this case we are installing an equator called “Capricorn Test Equator” the path will be C:\HL7Applications\Capricorn Test Equator
Now follow the prompts to continue through the install, & choose “Launch Equator” at the end.
Registration Process
1. Once the setup is complete you will need to enter the Token or Serial key that you will acquire from the Medical-Objects help desk
The Token or Serial Key can be emailed to you.
2. From the email, copy the token, click the blue Paste Token link
This will automatically fill in the Registration Token for you.
3. Click Enter
4. Enter the IP address or host name of the Firebird database server, and the path of the directory on that server which should contain the database that is about to be created. Click Install Database when settings are as you wish. Leave the Database Host name blank if the server is Firebird is to be run in embedded mode without a listening service. Generally it is recommended that "127.0.0.1" or "localhost" be entered when Firebird service is running on the local machine.
5. The database will get created
6. Once you have clicked Enter, the PGP Key Generation Window will appear
7. Enter pgp in lowercase into both fields. Then click Next
8. Once you have clicked Next, the following window will appear
9. At this window just type anything to make the blue bar move to 100%, then click Next
NOTE: What you type should be in lowercase.
10. Once you click Next, the following window will appear
11. Click Finish
NOTE: The main installation is now complete. The HL7 tray icon will now be shown in the system tray located at right hand bottom of the desktop.
Configuring Equator Software
1. Double click the HL7 Tray icon.
Note: If the Equator HL7 tray icon is not visible, open Equator from the Start Menu > All Programs > Medical-Objects > Medical Objects Equator or from the C:\MO\HL7Server\Equatordxtray.exe
2. The Log window is displayed
3. Click the Edit Server Properties icon
4. The Login screen will appear as shown below
5. Enter the following Username and Password and then click OK
Username: SYSDBA Password: masterkey
6. Click on Server Parameters in the left hand side panel
On the server parameters page it is important to choose at this point the model of server that you wish to run. Different server types have different "business logic", which cause HL7 messages to be processed differently, and may even be represented differently in the database for optimal processing.
The following types are most common:
Practice Server
- The most common type of server. Use this one if you plan to use the Equator as an information
repository that will be interacted with by clinical staff in the practice through clients
such as Medical-Objects Explorer to create reports and view inbound clinical content.
- A practice server will deliver multiple messages one for each "copy doctor" for a single
HL7 message from a client.
Gateway
- Use when the server will be used to route HL7 messages from a source system. Use this when
you want to integrate a third party system for delivery of reports with the Medical-Objects
messaging network. This type of server does not support many of the functions of a practice
server such as patient lookup, but it provides optimal performance for extremely high volume
traffic. It preserves the HL7 messages from the source system without modification for
secure transmission.
- A gateway server will deliver a single message only to the specified target doctor. A third
party system must provide multiple messages, one for each "copy doctor" recipient that is
intended to receive electronically.
VERY IMPORTANT NOTES:
- Make sure “Mirror ZDLs without Registration” is NOT ticked.
- In “Scheduled Tasks” make sure that “See if any Routing records are out of date” is DISABLED.
7. Scheduled Tasks.
| Task Name | Time | Notes |
| Backup Important Files | Anytime | |
| Perform Firebird Backup | 9pm to 4am | |
| Zip Archive Files | Anytime | Make sure the number of days is set |
| Update Routing Records | Anytime |
8. You will notice that the log shows that there is a routing response error (see screenshot below) because it can’t talk to the routing server. So we need to now set this up correctly.
9. Login to your equator as normal (User=SYSDBA Pass=Masterkey)
10. Click on ‘Administer Routing’ on the left hand menu and on the right hand side under ‘Medical-Objects Server’ choose ‘ROUTING SERVER’ from the drop down menu and click Apply.**
11.
- Note – The ‘Medical-Objects Server’ field varies depending on the server machine you are installing your equator on. For the “Equator” server the path should be ‘ROUTING SERVER’ as we have chosen above. However, if you are installing your equator on a different server be sure to check which Medical-Objects server to use.
12. Now that we have chosen ‘ROUTING SERVER’ we need to let this server know of the presence of your new Equator. Choose ‘Server Setup’ from the left hand menu, and highlight ROUTING SERVER on the right hand side.
Now click the ‘Edit’ button and click Next 3 times. Then click ‘Retrieve Key’ If it says that the key is already on your keyring just click OK.
Then click next again and click ‘Sign Key’ and ‘Yes’
Click next again and click ‘Upload Public Key’ to upload your Equator key back to the Routing Server.
Ignore the ‘Contact Details’ and ‘Your Public Key Properties’ window Click next twice and click ok to complete the wizard.
13. Now choose PGP Configuration from the left hand menu.
Choose ‘Edit Keyring’ from the right hand side and the PGP key manager Will Appear.
Make sure ‘Routing information Service’ (the full name of ROUTING SERVER) appears in the list and has 2 green icons to the right of it. (As below)
If it does not have the green icons but a red one instead. Right click it and choose ‘Sign’
You can now click Ok to exit the PGP Key Manager and also click OK to exit the Equator configuration Menu.
14. Finally you will have to contact Medical Objects Support to have the key you uploaded sign and given permissions on the Routing server. Phone 0754566000
