Updating the context-root of the XDIME Theme web application

You have the option of deploying your own XDIME theme instead of modifying the MPATheme.ear. If you choose this option, you will need to update the mcs-config.xml with the context-root of the your newly-deployed web application.

1. Copy the mcs-config.xml file from the wp_profile_root/installedApps/node_name/mcs.ear/mcs.war/WEB-INF directory to the wp_profile_root/PortalServer/wp.mobile/wp.mobile.mcs directory.
2. Edit wp_profile_root/PortalServer/wp.mobile/wp.mobile.mcs/mcs-config.xml. Replace all instances of the following:

   • base-url="current_context_root"

     with:

     base-url="new_context_root"

   • page-base="current_context_root"

     with:

     page-base="new_context_root"

   where current_context_root is the current context root (typically, mpa) and new_context_root is the new context root value.
3. Run the following Multi-Channel Server configuration update process, which deploys an updated file into the Multi-Channel Server EAR (mcs.ear).
   1. Make sure that the WebSphere_Portal application server is running.
   2. Run the following command to ensure that the WebSphere® environment is set up correctly:
      

      . wp_profile_root/bin/setupCmdLine.sh

      Attention: There is a space between the period (.) and the rest of the command.
      

      wp_profile_root\bin\setupCmdLine

   3. Change your working directory to wp_profile_root/ConfigEngine.
   4. Run the following command:
      

      ./ConfigEngine.sh init mcs-update-config

      

      ConfigEngine init mcs-update-config

      Note: For security reasons, if you do not want to store the WebSphere Portal admin password and WebSphere Application Server admin password in the wkplc.properties file, you can specify the passwords on the portal server command line. For example, when this topic directs you to enter the ConfigEngine script or batch file, you would add parameters to the command to specify the password values as shown here:
      
      

      ./ConfigEngine.sh init mcs-update-config
      -DPortalAdminPwd=WP_admin_password_value
      -DWasPassword=WAS_admin_password_value

      

      ConfigEngine init mcs-update-config
      -DPortalAdminPwd=WP_admin_password_value
      -DWasPassword=WAS_admin_password_value

      where
      • WP_admin_password_value is the value of the WebSphere Portal admin password
      • WAS_admin_password_value is the value of the WebSphere Application Server admin password if WebSphere Application Server security is enabled
   5. Restart the portal server using the following commands:
      

      wp_profile_root/bin/stopServer.sh server_name -username WAS_admin -password WAS_admin_password_value

      wp_profile_root/bin/startServer.sh server_name

      

      wp_profile_root\bin\stopServer server_name -username WAS_admin -password WAS_admin_password_value

      wp_profile_root\bin\startServer server_name

      where server_name is the name of the WebSphere Application Server instance (for example, WebSphere_Portal).