Difference between revisions of "Version 10.5 Installable (Oct 2015)"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 63: Line 63:
# [[Configure the MySQL Server]] so it is ready for use.
# [[Configure the MySQL Server]] so it is ready for use.
# Backup the platform database.
# Backup the platform database.
# [http://agileappscloud.info/aa104/Upgrading_the_Application_Server Upgrade the platform to version 10.4], in order to run the upgrade script below.
#:
# Download and run the [{{DOCHOST}}/files/update.sh update.sh] script to prepare the database for the upgrade.
# [http://agileappscloud.info/aa104/Upgrading_the_Application_Server Upgrade the platform to version 10.4], in order to run the upgrade script that follows.
#: {{TBD|Upload the script when available}}
# [http://agileappscloud.info/aa104/Stop_the_Application_Server Stop the 10.4 server]
#:
# Use the standard SoftwareAG installer to install the 10.5 platform, '''''but do not start it''''', as yet. (It won't run, at this point.)<br>''Learn more:'' In [http://documentation.softwareag.com/webmethods/wmsuites/wmsuites_vers.htm webMethods documentation page] see the {{wM Ver}} Installation document.
# Use the standard SoftwareAG installer to install the 10.5 platform, '''''but do not start it''''', as yet. (It won't run, at this point.)<br>''Learn more:'' In [http://documentation.softwareag.com/webmethods/wmsuites/wmsuites_vers.htm webMethods documentation page] see the {{wM Ver}} Installation document.
# ...
# Download [{{DOCHOST}}/files/update.zip update.zip], which contains JARs, an application program, and a wrapper script.
# [[Start the Application Server]]
# Unzip the package to the 10.5 <tt>{installDir}/aal-update</tt>
# Run <tt>{installDir}/aal-update/update.sh</tt> to prepare the main database and customer databases for the upgrade.
# When the script finishes, start the 10.5 server: <tt>{installDir|/profiles/LJP/bin/startup.sh
# In the of error check:
#* <tt>{installDir|/profiles/LJP/logs/wrapper.log</tt>
#* <tt>{installDir|/profiles/LJP/logs/relationals.log</tt>
# When done, proceed to [[Configuring the Application Server]].
# When done, proceed to [[Configuring the Application Server]].



Revision as of 20:38, 22 September 2015

Release Notes for the installable version of the AgileApps Cloud platform.

See also:

About the Installable Version

The installable version of the platform lets you create and manage a private cloud behind your corporate firewall. It can also be used to set up a public cloud that serves multiple clients--generally with a shared application and global data. This page highlights changes to the installation process, along with features of the new release.

Platform Functionality

New Platform Features

In addition to bug fixes, this release contains features that have been added to the cloud platform, as described in the Release Notes.

Bug Fixes

  • LJP-291: Broken links to the chart-handling libraries in the support wiki were fixed.
  • LJP-356: Display an error message when imports are disabled, and an import is attempted.

Installable Version Functionality

These new and changed features are of interest to those who maintain an instance of the platform's installable version:

Standard Installation Process

An on-premise installation of the AgileApps Cloud platform is accomplished using the standard Software AG installation procedures.

Certificate-based Platform Access

When the on-premise installation architecture is configured with a certificate-validation server, the platform can be accessed by browsers or by REST APIs without a login step, by supplying an identifying certificate.
Learn more: Client Certificate Authentication in a private AgileApps Cloud (pdf)

Session Limits

A new Tenant Capabilities option, Session Limits, enables the Session Management feature for selected tenants.
Learn more: Session Management

Promotion Codes

Platform administrators can create promotion codes for new tenants, "sweetening the pot" for a specified period of time to encourage new business.
Learn more: Promo Code Configuration

Promotion Code APIs

Along with the new promotion codes comes the ability to manage them using APIs. So it becomes possible to define a custom interface, rather than requiring the sales organization to use the platform admin interface.
Learn more: REST API:promoCode Resource

Upgrade Notes

Warn.png

Important:
Before upgrading, it is necessary to follow the preparation steps below.

Upgraded Software Requirements

These software requirements have been upgraded:
  • MySQL 5.6
  • JDK 8

Notepad.png

Note: While the installation and operation of the platform requires Java 8, custom code in a Java Class continues to be validated against Java 6 syntax -- in part because the instrumentation engine responsible for monitoring resource utilization only works on version 6 byte codes.

Platform Changes to Be Aware Of

  • Folder structure changes
    __TBD: Assess impact of these changes. Describe implications.__
  • Potential JAR Conflicts
    These JARs have been added. If your platform instance has added similar JARs, there could be conflicts that cause unpredictable behavior.
  • __TBD: List added JARs.__

Upgrading to 10.5

  1. Ensure that the Hardware Requirements are met.
  2. Ensure that the Software Requirements#Required for Installation are met.
  3. Configure the MySQL Server so it is ready for use.
  4. Backup the platform database.
  5. Upgrade the platform to version 10.4, in order to run the upgrade script that follows.
  6. Stop the 10.4 server
  7. Use the standard SoftwareAG installer to install the 10.5 platform, but do not start it, as yet. (It won't run, at this point.)
    Learn more: In webMethods documentation page see the 9.9 Installation document.
  8. Download update.zip, which contains JARs, an application program, and a wrapper script.
  9. Unzip the package to the 10.5 {installDir}/aal-update
  10. Run {installDir}/aal-update/update.sh to prepare the main database and customer databases for the upgrade.
  11. When the script finishes, start the 10.5 server: {installDir|/profiles/LJP/bin/startup.sh
  12. In the of error check:
    • {installDir|/profiles/LJP/logs/wrapper.log
    • {installDir|/profiles/LJP/logs/relationals.log
  13. When done, proceed to Configuring the Application Server.

Learn More