Upgrading your IBM Case Manager system using an external IBM Content Navigator

• Set the ECMTechnicalUserAlias as the user from the LDAP shared user repository that is used as the administrator for the object store, for example:

  ###########################################
     # ECM technical user authentication alias #
     ###########################################
     bpm.de.authenticationAlias.2.name=ECMTechnicalUserAlias
     bpm.de.authenticationAlias.2.user=admin
     bpm.de.authenticationAlias.2.password=admin
  

• Modify the network shared directory that is used by the external IBM Content Navigator, for example:

  # The network directory shared among multiple process servers in the deployment environment.
     bpm.de.caseManager.networkSharedDirectory=${WAS_INSTALL_ROOT}/CaseManagement/properties
  

  For setting up a network shared directory, see step 4 in Configuring IBM Business Automation Workflow with an external IBM Content Navigator.

• Configuring profiles and creating a network deployment environment on Linux
• Configuring profiles and creating a network deployment environment on Windows

custom_profile_install_root/bin/syncNode.bat dmgr_hostname dmgr_soap_port -user de_admin_user -password de_admin_password

1. Enable cross-origin resource sharing (CORS) settings for this custom extension package, which is installed and deployed in IBM Content Navigator. This is done by enabling and configuring the CORS filter servlet in IBM Content Navigator.
   1. Add the filter-mapping for custom extension plug-ins from IBM Content Navigator
      1. Modify the <IBM Content Navigator installation location>\configure\explodedformat\navigator\WEB-INF\web.xml to add

         <filter-mapping>
                 <filter-name>CORSFilter</filter-name>
                 <url-pattern>/plugin/*</url-pattern>
             </filter-mapping>

      2. Run IBM Content Navigator configuration tool to rebuild and redeploy the application.
   2. Create a new CORS.properties.
      1. Add the following text for CORS

         cors.origin.hostname=[bawserver]
         cors.origin.port=[bawserver port]
         cors.allow.methods=GET, OPTIONS, HEAD, PUT, POST
         cors.allow.credentials.boolean=true
         cors.options.status=202

         [bawserver] - the URL that client users access Workflow Center, Case Builder.

         [bawserver port] - the PORT that client users access Workflow Center, Case Builder.

   3. Add a com.ibm.ecm.icn.cors.file JVM parameter that points to the CORS.properties file that you created in (b)

      For example,

      -Dcom.ibm.ecm.icn.cors.file=/tmp/CORS.properties

2. In the Case configuration tool, run the Deploy & Register Extensions Package task to deploy the custom extension package plug-in to the IBM Content Navigator.
   1. Right-click the task and select Enable Task.
   2. Enter and check the properties.
   3. Run the task.

https://ICN_hostName:ICN_portNumber/navigator

1. Update the previous case resource path with the absolute path for the remote Case Client in the custom plug-in. JAR file. For example, use https://Workflow_hostName:CaseClient_portNumber/ICMClient/icm instead of /ICMClient/icm. Make this replacement in each place that refers to case resources.
2. Enable CORS settings for this custom widget, for example,
   1. Manually place the following CORS filter servlet in the web.xml file in the custom widget EAR file:

      <filter>
      	<description>Handling Cross Origin Resource Sharing</description>
      	<display-name>CORSFilter</display-name>
      	<filter-name>CORSFilter</filter-name>
      	<filter-class>com.ibm.casemgmt.cors.filter.CaseCORSFilter</filter-class>
            </filter>
          <filter-mapping>
      	<filter-name>CORSFilter</filter-name>
      	<url-pattern>/*</url-pattern>
          </filter-mapping>

   2. Put the casecors.jar file in the custom widgets application EAR lib folder. You can get the casecors.jar file from the following locations:
      On-premise

      Workflow_install_root/BPM/Case/lib/

      Container - In the workflow pod (for example - workflow-authoring-baw-server)

      /opt/ibm/wlp/usr/servers/defaultServer/case/lib/casecors.jar

3. In the Case configuration tool, run the Deploy & Register Custom Widgets Package task to deploy the Case custom widget plug-in to the IBM Content Navigator.
   1. Right-click the task and select Enable Task.
   2. Enter and check the properties.
   3. Run the task.