Making updates with ReleaseBuilder | HCL Digital Experience
You can use ReleaseBuilder to compare the XML configuration files that describe your staging server (REV1) and your updated staging server (REV2). You can also use it to create an XML configuration file that contains the differences between the two servers. You can then use this output file to import only the differences from your staging server (REV2) onto the production server. Features that are unchanged from (REV1) on the staging server (REV2) are not affected by the import.
Before you begin
Ensure that your development, test, and production environments are configured to allow all of the required artifacts and the configuration to be moved.
ReleaseBuilder is preferably run on an integration or staging server. Running ReleaseBuilder on the production server is not advised because ReleaseBuilder uses resources and affects portal services to users.
ReleaseBuilder uses XML configuration files to create an XML configuration file of the differences between the two servers. This XML configuration file is used to transfer the new portal configuration from your staging server to your production server. To export the configurations of the servers, use the XML configuration interface.
About this task
The XML files from your staging server (REV1) and from your updated staging server (REV2) refer to two exports that are taken from the SAME portal server. Building a release means to generate an XML file that contains the same modifications that are made to the staging server between REV1 and REV2. ReleaseBuilder is not designed to determine the differences between or changes that are made to two separate Portal servers.
Procedure
- Complete the following steps to export the staging server
configuration REV1:Remember: Export the entire portal configuration REV1 of the staging server; do not include users, users' access control, or any other user configurations.
- Develop and test new functions and portlets on the staging server. This phase is where you add or delete functions. This phase can last for a long time. Ensure that the staging server is fully tested and the portal is ready.
- Complete the following steps to export the staging server
configuration REV2:Remember: Export the entire portal configuration REV2 of the staging server; do not include users, users' access control, or any other user configurations.
- If you installed extra portlets or applications, copy the
necessary WAR files from the staging server to the wp_profile_root/PortalServer/deployed/archive installation
directory on the production server.Note: The deployed/archive directory is always in the original wp_profile_root installation path, even if the production server is using an extra profile that is created after installation.Note: As Windows™ limits the maximum path length to 260 characters, the name of the WAR file must be 25 characters or less. Installing a WAR file with a name that is more than 25 characters results in an error.
- Complete the following steps to generate the differences
between staging server configurations REV1 and REV2: Note: Complete these steps on the staging server and not on the production server. Computing a release difference produces a high load on the system and uses much memory for large releases. Therefore, do not complete them on the production system.
-
Use the
outputfile.xml
, which contains the differences between REV1 and REV2 portal server to import these differences onto the production server.Table 2. Task to import differences onto the production server Operating system Command AIX® HP-UX Linux™ Solaris ./xmlaccess.sh -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config" z/OS®: xmlaccess.sh -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config" Windows™: xmlaccess.bat -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config" IBM® i: xmlaccess.sh -in outputfile.xml -user wpsadmin_user_ID -password wpsadmin_pwd -url "http://productionserver.example.com:port/wps/config" Notes:- If portlet parameters are deleted from a configuration, the output script that is generated by ReleaseBuilder does not remove those parameters on the target system.
- XML files that are generated by ReleaseBuilder do not have any transaction levels set. To set a transaction level, edit the XML file that is generated by ReleaseBuilder and add the transaction level to the XML file.