SETUP ANALYZERS

Accessing Analyzers on OpenELIS

1. Login to OpenELIS:

   • Enter your username and password.

   • Click the Submit button.

2. Navigating to Analyzers:

   • Click on the Results menu.

   • Select Analyzers to view the existing setup.

   • In the new OpenELIS UI, access analyzers from the menu icon at the top-left corner.

   • Navigate to Results > Analyzer.

Building and Compiling OpenELIS Analyzers

1. Clone the OpenELIS Global Repository:

   • Open a web browser and visit OpenELIS/Global.

   • Click on the openelisglobal-plugins repository on GitHub.

   • Clone the repository locally using:

     git clone <repository-url>

2. Build the Project:

   • Navigate to the cloned directory.

   • Run the following command to compile the sub-modules:

     mvn clean install

   • Modify the systemPath in pom.xml to reference a local path instead of GitHub Actions.

   • Save the changes and rerun mvn clean install.

3. Using Docker for Compilation:

   • Delete the old JAR files (if incompatible with Java 11).

   • Run a Docker build command:

     sudo docker build .

   • Run the Docker container:

     sudo docker compose up -d --build

   • Move compiled plugins from build/plugins/ to the main plugins directory:

     mv build/plugins/* /plugins/

Deploying Analyzers to OpenELIS

1. Via Dropbox:

   • Change file ownership:

     sudo chown <user>:<user> -R plugins/

   • Upload the files to Dropbox and download them onto an OpenELIS instance.

2. Via Secure Copy (SCP):

   • Securely connect to the test instance:

     ssh ubuntu@testing.openelis-global.org

   • Copy the JAR file:

     scp Mindray-0.1.jar ubuntu@testing.openelis-global.org:/home/ubuntu/

   • Move the file to the correct directory:

     sudo mv /home/ubuntu/Mindray-0.1.jar /var/lib/openelis-global/plugins/

   • Restart OpenELIS:

     sudo docker compose down sudo docker compose up -d

Setting Up an ASTM Bridge

1. Analyzer Submission Methods:

   • OpenELIS supports submission through:

     • /importAnalyzer endpoint (multipart file upload)

     • /analyzer/astm endpoint (ASTM compliant messages over HTTP)

2. Configuring the ASTM HTTP Bridge:

   • Verify the bridge is running:

     sudo docker ps

   • Edit the configuration file:

     vi /var/lib/openelis-global/astmbridge/configuration.yml

   • Update the forward-astm-server section with the correct OpenELIS endpoint.

   • Modify docker-compose.yml to expose the ASTM bridge service on port 12000.

   • If required, update setup.ini:

     vi /etc/openelis-global/setup.ini

     • Set activate_astm = true.

   • Rerun the OpenELIS setup script:

     sudo python3 setup_OpenELIS.py

By following these steps, you can successfully build, deploy, and configure analyzers in OpenELIS Global.