Difference between revisions of "Version 10.7 Installable (Oct 2016)"

From AgileApps Support Wiki
imported>Aeric
(Created page with "Release Notes for the installable version of the {{EnterpriseBrand}}. :{| border="1" align="right" cellpadding="5" cellspacing="1" | '''''See also:''''' * [[Version 10.6 Instal...")
 
imported>Aeric
 
(11 intermediate revisions by the same user not shown)
Line 4: Line 4:
|
|
'''''See also:'''''
'''''See also:'''''
* [[Version 10.6 Installable]] (previous release)
* [[All Release Notes]]
* [[All Release Notes]]
* [[Upcoming Releases]]
* [[Release calendar]]
|}
|}
==About the Installable Version==
==About the Installable Version==
Line 25: Line 24:
==Upgrade Notes==
==Upgrade Notes==
{{Important|<br>Before upgrading, it is necessary to follow the preparation steps below.}}
{{Important|<br>Before upgrading, it is necessary to follow the preparation steps below.}}
=== Upgraded Software Requirements ===
=== Upgraded software support ===
:These software requirements have been upgraded:
:The following software versions are supported:
::* MySQL 5.6
::* MySQL 5.7
::* JDK 8
::* 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.}}
{{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.}}
Line 35: Line 34:


To upgrade to 10.7:
To upgrade to 10.7:
# [http://agileappscloud.info/aa105/Upgrading_the_Application_Server Upgrade the platform to version 10.5 or 10.6] (the version required to run the 10.7 upgrade script).
# Ensure that the 10.7 [[Hardware Requirements]] are met.
# Ensure that the 10.7 [[Hardware Requirements]] are met.
# Ensure that the 10.7 [[Software Requirements#Required for Installation]] are met.
# Ensure that the 10.7 [[Software Requirements#Required for Installation]] are met.
#:
#:
# [http://agileappscloud.info/aa105/Stop_the_Application_Server Stop the 10.5 or 10.6 server]
# [http://agileappscloud.info/aa105/Stop_the_Application_Server Stop the 10.5 or 10.6 server]
# For safety, do a [[Database Backup and Recovery#Standard Database Backup|Standard Database Backup]].
# For safety, perform [[Database Backup and Recovery#Standard Database Backup|Standard Database Backup]].
#:
#:
# Use the standard SoftwareAG installer to install the 10.7 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.7 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.
# In the 10.7 <tt>{install_dir}</tt>, create the <tt>aal-update/</tt> folder.
# In the 10.7 <tt>{install_dir}</tt>, create the <tt>aal-update/</tt> folder.
# Download [{{DOCHOST}}/files/update.zip update.zip]
# Locate update.zip in the AgileApps installation folder.
# Unzip it to the 10.7 <tt>{install_dir}/aal-update</tt><br>Several JARs, the update program, and a wrapper script are created.
# Unzip it to the 10.7 <tt>{install_dir}/aal-update</tt><br>Several JARs, the update program, and a wrapper script are created.
#:
#:
Line 59: Line 57:
#::: Replicate the 10.5 or 10.6 configuration of tomcat ports (80 and 443) in the 10.7 server.<br>Disable this option to use the default configuration (8284 and 8283).
#::: Replicate the 10.5 or 10.6 configuration of tomcat ports (80 and 443) in the 10.7 server.<br>Disable this option to use the default configuration (8284 and 8283).
# Add the below servlet mappings  to the web.xml available @ "$INSTALL_DIR/profiles/LJP/workspace/webapps/networking/WEB-INF/ after the closing tag of <servlet-mapping>(</servlet-mapping>) after <url-pattern>/SDAjaxFormSubmit</url-pattern>and attached is the sample for reference
# Add the below servlet mappings  to the web.xml available @ "$INSTALL_DIR/profiles/LJP/workspace/webapps/networking/WEB-INF/ after the closing tag of <servlet-mapping>(</servlet-mapping>) after <url-pattern>/SDAjaxFormSubmit</url-pattern>and attached is the sample for reference
  <servlet>
#:  <servlet>
    <servlet-name>delegateeLogin</servlet-name>
#:: <servlet-name>delegateeLogin</servlet-name>
    <servlet-class>com.es.relationals.DelegateeLogin</servlet-class>
