First experience of using an IRIS for Health docker container
Tags: docker, github, vscode
Published: 2023-03-28 14:32:17

<p style="margin-bottom:11px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">I am happy to share with you my first experience of using a docker container version of IRIS for Health to explore your interest in using or having a trial by taking the advantage of a docker container that is lightweight, and easy to deploy. This cookbook will go through the implementation steps using the GitHub repository called ENSDEMO written by Renan Lourenco.</span></span></span>
</p>

<p style="margin-bottom:11px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><span style="font-size:13.0pt"><span style="line-height:107%">Steps for setting up an IRIS for Health Community Edition docker container environment </span></span></span></span></span>
</p>

<li style="margin-left:8px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Docker up and running</span></span></span>
</li>
<li style="margin-left:8px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Download the docker image </span></span></span>
</li>

<p style="margin-left:48px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><b><i>docker pull containers.intersystems.com/intersystems/irishealth-community:2022.2.0.304.0</i></b></span></span></span>
</p>

<ol start="3">
  <li style="margin-left:8px">
    <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Clone the source repository from GitHub </span></span></span>
  </li>
</ol>

<p style="margin-left:48px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><b><i>git clone </i></b><a href="https://github.com/OneLastTry/irishealth-ensdemo"><b><i>https://github.com/OneLastTry/irishealth-ensdemo</i></b></a></span></span></span>
</p>

<ol start="4">
  <li style="margin-left:8px">
    <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Change the file directory to where you have cloned from Github.</span></span></span>
  </li>
  <li style="margin-left:8px">
    <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Build container image from the file docker-compose.yml</span></span></span>
  </li>
</ol>

<p style="margin-left:48px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><b><i>docker-compose build </i></b></span></span></span>
</p>

<ol start="6">
  <li style="margin-left:8px">
    <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Run your container</span></span></span>
  </li>
</ol>

<p style="margin-left:48px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><b><i>docker-compose up -d</i></b></span></span></span>
</p>

<p style="margin-left:48px">
   
</p>

<p style="text-align:justify; margin-bottom:11px; margin-left:48px">
  <span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">During my initial attempt, I could not download the exact version of irishealth community:2022.2.0.304.0, because it had changed since the initial release of ENSDEMO. The fix is to pull the latest available tag in the registry when trying to pull the docker image from the InterSystems Container Registry.</span></span></span></span>
</p>

<p style="margin-left:48px">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Another error that I run into was indicating “<span style="background:yellow">=>ERROR[internal] load metadata for docker pull containers.intersystems.com/intersystems/irishealth-community:2022.2.0.293.0</span>” after executing the command <b><i>docker-compose build. </i></b></span></span></span><span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">This is because there is a conflict between the version of the docker image I downloaded and the specified container image version in <i>Dockerfile.</i> </span></span></span></span>
</p>

<p style="text-align:justify; margin-left:48px">
   
</p>

<p style="text-align:justify; margin-bottom:11px">
  <span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><span style="font-size:13.0pt"><span style="line-height:107%">To login into IRIS for Health:</span></span></span></span></span></span>
</p>

<li style="text-align: justify; margin-bottom: 11px;">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Management Portal: <a href="http://localhost:9092/csp/sys/%25CSP.Portal.Home.zen">http://localhost:9092/csp/sys/%25CSP.Portal.Home.zen</a> </span></span></span>
</li>
<li style="margin-bottom: 11px;">
  <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Username: SuperUser</span></span></span>
</li>
  * <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Password: SYS</span></span></span>
  * <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">SuperServer port: 9091</span></span></span>
  * <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Web port: 9092</span></span></span>
  * <span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Namespace: ENSDEMO</span></span></span>

<span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Start an IRIS terminal session: <b><i>docker exec -it ensdemo iris session iris</i></b></span></span></span>

<span style="font-size:11pt"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">Start a bash session: <b><i>docker exec -it ensdemo /bin/bash</i></b></span></span></span>

 

<p style="text-align:justify; margin-bottom:11px">
  <span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><span style="font-size:13.0pt"><span style="line-height:107%">My walk-through implementing video: https://www.loom.com/share/36bd8c63db724eebae65debf0d89c821</span></span></span></span></span></span><br /> 
</p>

<p style="text-align:justify; margin-bottom:11px">
  <span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">References:</span></span></span></span>
</p>

<p style="text-align:justify; margin-bottom:11px">
  <span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif"><a href="https://github.com/OneLastTry/irishealth-ensdemo">https://github.com/OneLastTry/irishealth-ensdemo</a> </span></span></span></span>
</p>

<p style="text-align:justify; text-indent:36.0pt; margin-bottom:11px">
  <span style="font-size:11pt"><span style="text-justify:inter-ideograph"><span style="line-height:107%"><span style="font-family:Calibri,sans-serif">by Renan Lourenco (<a href="mailto:Renan.Lourenco@intersystems.com"><span style="font-size:12.0pt"><span style="line-height:107%">Renan.Lourenco@intersystems.com</span></span></a><span style="font-size:12.0pt"><span style="line-height:107%"><span style="color:black">)</span></span></span></span></span></span></span>
</p>

<span style="font-size:11.0pt"><span style="line-height:107%"><span style='font-family:"Calibri",sans-serif'><a href="https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=ACLOUD">https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=ACLOUD</a></span></span></span>