fEMR Installers

Creates installers for the fEMR application for Mac and Windows systems.

File Structure

• macOS-x64 contains the files for creating the Mac installer.
• windowsInstaller contains files for creating the Windows installer.
• release.py uploads all generated artifacts to S3 to release to users.

Find instructions to set up the Mac installer and Windows installer below.

macOS Installer Builder

Creates a macOS installer for the fEMR application.

Acknowledgements: https://medium.com/swlh/the-easiest-way-to-build-macos-installer-for-your-application-34a11dd08744

File Structure

• application contains the files that will be installed on the user's machine upon running the installer.
• darwin/Resources contains resources used by the installer, such as the banner image, html pages, and other required texts.
• darwin/scripts contains the preinstall and postinstall scripts that are used to install necessary dependencies when the installer runs.

Creating the Installer

To compile the files into a .pkg installer:

./macOS-x64/build-macos-x64.sh [APPLICATION_NAME] [APPLICATION_VERSION]

This will create the .pkg installer under the /macOS-x64/target/pkg directory. The installer can now be double clicked inside Finder and the installer will run through the necessary steps to install the fEMR software.

Running the Application

Once the installer has finished running through all the steps and installing the necessary software, you can now run the application. Inside your Applications folder there should now be a fEMR application. This can be double clicked to boot up the software.

Windows Installer Builder

Creates a Windows installer for the fEMR application from advanced installer.

File Structure

• ./newFemer contatins all of the files neccessary to build the installer.
• ./femrInstall-cache contains all the installer cache information

Building the installer via advanced installer

To compile the installer via advanced installer, create a new project with the file location as the windowsInstaller file location. Add all of the files in ./newFemr to the applications folder in the target computer. Add the docker desktop installation to the prerequisite condition for instillation. Add the cache to the project then build the project as a single exe file with the documents included.

Other Repositories

• super-femr - The latest version of off-chain femr
• AWS - AWS code for CI pipeline and API
• Frontend - Frontend React code for self-enrollment webpage

Uploading a release

• Make sure that an up-to-date femr docker image has been pushed to Dockerhub from the super-femr repository.
• Make sure your AWS configuration file is configured to write to the release S3 bucket.
• Run release.py (if necessary, you can install the necessary requirements from the requirements.txt at the top level of this repository)

Notes for DNS

There is a DNS server as a package in the docker compose. This DNS server is configured to redirect the femr.net to 192.168.1.2 This can be changed by editing the application/dns.conf. Details on how users can configure their routers to use the DNS can be found here: https://docs.google.com/document/d/1opcGO7SUYSOtQPjx1CUQ2PdLrzKxleHNVE4bLMBpUkE/edit?usp=sharing