Migration
IG is delivered in this release as a standalone Java executable in a .zip file, as well as in a .war file. Consider these points to migrate from IG in web container mode to IG in standalone mode.
- Session replication between IG instances
Use only stateless sessions, as described in "Sessions". Stateful sessions are not supported.
- Streaming of asynchronous responses and events
In ClientHandler and ReverseProxyHandler, use only the default mode of
asyncBehavior:non_streaming; responses are processed when the entity content is entirely available. If the property is set tostreaming, the setting is ignored. For information, see "ClientHandler" and "ReverseProxyHandler".- Connection reuse when a client certificate is used for authentication
In ClientHandler and ReverseProxyHandler, use only the default mode of
stateTrackingEnabled:true; when a client certificate is used for authentication, connections cannot be reused. If the property is set tofalse, the setting is ignored. For information, see "ClientHandler" and "ReverseProxyHandler".- Tomcat configuration alternative
- Port number
Tomcat: Configure in the
Connectorelement of/path/to/tomcat/conf/server.xml:<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
Standalone: Configure the
connectorsproperty$HOME/.openig/config/admin.json, where$HOME/.openigis the instance directory. For information, see "AdminHttpApplication (admin.json)".
- Configuring IG for HTTPS server-side
Tomcat: Create a keystore, and set up the SSL port in the
Connectorelement of/path/to/tomcat/conf/server.xml. For information, see "Configuring IG for HTTPS (Server-Side) in Tomcat".Standalone: Create a keystore, set up secrets, and configure secrets stores, ports, and ServerTlsOptions in
$HOME/.openig/config/admin.json, where$HOME/.openigis the instance directory. For information, see "Configuring IG For HTTPS (Server-Side)".
- Session cookie name
Tomcat: Configure
WEB-INF/web.xmlwhen you unpack the IG .war file.Standalone: Configure the
sessionproperty of$HOME/.openig/config/admin.json, where$HOME/.openigis the instance directory. For information, see "AdminHttpApplication (admin.json)".
- Access logs
Tomcat: Configure with AccessLogValve.
Standalone: Configure in the Audit framework. For information, see Auditing Your Deployment and Audit Framework.
- JDBC datasource
Tomcat: Configure in the
GlobalNamingResourceselement of/path/to/tomcat/conf/server.xml.Standalone: Configure with the JdbcDataSource object. For information, see "JdbcDataSource". For an example, see "Logging In With Credentials From a Database".
- Environment variables
Tomcat: Configure in
/path/to/tomcat/bin/setenv.sh, where$HOME/.openigis the instance directory.Standalone: Configure in
$HOME/.openig/bin/env.sh, where$HOME/.openigis the instance directory.
- Jar files
Tomcat: Add to to web container classpath; for example
/path/to/tomcat/webapps/ROOT/WEB-INF/lib.Standalone: Add to
$HOME/.openig/extra, where$HOME/.openigis the instance directory.