Release Notes - WildFly 10

27/04/2016 4:13 PM
- Release Notes - VM Applications

Overview - WildFly 10

This Release Note covers all point releases for WildFly 10 that are offered by eApps. Upgrade instructions are included.

WildFly is the continuation of the JBoss Application Server (JBoss AS) project. It is essentially JBoss AS 8, but the project was renamed by Red Hat in order to differentiate the open source JBoss AS project from the commercial Red Hat JBoss Middleware project.

WildFly 10 and above is only available for Virtual Servers running CentOS 6 or CentOS 7. If you are on a CentOS 5 (Webmin) or CentOS 4 (VPS) plan and need WildFly, you will need to migrate to a CentOS 6 or CentOS 7 plan. Contact eApps Sales for more information.

WildFly 10 and above requires Java SE 8. It will not run with Java SE 6 or Java SE 7.

Along with the name change, WildFly is a major update to the existing JBoss AS 7. This release has introduced new functionality and significant changes to the existing Application Server. If you are upgrading from any prior version of JBoss to WildFly, there is a HIGH RISK of data loss and downtime if you do not carefully test your existing application with this new version.

eApps recommends, as a best practice, to maintain a staging server where you can test software upgrades before moving them into production. This approach will allow you to minimize the risk of data loss and downtime of your production service when performing software upgrades. If necessary, you can rebuild your staging Virtual Server on demand so that you have a fresh installation to test on. If you need more information about setting up a Virtual Server for staging or testing, please contact eApps Sales.

IMPORTANT: WildFly 10 has an extensive list of new features and changes. See the Official WildFly 10 Release Notes for a list of changes that may cause issues when upgrading: WildFly 10 Release Notes. Please read this document carefully to understand all the changes in WildFly 10. Upgrading to this version may significantly impact the operation of your database and applications. All WildFly 10 documentation is located here: WildFly 10 Documentation

eApps Release Notes for WildFly 10.0.0

How to Upgrade
JBoss 6 or JBoss 7 to WildFly 10
WildFly 8 or WildFly 9 to WildFly 10

Highlighted Features and Fixes in WildFly 10.0.0

Features

Full support for Java SE 8 (no support for Java SE 7)
Offline CLI support for Domain Mode
Support for Java EE 7 Full and Web Profile Standards
Ability to restart and stop batch jobs

Fixes

jboss-common-core.jar removed
Management schema updated to version 4
Updates to Undertow mod_cluster CLI

The official Release Notes for WildFly 10.0.0 are available here - http://wildfly.org/release/10.0.0/

How to Upgrade

It is your responsibility to ensure that your application will work on the newer version of WildFly. There may be incompatibilities that will affect how your application works. Please make sure that you have read the official Release Notes and Changelog, and have done any necessary testing before upgrading a production application.

Before upgrading WildFly make a backup of your database. Follow the instructions for your database: MySQL, MariaDB, or PostgreSQL.

You should also make a backup of your application, your configuration, and any tunings or changes you have made. If you do not have current backups and something goes wrong during the upgrade process, you could have data loss.

The upgrade from JBoss (any version) or any previous version of WildFly to WildFly 10 has to be done manually, there is no way to automate the process. Please read the upgrade instructions for your scenario and proceed accordingly. Failure to follow the correct upgrade instructions can result in data loss and extended downtime for your applications and users.

JBoss 6 or JBoss 7 to WildFly 10

There is no direct upgrade path from JBoss (any version) to WildFly (any version). To upgrade from any version of JBoss to WildFly 10 you will need to make a backup of your existing application, database, configuration, and any customizations and tunings, and then uninstall JBoss and install WildFly 10. Once WildFly 10 is installed, you will need to redeploy your application and all configurations and databases.

It is highly recommended that you provision a test Virtual Server, install WildFly 10 and your database server, and then copy your existing application, configurations, and database to the test VS. This will allow you to fully test that your existing application will work with WildFly 10 before moving it into production. Once you have completed your testing you can then upgrade your production Virtual Server, and then cancel the test VS. Instructions on how to install WildFly 10 are available here - WildFly Installation

To upgrade from JBoss to WildFly, you will need to do the following:

Uninstall JBoss from the ISPmanager Control Panel
Install a supported version of Java SE from the ISPmanager Control Panel (if necessary)
Install WildFly 10 from the ISPmanager Control Panel and redeploy your applications and databases

1. Uninstall JBoss from the ISPmanager Control Panel

To uninstall JBoss 6 or JBoss 7, log in as root to the ISPmanager Control Panel.

For ISPmanager 4, go to Server Settings > Applications, and locate your version of JBoss. Click to highlight it, and then click on Delete in the upper-right corner.
For ISPmanager 5, go to Settings > Features, and locate your version of JBoss. Click to highlight it, and then click on Delete in the upper-left corner.

Wait a few minutes, and then click on the link to Applications or Features again to see if the uninstall process has completed. You may have to click several times before you see the application removed.

Install a supported version of Java SE from the ISPmanager Control Panel (if necessary)

Also be aware that WildFly 10 requires Java SE 8. It will not run with Java SE 6 or Java SE 7. If you are using Java SE 6 or Java SE 7, you will need to uninstall it and install Java SE 8. For more information see the Java SE 8 Release Notes.

Install WildFly 10 from the ISPmanager Control Panel and redeploy your applications and databases

Once the older version of JBoss has been removed and Java SE updated (if necessary), install WildFly 10.

For ISPmanager 4, go to Server Settings > Applications, and locate WildFly 10. Click to highlight it, and then click on Install.
For ISPmanager 5, go to Settings > Features, and locate WildFly 10. Click to highlight it, and then click on Install.

Wait a few minutes, then click on the link to Applications or Features again to see if the install process has completed. You may have to click several times before you see the application installed.

Once the update completes, you will need to redeploy and restart your applications, customizations, and databases. Deploying your applications on WildFly is different than deploying on JBoss, see the relevant User Guide for more information: WildFly Deployment in Standalone Mode

WildFly 8 or WildFly 9 to WildFly 10

There is no direct upgrade path from WildFly 8 or WildFly 9 to WildFly 10 To upgrade from WildFly 8 or WildFly 9 you will need to make a backup of your existing application, database, configuration, and any customizations and tunings, and then uninstall WildFly 8 or WildFly 9 and install WildFly 10. Once WildFly 10 is installed, you will need to redeploy your application and all configurations and databases.

To upgrade from WildFly 8 or WildFly 9 to WildFly 10, you will need to do the following:

Uninstall WildFly 8 or 9 from the ISPmanager Control Panel
Install WildFly 10 from the ISPmanager Control Panel and redeploy your applications and databases

1. Uninstall WildFly 8 or 9 from the ISPmanager Control Panel

To uninstall WildFly 8 or 9, log in as root to the ISPmanager Control Panel.

For ISPmanager 4, go to Server Settings > Applications, and locate WildFly 8 or 9. Click to highlight it, and then click on Delete in the upper-right corner.
For ISPmanager 5, go to Settings > Features, and locate WildFly 8 or 9. Click to highlight it, and then click on Delete in the upper-left corner.

Install WildFly 10 from the ISPmanager Control Panel and redeploy your applications and databases

Once the older version of WildFly 8 or 9 has been removed, install WildFly 10.

For ISPmanager 4, go to Server Settings > Applications, and locate WildFly 10. Click to highlight it, and then click on Install.
For ISPmanager 5, go to Settings > Features, and locate WildFly 10. Click to highlight it, and then click on Install.