Posted Mar 24 by Simon Day.
Updated Jun 13 by Edmund Clayton.

Last activity Jun 13 by Edmund Clayton.
3395 views. 1 comment.

1 Introduction

These Release Notes provide an overview of AppWorks Gateway 1.2.2,
including new features, delivery information, and supported platforms.
OpenText recommends that you read these Release Notes in conjunction
with the documentation included with the software package. If any
conflicts exist, the Release Notes supersede the other documentation.

We also recommend that you check OpenText Developer
( for any patches or documentation
updates that may have been posted after the initial release of AppWorks
Gateway 1.2.0, 1.2.1, and 1.2.2.

1.1 Release Notes Revision History

Revision DateSections RevisedDescription of Revisions
2015-03-23First release.All new content.
2015-03-27Final release.Minor updates to content.
2015-05-08Patch 1 Updates.Changes for AppWorks 1.2.1.
2015-11-24Patch 2 Updates.Changes for AppWorks 1.2.2.

2 About AppWorks Gateway

The AppWorks Gateway is the Enterprise Application Development and
Management platform for OpenText. AppWorks allows you to quickly and
easily build purpose-specific apps for the Enterprise using the Web
technologies we are all familiar with: HTML5, CSS3 and JavaScript. These
apps, called AppWorks Apps, can connect to the OpenText EIM Suite using
a common RESTful API.

2.1 New Features

AppWorks Gateway 1.2.0 Includes the following new features.

  • Single Sign On from Windows Desktop Browser Clients.


  • The Single Sign on from Windows Desktop browsers only works for Content Server 10.5 installations.
  • Content Server 10 users must disable the OpenText Directory Services (OTDS) single sign-on option in the Advanced Settings of the Appworks Gateway. however they will still be able to login with any OTDS supported user format.
  • Content Server 10 users will not have single sign-on functionality, but will be able to login with any OTDS supported user format.
  • If Content Server authentication is used, single sign-on is disabled automatically on addition of the Content Server identity provider.

2.2 New Features in AppWorks Gateway 1.2.1

The following new features have been added to AppWorks 1.2.1:

  • Single sign-on from Windows desktop browsers using OTDS SAML authentication handlers.
  • Single sign-on from Windows desktop browsers using OTDS two-factor authentication.
  • Single sign-on from Windows desktop browsers using OTDS and Google oAuth2.0 authentication.
  • Support for Java 8 and Tomcat 8.


The single sign-on from Windows desktop browsers with SAML, two-factor authentication and Google Oauth 2.0 authentication only works for Content Server 10.5 installations.

2.3 New Features in AppWorks Gateway 1.2.2

AppWorks 1.2.2 is a patch update and no new features have been added.

2.4 Discontinued and Deprecated Features

The following features have been deprecated in this release:

  • Within the AppWorks Gateway Admin UI, the Server and Client Traffic
    report functionality has been deprecated. It will be replaced with
    enhanced functionality in a later release.

  • New installations of the AppWorks Add-on Bundle will not contain the
    Insight Admin Dashboard. Upgrading from version 1.1.6 to 1.2.0,
    1.2.1 or 1.2.2 will not remove the Insight Admin Dashboard, but it
    can be disabled or deleted from the AppWorks Gateway Admin UI.

3 Packaging and Documentation

Downloads and documentation for are available on OpenText Developer

3.1 Packaging and Delivery Information

The software and documentation for includes:

  • AppWorks Gateway 1.2.2. A full server release that is provided as a
    single ZIP archive. The AppWorks Gateway is available on OpenText Developer

  • AppWorks Add-ons Bundle 1.2.2. The AppWorks Add-ons Bundle is
    available on OpenText Developer

  • AppWorks Encryption Tool. The AppWorks encryption for encryption
    tool for updating an existing file is
    available on OpenText Developer

3.2 Related Documentation

For additional information about , or for supplemental information about
related products, refer to OpenText Developer

4 Supported Environments and Compatibility

This section provides details about supported platforms, systems, and versions.

4.1 Supported Systems

Component VersionLevel of Support
Java C
Java C
Tomcat Application Server7.0.65C
Tomcat Application Server8.0.28C
Microsoft Windows Server 2012 R2C
Centos Linux6C
Red Hat Linux6S
Microsoft Windows Server2012S
Microsoft Windows Server2008 R2S
Microsoft SQL Server2012C
Oracle Database11G R2C
MySQL Database Community Edition5.6C

Notes on Supported Platforms:

C = Certified

This platform was used for regression testing with this release of the
AppWorks Gateway. Use of this platform is fully supported by OpenText
Customer Support for customers that have purchased product licenses.

S = Supported

This platform received limited testing for this release of the AppWorks
Gateway. Use of this platform is fully supported by OpenText Customer
Support for customers that have purchased product licenses.

Not Listed = Unsupported

This received no testing by OpenText. There may or may not be known
issues with this platform. Its use is not supported by OpenText Customer Support.

4.2 OpenText Product Compatibility

The section provides details about which versions of other OpenText
products are compatible with this release of AppWorks Gateway 1.2.2.

  • Note: For the latest compatibility information for OpenText
    products, refer to the Compatibility Matrix
    ( on the OpenText
    Knowledge Center.

    Product NameVersionNotes
    Content Server10Up to Service Pack 2 (2015-09)
    Content Server10.5Up to Service Pack 1 (2015-09)
    Directory Services10Latest patch recommended
    Directory Services10.5Latest patch recommended

4.3 Language Support

AppWorks Gateway is currently localized in the following languages. Future releases may add additional languages.

Appworks Gateway Admin UIB       
AppWorks Gateway Web AccessB       

UI = user interface only
B = both user interface and online help

5 Installation, Upgrade, and Patch Notes

This section provides additional installation and upgrade information,
including related or third-party product information and any required
critical patches.

5.1 Installation Notes

Before you install AppWorks Gateway, review these additional installation notes and verify related product or third-party product requirements.

  • Ensure you are running the supported versions of Tomcat and Java.

5.2 Upgrade Notes

The AppWorks Gateway supports upgrading from AppWorks 1.1.5 and higher.
Complete upgrade details are available in the installation and upgrade
documentation that is available on OpenText Developer
OpenText Developer Site.

  • Note:
    In the AppWorks 1.2.2 release, the file is enhanced to enforce encryption of the database connection information. Ensure you follow the installation guide for AppWorks Gateway 1.2.2 to encrypt the contents of that file because otherwise the upgrade will fail.

5.3 Patches

The following patches must be applied to AppWorks Gateway 1.2.1. OpenText also recommends that you check the OpenText Developer Site for any patches or documentation updates that may have been posted after this release.

5.3.1 Patch Prerequisites

Before installing the patch, ensure that you have met the following prerequisites:

  • Ensure you have applied all of the latest required patches for components other than AppWorks. For example, if you want to use Content Server with AppWorks, ensure the latest Content Server patches and updates are applied.

5.3.2 Patch Downloads

You must download the following to install this patch:

  • No AppWorks Patches currently exist for this version.

5.4 Installation and Administration Guide

Further information on installing, upgrading and administering the AppWorks Gateway is available here:

6 Fixed Issues

This section provides information about past issues that have been fixed
in this release.

Issue NameIssue Description
OTAG-1796Encryption of file.
OTAG-1818SMTP password encryption.
OTAG-2401Update to SMTP settings area of Gateway Admin Interface.
OTAG-2643Preflight check support for Java 8.
OTAG-2718Tempo Social permalinks fix when not logged in.
OTAG-2806URL Security enhancements.
OTAG-2811Enhancements to administrative action logging.
OTAG-3288HTTP Only Cookie enhancements.
OTAG-3532Enhancements to Events Database Queries.

7 Known Issues

Issue NameIssue Description
OTAG-3439Embedded OTDS fails to deploy on Centos 7.

This issue does not occur if an external OTDS is used.
This is an issue that will be resolved in a future release of AppWorks

Issue NameIssue Description
OTAG-3425External Authentication with Reverse Proxy .
OTAG-3391Tomcat 8.0.29 gateway CSS issues.

8 Contact Information

OpenText Corporation

275 Frank Tompa Drive\
Waterloo, Ontario\
Canada, N2L 0A1


Knowledge Center:

OpenText Developer

For more information, visit

1 Comment


The binaries for AppWorks 1.2.2 will be posted on this site on the 25th of March 2016

Table of Contents

Your comment

To leave a comment, please sign in.