#:: <servlet-class>com.es.relationals.DelegateeLogin</servlet-class>
  </servlet>
#:  </servlet>
 
#:  <servlet-mapping>
  <servlet-mapping>
#:::  <servlet-name>delegateeLogin</servlet-name>
      <servlet-name>delegateeLogin</servlet-name>
#::  <url-pattern>/delegateeLogin</url-pattern>
      <url-pattern>/delegateeLogin</url-pattern>
#:  </servlet-mapping>
  </servlet-mapping>
# When the script finishes, start the 10.7 server:  
# When the script finishes, start the 10.7 server:  
#: <tt>{install_dir|/profiles/LJP/bin/startup.sh</tt>
#: <tt>{install_dir|/profiles/LJP/bin/startup.sh</tt>
Line 73: Line 70:
#* <tt>{install_dir|/profiles/LJP/logs/wrapper.log</tt>
#* <tt>{install_dir|/profiles/LJP/logs/wrapper.log</tt>
#* <tt>{install_dir|/profiles/LJP/logs/relationals.log</tt>
#* <tt>{install_dir|/profiles/LJP/logs/relationals.log</tt>
# When done, proceed to [[Configuring the Application Server]].
# Proceed to [[Configuring the Application Server]].
<noinclude>
<noinclude>


[[Category:ISV Release Notes]]
[[Category:ISV Release Notes]]
</noinclude>
</noinclude>

Latest revision as of 08:53, 13 April 2018

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.

New Installations

These instructions apply to new installations. To upgrade and existing installation, see the notes that follow.

Upgrade Notes

Warn.png

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

Upgraded software support

The following software versions are supported:
  • MySQL 5.7
  • 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.

Upgrading to 10.7

This process utilizes an upgrade program to migrate a version 10.5 or 10.6 application server to version 10.7. Before the program runs, a new 10.7 application server is installed alongside the existing 10.5 or 10.6 server. The upgrade program then migrates custom JARs to the new server and modifies the server databases for use with 10.7 (the main database and each of the tenant databases).

To upgrade to 10.7:

  1. Ensure that the 10.7 Hardware Requirements are met.
  2. Ensure that the 10.7 Software Requirements#Required for Installation are met.
  3. Stop the 10.5 or 10.6 server
  4. For safety, perform Standard Database Backup.
  5. Use the standard SoftwareAG installer to install the 10.7 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.
  6. In the 10.7 {install_dir}, create the aal-update/ folder.
  7. Locate update.zip in the AgileApps installation folder.
  8. Unzip it to the 10.7 {install_dir}/aal-update
    Several JARs, the update program, and a wrapper script are created.
  9. Run the update script:
    {install_dir}/aal-update/update.sh
    Parameters:
    • --aal-path {path} - Required.
    Provide the path to the 10.5 or 10.6 installation
    • move-reportdb-cfg=yes|no - Default: no.
    If there is a redundant database that is used for reporting, enable this option to replicate the configuration in the 10.5 or 10.6 server.
    • move-quartz=yes|no - Default: yes.
    Replicate the quartz configuration. Disable this option if you are planning a different configuration.
    • move-tomcat-ports=yes|no - Default: yes.
    Replicate the 10.5 or 10.6 configuration of tomcat ports (80 and 443) in the 10.7 server.
    Disable this option to use the default configuration (8284 and 8283).
  10. Add the below servlet mappings to the web.xml available @ "$INSTALL_DIR/profiles/LJP/workspace/webapps/networking/WEB-INF/ after the closing tag of <servlet-mapping>(</servlet-mapping>) after <url-pattern>/SDAjaxFormSubmit</url-pattern>and attached is the sample for reference
    <servlet>
    <servlet-name>delegateeLogin</servlet-name>
    <servlet-class>com.es.relationals.DelegateeLogin</servlet-class>
    </servlet>
    <servlet-mapping>
    <servlet-name>delegateeLogin</servlet-name>
    <url-pattern>/delegateeLogin</url-pattern>
    </servlet-mapping>
  11. When the script finishes, start the 10.7 server:
    {install_dir|/profiles/LJP/bin/startup.sh
  12. In the event of an error, check:
    • {install_dir|/profiles/LJP/logs/wrapper.log
    • {install_dir|/profiles/LJP/logs/relationals.log
  13. Proceed to Configuring the Application Server.