WMS 11672 - Update to the WCC RFP MGMT Application details and usage …

…of WCC Folios (#28) * update for the publish with ip address blurred * wcc_rfpmgmt added details for https rest configuration * wcc_rfpmgmt fix hostname url samples for https * wcc_rfpmgmt fix note messages * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * updated the screenshots * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * Update 04-setup-apex-application.md * update with folios * Update 03-initialize-environment.md * Update 01-prepare-setup.md * update to the addr * Update 04-setup-apex-application.md * update to rest catalog * Update 04-setup-apex-application.md * Update 03-initialize-environment.md
oracle-livelabs · Aug 21, 2024 · 8ef47b8 · 8ef47b8
1 parent 934ddf0
commit 8ef47b8
Show file tree

Hide file tree

Showing 30 changed files with 626 additions and 487 deletions.
diff --git a/webcenter-content/wcc-rfp-mgmt/01-prepare-setup/01-prepare-setup.md b/webcenter-content/wcc-rfp-mgmt/01-prepare-setup/01-prepare-setup.md
diff --git a/...enter-content/wcc-rfp-mgmt/02-wcc-environment-setup/02-wcc-environment-setup.md b/...enter-content/wcc-rfp-mgmt/02-wcc-environment-setup/02-wcc-environment-setup.md
@@ -92,7 +92,7 @@ To provision Oracle WebCenter Content on a Marketplace instance:
 
       - **Network Compartment**: Select the compartment you created earlier, as **wcc*
 
-      - **Existing WebCenter Content Virtual Cloud Network**: Select the VCN provisioned for WebCenter Content, as **wcc-rfpmgmt-demo**
+      - **Existing WebCenter Content Virtual Cloud Network**: Select the VCN provisioned for WebCenter Content, as **wcc\_rfpmgmt\_demo**
 
           ![Virtual Cloud Network](images/wcc_setup_task1_step3_3.png "Virtual Cloud Network")
 
@@ -189,6 +189,11 @@ To provision Oracle WebCenter Content on a Marketplace instance:
 
 6. Note the WebCenter Content CS **Endpoint URL** displayed at the end and the **hostname/ipaddress** .
 
+7. Note the Private IP for the WLS Node 1 ( *This will be used for setting up the APEX Application* ) - This will be referred later as **WLS\_NODE1\_IPADDR** eg: **10.15.xx.xxx**
+
+    - Navigate to **Compute** > **Instances** > Select the compartment **wcc** , in the instances list, note the Private IP Address for the instance name **WCCRFPMGMT-wls-1**
+  ![Private IP for the WLS Node 1](images/wcc_setup_task1_step3_12.png "Note the WLS_NODE1_IPADDR ")
+
 You may now **proceed to the next lab**.
 
 ### Learn More

diff --git a/...ntent/wcc-rfp-mgmt/02-wcc-environment-setup/images/wcc_setup_task1_step3_12.png b/...ntent/wcc-rfp-mgmt/02-wcc-environment-setup/images/wcc_setup_task1_step3_12.png
diff --git a/...ter-content/wcc-rfp-mgmt/03-initialize-environment/03-initialize-environment.md b/...ter-content/wcc-rfp-mgmt/03-initialize-environment/03-initialize-environment.md
@@ -30,7 +30,8 @@ This lab assumes you have:
             ```
             <copy>http://localhost:16200/cs/</copy>
             ```
-        > Note : Replace **localhost** with your **hostname**
+
+        > Note : Replace `"http://localhost"` with your **hosturl** ( eg: `"http://wcc-rfpmgmt-livelab.livelabs.oraclevcn.com"` or `"https://192.0.0.0"`)
     - Username
             ```
             <copy>weblogic</copy>
@@ -58,7 +59,8 @@ This lab assumes you have:
             ```
             <copy>http://localhost:16200/cs/</copy>
             ```
-       > **Note** : Replace **localhost** with your **hostname**
+
+           > Note : Replace `"http://localhost"` with your **hosturl** ( eg: `"http://wcc-rfpmgmt-livelab.livelabs.oraclevcn.com"` or `"https://192.0.0.0"`)
     - **Username**
             ```
             <copy>weblogic</copy>
@@ -78,14 +80,31 @@ This lab assumes you have:
 
  ![This image shows the WCC Instance Configuration Page - Database Metadata](./images/task2_webcenter_configuration_page_db_metadata.png "WCC Instance Configuration Page - Database Metadata")
 
-## Task 3: Import WebCenter Content Configuration bundle
+## Task 3: Enable Content Folios Component & Add Additional Instance Configurations
+
+To enable Content Folios Component & Add additional instance configurations, follow the below steps;
+
+1. Login to WebCenter Content server, Under **Administration** tab, navigate to **Admin Server** > **Component Manager**. In the **Components** section list , click on **Document Management**, Select/Check **ContentFolios** Component and click **Update** button
+    ![This image shows the WCC Instance Component Manger Page](./images/task3_webcenter_configuration_page_jsec_1.png "WCC Component Manger Page")
+
+2. Login to WebCenter Content server, Under **Administration** tab, navigate to **Admin Server** > **General Configuration**. In the **Additional Configuration Variables** section list of variables, add the below line and click **Save** button
+            ```
+            <copy>AllowModifyProfileDocMetaField=true
+DisableAuthorizationTokenCheck=1</copy>
+            ```
+    ![This image shows the WCC Instance General Configuration Page](./images/task3_webcenter_configuration_page_jsec_2.png "WCC Instance General  Configuration Page")
+
+3. Restart the Content Server instance , using the steps mentioned in **Appendix 1: Restart UCM Server Instance**
+
+## Task 4: Import WebCenter Content Configuration bundle
 
 1. On the new *web browser* window , Login to the *WebCenter Content* homepage URL as Administator User (eg: weblogic). Details are provided below:
     - **URL**
             ```
             <copy>http://localhost:16200/cs/</copy>
             ```
-       > Note : Replace **localhost** with your **hostname**
+
+          > Note : Replace `"http://localhost"` with your **hosturl** ( eg: `"http://wcc-rfpmgmt-livelab.livelabs.oraclevcn.com"` or `"https://192.0.0.0"`)
     - **Username**
             ```
             <copy>weblogic</copy>
@@ -132,7 +151,7 @@ This lab assumes you have:
 
     ![This image shows the WCC Instance homepage with Alert Message for Index collection rebuild](./images/appendix3_webcenter_rebuild_index_message.png "WCC Instance  Homepage with Alert Message for Index collection rebuild")
 
-## Task 4: Add RFP Profile Values in WCC
+## Task 5: Add RFP Profile Values in WCC
 
 This task helps in adding RFP related ProfileTriggerValues to xIdcProfile
 
@@ -141,7 +160,8 @@ This task helps in adding RFP related ProfileTriggerValues to xIdcProfile
             ```
             <copy>http://localhost:16200/cs/</copy>
             ```
-       > Note : Replace **localhost** with your **hostname**
+
+           > Note : Replace `"http://localhost"` with your **hosturl** ( eg: `"http://wcc-rfpmgmt-livelab.livelabs.oraclevcn.com"` or `"https://192.0.0.0"`)
     - **Username**
             ```
             <copy>weblogic</copy>
@@ -202,7 +222,7 @@ This task helps in adding RFP related ProfileTriggerValues to xIdcProfile
 
     ![This image shows the WCC Configuration Manager Java Applet](./images/webcenter_config_task4_step5.png "WCC Configuration Manager Java Applet Window")
 
-## Task 5: Enable WCC Workflows
+## Task 6: Enable WCC Workflows
 
 This task helps in enabling WCC Workflows for Section Documents
 
@@ -212,7 +232,8 @@ This task helps in enabling WCC Workflows for Section Documents
             ```
             <copy>http://localhost:16200/cs/</copy>
             ```
-       > Note : Replace **localhost** with your **hostname**
+
+           > Note : Replace `"http://localhost"` with your **hosturl** ( eg: `"http://wcc-rfpmgmt-livelab.livelabs.oraclevcn.com"` or `"https://192.0.0.0"`)
     - **Username**
             ```
             <copy>weblogic</copy>
@@ -234,7 +255,7 @@ This task helps in enabling WCC Workflows for Section Documents
 
     ![This image shows the WCC Workflow Admin Java Applet](./images/webcenter_config_task5_step3.png "WCC Workflow Admin Java Applet Window")
 
-## Task 6: Validate APEX is Up and Running
+## Task 7: Validate APEX is Up and Running
 
 This task helps to validate if APEX has been installed properly and its up & accessible.
 
@@ -244,7 +265,8 @@ This task helps to validate if APEX has been installed properly and its up & acc
             ```
             <copy>http://localhost:16200/ords/</copy>
             ```
-        > Note : Replace **localhost** with your **hostname**
+
+           > Note : Replace `"http://localhost"` with your **hosturl** ( eg: `"http://wcc-rfpmgmt-livelab.livelabs.oraclevcn.com"` or `"https://192.0.0.0"`)
     - **Workspace Name**
             ```
             <copy>INTERNAL</copy>
@@ -268,6 +290,36 @@ This task helps to validate if APEX has been installed properly and its up & acc
 
     If successful, the page above is displayed and as a result, your WCC instance is now ready.
 
+## Task 8 : Grant connect for ACL
+
+Login to the Database as **sys** or user with **sysdba** privileges and perform the below steps:
+      - Use the steps mentioned under **Appendix 4: Connect to DB System via SSH and login to database as sys** to connect to DB
+
+1. Find the latest version schema name
+            ```
+            SQL> SELECT  schema  FROM dba_registry WHERE comp_id = 'APEX' ORDER BY schema DESC FETCH FIRST 1 ROW ONLY;
+            ```
+
+2. Add the ACL entry for granting connect & resolve privilege for the required WCC CS urls
+
+            ```
+            <copy>
+            BEGIN
+            DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
+                  host => '*',
+                  ace => xs$ace_type(privilege_list => xs$name_list('connect', 'resolve'),
+                        principal_name => 'APEX_230200',
+                        principal_type => xs_acl.ptype_db
+                  )
+            );
+            END;
+            /
+            </copy>
+            ```
+
+      > Note : Replace `"APEX_230200"` with your **schema** retrieved from the above select query
+
+
 You may now **proceed to the next lab**.
 
 ## Appendix 1: Restart UCM Server Instance
@@ -326,9 +378,43 @@ To set up and use full-text searching and indexing with OracleTextSearch, follow
 
     ![This image shows Collection Rebuild Finished in Indexer tab of Repository Manager Java Applet](./images/appendix2_reindex_screenshot5_3.png "Collection Rebuild Completed in Indexer Tab of Repository Manager Applet")
 
-## Appendix 4: Reset ADMIN password for APEX/ORDS
+## Appendix 4: Connect to DB System via SSH and login to database as sys**
+
+   1. Log in to **OCI Console**, navigate to **Oracle Database**, then to **Oracle Base Database Service** and Click on the DB System **wcc-rfpmgmt-DBSystem** ( *which was created as part of the Lab **Prepare Setup*** )
+      ![Oracle DB System](/weblogic/webcenter-content/wcc-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_1_upt.png "View Oracle DB System details")
+
+   2. Scroll down to the **Resources** Section and click on **Nodes**. Note the *IP Address* of all the Nodes listed
+      ![Oracle DB System Nodes and IP Info](/weblogic/webcenter-content/wcc-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_2_upt.png "View Oracle DB System Node IP details")
+            > *Note: You can use the Private IP Address also, in which case, connect to the private IP Address from/through Bastion Server*
+
+   3. Open a terminal or a bash window , and invoke the below ssh command to login to the Node as **opc** user and then switch to **oracle** user
+      - **ssh command**
+            ```
+            <copy>ssh -i db-ssh.key [email protected]
+            sudo su - oracle </copy>
+            ```
+
+      - **Note** :
+        - **db-ssh.key** - is the key used/created while creating the DB System ( in Lab **Prepare Setup** , **Task 3: Create Database**, **3.2 Create a New DB System**). *FYI, Also, if **vault** was used for storing keys and secrets, this key can be obtained from there as well*
+        - **xxx.xxx.xxx.xxx** - replace this value with the ip address of the node
+
+      ![SSH to Node](/weblogic/webcenter-content/wcc-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_3_upt.png "SSH to Node")
+
+   4. In the terminal window, invoke the below commands command and connect to the required PDB
+      - invoke **sqlplus** command
+            ```
+            <copy>sqlplus '/as sysdba'</copy>
+            ```
+      - execute **sql** statement to connect to required PDB
+            ```
+            <copy>alter session set container=PDB1;</copy>
+            ```
+   5. Now execute any required sql statements in this sqlplus session.
+
+## Appendix 5: Reset ADMIN password for APEX/ORDS
 
-Use the below steps to reset the ADMIN User Password , if facing any issue like Forgot ADMIN password (or) ADMIN account is locked_
+Use the below steps to reset the ADMIN User Password , if facing any issue like Forgot ADMIN password (or) ADMIN account is locked
+      - Use the steps mentioned under **Appendix 4: Connect to DB System via SSH and login to database as sys** above, to connect to DB
 
 1. Find the latest version schema name:
             ```

diff --git a/...-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_1_upt.png b/...-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_1_upt.png
diff --git a/...-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_2_upt.png b/...-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_2_upt.png
diff --git a/...-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_3_upt.png b/...-rfp-mgmt/03-initialize-environment/images/apex_https_setup_ap1_step2_3_upt.png
diff --git a/.../03-initialize-environment/images/task3_webcenter_configuration_page_jsec_1.png b/.../03-initialize-environment/images/task3_webcenter_configuration_page_jsec_1.png
diff --git a/.../03-initialize-environment/images/task3_webcenter_configuration_page_jsec_2.png b/.../03-initialize-environment/images/task3_webcenter_configuration_page_jsec_2.png