March Release (#199)

HCL-TECH-SOFTWARE · Mar 14, 2022 · 64b6dd9 · 64b6dd9
1 parent e895cf5
commit 64b6dd9
Show file tree

Hide file tree

Showing 28 changed files with 134 additions and 289 deletions.
diff --git a/README.md b/README.md
@@ -6,7 +6,7 @@ Before you start, please be sure to check out [Frequently Asked Questions](https
 
 For HCL Connections 7 dependencies this means that:
 
-* Database will be installed (IBM DB2, Oracle or Microsoft SQL Server), configured as per Performance tunning guide for HCL Connections, and license applied. Please note: the license, the same one from FlexNet, will be applied only to IBM DB2 v11.1. If you want to learn more about using HCL Connections with different database backends, please [check out this document](https://github.com/HCL-TECH-SOFTWARE/connections-automation/blob/main/documentation/howtos/setup_connections_with_different_database_backends.md).
+* Database will be installed (IBM DB2, Oracle or Microsoft SQL Server), configured as per Performance tunning guide for HCL Connections, and license applied. Please note: the license, the same one from FlexNet, will be applied only to IBM DB2 v11.5. If you want to learn more about using HCL Connections with different database backends, please [check out this document](https://github.com/HCL-TECH-SOFTWARE/connections-automation/blob/main/documentation/howtos/setup_connections_with_different_database_backends.md).
 * HCL Connections Wizard will populate the database with needed schemas and grants.
 * If needed for demo or even production purposes, OpenLDAP will be spun up and seeded with some demo users. OpenLDAP will be spun up with SSL enabled, as needed later for setting up IBM WebSphere Application Server properly.
 * IBM TDI will be installed, configured, and run to populate profiles database in IBM DB2 with users from OpenLDAP
@@ -85,9 +85,9 @@ DB2:
 total 2067052
 drwxr-xr-x.  2 dmenges orion           96 Nov 19 11:01 .
 drwxr-xr-x. 13 root    orion          192 Nov 18 08:33 ..
--rw-r--r--.  1 dmenges dmenges    3993254 Oct 16 13:13 CNB23ML.zip
--rw-r--r--.  1 dmenges orion    250880000 Jun  3 10:48 v11.1.4fp5_jdbc_sqlj.tar.gz
--rw-r--r--.  1 dmenges orion   1861783964 Apr 23  2020 v11.1.4fp5_linuxx64_universal_fixpack.tar.gz
+-rw-r--r--.  1 dmenges dmenges    3993254 Oct 16 13:13 DB2_ESE_AUSI_Activation_11.5.zip
+-rw-r--r--.  1 dmenges orion    250880000 Jun  3 10:48 v11.5.6_jdbc_sqlj.tar.gz
+-rw-r--r--.  1 dmenges orion   1861783964 Apr 23  2020 v11.5.6_linuxx64_universal_fixpack.tar.gz
 
 Docs:
 total 1397484
@@ -433,7 +433,7 @@ ansible-playbook -i environments/examples/cnx7/db2/inventory.ini playbooks/hcl/s
 
 ### Running post installation tasks
 
-If you don't plan on installing the Component Pack and `cnx_application_ingress` is set to a host that can access the Connections server frontend (eg. IHS) via a browser now, run this playbook to set up some post installation bits and pieces to make the Connections deployment accessible.  Otherwise, continue to the Component Pack deployment before testing the deployment.
+If you don't plan on installing the Component Pack and `cnx_application_ingress` is set to a host that can access the Connections server frontend (eg. IHS) via a browser now, run this playbook to set up some post installation bits and pieces to make the Connections deployment accessible.  Otherwise, continue to the Component Pack deployment before testing the deployment. 
 
 ```
 ansible-playbook -i environments/examples/cnx7/db2/inventory.ini playbooks/hcl/connections-post-install.yml

diff --git a/documentation/VARIABLES.md b/documentation/VARIABLES.md
@@ -215,6 +215,9 @@ cnx_enable_moderation | false | true will install and configure Moderation
 global_moderator | *none* - optional | Global moderator user
 cnx_enable_full_icec | false | true will configure full CEC
 cnx_enable_lang_selector | false | true will enable and add additional languages to the language selector
+enable_homepage_switcher | true | set `com.ibm.orient.isHomepageSwitcherEnabled` in LotusConnections-config.xml
+enable_orientme_default_hp | true | true will set `com.ibm.orient.isOrientHomepage` in LotusConnections-config.xml
+enable_action_center | enabled | set `actioncenter` in LotusConnections-config.xml
 mail_outgoing_server | *none* - optional | Mail notification outgoing server.  When set, it will also set the SMTP port according to `{{ mail_smtp_port }}`
 mail_smtp_port | 25 | Mail SMTP port, set when `{{ mail_outgoing_server }}` is defined
 cnx_updates_enabled | false | true will upgrade Connections if a new version is available in cnx_repository_url

diff --git a/documentation/howtos/setup_connections_with_different_database_backends.md b/documentation/howtos/setup_connections_with_different_database_backends.md
@@ -1,6 +1,6 @@
 # Using different database backends with HCL Connections' automation
 
-Automated and tested database backends by HCL are IBM DB2 11.1, Oracle 19c and Microsoft SQL Server 2019. Please note that automated and tested only implies that it is covered by this automation, and does not mean it is (not) officially supported by HCL.
+Automated and tested database backends by HCL are IBM DB2 11.5.6, Oracle 19c and Microsoft SQL Server 2019. Please note that automated and tested only implies that it is covered by this automation, and does not mean it is (not) officially supported by HCL.
 
 ## What did we change?
 
@@ -19,9 +19,9 @@ By default, they are set to false, which means that if you don specifically say
 
 This applies only for HCL Connections.
 
-## Defaults and IBM DB2 11.1
+## Defaults and IBM DB2 11.5.6
 
-First supported database with this automation was IBM DB2 v11.1.
+First supported database with this automation was IBM DB2 v11.5.6
 
 To install Connections by using DB2 as a backend, all you need is this:
 
@@ -44,9 +44,28 @@ db_username=LCUSER
 db_password=password
 db_hostname=db1.internal.example.com
 db_port=50000
-db_jdbc_file=/opt/IBM/db2/V11.1/java
 db_type=DB2
 ```
+To install Connections by using DB2 v11.1 as a backend, addition to the above set of parameters you need to set(by default it is set to false):
+
+```
+install_latest_db2=false
+```
+
+To terminate the script when already installed version of DB2 (if any) on the system is different than the version that user expects you need to set(by default it is set to false).
+```
+force_check_db2_version_mismatch=True
+```
+If force_check_db2_version_mismatch is set to true:
+- If already installed version on the system is different than the version that user expects - Script fails.
+- If already installed version on the system is same as user's expectation - No change, existing flow.
+- No existing DB2 installed - Install DB2 with the version derived from var install_latest_db2.
+
+If force_check_db2_version_mismatch is set to false:
+- If already installed version on the system is different than the version that user expects - Script continues with the existing installed DB2 version. Also it overwrites variable's defaults which are needed for DB2 installation.
+- If already installed version on the system is same as user's expectation - No change, existing flow.
+- No existing DB2 installed - Install DB2 with the version derived from var install_latest_db2.
+
 
 HCL Connections installer will use this set of parameters when setting up HCL Connections installation:
 

diff --git a/playbooks/third_party/kubernetes/setup-kubernetes.yml b/playbooks/third_party/kubernetes/setup-kubernetes.yml
@@ -3,55 +3,64 @@
 - name:                    Install Kubernetes
   hosts:                   k8s_masters, k8s_workers
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/kubernetes-install
 
 - name:                    Setup and initialize Kubernetes master node
   hosts:                   k8s_masters
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/setup-master-node
 
 - name:                    Setup kubectl on masters and workers
   hosts:                   k8s_masters, k8s_workers
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/setup-kubectl
 
 - name:                    Enable PodSecurity Policy
   hosts:                   k8s_masters
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/enable-pod-security-policy
 
 - name:                    Install Kubernetes addons...
   hosts:                   k8s_masters
   serial:                  1
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/install-network-addons
 
 - name:                    Join other masters to the cluster
   hosts:                   k8s_masters
   serial:                  1
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/join-master-nodes
 
 - name:                    Setup Kubernetes worker nodes
   hosts:                   k8s_workers
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/setup-worker-node
 
 - name:                    Allow pods to run on master in case of single node installation
   hosts:                   k8s_masters, k8s_workers
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/kubernetes/taint-all-nodes
 
 - name:                    Setup Helm
   hosts:                   k8s_admin
   become:                  true
+  any_errors_fatal:        true
   roles:
     - roles/third_party/helm-install
diff --git a/playbooks/third_party/setup-database.yml b/playbooks/third_party/setup-database.yml
@@ -1,8 +1,11 @@
 - name:                  Setup DB2
   import_playbook:       setup-db2.yml
+  when:                  "'db2_servers' in groups"
 
 - name:                  Setup Oracle
   import_playbook:       setup-oracle.yml
+  when:                  "'oracle_servers' in groups"
 
 - name:                  Setup MSSQL
   import_playbook:       setup-mssql.yml
+  when:                  "'mssql_servers' in groups"  
diff --git a/roles/hcl/component-pack/post-install-config/tasks/setup_orientme.yml b/roles/hcl/component-pack/post-install-config/tasks/setup_orientme.yml
@@ -8,12 +8,12 @@
   when:                                     cnx_setup_mt is not defined or not cnx_setup_mt|bool
   # internal use only, do not set cnx_setup_mt to true.  This is set via auto-deploy when MT.
 
-- name:                                     Enable action center in LCC.xml
+- name:                                     "Update actioncenter in LCC.xml to {{ __enable_action_center | lower }}" 
   xml:
     path:                                   "{{ __lcc_full_path }}"
     namespaces:                             "{{ __lcc_namespaces }}"
     xpath:                                  "{{ __lcc_action_center_xpath }}"
-    value:                                  "enabled"
+    value:                                  "{{ __enable_action_center | lower }}"
 
 # Query element text using XPath
 - name:                                     Get current value of isHomepageSwitcherEnabled

diff --git a/roles/hcl/component-pack/post-install-config/vars/main.yml b/roles/hcl/component-pack/post-install-config/vars/main.yml
@@ -41,6 +41,7 @@ __lcc_genprop_default_hpswitch_xpath:  "/tns:config/tns:properties/tns:genericPr
 
 __enable_homepage_switcher:            "{{ enable_homepage_switcher | default('true') }}"
 __enable_orientme_default_hp:          "{{ enable_orientme_default_hp | default('true') }}"
+__enable_action_center:                "{{ enable_action_center | default('enabled') }}"
 
 # appreg
 __lcc_version_xpath: "/tns:config/tns:properties"

diff --git a/roles/hcl/component-pack/templates/helmvars/kudosboards.yml.j2 b/roles/hcl/component-pack/templates/helmvars/kudosboards.yml.j2
@@ -29,12 +29,14 @@ webfront:
   ingress:
     annotations:
       nginx.ingress.kubernetes.io/rewrite-target: /$1
+      kubernetes.io/ingress.class: nginx
     path: /boards/(.*)
     # This hostname must match other Ingresses defined in your CP environment
     # If all ingresses start with * you must match the pattern, or all traffic will be routed to Boards and everything will break
     # kubectl get ingresses --all-namespaces
     hosts:
 {% if  __ingress_multi_domain_enabled == "true"  %}
+    - "*.{{ load_balancer_dns.split('.', 1)[1] }}"
 {% if  load_balancer_dns != frontend_fqdn %}
     - "*.{{ frontend_fqdn.split('.', 1)[1] }}"
 {% endif %}
@@ -45,13 +47,6 @@ webfront:
 core:
   image:
     name: kudosboards-core
-  env:
-    NOTIFIER_EMAIL_HOST: smtp.example.com
-    NOTIFIER_EMAIL_USERNAME: user123
-    NOTIFIER_EMAIL_PASSWORD: passw0rd
-    # APP_NAME: Kudos Boards # Used for all notifications, e.g. Orient Me
-    # NOTIFIER_EMAIL_FROM_NAME: Kudos Boards
-    # NOTIFIER_EMAIL_FROM_EMAIL: [email protected]
   ingress:
     annotations:
       nginx.ingress.kubernetes.io/rewrite-target: /$1
@@ -90,13 +85,23 @@ user:
     # CONNECTIONS_NAME: HCL Connections
     CONNECTIONS_CLIENT_ID: kudosboards
     CONNECTIONS_URL: https://{{ frontend_fqdn }}
-    CONNECTIONS_CLIENT_SECRET: {{ kudosboards_secret.stdout_lines | last }} 
+    CONNECTIONS_CLIENT_SECRET: {{ kudosboards_secret.stdout_lines | last }}
     CONNECTIONS_ADMINS: "[\"[email protected]\", \"[email protected]\", \"PROF_GUID_3\"]"
 
 provider:
   image:
     name: kudosboards-provider
 
+events:
+  image:
+    name: kudosboards-boards-event
+  env:
+    NOTIFIER_EMAIL_HOST: smtp.example.com
+    NOTIFIER_EMAIL_USERNAME: user123
+    NOTIFIER_EMAIL_PASSWORD: passw0rd
+    # NOTIFIER_EMAIL_FROM_NAME: Kudos Boards
+    # NOTIFIER_EMAIL_FROM_EMAIL: [email protected]
+
 migration:
   image:
     name: kudosboards-activity-migration

diff --git a/roles/hcl/connections-wizards/tasks/main.yml b/roles/hcl/connections-wizards/tasks/main.yml
@@ -1,7 +1,10 @@
 ---
-- name:                       Pre-check DB2 version 
+- name:                       Pre-check DB2 version
   include_tasks:              precheck_DB2_version.yml
-
+  when:
+    - __setup_connections_wizards |bool
+    - "'db2_servers' in groups"
+
 - name:                       Setup Connections Wizards on DB2
   include_tasks:              setup_connections_wizards.yml
   when:

diff --git a/roles/hcl/connections/mt/tasks/main.yml b/roles/hcl/connections/mt/tasks/main.yml
@@ -9,6 +9,8 @@
 
 - name:                    Pre-check DB2 version
   include_tasks:           precheck_DB2_version.yml
+  when:
+    - "'db2_servers' in groups"  
 
 - name:                    Define Vars
   include_tasks:           define_vars.yml

diff --git a/roles/hcl/connections/post_install_config/tasks/setup_invite_config.yml b/roles/hcl/connections/post_install_config/tasks/setup_invite_config.yml
@@ -28,7 +28,7 @@
   xml:
     path:                                   "{{ __selfreg_full_path }}"
     xpath:                                  "{{ __selfreg_invite_usertype_xpath }}"
-    value:                                  "{{ invite_user_type | default('internal') }}"
+    value:                                  "{{ invite_user_type | default('external') }}"
   when:
     - __cnx_major_version is version('7', '>=')
 

diff --git a/roles/hcl/connections/tasks/main.yml b/roles/hcl/connections/tasks/main.yml
@@ -11,6 +11,8 @@
 
 - name:          Pre-check DB2 version
   include_tasks: precheck_DB2_version.yml
+  when:
+    - "'db2_servers' in groups"    
 
 - name:          Define Vars
   include_tasks: define_vars.yml

diff --git a/roles/hcl/docs/tasks/main.yml b/roles/hcl/docs/tasks/main.yml
@@ -7,6 +7,8 @@
 
 - name:                    Pre-check DB2 version
   include_tasks:           precheck_DB2_version.yml
+  when:
+    - "'db2_servers' in groups"  
 
 - name:                    Download Docs installer to Docs env
   include_tasks:           download_docs.yml