Dictionary Import Tool

Making sure you can deploy the OpenMRS application with Web services

Before deploying, please ensure the following:

• You must be using code checked out from /branches/dictionary_import, revision 1539 or later
• You must be compiling with a tools.jar library from JDK 1.5 update 1 or later (earlier versions will result in NoSuchMethodError during compilation).
• Recommended that you build in Eclipse

Preparing to use the Dictionary Import tool

Before using the Dictionary Import tool, please ensure the following:

• For the Parent server, it is important that the ConceptWebService is enabled. Do so by making sure there is a Global Property called "webServices.allowServices", and that the value contains the word "ConceptWebService" (case does not matter).
• For the Child server, you must have a valid login to the Parent server (right now, Dictionary Import requires authentication, although soon this will be moved to a global property for easy modification).
• For the Child server, if the Parent server with the dictionary to be imported uses SSL, i.e. the address starts with "https", then you will need to import its certificate into a keystore that's accessible by Tomcat on the Child server. Currently, the setting for the location of the keystore is in properties.xml and by this default is at C:/Program Files/Apache Software Foundation/Tomcat 5.5/keystore. In the future, this will be easier to set via global property. Also, in the future, am looking for a way around this manual process of certificate validation. Luckily, even as is now, it is still a one-time process.

Using the Dictionary Import tool

• Log into the Child server - the server that is going to receive a copy of the remote dictionary.
• Go to Administration > Concepts > Dictionary Import
• If you have not set up the server that you will connect to yet, you will be prompted to do so at the screen. Enter the remote address of the Parent server first, then a username and password, if applicable (necessary at the time this page was written).
• You can test the connection to that address with those credentials if you wish, or go directly to Save. This will keep the address and login information for future import attempts.
• Once you have established a remote server and login info (if applicable), you can begin to use the import tool
• Click Begin Import to see if there are any updates to receive.
• If the connection is successful, and there are new or updated concepts, you will be prompted to see if you want to download them. Click Show Details to see exactly which concepts the import will download.
• Wait and watch to see if the concepts are imported to the local dictionary successfully. It's that easy!