samindcon/rpms repository overview

⁠Introduction

You need to install Docker first. Install is easiest on Windows 10 Professional, recent Macs, and any Linux. If you don't have Windows 10 Professional or an older Mac (< 2012), you will need to use Docker Toolbox. It's less reliable, but worth a try. Your docker IP address is localhost if you run regular docker, or 192.168.99.100 on Docker Toolbox. Go here to get Docker. https://www.docker.com/community-edition⁠

⁠Run RPMS

Run this first to download RPMS. This will require several minutes before the system completes the setup. On a faster internet connection, it should take about 1-2 minutes. The below command will get the latest version of RPMS; but you can specify a specific version by putting :tag after osehra/rpms. See available versions under the tags tab above.

docker run -d -p 2222:22 -p 9100:9100 -p 9101:9101 --name rpms osehra/rpms

Once it is done, wait 10 seconds. Then, To get into roll and scroll, type

docker exec -it rpms su - rpms -c 'mumps -r ZU'

If that fails, you can ssh into the environment, like this:

ssh -p2222 rpmstied@localhost

Password is tied.

On Windows 10, you can open a command line and then type `ssh rpmstied@{docker_ip_address} -p 2222. On Windows 7, you have to access the container using an SSH client such as PuTTY.

Your access and verify codes are shown in the screen, but here they are for reference:

NAME               ACCESS CODE    VERIFY CODE
====               ===========    ===========
ADAM,ADAM          ADAM.01        USER.001
MANAGER,SYSTEM     SYS123         RPMS.000

Programmer (i.e. Direct) mode can be reached using either: docker exec -it rpms su - rpms -c 'mumps -dir' or ssh -p2222 rpmsprog@{docker_ip_address} with password prog.

⁠RPMS Clients

There are many clients for RPMS. They are all Microsoft Windows applications. At this point in time, OSEHRA has no plans to test all of them. We packaged a four clients that are commonly used: Patient Registration, Scheduling, iCare, and VueCentric (a.k.a. RPMS-EHR). You can find them here: https://code.osehra.org/files/clients/RPMS/⁠. There are multiple versions corresponding to each version of the docker image that can be downloaded here. If you want the latest version, just click on latest.

Like VistA, all RPMS clients communicate via TCP, which means you need to supply a host/IP address and a port to connect to the RPMS server.

If you installed RPMS on a Mac or Linux, you will need to point the IP address (mentioned above) to the Mac or Linux machine. If you installed on Windows, your IP address will be localhost if you installed the regular version of docker or 192.168.99.100 for Docker Toolbox.

The port for the CIA broker is 9100. The BMX broker port is 9101. For VueCentric, you will need to connect to port 9100; for iCare, Scheduling, and Registration will need to connect to port 9101.

⁠Pre-use notes

I have found out that pretty much all clients require .Net (even the Delphi ones); so you need to install .Net 1.1, 2.0 and 3.5. Type WIN+R to open the run box, type "appwiz.cpl", and then click on "Turn Windows Features on or off" on the left hand side bar, and then choose ".Net Framework 3.5 (includes .Net 2.0 and 3.0)" and then press okay.

You can do the same thing via an admin command line. Open a command prompt as an administrator (see https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx⁠) and then type this:

dism /online /enable-feature /featurename:NetFX3 /all

⁠VueCentric Setup

VueCentric needs a lot of specific set-up, and you need to do that before you start using it for the first time.

Here are the steps:

1. Download the zip file corresponding to your version.
2. Extract anywhere you like; but note that you must remember the folder where you extracted so that you can enter it in the vcIniConfig.exe dialog.
3. Run vcIniConfig.exe in the bin folder.
4. On the "Updater" tab, the source folder is the path of the bin folder in the place you extracted. The target folder is anywhere you like; I recommend under the same folder, but as \run\ rather than \bin.
5. Under Server List tab, put in the correct ip address for your server.
6. Press OK.
7. Go to the bin folder, find VueCentric.exe INSIDE the bin folder (not the one one level above); right click, Send To > Desktop (Create Shortcut).
8. Right-click on the shortcut, click on the Advanced button, and then check "Run as administrator".
9. Double-click on the shortcut and log-into VueCentric. This will take about 5 minutes for it to update everything. You will get a bunch of errors relating to mismatching version numbers.
10. Open a command prompt as an administrator. Follow this guide: https://technet.microsoft.com/en-us/library/cc947813(v=ws.10).aspx⁠. Once you are there, cd to the target folder in step #4 (here, it's "run"). Run the following:

copy \Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe .

Confirm the overwrite. 10. Again, double-click on the shortcut, and log into VueCentric. This time, you may or may not have a single error. It's safe to ignore.

Happy browsing. Remember that if you want to add more patients, you can use the registration GUI.

⁠Other clients set-up (Registration, Scheduling, iCare)

These are all just installable programs. Run the installer .msi file that is in the zip and the program will be installed. Then find it in the start menu to run it. Use the server manager to add the host/IP, port, and leave the namespace blank. When prompted for the access/verify code, put it on the access/verify codes that are supplied with the RPMS instance. ADAM.01/USER.001 works.

⁠Other clients not supplied by OSEHRA

The rest of the RPMS clients can be found either on the IHS website (https://ihs.gov/rpms⁠); or can be downloaded from the OSEHRA technical journal. Here's a table of the links to the journal vis-a-vis the releases:

⁠Docker RPMS Container management

To stop the container, type docker stop rpms To restart the container, type docker restart rpms. Any changes you made will still be there. To delete the container, type docker rm rpms. You will lose all your data. To delete the downloaded image, type docker rmi osehra/rpms. If you do docker run... again, you will have to download it again.