The Virtual Machine (VM) PHR

Automatic Startup

• Starting the VM from the VM manager will cause several startup steps to execute automatically, ending with the PHR login page being presented in a Firefox browser window. Those steps are, specifically:
  • logging you into the VM as user phr;
  • opening up access to the internet;
  • starting up the apache webserver as well as the node process;
  • starting up firefox; and
  • bringing up the PHR system, which will start you out at the login page.

Startup Problems?

If you are using the Oracle VirtualBox VM manager on a Windows system, you may get a problem when you first try to start the imported VM. The error will be about VT-x being disabled in the BIOS.

To work around that you can turn off the use of hardware virtualization on VBoxManage.exe, which should be in the same folder as the VirtualBox program. For example, on Windows 7, running the following command will solve the issue:

C:\Program Files\Oracle\VirtualBox\VBoxManager.exe modifyvm VmPHR --hwvirtex off

where you would replace VmPHR with whatever name you chose for your imported VM.

PHR User Accounts

• We recommend that when you first bring up the PHR, you create your own PHR user account(s) (use the REGISTER button on the login page). We have provided two sample accounts that you can look at to see some of the features of the system. The two accounts are:
  1. SampleAccount1
     • account ID: SampleAccount1
     • password: Password1
     • selected security question 1: In what city was your mother born?
       • answer: City
     • selected security question 2: In what city were you born?
       • answer: City
     • created question: What is the question?
       • answer: City
     • email address: sample1@localhost.com
  
  
  2. SampleAccount2
     • account ID: SampleAccount2
     • password: Password1
     • selected security question 1: In what city was your mother born?
       • answer: City
     • selected security question 2: In what city were you born?
       • answer: City
     • created question: What is the question?
       • answer: City
     • email address: sample2@localhost.com

Linux Accounts

• The VM PHR comes with 2 Linux user accounts:
  1. a standard root account
     • password: phrdemo
  2. a standard user account
     • username: phr
     • password: demo

Your Organization's Email Address

• You will need to update 2 files with the email address of the person who needs to receive emails requesting support as well as certain data update notifications. The files are:
  • def/proto1/config/constants.rb; and
  • def/proto1/config/app_settings.rb.
  In both of those files, search for "phrgeneric@mailinator.com" and replace it with the appropriate email address. Otherwise those messages will go to a generic and unattended mailbox.

System Documentation

• Please see the online User's Guide for detailed descriptions of the PHR system and how to use its many features. You may also download a Microsoft Word or PDF version of the User's Guide.
• The technical documentation on the PHR's GitHub website provides a detailed description of the code and third-party packages used by the system. We recommend you look there if you are interested in understanding what's is included in the system. The VM PHR includes the third-party packages described in that documentation.