Release 20.0.1

Author: FrancoisTrible

AAE/README_config.md

@@ -1,4 +1,4 @@
-# Configuring IBM Business Automation Application Engine (App Engine) 19.0.3 
+# Configuring IBM Business Automation Application Engine (App Engine) 20.0.1 
 
 These instructions cover the basic installation and configuration of IBM Business Automation Application Engine (App Engine).
 
@@ -57,16 +57,16 @@ Follow the OpenShift instructions in [Planning Your Installation 3.11](https://d
 
 Besides the common steps to set up the operator environment, you must do the following steps before you install App Engine.
 
-* Create the App Engine database. See [Creating the database](https://www.ibm.com/support/knowledgecenter/SSYHZ8_19.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_db.html).
-* Create secrets to protect sensitive configuration data, See [Creating secrets to protect sensitive configuration data](https://www.ibm.com/support/knowledgecenter/SSYHZ8_19.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_data.html). 
+* Create the App Engine database. See [Creating the database](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_db.html).
+* Create the required secrets. See [Creating secrets to protect sensitive configuration data](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_data.html). 
 
 ## Step 2: Configuring Redis for App Engine (Optional)
 
-You can configure App Engine with Remote Dictionary Server (Redis) to provide more reliable service. See [Configuring App Engine with Redis](https://www.ibm.com/support/knowledgecenter/SSYHZ8_19.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_redis.html).
+You can configure App Engine with Remote Dictionary Server (Redis) to provide more reliable service. See [Configuring App Engine with Redis](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_redis.html).
 
 ## Step 3: Implementing storage (Optional)
 
-You can optionally add your own persistent volume (PV) and persistent volume claim (PVC) if you want to use your own JDBC driver or you want Resource Registry to be backed up automatically. The minimum supported size is 1 GB. For instructions, see [Optional: Implementing storage](https://www.ibm.com/support/knowledgecenter/SSYHZ8_19.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_storage.html).
+You can optionally add your own persistent volume (PV) and persistent volume claim (PVC) if you want to use your own JDBC driver or you want Resource Registry to be backed up automatically. The minimum supported size is 1 GB. For instructions, see [Optional: Implementing storage](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.install/op_topics/tsk_aeprep_storage.html).
 
 
 ## Step 4: Configuring the custom resource YAML file for your App Engine deployment
@@ -78,12 +78,14 @@ You can optionally add your own persistent volume (PV) and persistent volume cla
    a. Uncomment and update the `shared_configuration` section if you haven't done it already.
 
    b. Update the `application_engine_configuration` and `resource_registry_configuration` sections.
+     * Automatic backup for Resource Registry is recommended. See [Enabling Resource Registry disaster recovery](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.managing/topics/tsk_enabling_disaster_recovery.html) for configuration information.
+     
      * If you just want to install App Engine with the minimal required values, replace the contents of `application_engine_configuration` and `resource_registry_configuration` in your copy of the template custom resource YAML file with the values from the [sample_min_value.yaml](configuration/sample_min_value.yaml) file.
 
     * If you want to use the full configuration list and customize the values, update the required values in `application_engine_configuration` and `resource_registry_configuration` in your copy of the template custom resource YAML file based on your configuration.
 
 ### Configuration
-If you want to customize your custom resource YAML file, refer to the [configuration list](https://www.ibm.com/support/knowledgecenter/SSYHZ8_19.0.x/com.ibm.dba.ref/k8s_topics/ref_ae_params.html) for each parameter.
+If you want to customize your custom resource YAML file, refer to the [configuration list](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.ref/k8s_topics/ref_ae_params.html) for each parameter.
 
 ## Step 5: Completing the installation
 
@@ -101,7 +103,7 @@ Update pages:
 
 ## Limitations
 
-* After you deploy the App Engine, you can't change App Engine admin user in the admin secret. 
+* After you deploy the App Engine, you can't change App Engine admin user. 
 
 * Because of a Node.js server limitation, App Engine trusts only root CA. If an external service is used and signed with another root CA, you must add the root CA as trusted instead of the service certificate.
 

AAE/README_migrate.md

@@ -1,11 +1,11 @@
 
-# Migrating from IBM Business Automation Application Engine (App Engine) 19.0.2 to 19.0.3 
+# Migrating from IBM Business Automation Application Engine (App Engine) 19.0.2 to 20.0.1 
 
-These instructions cover the migration of IBM Business Automation Application Engine (App Engine) from 19.0.2 to 19.0.3.
+These instructions cover the migration of IBM Business Automation Application Engine (App Engine) from 19.0.2 to 20.0.1.
 
 ## Introduction
 
-If you install App Engine 19.0.2 and want to continue to use your 19.0.2 applications in App Engine 19.0.3, you can migrate your applications from App Engine 19.0.2 to 19.0.3.
+If you install App Engine 19.0.2 and want to continue to use your 19.0.2 applications in App Engine 20.0.1, you can migrate your applications from App Engine 19.0.2 to 20.0.1.
 
 ## Step 1: Export apps that were authored in 19.0.2
 
@@ -23,12 +23,12 @@ Log in to your OpenShift environment to stop all the development pods. You can s
 
 Reuse the existing App Engine database. Update the database configuration information under application_engine_configuration in the custom resource YAML file.
 
-## Step 5: Install App Engine 19.0.3
+## Step 5: Install App Engine 20.0.1
 
 [Install IBM Business Automation Application Engine](../AAE/README_config.md).
 
-## Step 6: Migrate IBM Business Automation Navigator from 19.0.2 to 19.0.3 to verify your apps
+## Step 6: Migrate IBM Business Automation Navigator from 19.0.2 to 20.0.1 to verify your apps
 
-Following the IBM Business Automation Navigator migration instructions(We should add a link to the Navigator migration instructions,once navigator migration link is ready), migrate Business Automation Navigator from 19.0.2 to 19.0.3. Then, test your apps.
+Following the IBM Business Automation Navigator migration instructions(We should add a link to the Navigator migration instructions,once navigator migration link is ready), migrate Business Automation Navigator from 19.0.2 to 20.0.1. Then, test your apps.
 
 

AAE/README_upgrade.md

@@ -0,0 +1,34 @@
+# Upgrading from IBM Business Automation Application Engine (App Engine) 19.0.3 to 20.0.1 
+
+These instructions cover the upgrade of IBM Business Automation Application Engine (App Engine) from 19.0.3 to 20.0.1.
+
+## Introduction
+
+If you installed App Engine 19.0.3 and want to continue to use your 19.0.3 applications in App Engine 20.0.1, you can upgrade your applications from App Engine 19.0.3 to 20.0.1.
+
+## Step 1: Update the custom resource YAML file for your App Engine 20.0.1 deployment
+
+Get the custom resource YAML file that you used to deploy App Engine for 19.0.3, and edit it by following these steps:
+
+1. Change the release version from 19.0.3 to 20.0.1.
+
+2. Add `appVersion: 20.0.1` to the `spec` section. See the [sample_min_value.yaml](configuration/sample_min_value.yaml) file.
+
+3. Update the `application_engine_configuration` and `resource_registry_configuration` sections.
+ * Automatic backup for Resource Registry is recommended. See [Enabling Resource Registry disaster recovery](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.managing/topics/tsk_enabling_disaster_recovery.html) for configuration information.
+
+ * If you just want to update App Engine with the minimal required values, use the values in the [sample_min_value.yaml](configuration/sample_min_value.yaml) file.
+    * Add `admin_user` to the `application_engine_configuration` sections.
+    * Change the image tags from 19.0.3 to 20.0.1 in all sections.
+
+ * If you want to use the full configuration list and customize the values, update the required values in the `application_engine_configuration` and `resource_registry_configuration` sections in your custom resource YAML file based on your configuration. See the [configuration list](https://www.ibm.com/support/knowledgecenter/SSYHZ8_20.0.x/com.ibm.dba.ref/k8s_topics/ref_ae_params.html) for each parameter.
+
+## Step 2: Update the configuration sections for other deployments
+
+To update the configuration sections for other components, such as User Management Service and IBM Business Automation Navigator, go back to the relevant upgrade page to follow their upgrade documents to update your custom resource YAML file.
+
+Upgrade pages:
+   - [Managed OpenShift upgrade page](../platform/roks/upgrade.md)
+   - [OpenShift upgrade page](../platform/ocp/upgrade.md)
+   - [Certified Kubernetes upgrade page](../platform/k8s/upgrade.md)
+   

AAE/configuration/sample_min_value.yaml

@@ -2,38 +2,40 @@
 # This is a YAML-formatted file.
 # Declare variables to be passed into your templates.
 spec:
-  ## production configuration
+  appVersion: 20.0.1
+  ## Production configuration
   ## App Engine configuration 
   application_engine_configuration:
-  ## The application_engine_configuration is a list, you can deploy multiple instances of AppEngine, you can assign different configurations for each instance.
-  ## For each instance, application_engine_configuration.name and application_engine_configuration.name.hostname must be assigned to different values.
+  ## The application_engine_configuration is a list. You can deploy multiple instances of App Engine and assign different configurations for each instance.
+  ## For each instance, application_engine_configuration.name and application_engine_configuration.name.hostname must have different values.
   - name: ae_instance1
     hostname: <your external app engine host name>
     port: 443
     admin_secret_name: ae-secret-credential
+    admin_user: <your default administrator ID>
     database:
       host: <your database host/IP>
       name: <your database name>
       port: <your database port>
-      ## If you setup DB2 HADR and want to use it, you need to configure alternative_host and alternative_port, or else, leave is as blank.
+      ## If you set up DB2 HADR and want to use it, you must configure alternative_host and alternative_port. Otherwise, leave them blank.
       alternative_host: 
       alternative_port: 
     images:
       db_job:
         repository: cp.icr.io/cp/cp4a/aae/solution-server-helmjob-db
-        tag: 19.0.3
+        tag: 20.0.1
       solution_server:
         repository: cp.icr.io/cp/cp4a/aae/solution-server
-        tag: 19.0.3
+        tag: 20.0.1
 
   ## Resource Registry Configuration
-  ## Important: if you've already configured Resource Registry before, you don't need to change resource_registry_configuration section in your copy of the template custom resource YAML file.
+  ## Important: If you've already configured Resource Registry, you don't need to change the resource_registry_configuration section in your copy of the template custom resource YAML file.
   resource_registry_configuration:
     admin_secret_name: resource-registry-admin-secret
     hostname: <your external resource registry host name>
     port: 443
     images:
       resource_registry:
         repository: cp.icr.io/cp/cp4a/aae/dba-etcd
-        tag: 19.0.3
+        tag: 20.0.1
 

ACA/README.md

@@ -0,0 +1,19 @@
+# Configuring IBM Business Automation Content Analyzer 20.0.1 
+
+These instructions cover the basic configuration of Business Automation Content Analyzer.
+
+
+
+### Step n Complete the installation
+
+Go back to the relevant install or update page to configure other components and complete the deployment with the operator.
+
+Install pages:
+   - [Managed OpenShift installation page](../platform/roks/install.md)
+   - [OpenShift installation page](../platform/ocp/install.md)
+   - [Certified Kubernetes installation page](../platform/k8s/install.md)
+
+Update pages:
+   - [Managed OpenShift installation page](../platform/roks/update.md)
+   - [OpenShift installation page](../platform/ocp/update.md)
+   - [Certified Kubernetes installation page](../platform/k8s/update.md)