--- title: Migrate from web container mode to standalone mode description: Consider these points to migrate from IG in web container mode to IG in standalone mode. component: pinggateway version: 2023.11 page_id: pinggateway:upgrade:upgrade-war-to-zip canonical_url: https://docs.pingidentity.com/pinggateway/2026/upgrade/upgrade-war-to-zip.html llms_txt: https://docs.pingidentity.com/pinggateway/llms.txt docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md revdate: 2023-09-19T08:48:14Z keywords: ["Install", "Configuration", "Migration", "Authentication", "Certificates"] superseded_by: https://docs.pingidentity.com/pinggateway/2026/upgrade/upgrade-war-to-zip.html section_ids: session_replication_between_ig_instances: Session replication between IG instances streaming_asynchronous_responses_and_events: Streaming asynchronous responses and events connection_reuse_when_client_certificates_are_used_for_authentication: Connection reuse when client certificates are used for authentication tomcat_configuration: Tomcat configuration --- # Migrate from web container mode to standalone mode Consider these points to migrate from IG in web container mode to IG in standalone mode. ## Session replication between IG instances High-availability of sessions is not supported . ## Streaming asynchronous responses and events In [ClientHandler](../reference/Handlers.html#ClientHandler) and [ReverseProxyHandler](../reference/Handlers.html#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 to `streaming`, the setting is ignored. ## Connection reuse when client certificates are used for authentication In [ClientHandler](../reference/Handlers.html#ClientHandler) and [ReverseProxyHandler](../reference/Handlers.html#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 to `false`, the setting is ignored. ## Tomcat configuration | Feature | Standalone | Tomcat | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Port number | Configure the `connectors` property of [admin.json](../reference/AdminHttpApplication.html). | Configure in the `Connector` element of `/path/to/tomcat/conf/server.xml`:```xml ``` | | HTTPS server-side configuration | Create a keystore, set up secrets, and configure secrets stores, ports, and ServerTlsOptions in [admin.json](../reference/AdminHttpApplication.html).For information, refer to [Configure IG for HTTPS (server-side)](../installation-guide/envvar-sysprop.html#standalone-https). | Create a keystore, and set up the SSL port in the `Connector` element of `/path/to/tomcat/conf/server.xml`.For information, refer to [Configure IG for HTTPS (server-side) in Tomcat](../installation-guide/install-tomcat.html#tomcat-https). | | Session cookie name | Configure the `session` property of [admin.json](../reference/AdminHttpApplication.html). | Configure `WEB-INF/web.xml` when you unpack the IG .war file. | | Access logs | Configure in the Audit framework.For information, refer to [Audit the deployment](../maintenance-guide/auditing.html) and [Audit framework](../reference/AuditFramework.html). | Configure with `AccessLogValve`. | | JDBC datasource | Configure with the JdbcDataSource object.For information, refer to [JdbcDataSource](../reference/MiscellaneousConfigurationObjects.html#JdbcDataSource).For an example, refer to [Password replay from a database](../gateway-guide/sso-cdsso.html#credentials-database). | Configure in the `GlobalNamingResources` element of `/path/to/tomcat/conf/server.xml`. | | Environment variables | Configure in `$HOME/.openig/bin/env.sh`, where `$HOME/.openig` is the instance directory. | Configure in `/path/to/tomcat/bin/setenv.sh`. | | Jar files | Add to `$HOME/.openig/extra`, where `$HOME/.openig` is the instance directory. | Add to to web container classpath; for example `/path/to/tomcat/webapps/ROOT/WEB-INF/lib`. |