Version 10.9 Installable (Oct 2017)

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

See also: All Release Notes Release calendar

About the Installable Version

The installable version of the AgileApps Cloud platform allows you to create and manage a private cloud behind your firewall. AgileApps Cloud platform also helps you to set up a public cloud with a shared application and global data.

10.9 platform features and fixes

For more information on new features and fixes, see Release Notes.

Software support

• MySQL 5.7
• JDK 8

For more information, see Software Requirements and Hardware Requirements

New Installation

For new installation, see Quick Install Guide and Platform Installation Guide.

Note: The installation and operation of the AgileApps Cloud platform requires Java 8. But, the custom code in Java Class continues to be validated against Java 6 syntax as the instrumentation engine responsible for monitoring resource utilization works only on Java 6 byte codes.

Upgrading an existing installation

Upgrade options available:

• Version 10.5 to Version 10.9
• Version 10.6 to Version 10.9
• Version 10.7 to Version 10.9
• Version 10.8 to Version 10.9

Upgrade program

AgileApps Cloud uses an upgrade program to update from an existing application server to the target application server. The upgrade program migrates the custom JARs from the existing application server to the target application server.

Note: 10.9 is the target application server.

Prerequisites:

• Set the value for max_allowed_packet property in my.cnf or my.cfg (MySQL configuration files) under [client], [mysqld] & [mysqldump] sections. If you are installing any package through Packages using AgileApps Cloud application, you must have at least 512 MB of RAM or ten times the size of package.
• Verify the privileges to access the database with the username, password, host-name and port as mentioned in the com.softwareag.catalina.resource.pid-agileappsRN.properties file under the target application server. Use the following command to ensure that you have the database access:

mysqldump -u<DB_USER_NAME> -p<DB_PASSWORD> -h<DB_SERVER_HOST_NAME> -P<DB_PORT> db<DB_NUMBER> > db<DB_NUMBER>.sql

For example: mysqldump -uthomas -pthomas-hvmaalind05 -P3306 db1108948326 > db1108948326.sql

Upgrading to 10.9

1. Stop the 10.5 or 10.6 or 10.7 or 10.8 application server.
2. Install the 10.9 application server using SoftwareAG installer. For more information, see webMethods 10.0 Installation documents available on Empower.

Important: Do not run the 10.9 application server after installation. After the installation, the 10.9 application server exists in parallel with the 10.5 or 10.6 or 10.7 or 10.8 application server. Do not initiate the upgrade program.

3. Create a new folder aal-upgrade in the installed 10.9 root directory.

4. Extract upgrade.tar.gz. The extracted folder upgrade is available at {install_dir}/AgileApps/upgrade. The extracted folder consists of three files upgrade.sh,upgrade.jar,upgrade_supported_configurations.txt, and one folder db-upgrade-patches.

5. Move the extracted Upgrade folder to aal-upgrade folder.

6. Provide executable permission to upgrade.sh file.

7. Run upgrade.sh file with mandatory parameters.

Mandatory parameters

1. --aal-path - provide the folder path of the existing application server.

   Example: --aal-path=/{install_dir}/aal-lab/AgileApps10.6

2. --aal-version - provide the version number of the target application server.

   Example: --aal-version=10.9

Non-mandatory parameters

1. --aal-db-backup-folder - provide a path for database backup of all relationals and tenants.

   Example: --aal-db-backup-folder=/{install_dir}/aal-lab/AgileApps10.6_DB_Backup