worldvista/vehu repository overview

⁠Run VistA VEHU Demo

Run this first to download VistA. This will require several minutes before the system completes the setup. On a faster internet connection, it should take about 1-2 minutes.

docker run -d -p 2222:22 -p 8001:8001 -p 9430:9430 -p 5001:5001 --name vehu worldvista/vehu

We also provide a version that includes the FHIR Data Ingestor and FHIR exporter. You can run that by typing:

docker run -d  -p 2222:22 -p 8001:8001 -p 9430:9430 -p 9080:9080  -p 5001:5001 --name=vehu worldvista/vehu:201911-syn-fhir
docker run --rm --name fhir-api --link vehu:vista -p 8080:8080 worldvista/fhir-on-vista

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

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

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

ssh -p2222 vehutied@localhost

See section below on ssh access.

On Windows, you can use command line ssh or PuTTY, an open source ssh client.

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

     VEHU or CPRS DEMO INSTANCE - Patched to June 2017.
 
     NAME                     ACCESS    VERIFY    E SIG
     ----                     ------    ------    -----
     PROGRAMMER,ONE           PRO1234   PRO1234!! 123456
     PROVIDER,VERO            CAS123    CAS123..  123456
     PROVIDER,FORTY           PROV40    PROV40!!  123456
     VEHU,TEN                 10VEHU    QXYG~011  123456
     PHARMACIST,EIGHT         PHA1234   PHA1234!! 123456
     LABTECH,ELEVEN           LABT11    LABT11!!  123456
     LABTECH,FIFTEEN          LABT15    LABT15!!  123456
     LABTECH,EIGHT            LAB1234   LAB1234!! 123456
     TDNURSE,ONE              1TDNURSE  BDNURSE1! 123456
     LABTECH,FIFTY            LABT50    LABT50!!  123456
     LABTECH,FIFTYEIGHT       LABT58    LABT58!!  123456
     PROVIDER,FIVE HUNDRED    PRO500    PRO500!!  123456
     PCMM,FOUR                PR12345   PR12345!! 123456
     PROVIDER,EHMP            EHMP123   PREH123!! 123456
     USER,PANORAMA            PU1234    PU1234!!  123456
     XIU,MARGARET             MX1234    MX1234!!  123456
     KHAN,VIHAAN              VK1234    VK1234!!  123456
     KEELEY,TRACY             TK1234    TK1234!!  123456
     DAY,MICHAEL              MD1234    MD1234!!  123456
     ZZZ,ZZZ                  ZZZ001    001XXX!!  123456

Programmer (i.e. Direct) mode can be reached using either: docker exec -it vehu su - vehu -c 'mumps -dir' or ssh -p2222 vehuprog@localhost. See section below for ssh access.

⁠SSH Access

There are two shell accounts vehutied and vehuprog, used for TCP-tied SSH logins into VistA. These get fresh passwords every time the container starts. Two ways to supply them:

• Random (default) — a base64 password is generated for each account and printed to the container log. Retrieve them with:

    docker logs <container-name> | grep -A3 "VistA account passwords"
  

  Copy

• Fixed via environment variables — pass TIED_PASSWORD and/or PROG_PASSWORD on docker run:

    docker run -d -e TIED_PASSWORD=mytied -e PROG_PASSWORD=myprog ...
  

  Copy

⁠VistA Clients

The version of the clients you use depends on the version of VEHU you download. If you download the latest one (as per the instructions above), you should get the latest clients from the below table:

Don't forget to change the target of the shortcut (or to create the shortcut) as described in: https://code.worldvista.org/files/clients/OSEHRA_VistA/CPRS/README.txt⁠.

⁠Docker VEHU Container management

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

⁠Loading Synthetic Patients from Synthea into VistA

Follow the instructions here⁠ to generate new synthetic patients and load them into VistA.

⁠HL7

The HL7 1.6 listener is listening at port 5001.