Version 10.5 Installable (Oct 2015)
Release Notes for the installable version of the AgileApps Cloud platform.
See also:
- Version 10.4 Installable (previous release)
- All Release Notes
- Upcoming Releases
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
Installing and Upgrading
New Platform Installation
Before starting a new installation:
- Ensure that the Hardware Requirements are met.
- Ensure that the Software Requirements#Required for Installation are met.
- Configure the MySQL Server so it is ready for use.
- When done, you are ready to install the platform.
Upgrading from a Previous Version
Prepare to Upgrade
Important:
Follow all of these steps before upgrading.
- Ensure that the Hardware Requirements are met.
- Ensure that the Software Requirements#Required for Installation are met.
- Upgrade the platform to version 10.4.
That is the only version that supports the upgrade script. - Download and run the update.sh script to prepare the platform for the upgrade.
- __TBD: Upload the script when available__
- When done, you are ready to upgrade the platform.
Additional Upgrade Notes
Upgraded Software Requirements
- These software requirements have been upgraded:
- MySQL 5.6
- JDK 8
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.__
Learn More
- Quick Install Guide (development and testing)
- Platform Installation Guide (production installation)