Wide installation

Manual installation (Debian x64 >= 6)

Manual installation is quite long but allow fine tuning. It consists in a number of steps.

Pre-requisites

jdk 1.7

As WIDE use last version of java, it is needed to install java manually. Glassfish requires a jdk and not a jre.
This procedure assume that there is no jre/jdk installed on system.
First, download the jdk-7u<version>-linux-x64.tar.gz file.

# mkdir /usr/lib/jvm
# mv jdk-7u<version>-linux-x64.tar.gz /usr/lib/jvm
# cd /usr/lib/jvm
# tar zxvf jdk-7u<version>-linux-x64.tar.gz

Add java to the path
# ln -s /usr/bin/java /usr/lib/jvm/jdk1.7.0_<version>/bin/java

Check java version
# java -version
java version "1.7.0_06"
Java(TM) SE Runtime Environment (build 1.7.0_06-b24)
Java HotSpot(TM) 64-Bit Server VM (build 23.2-b09, mixed mode)

Installing glassfish >= 3.1

Create a glassfish user (recommended)

# adduser glassfish

Downloading glassfish

Adapt the version number, version must be >= 3.1
Glassfish can be found on https://glassfish.java.net

# cd /home/glassfish
# su glassfish
# wget http://download.java.net/glassfish/3.1.2.2/release/glassfish-3.1.2.2.zip
# unzip glassfish-3.1.2.2.zip

Remove the default domain
# rm -rf glassfish3/glassfish/domains/domain1

Create a passwordfile

The password file is convenient to perform automtized tasks, for example using ant.
In the glassfish installation folder, create a file called passwordfile
with this content:
AS_ADMIN_PASSWORD=adminadmin
replace adminadmin by the admin password of the application server.

# cd glassfish3/glassfish
# vi passwordfile // Or use your preferred editor
type AS_ADMIN_PASSWORD=adminadmin // replace "adminadmin" by your admin password

Installation MySQL database server (>5.x)

The Mysql Server installation is quite typical, the only requirement is that the version must be superior to 5.

Installation using the debian package manager:
# su root
# apt-get install mysql-server
The installer will ask you for a root password

Create an user (recommended)

In order to create a new user, first log to the mysql client using root user. In this sequence,
localhost can be replace by remote server name if mysql server is running on a different system.

# mysql -h localhost -u root -p

Then create the Wide user with privileges from localhost
mysql> GRANT ALL PRIVILEGES ON *.* TO 'wideuser'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Then the same privileges from distant hosts
mysql> GRANT ALL PRIVILEGES ON *.* TO 'wideuser'@'%' IDENTIFIED BY 'password' WITH GRANT OPTION;

Wide Installation

Download wide.zip
Uncompress the file.

# su glassfish
# cd /home/glassfish
# wget http://dev.mri.cnrs.fr/attachments/download/1072/wide-1.3.1.zip@
# unzip wide-1.3.1.zip

Make ant executable
# chmod +x ant/bin/*

Create a folder to store wide images (if not exists)

# su root
# mkdir /home/wide

Give this folder permissions for user glassfish
# chown glassfish:glassfish /home/wide
# su glassfish

Edit config.properties

The default values uses this installation scheme.
  • specify glassfish path and asadmin program,
  • specify MySQL binaries installation folder,
  • specify mysql user and password created above,
  • specify glassfish admin user and password

Launch the wide setup task

ant\bin\ant -f setup.xml

Testing your installation

Web interface

Wide web interface can be access by this URL.
http://yourdomain.com:9080/wide_file_manager
A default user allow to log-in with admin as login and admin as password.

Upload client

Install the upload client.