This project has moved. For the latest updates, please go here.
Jexus installers can be found at Jexus.org, which is usually in the following URL patterns,
http://www.linuxdot.net/down/jexus-x.y.z.tar.gz
http://www.linuxdot.net/down/jexus-x.y.tar.gz


For example, a stable release, such as 5.5.2, can be downloaded from http://www.linuxdot.net/down/jexus-5.5.2.tar.gz.

Index

Installation on a clean machine

1. Install Mono runtime
Xamarin maintains the installation packages here. Please follow the guide to install it and then execute
mono --version
at terminal to verify. mono-complete is recommended.

Mono 3.2.8 and above is recommended version for all Linux/OS X if you know how to get it installed.

2. Download and unpack Jexus
wget http://www.linuxdot.net/down/jexus-x.y.z.tar.gz
tar -zxvf jexus-x.y.z.tar.gz

Jexus binary package is downloaded from its official site, and extracted to a folder named “jexus-x.y.z″ after this step.

Image 1: Jexus installation package

3. Create default web site
sudo mkdir /var/www
sudo mkdir /var/www/default
sudo vi /var/www/default/index.html
  • Press i on keyboard to enter edit mode.
  • Type “Hello World from Jexus” and press Esc on keyboard to exit edit mode.
  • Type :wq and press Enter on keyboard to exit vi.
/var/www/default is the default web site path for Jexus. In this step we create a test page using vi. You might use any other Linux text editor to create this test page.

4. Install and start Jexus
cd jexus-x.y.z
sudo ./install
cd /usr/jexus
sudo ./jws start

Here we put Jexus binary to /usr/jexus folder, grant the jws shell script file execution permission, and then use it to register Jexus modules in Mono GAC and launch the HTTP service.

If you want to install Jexus to another location, please change the commands accordingly.

5. (Optional) Add Jexus to startup commands
sudo vi /etc/rc.local
  • Press i on keyboard to enter edit mode.
  • Add start command “/usr/jexus/jws start”.
  • Press Esc on keyboard to exit edit mode.
  • Type :wq and press Enter on keyboard to exit vi.

Now if we open Firefox and navigate to http://localhost, the test page we created is displayed correctly,

Image 2: Jexus test page in Firefox

Upgrade on Existing Installation

1. Download and unpack Jexus
wget http://www.linuxdot.net/down/jexus-x.y.z.tar.gz
tar -zxvf jexus-x.y.z.tar.gz

Jexus binary package is downloaded from its official site, and extracted to a folder named “jexus-x.y.z″ after this step.

2. Stop current Jexus server,
cd /usr/jexus
sudo ./jws stop

Assume the previous release was installed at /usr/jexus, we stop the service. If Jexus 5.3 was there, use "sudo ./jws.stop" instead of "sudo ./jws stop".

3. Copy new files to Jexus folder
cd ~/jexus-x.y.z
sudo ./upgrade

Now let’s go back to the extracted folder and upgrade necessary files to /usr/jexus.

4. Fix startup commands
sudo vi /etc/rc.local
  • Press i on keyboard to enter edit mode.
  • If previous start command “/usr/jexus/jws.start” exists, replace it with “/usr/jexus/jws start”.
  • Remove “/usr/jexus/state.start” if it presents.
  • Press Esc on keyboard to exit edit mode.
  • Type :wq and press Enter on keyboard to exit vi.
Here we remove the old entries, and use a new entry to start Jexus at startup.

5. Start Jexus HTTP service
cd /usr/jexus 
sudo ./jws start

Notes

Jexus author has recently found a new way to distribute Jexus web server. It is called Jws.mono at this moment, which means "Jexus bundled with Mono". By using this approach, you can install Jexus and Mono easily from a binary package, instead of installing Mono runtime via Linux distro or building from source code.

However, Jexus Manager does not yet support Jws.mono. You have to install Mono via Linux distro or build from source code still if you want to use Jexus Manager.

Last edited Mar 1, 2015 at 5:55 AM by lextm, version 6