New post
AllAccepted answers
Dmitry Maslennikov · Mar 24, 2020

Possible reasons

  • Another recommendation is to separate code and data. So, I need at least two databases, code which is always in a container, and data mounted outside.
  • Just to be consistent, some project, and namespace with the same name as the project. With only own configuration. Without anything predefined. In most cases, namespace and any related configuration, supposed to be configured for the particular project. And keeping USER as is and do not touch except for some temporary staff, like import Installer manifest and setup it.
  • One of the reasons for USER still exists, that it is kind of entrypoint, and keep it as is, will keep from anything unexpected.

Just my thoughts

Dmitry Maslennikov · Mar 23, 2020

Any IRIS edition includes formerly known as Ensemble feature, which is now is Interoperability (and one of the letters in IRIS).

You may get this error if you work in the namespace where Ensemble was activated. By default for USER was not activated.

When you create a new namespace Ensemble checkbox checked by default and, but you can uncheck it.

to enable namespace manually, do this command

do ##class(%EnsembleMgr).EnableNamespace("YOUR-NAMESPACE")
Dmitry Maslennikov · Mar 23, 2020

$listvalid

%SYS>w $listvalid($lb("test"))
1
%SYS>w $listvalid("test")     
0
%SYS>w $listvalid("")    
1

$listbuild is not an object, so, it's not a check as an instance of, it is only possible that variable is valid as $listbuild

$listbuild as just a string with a special format, so, that's why this will also return true

%SYS>w $listvalid($char(1))   
1
%SYS>write $lb()=$c(1)
1

because

%SYS>zzdump $lb()  

0000: 01                                                      .
Dmitry Maslennikov · Mar 14, 2020

So, to get own docker-running Cache, is quite easy.

You just need docker desktop installed on your mac. Then when it installed, and running. You'll be able to run it from the terminal by command.

docker run -d --name cache \
  -p 1973:1972 \
  -p 57773:57772 \
  -v $HOME/cache.key:/usr/cachesys/mgr/cache.key \
  daimor/intersystems-cache:2018.1

It supposed that you have valid cache.key in your home directory. And that your ports 1973 and 57773 is free to use. If you would like to change the port just change 1973 and 57773 with any you'd like to use.

This command will download the image (daimor/intersystems-cache:2018.1) from the public repository, and run it in the background.

You can control the running container by commands, wherein all subsequent commands cache is the name of the container from the docker run command.

To see cconsole.log of the container.

docker logs cache

To look at the status of the container

docker ps cache

Stop running container

docker stop cache

This is just an empty instance, to look at how it works. In the real case scenario, some more work should be done.

Docker images for Cache or for Ensemble are provided by me, and it is available for different versions.

Nowadays is best to migrate to IRIS, and use official images provided by InterSystems itself.

And the next step for you would be to use an editor that can be run on macOS, instead of Studio which working only on Windows.  

And you can use VSCode editor with an extension VSCode-ObjectScript, developed by me. 

I would recommend reading here articles tagged by Docker. There much more information about how to best use it. 

As well as about using VSCode.

You can contact me directly, if you need any help with establishing development process, with such modern tools as Docker and VSCode. or migrating to IRIS.

Dmitry Maslennikov · Mar 14, 2020

I suppose you going to use it like for local development, not for production, so, I would recommend just use docker images instead. I'm using macOS and have not installed Cache/IRIS locally already for some years.

You did not provide the version you try to install and no cconsole.log. If you add this here, so it may help.

Dmitry Maslennikov · Mar 5, 2020

there are some possible issues to have docker related files in a dedicated folder. 

When you would like to start an environment with docker-compose, you can do it with a command like this.

docker-compose up -d

but it will work only if the docker-compose.yml file name has not changed and it lays right in the current folder.

if you change its location or name, you will have to specify the new place

docker-compose -f ./docker/docker-compose.yml up -d

became not so simple, right?

Ok, next about Dockerfile.

when you build docker image, you have to specify context. So, the command below, just uses file Dockerfile in the current folder, and uses current folder as a context for build.

docker build .

To build docker image with Dockerfile placed somewhere else, you should specify it, suppose you still would like to have current folder as context.

docker build -f ./docker/Dockerfile .

any other files in the root, such as Installer.cls, irissession.sh or any other files which should be used during docker build have to be available from specified context folder. And you can't specify more than one context. So, any of those files should have some parent folder at least, and why not the root of a project.

with docker-compose.yml, we forget about docker build command, but we still have to care about docker-compose

Dmitry Maslennikov · Mar 3, 2020

The first iris after exec is the service name from docker-compose.yml, then goes command which has to be executed.

 iris command is a replacement for ccontrol from Cache/Ensemble

session - subcommand for iris tool

And the latest iris as the instance name inside for IRIS inside the container

Dmitry Maslennikov · Feb 27, 2020

It's great that you trying to do it.

But I'm not sure what you actually going to achieve with WebGateway?

A provided link has info about running in docker.

So, if you just want to activate server-status page in internal apache which goes with IRIS, you should know, that it is not recommended to use internal webserver in production.

Some time ago I did an example of Apache with CSPgateway as a docker image. It can be outdated a bit but can be used as an example, how to achieve it. You can easily extend Apache settings there, to allow server-status as well.

Dmitry Maslennikov · Feb 23, 2020

$lb is a binary format, when you try to write it you just outputs everything including special symbols.

zwrite command, can do it respectively to format.

zzdump can show how it looks in real, it's byte sequence.

USER>zw $lb("words","more","words")
$lb("words","more","words") 

USER>zzdump $lb("words","more","words") 

0000: 07 01 77 6F 72 64 73 06 01 6D 6F 72 65 07 01 77         ..words..more..w
0010: 6F 72 64 73                                             ords

USER>zzdump $lb(1,2,3,4,5)              
0000: 03 04 01 03 04 02 03 04 03 03 04 04 03 04 05            ...............

But it is not so important how it looks low-level, as we mostly don't care about it.  Developers work with $ListBuild mostly through a bunch of functions, such as $list, $listget, $listnext and so on. You can find more information about $listbuild in the documentation, as well as many examples, and all functions which can be used to work with it.