...

Upgrade to Lequinox platform 5.2.0

Steps

1. Copy and extract the release package to the target machine.

2. Update the deployment profile that you backed up during your previous install:

   1. Locate the deployment profile backup from your previous installation.

   2. Copy the contents of your backed up deployment/profiles directory to the newly extracted deployment/profiles/ directory on the target machine for your 5.2.0 install.

...

1. 1. For your version upgrade

...

1. 1. , apply any deployment profile changes

...

1. 1.  to the files you just copied from your backup to the deployment/profiles directory.

      Note
      If you did not back up your deployment profile when you did your previous installation, or if you cannot locate it, you need to go through all the .properties files in your deployment profile directory and set all the UNCONFIGURED values. You also need to change any other default settings where you prefer a different setup or if your environment requires additional adjustments.

2. Go to the extracted release folder.

3. Stop any running WildFly instance:

   Code Block
   language xml
   > python deployment/stop_jboss.py -p <profile>

...

If you are upgrading from version 4.1.0 or earlier, you need to manually remove datasource from standalone.xml in WildFly. The following content shall be removed: Verify with team that this entire step can be removed in 5.2.0, since no one is upgrading from 4.1.0 or earlier.

...

...

2. Remove any previous deployed artifacts, .war- and .ear files, from the WildFly deployment directory <WILDFLY_HOME>/standalone/deployments/.

3. Generate a new configuration file (config.properties):

   Code Block
   language xml
   > python deployment/generate_configuration.py -p <profile> -d lequinox -f </path/to/config_directory>/config.properties

4. Run the pre-deploy upgrade script:

   Code Block
   language xml
   > python deployment/upgrade_pre_deploy_config_all.py -p <profile> -d lequinox

5. Start the WildFly server and wait until all services are started. (If changed since last upgrade: point out your configuration file "-Dconfig.path=<path/to/config_directory>"): 

   Code Block
   language xml
   > python deployment/start_jboss.py -p <profile>

6. Configure WildFly (the script adds datasources, enables HTTPS etc.):

   Code Block
   language xml
   > python deployment/jboss_config_all.py -p <profile> -d lequinox

   See jboss_config_all.py for limitations.

7. Deploy new artifacts from current release directory:

   Code Block
   language xml
   > python deployment/deploy_all.py -p <profile> -d lequinox -a .

8. Run post deploy upgrade script:

   Code Block
   language xml
   > python deployment/upgrade_post_deploy_config_all.py -p <profile> -d lequinox

9. Check the status of running services on "https://<FQDN>:<PORT>/status".

10. The upgrade of the Lequinox platform is complete.

11. Revisit the recommendations regarding backup and security, there might be new information since your first installation.