Missing Ensemble Classes in IRIS for Health Community Docker

Question

Question

Michael Davidovich · Aug 26, 2022

#Docker #Key Question #InterSystems IRIS for Health

Hello,

I'm using CircleCI to spin up the image `store/intersystems/irishealth-community:2021.2.0.649.0`.

When building the application we are getting messages that say:

ERROR #5373: Class 'EnsLib.HL7.Message', used by 'Package.Class', does not exist
Skip class Package.Class

Other missing classes seem to include, but not limited to:

Ens.BusinessProcessBPL
Ens.BusinessService
EnsLib.RecordMap.ComplexChild
EnsLib.EDI.XML.Document
Ens.Request

Binding to a port and looking the management portal, it seems we have the namespace HSLIB and some classes:

As far as we understand, these classes should be available on the community edition. Is there possibly a setting or some setup we are missing in the build that these classes aren't generated?

Any help is appreciated!

Product version: IRIS 2021.2

$ZV: IRIS for UNIX (Ubuntu Server LTS for x86-64 Containers) 2021.2 (Build 649U) Thu Jan 20 2022 08:53:15 EST

Discussion (19)2

Log in or sign up to continue

Evgeny Shvarov · Aug 26, 2022

We delete "old" images from the registry. I'd advise using official container images from containers.intersystems.com.

The actual set of available images can be easily got with this powerful extension to Docker Desktop, which shows you the up-to-date list and has a nice UI to copy image names.

0 0

score 0 · Answer 1 · 2022-08-26T10:09:18-04:00

Also did something change since last week?

"Head "https://registry-1.docker.io/v2/store/intersystems/irishealth-community/...": unknown: store has been removed."

score 0 · Answer 2 · 2022-08-26T13:11:18-04:00

I'm using the login command generated from the link but get this:

Error response from daemon: Get "https://containers.intersystems.com/v2/": unauthorized: BAD_CREDENTIAL

score 0 · Answer 3 · 2022-08-28T09:42:54-04:00

Hi Michael! Probably the account you use doesn’t have WRC support. Nevertheless you should be able to pull community images from containers.InterSystems.com.

score 0 · Answer 4 · 2022-08-29T09:44:40-04:00

Ah yes, I pulled from my account I'm using now, not my work-email account. Going back to the community image you spec below.

score 0 · Answer 5 · 2022-08-29T05:39:05-04:00

BTW, for IRIS Community images you can use:

FROM intersystemsdc/iris-community

to pull the latest release image of InterSystems IRIS Community Edition with ZPM included.

Or:

FROM intersystemsdc/irishealth-community

And for the latest preview release:

FROM intersystemsdc/iris-community:preview

score 0 · Answer 6 · 2022-08-26T11:09:01-04:00

Hi Michael!

I guess the Namespace you deploy to doesn't have Interoperability enabled. You can simply check this by deploying your solution e.g. into the USER namespace, which is Interoperability enabled by default.

score 0 · Answer 7 · 2022-08-26T12:44:40-04:00

Hi @Evgeny Shvarov and thank you!

I did forget to mention I do have this in the Installer.cls

Is Ensemble=1 the same as having interoperability enabled?

score 0 · Answer 8 · 2022-08-28T09:43:48-04:00

Evgeny Shvarov · Aug 28, 2022

Yes, this is how you create Interoperability-enabled namespace using %Installer

0 0

score 0 · Answer 9 · 2022-08-30T11:20:04-04:00

@Evgeny Shvarov and @Alex Woodhead

Lots of good progress here, but still a few issues:

- Thanks to @Dmitry Maslennikov and his help, I am using a Dockerfile and compose to do the build, so everything is a little more contained and standard (I used that coffee store template as a starting place)

- After running App.Installer.setup() via the Dockerfile commands, I run do ##class(%EnsembleMgr).EnableNamespace("$NAMESPACE"). After that I do some application setup logic including a recompile of those classes that depend on those Ensemble classes and I finally get that clean compile of those classes and no error messages saying HL7.Class does not exist.

- As I mentioned before, the namespace element in the Installer.cls manifest has interoperability turned on <Namespace Name="${NAMESPACE}" Code="${NAMESPACE}-CODE" Data="${NAMESPACE}-DATA" Create="yes" Ensemble="1">

