Skip to content
A small bunch of Bash scripts intended to facilitate tasks with different versions of JBoss (including Wildfly, EAP, and older) installed through zips.
Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
patches
scripts
.gitignore
README.adoc
install
uninstall

README.adoc

JBoss Scripts

This project is a small bunch of Bash scripts intended to facilitate tasks with different versions of JBoss (including Wildfly, EAP, and older) installed through zips.

1. JBoss versions already tested with this scripts

  • JBoss EAP 7

  • JBoss EAP 6

  • JBoss EAP 5

2. Installation

Go to a directory where you already downloaded binaries for a specific JBoss version. For example, supose that you are in a directory called jboss-eap-7 with this structure:

$ cd jboss-eap-7
$ find .
.
./jboss-eap-7.0.0-maven-repository.zip
./jboss-eap-7.0.0-quickstarts.zip
./jboss-eap-7.0.0.zip
./jboss-eap-7.0.4-incremental-maven-repository.zip
./jboss-eap-7.0.4-patch.zip
./jboss-eap-7.0.4-src.zip

To start using jboss-scripts with this version of jboss, do this:

$ (cd .. && git clone https://github.com/paulojeronimo/jboss-scripts)
$ ../jboss-scripts/install

You will see that some links were created:

$ find . -type l|sort|xargs readlink
../jboss-scripts/scripts/home
../jboss-scripts/scripts/jboss-config.sample
../jboss-scripts/scripts/jboss-deploy
../jboss-scripts/scripts/jboss-install
../jboss-scripts/scripts/jboss-run
../jboss-scripts/scripts/jboss-undeploy

3. Uninstallation

$ ../jboss-scripts/uninstall

4. Configuration

Inside scripts directory, copy jboss-config.sample to jboss-config and edit it according to your needs.

You can also create a file named jboss-version. Inside it, configure a $JBOSS_VERSION. For example, if you are configuring a JBoss EAP 6.4 dir, you can do:

$ pwd
jboss-eap-6
$ echo "JBOSS_VERSION=6.4" > jboss-version

If you created this file, it will be sourced before jboss-config. So, you can take some configure decisions based on $JBOSS_VERSION value.

5. Tasks

5.1. Configure your PATH and put JBOSS variables in your shell

To configure your PATH and put all JBOSS_ variables visible in your shell, execute:

$ ./source home
Tip

You could run source <script> from anywhere.

Now, you can see the what JBOSS_ variables are present:

$ echo ${!JBOSS_*}|tr ' ' '\n'

5.2. Install JBoss

To install JBoss (removing the existing installation), execute:

jboss-install

The jboss-install script will do many tasks. For example, it will:

  1. Extract the (default or configured) JBoss zip installer.

  2. Apply the configured patches.

  3. Configure modules and JDBC drivers (ex: Oracle).

  4. Create a configured JBoss zip installer.

Tip

The jboss-install script will extract the configured JBoss zip installer (if it exists). You can force a creation of this zip running jboss-install -f.

5.3. Run JBoss

To run JBoss:

jboss-run

5.4. Deploy a package

To deploy a package (copying it to $JBOSS_HOME/$JBOSS_DEPLOY_DIR):

jboss-deploy package

5.5. Undeploy a package

To undeploy a package (removing it from $JBOSS_HOME/$JBOSS_DEPLOY_DIR):

jboss-undeploy package
You can’t perform that action at this time.