Chapter 6. Upgrading JBoss Web Server


Note

The JBoss Web Server 5.0 can run on the same system as previous releases, however, this is not supported.

For systems using the JBoss Web Server 3.1, the recommended procedure for upgrading to the JBoss Web Server 5.0 is:

  1. Shutdown any running instances of JBoss Web Server 3.1.
  2. Backup the JBoss Web Server 3.1 installation and configuration files.
  3. Change the ports used by the JBoss Web Server 3.1 connectors if the ports used are 8080 or 8443.
  4. Install JBoss Web Server 5.0 using one of the following guides:

  5. Migrate your configuration from the JBoss Web Server 3.1

    Note

    The JBoss Web Server configuration files may have changed since the JBoss Web Server 3.1 release. It is recommended that you update the 5.0 version configuration files, rather than overwrite them with the configuration files from a different version (such as JBoss Web Server 3.1).

  6. Remove the JBoss Web Server 3.1:

    • For systems where JBoss Web Server 3.1 was installed from RPM packages, uninstall using:

      Copy to Clipboard Toggle word wrap
      yum group remove jws3
    • For systems where JBoss Web Server 3.1 was installed from .zip archives, uninstall by deleting the JBoss Web Server 3.1 root directory.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.