Version 10.8 Installable (Apr 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.8 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.6 to Version 10.8
• Version 10.7 to Version 10.8

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.8 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.8

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

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

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

4. Extract upgrade.tar.gz. The extracted folder consists of two files upgrade.sh and upgrade.jar, and one folder db-upgrade-patches.

5. Move upgrade.sh and upgrade.jar files and db-upgrade-patches folder from 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=/home/aal-lab/AgileApps10.6

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

   Example: --aal-version=10.8

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

   Example: --aal-db-backup-folder=/home/aal-lab/AgileApps10.6_DB_Backup

Non-mandatory parameters

1. --move-reportdb-cfg - enable this parameter to replicate the configuration in the target application server, if there is a redundant database used for reporting in the existing application server.

   To enable: --move-reportdb-cfg=yes

   To disable: --move-reportdb-cfg=no

2. --move-tomcat-ports – enable this parameter to replicate the configuration of the Tomcat server ports 80 and 443 from the existing application server to the target application server. Disable this parameter to use the default configuration of Tomcat server ports 8284 and 8283.

   To enable: --move-tomcat- ports=yes

   To disable: --move-tomcat- ports=no

3. --move-quartz – enable this parameter to replicate the quartz configuration from the existing application server to the target application server. Disable this parameter or do not provide this parameter for different quartz configuration in the target application server.

   To enable: --move-quartz=yes

   To disable: --move-quartz=no

Note

• Provide the mandatory parameter’s value separated by equal (=) character. For example, --aal-version=10.8
• Provide the non-mandatory parameters with values ‘yes’ or ‘no’ separated by equal (=) character. For example, --move-reportdb-cfg=yes and --move-reportdb-cfg=no
• You can also provide the non-mandatory parameters without the value ‘yes’. For example, --move-reportdb-cfg
• If you do not mention the non-mandatory parameter, the upgrade utility program does not consider the parameter.
• The values ‘yes’ and ‘no’ are not case sensitive.
• Syntax: {install_dir}/aal-upgrade/upgrade.sh mandatory-param1=val1 mandatory-param2=val2 mandatory-param3=val3 non-mandatory-param4 non-mandatory-param5 non-mandatory-param6. For example: upgrade.sh --aal-path=/home/aal-lab/AgileApps10.6 --aal-version=10.8 --aal-db-backup-folder=/home/aal-lab/AgileApps10.6_DB_Backup --move-reportdb-cfg --move-tomcat-ports --move-quartz
• In case of errors, look at the log messages available at upgrade.log file under aal-upgrade/logs.

8. Move the documents and temporary files or folders from the existing application server to the target application server.

(a) <SOURCE_INSTALLATION_HOME_PATH>/docs to <TARGET_INSTALLATION_HOME_ PATH>/docs

(b) <SOURCE_INSTALLATION_HOME_ PATH>/temp to <TARGET _INSTALLATION_HOME_ PATH>/temp

9. Start the 10.8 application server available at {install_dir}/profiles/LJP/bin/startup.sh

10. In case of errors, check:

{install_dir}/profiles/LJP/logs/wrapper.log

{install_dir}/profiles/LJP/logs/relationals.log

11. Change the ‘Document Directory’ and ‘Temp Directory’ folder path in 'Configure Service settings' in the target application server.

12. For custom configuration, proceed to Configuring the Application Server.

Custom configuration considerations:

• This upgrade program does not copy custom libraries like the third-party JARs available at {install_dir}/AgileApps/lib or {install_dir}/AgileApps/platformlib or {install_dir}/AgileApps/userlib. You must move such libraries manually from the existing application server to the target application server.
• This upgrade program does not copy the custom configurations present in wrapper.conf and custom_wrapper.conf files under {install_dir}/profiles/LJP/configuration. You must move such configurations manually from the existing application server to the target application server.