Home Applications CrossECP-IRIS

CrossECP-IRIS

This application is not supported by InterSystems Corporation. Please be notified that you use it at your own risk.
5
1 reviews
0
Awards
202
Views
15
IPM installs
5
1
Details
Releases
Reviews
Issues
Pull requests
Articles
IRIS ECP Client in Docker to use Caché ECP Server

What's new in this version

move to archive

Migration from Caché to IRIS can be quite a challenge if your code is grown over many years
and probably not so clean structured as you may like it. So you face the need to check your
migrated code against some reference data. A few samples might not be a problem,
but some hundred GB of data for testing might be.  

A possible step could be to have your fresh code in IRIS but leave your huge datastore on Caché
and connect both environments over ECP.  I have created a demo project that gives you the 
opportunity to try this based on 2 Docker images with IRIS and with Caché connected over ECP.

Attention:  

  • Both Docker images require a personal license for MultiServer to enable ECP 
  • The default Community License doesn’t allow ECP and can’t be used for Caché.
    As a customer with a support contract, you may get loan licenses directly from WRC.

Scenario:

Caché acts as ECP Server while IRIS acts as ECP Client.
In IRIS you have a namespace SAMPLES.
Globals are in remote database SAMPLES on Caché
Routines (and Classes) are in database USER
The classes were just migrated by drag/drop from Cashé Studio to Iris Studio
Data-Globals are in remote database SAMPLES on Caché

This setup allows you to have local data in namespace USER
and remote data in namespace SAMPLES and run your test queries or other exercises.

Installation for IRIS:

  • Get the external IPV4 address of the machine that runs your docker environment (example =10.10.1.99 )
    This is required to establish access between both containers

  • Install CrossECP-Caché from OEX

  • Download CrossECP-IRIS from OEX
    Copy your (loan) license key into iris.key

  • From the download directory run:  
    docker-compose up -d –build
    It uses these port mapings -p 45773:1972 -p 46773:52773 -p 47773:53773
    Your actual directory is mapped to /external to allow file exchange with docker environment

  • To complete installation feed your Docker host IP address (10.10.1.99) and start operation run:
    docker-compose exec iris iris session iris initECP

Server status 1 Not Connected 
Continue anyway ? (nNyY) [Y]: Y 
Enter Host-IP-Adress of Docker (nn.nn.nn.nn) [192.168.0.6]: 10.10.1.99
Connect to ECP sever on 10.10.1.99 now ? (nNyY) [Y]: Y   
Server status 5 Normal   

This last step is just for your comfort. Of course, you can do this also from SMP
by System > Configuration > ECP Settings > ECP Data Servers

Now you are ready for testing

Article in DC

Read more
Made with
Install
zpm install initECP download archive
Version
1.0.305 Nov, 2023
ObjectScript quality test
Category
Technology Example
Works with
InterSystems IRIS
First published
05 Mar, 2021
Last checked by moderator
25 Jul, 2023Works