InterSystems External Server Requirements
All InterSystems External Servers are set to a predefined default configuration automatically on installation. If your language platforms are installed in default locations, no additional configuration should be necessary. If an external server fails to start with the predefined settings, the problem can almost always be corrected by setting the correct path to the supporting language platform (see Troubleshooting External Server Definitions for details).
This section provides information on the default location and supported versions for all Java, .NET, and Python external servers:
InterSystems IRIS Requirements and Setup
To communicate with an InterSystems External Server, your instance of InterSystems IRIS must be version 2020.4 or higher. The Java, .NET, and Python External Servers are designed to work automatically if the default settings for those language platforms can be used. In some cases, minor changes to server configurations may be required (as described in the following sections).
The path to your installation directory can be displayed at the Terminal by entering the following ObjectScript command:
write $SYSTEM.Util.InstallDirectory()
Java External Server Setup
A version of the Java External Server executable is provided for each supported version of Java. The correct version will usually be specified automatically for the default Java server configuration (%Java Server) during installation.
Each server version is located in a different subdirectory of install-dir\dev\java\bin where install-dir contains your preferred instance of InterSystems IRIS.
The following versions of the Java External Server are included in the standard installation:
-
Java 8: install-dir\dev\java\lib\JDK18\intersystems-gateway-3.2.0.jar
-
Java 11: install-dir\dev\java\lib\JDK11\intersystems-gateway-3.2.0.jar
If you wish to use a JVM other than the one specified in your JAVA_HOME setting, some extra configuration will be required to set the path to your desired language platform (see “Defining External Server Configurations for Java”).
The appropriate version of Java must be installed on your system in order to use these components. The InterSystems IRIS installation procedure does not install or upgrade any version of Java.
.NET External Server Setup
A version of the .NET External Server assembly is provided for each supported .NET version. The correct external server version will be specified automatically for the default .NET external server configuration (%DotNet Server) during installation.
In some applications, the .NET and .NET Framework assemblies may be used to load unmanaged code libraries. Both 32-bit and 64-bit assemblies are provided for each supported version, which makes it possible to create gateway applications for 64-bit Windows that can load 32-bit libraries.
If you wish to use a version other than the default for your system, some extra configuration will be required to set the path to your desired language platform (see “Defining External Server Configurations for .NET”).
Python External Server Setup
The Python External Server requires Python 3.6.6 or higher. If a supported version of Python is available on your system, the correct path to the Python executable will usually be specified automatically for the default Python external server configuration (Python Server) during installation.
If a supported version of Python 3 is not the default for your system, some extra configuration will be required to set the path to your desired instance (see “Defining External Server Configurations for Python”).
Install the Python External Server package with the following command:
python -m pip install --upgrade <path>\intersystems_irispython-3.2.0-py3-none-any.whl
Do not use the --user option.
A supported version of Python 3 must be installed on your system in order to use this package. The InterSystems IRIS installation procedure does not install or upgrade any version of Python.
