Important upgrade preparations for users currently on 5.1.0

Verify administrator level ‘role administrator’ is not used

The console administration level ‘role administrator’ has been removed in version 5.2.0. Therefore, you must verify that none of you role accounts are assigned the console administration level Role administrator when you upgrade.

Steps

1. Sign in to the Lequinox console. 
2. Click Internal in the top navigation bar, and select Role accounts.
3. Verify that no role accounts are assigned the administration level Role administrator.
4. If any accounts are, assign them another console administration level that suits their role in the organisation.

Rename internal roles

In Lequinox console 5.2.0, you will find system roles implemented under new names on a separate tab under your organisation settings. In relation to this, you must make sure that you do not have any internal non-system roles called ‘Platform manager’ or ‘Organisation manager’ when you perform an upgrade. If you do, make sure to change their names to something else before you upgrade.

Steps

5. Go to the instructions to Edit an internal role.
6. Change any ‘Platform manager’ or ‘Organisation manager’ role names to something else.

Upgrade to Lequinox platform 5.2.0

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.

   3. Apply any changes for your version upgrade mentioned on the deployment profile changes page to the files you just copied from your backup to the deployment/profiles directory.

      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.
3. Go to the extracted release folder.

4. Stop any running WildFly instance:

   > python deployment/stop_jboss.py -p <profile>

5. 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.

   <datasource jndi-name="java:jboss/datasources/DtsEventsDatasource" pool-name="DtsEventsDatasource" use-java-context="true">
       <connection-url>jdbc:postgresql://127.0.0.1:5432/events?useUnicode=true&amp;characterEncoding=UTF-8</connection-url>
       <driver>postgresql-jdbc42</driver>
       <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
   	<pool>
          	<min-pool-size>2</min-pool-size>
           <max-pool-size>10</max-pool-size>
           <prefill>true</prefill>
   	</pool>
   	<security>
            <user-name>events_user</user-name>
            <password><password></password>
   	</security>
   </datasource>

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

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

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

8. Run the pre-deploy upgrade script:

   > python deployment/upgrade_pre_deploy_config_all.py -p <profile> -d lequinox

9. 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>"): 

   > python deployment/start_jboss.py -p <profile>

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

    > python deployment/jboss_config_all.py -p <profile> -d lequinox

    See jboss_config_all.py for limitations.
    
    

11. Deploy new artifacts from current release directory:

    > python deployment/deploy_all.py -p <profile> -d lequinox -a .

12. Run post deploy upgrade script:

    > python deployment/upgrade_post_deploy_config_all.py -p <profile> -d lequinox

13. Check the status of running services on "https://<FQDN>:<PORT>/status".
14. The upgrade of the Lequinox platform is complete.
15. Revisit the recommendations regarding backup and security, there might be new information since your first installation.