- How can I run the command do ##class(%EnsembleMgr).EnableNamespace("$NAMESPACE") after the creation of the application's namespace but BEFORE loading and compiling the source code? My only workaround is to recompile after running App.Installer.setup() and do ##class(%EnsembleMgr).EnableNamespace("$NAMESPACE"). I'm not sure how and where the manifest for the application in App.Installer is used and where I can insert this enable method. That said, I feel like that <Namespace> tag should be turning it on. I can't find a reference in the documentation for this manifest.

- Another question/issue is CSP pages. Following the template, in the docker file I 'COPY csp csp`. In the installer I mapp the source director to all the code I put in the src folder (classes and mac files). Should I copy my CSP file here as well so they compile? My workaround is similar to above, I use a utility to compile the CSP pages in the csp director since the installer doesn't pick them up since they aren't in the source dir.

score 0 · Answer 10 · 2022-08-26T11:48:32-04:00

Some ideas for general configuration.

In a target namespace can test integration is enabled with:
write ##class(%EnsembleMgr).IsEnsembleNamespace()

Can enable integration for an existing namespace with:
do ##class(%EnsembleMgr).EnableNamespace($NAMESPACE)

When enabled, as a test can Run a integration method from mapped class:
write ##class(EnsLib.HL7.Message).%ExistsId(1)

score 0 · Answer 11 · 2022-08-26T12:45:13-04:00

Michael Davidovich · Aug 26, 2022

Thanks, Alex. I will remote into my build and run some of these commands and see where it gets me!

0 0

score 0 · Answer 12 · 2022-08-26T13:04:16-04:00

@Alex Woodhead
Looks like ##class(%EnsembleMgr).IsEnsembleNamespace()=1

and ##class(EnsLib.HL7.Message).%ExistsId(1)=0

When I built my project, I got the same error messages as you might imagine with the output above.

Any other thoughts?

score 0 · Answer 13 · 2022-08-26T13:22:03-04:00

This is sucessful if no longer showing class not found error.

It found the class and ran the method sucessfully.

Set rowId=1

If ##class(EnsLib.HL7.Message).%ExistsId(rowId)=0 or 1 then

The class EnsLib.HL7.Message has been mapped to the current namespace.

It is giving 0 because there has been no HL7 messages created yet (with rowId 1) or message rowId 1 has been purged from namespace.

A better non-error prone way to programatically test whether the class is available to the namespace could use:

write ##class(%Dictionary.CompiledClass).%ExistsId("EnsLib.HL7.Message")

score 0 · Answer 14 · 2022-08-26T12:51:47-04:00

While I have some smart people on the line, any idea why I might see this message:

Sign-on inhibited: Startup or Installation in progress

I run a sleep command for 10 seconds before going into the container which I think is a good amount of time, but no dice. I was able to get in no problem when I used a previous image.

score 0 · Answer 15 · 2022-08-26T14:22:54-04:00

10 seconds may not be enough, in my case starting IRIS may take more than one minute.

Where do you use the sleep command, and what for?

score 0 · Answer 16 · 2022-08-29T09:58:31-04:00

@Dmitry Maslennikov

It's a bit much and there's probably a better way, but the long story short is that many of our static files are in a folder in the root, so I have to build the container, run a 'docker exec' command as root to copy my file to the root, exit out of that, then log in again as a the regular user to start the iris session and run the build script.

The script uses the sleep command to wait (now at 70 seconds and working fine) for iris to finish starting so I can start the session and run the script. Otherwise I get the startup error.

score 0 · Answer 17 · 2022-08-29T10:16:57-04:00

So, it looks like you doing it a wrong way.

If you need to build your application, then you have to do it with Dockerfile during the build stage, not when it is just up and running. And you still build some container before it.

In any case you may use this way, to wait until it's started

sleep 5; docker exec $CONTAINER /usr/irissys/dev/Cloud/ICM/waitISC.sh

Teah, not documented, internally used script, but nothing offered instead.

Contact me directly, I may help to review the build process, and give particular recommendations.

score 0 · Answer 18 · 2022-09-03T05:06:42-04:00

Developer Commu... · Sep 3, 2022

💡 This question is considered a Key Question.

0 0