Article Eduard Lebedyuk · Jan 26, 2022 4m read Container configuration management If you're deploying to more than one environment/region/cloud/customer, you will inevitably encounter the issue of configuration management. While all (or just several) of your deployments can share the same source code, some parts, such as configuration (settings, passwords) differ from deployment to deployment and must be managed somehow. In this article, I will try to offer several tips on that topic. This article talks mainly about container deployments. #Cloud #Containerization #Continuous Delivery #Deployment #InterSystems IRIS 3 4 0 455
Article Eduard Lebedyuk · Jun 3, 2021 7m read Running InterSystems Reports in containers IMPORTANT NOTE InterSystems no longer provides a separate InterSystems Reports Server container. To run containerized InterSystems Reports Server, use Logi Reports Server container and your InterSystems Reports Server license. Documentation. InterSystems Reports is powered by Logi Report (formerly named JReport), a product of Logi Analytics. InterSystems Reports is supported by InterSystems IRIS and InterSystems IRIS for Health. It provides a robust modern reporting solution that includes: Embedded operational reporting which can be customized by both report developers and end users. Pixel-perfect formatting that lets you develop highly specific form grids or other special layout elements for invoices, documents, and forms. Banded layouts that provide structure for aggregated and detailed data. Exact positioning of headers, footers, aggregations, detailed data, images, and sub-reports. A variety of page report types. Large-scale dynamic report scheduling and distribution including export to PDF, XLS, HTML, XML, and other file formats, printing, and archiving for regulatory compliance. InterSystems Reports consists of: A report designer, which provides Design and Preview Tabs that enable report developers to create and preview reports with live data. A report server which provides end users browser-based access to run, schedule, filter, and modify reports. From InterSystems documentation. This article focuses on the Server part of InterSystems Reports and provides a guide on running Report Server in containers while persisting all the data. #Docker #System Administration #InterSystems IRIS Open Exchange app 6 2 3 855
Article Eduard Lebedyuk · Apr 21, 2021 1m read Ctrl+C / Ctrl+V in IRIS Terminal It's possible to enable Ctrl+C / Ctrl+V in IRIS Terminal for Windows. To do that, open Terminal and select Edit > User Settings and enable Windows edit accelerators. This setting specifies whether the Terminal enables the common Windows edit shortcuts (Ctrl+C, Ctrl+V, Ctrl+Shift+V), in addition to the basic Terminal edit shortcuts (Ctrl+Insert and Shift+Insert). After that Ctrl+C / Ctrl+V would work. Also <SYNTAX> errors after incorrect copy/paste go away. Docs. #Beginner #Microsoft Windows #Terminal #InterSystems IRIS 11 7 1 422
Article Eduard Lebedyuk · Mar 4, 2021 1m read Get a list of cached queries and their texts Recently I wanted to get a list of all cached queries and their texts. Here's how to do that. First create an SQL Procedure returning Cache Query text from a Cached Query routine name: Class test.CQ { /// SELECT test.CQ_GetText() ClassMethod GetText(routine As %String) As %String [ CodeMode = expression, SqlProc ] { ##class(%SQLCatalog).GetCachedQueryInfo(routine) } } And after that you can execute this query: #Code Snippet #SQL #InterSystems IRIS 5 4 0 695
Article Eduard Lebedyuk · Jan 12, 2021 1m read How to work with InterSystems IRIS from DataGrip DataGrip is a multi-engine database environment targeting the specific needs of professional SQL developers, DataGrip makes working with databases an enjoyable and productive experience. To work with InterSystems IRIS from DataGrip you'll need to add InterSystems JDBC driver first (once per DataGrip) and after that add all your InterSystems IRIS connections. Part 1: Add InterSystems IRIS JDBC Driver 1. Go To File → DataSources #JDBC #SQL #InterSystems IRIS 1 0 0 804
Article Eduard Lebedyuk · Dec 2, 2020 2m read Calculating detailed class/table size In the good old days (tm) determining the size of the data, streams, and indices for a class/table was easy - you just ran %GSIZE and check D, S, and I globals respectively. However, nowadays sharding, optimized global names, and indices in separate globals produce %GSIZE output looking like this: #Sharding #SQL #InterSystems IRIS Open Exchange app 12 6 5 1.3K
Article Eduard Lebedyuk · Nov 19, 2020 3m read Deploying a sharded cluster with Docker and MergeCPF In this article, we will run an InterSystems IRIS cluster using docker and Merge CPF files - a new feature allowing you to configure servers with ease. On UNIX® and Linux, you can modify the default iris.cpf using a declarative CPF merge file. A merge file is a partial CPF that sets the desired values for any number of parameters upon instance startup. The CPF merge operation works only once for each instance. Our cluster architecture is very simple, it would consist of one Node1 (master node) and two Data Nodes (check all available roles). Unfortunately, docker-compose cannot deploy to several servers (although it can deploy to remote hosts), so this is useful for local development of sharding-aware data models, tests, and such. For a productive InterSystems IRIS Cluster deployment, you should use either ICM or IKO. #Beginner #Best Practices #Docker #Sharding #InterSystems IRIS Open Exchange app 6 3 1 717
Article Eduard Lebedyuk · Aug 12, 2020 3m read Calling production from a REST Broker Productions often need to receive REST requests. Here's how to do that. 1. Create proxy Service: /// Empty BS we would use to send Produciton requests Class production.ProxyService Extends Ens.BusinessService { } 2. Add it to production as RESTService (or any other name). #Business Operation #Business Process (BPL) #Business Service #Interoperability #REST API #InterSystems IRIS 5 8 1 1.1K
Article Eduard Lebedyuk · Aug 7, 2020 5m read Containerising .Net/Java Gateways (or Kafka Integration Demo) In this article, I will show how you can easily containerize .Net/Java Gateways. For our example, we will develop an Integration with Apache Kafka. And to interoperate with Java/.Net code we will use PEX . Architecture Our solution will run completely in docker and look like this: #.NET #Best Practices #Business Operation #Business Service #Docker #Interoperability #Java #InterSystems IRIS Open Exchange app 7 7 1 1.4K
Article Eduard Lebedyuk · Aug 3, 2020 3m read Creating classes/tables with more than 999 properties in InterSystems IRIS InterSystems IRIS currently limits classes to 999 properties. But what to do if you need to store more data per object? This article would answer this question (with the additional cameo of Community Python Gateway and how you can transfer wide datasets into Python). The answer is very simple actually - InterSystems IRIS currently limits classes to 999 properties, but not to 999 primitives. The property in InterSystems IRIS can be an object with 999 properties and so on - the limit can be easily disregarded. #Globals #Object Data Model #Python #Relational Tables #SQL #Tips & Tricks #InterSystems IRIS 5 13 1 772
Article Eduard Lebedyuk · Jun 19, 2020 2m read Generate Swagger spec from persistent and serial classes Recently I needed to generate a Swagger spec from persistent and serial classes, so I'm publishing my code (it's not complete - you still need to hash out the application specifics, but it's a start). It's available here. Let's say you have these classes: #API #Best Practices #Code Snippet #REST API #InterSystems IRIS 9 14 2 1.9K
Article Eduard Lebedyuk · Jun 18, 2020 1m read Debugging Business Operations Often we need to debug a Business Operation. Tracing and logging work but sometimes you want to work with a BO as with your local terminal session. Here's how you can do that on any operating system. Windows has a great tool for debugging Business Operations - Foreground mode. In that mode Windows launches a local terminal with operation job. #Business Operation #Debugging #Interoperability #InterSystems IRIS 2 0 2 579
Article Eduard Lebedyuk · Apr 22, 2020 1m read Get VSCode to look like Studio One of the things I want from VSCode is to have a familiar Studio look. Thankfully VSCode is easily customizable so you can choose any color for any element. Here's what I got so far: To get the same look add to your settings.json: #VSCode #InterSystems IRIS Open Exchange app 6 0 1 438
Article Eduard Lebedyuk · Feb 11, 2020 6m read Asymmetric RSA encryption with JS and InterSystems IRIS Asymmetric cryptography is a cryptographic system that uses pairs of keys: public keys which may be disseminated widely, and private keys which are known only to the owner. The generation of such keys depends on cryptographic algorithms based on mathematical problems to produce one-way functions. Effective security only requires keeping the private key private; the public key can be openly distributed without compromising security. In such a system, any person can encrypt a message using the receiver's public key, but that encrypted message can only be decrypted with the receiver's private key. Robust authentication is also possible. A sender can combine a message with a private key to create a short digital signature on the message. Anyone with the sender's corresponding public key can combine the same message and the supposed digital signature associated with it to verify whether the signature was valid, i.e. made by the owner of the corresponding private key. (C) Wikipedia. #Encryption #REST API #InterSystems IRIS Open Exchange app 0 2 0 738
Article Eduard Lebedyuk · Jan 16, 2020 2m read Python Gateway VI: Jupyter Notebook This series of articles would cover Python Gateway for InterSystems Data Platforms. Execute Python code and more from InterSystems IRIS. This project brings you the power of Python right into your InterSystems IRIS environment: Execute arbitrary Python code Seamlessly transfer data from InterSystems IRIS into Python Build intelligent Interoperability business processes with Python Interoperability Adapter Save, examine, modify and restore Python context from InterSystems IRIS Other articles The plan for the series so far (subject to change). Part I: Overview, Landscape, and Introduction Part II: Installation and Troubleshooting Part III: Basic functionality Part IV: Interoperability Adapter Part V: Execute function Part VI: Jupyter Notebook <-- you're here Part VII: Dynamic Gateway Part VIII: Proxy Gateway Part IX: Use cases and ML Toolkit Intro The Jupyter Notebook is an open-source web application that allows you to create and share documents that contain live code, equations, visualizations and narrative text. This extension allows you to browse and edit InterSystems IRIS BPL processes as jupyter notebooks. #Convergent Analytics #Machine Learning (ML) #Python #InterSystems IRIS Open Exchange app 4 0 0 665
Article Eduard Lebedyuk · Jan 13, 2020 1m read Difference between while and for While and for are pretty similar, but sometimes you need to do a not recommended thing - change cycle boundaries. In this situation while and for are different. For calculates boundaries once per run and while calculates boundaries on every iteration. Consider this code sample: set x = 5 for i=1:1:x { write "i: ", i,", x: ", x,! set x = x+1 } You'll get this output: #Beginner #InterSystems IRIS 2 7 0 460
Article Eduard Lebedyuk · Jan 6, 2020 1m read Python Gateway V: Execute function This series of articles would cover Python Gateway for InterSystems Data Platforms. Execute Python code and more from InterSystems IRIS. This project brings you the power of Python right into your InterSystems IRIS environment: #Python #InterSystems IRIS Open Exchange app 0 0 0 444
Article Eduard Lebedyuk · Dec 17, 2019 3m read Python Gateway IV: Interoperability Adapter This series of articles would cover Python Gateway for InterSystems Data Platforms. Execute Python code and more from InterSystems IRIS. This project brings you the power of Python right into your InterSystems IRIS environment: #Business Operation #Business Process (BPL) #Interoperability #InterSystems IRIS Open Exchange app 2 0 0 507
Article Eduard Lebedyuk · Dec 9, 2019 1m read ÍàØâàÞæØâë and you If you work with anything other than English, you would earlier or later encounter the characters from the title or just plain ??????????. Encodings are usually known, but sometimes you just get gibberish and need to make sense of it. In this cases $zcvt is your friend, the three argument form specifically. But there are a lot of options. So here's an utility script to check how the text would look like in different encodings: #Beginner #InterSystems IRIS 3 4 0 425
Article Eduard Lebedyuk · Dec 7, 2019 1m read About %objlasterror %objlasterror is a useful reference to the last error. Every time $$$ERROR is called, %objlasterror is set to a result of this call. It's important in cases where you want to convert exception to status: Try { // quality code } Catch ex { Set sc = $g(%objlasterror, $$$OK) Set sc = $$$ADDSC(sc, ex.AsStatus()) } Because AsStatus calls $$$ERROR under the wraps, the order is important, first you need to get %objlasterror and convert exception after that. #InterSystems IRIS 7 8 3 1.4K