resin Resin 4.0 Open Solaris Installation Instructions

Resin for OpenSolaris Step-by-Step Installation Guide If you've decided that you're ready to deploy Resin for production, this page will guide you through the steps to install this powerful application server system-wide. You'll see where we recommend installing the various components of Resin as well as some basic production tuning tips.

This page is for you if you:

  • Are evaluating Resin
  • Want to do local application development with Resin
  • Have evaluated Resin and are ready to install system-wide
  • Want to install Resin on Solaris / OpenSolaris Systems

This page leads you step-by-step through the installation of Resin. After going through these steps, you'll have a full Java and PHP Application Server able to serve even the most demanding web sites.

You'll learn:

  • What you'll need to install for Resin to work on your system
  • What you'll need to install for Resin to compile on your system
  • How to install Resin system-wide
  • The recommended installation locations for Resin
  • How to run the Resin administration application
This guide is still an early working draft. Use at your own risk! Before actually installing Resin4, we need some packages to be installed on your system first.
In OpenSolaris do this by going to System -> Administration -> Package Manager.
Install the following Packages:
  • SUNWopenssl
    (optional, if you don't want to compile your own OpenSSL)
  • SUNWgcc
  • SUNWbinutils
  • SUNWj6dev
  • SUNWant

Notice: You only have to do this if you don't selected the SUNWopenssl package in the Package Manager.

Download OpenSSL 0.9.8o (or newer) from http://www.openssl.org to a folder of your choice.

Change to the directory where you've saved the openssl tar.gz bundle, then extract it and compile it for your environment. gunzip openssl-0.9.8o.tar.gz tar xf openssl-0.9.8o.tar cd openssl-0.9.8o ./Configure --prefix=/usr/local/openssl solaris-x86-gcc shared make su make install

Download the current version of Resin Pro (at the time of this writing, 4.0.8 is current), extract and compile it: unzip resin-pro-4.0.8.zip cd resin-pro-4.0.8 as of this writing there is a small issue with Solaris and linking. Open the files
  • modules/c/src/resin/Makefile.in
  • modules/c/src/resin_os/Makefile.in
  • modules/c/src/resinssl/Makefile.in
and change the line 
                    LDFLAGS_SHLIB=@LDFLAGS_SHLIB@
to 
                    LDFLAGS_SHLIB=@LDFLAGS_SHLIB@ -mimpure-text
then configure and compile your Resin Application Server: ./configure --prefix=/usr/local/resin make Now we first create the required user directories, so we later don't have to run make install as root (and prevent an infinite loop bug) pfexec mkdir /usr/local/resin pfexec chown YOURUSER /usr/local/resin pfexec touch /etc/init.d/resin pfexec chown YOURUSER /etc/init.d/resin Now simply install it: make install #this currently makes an infinite loop if the directories don't exist or are not writable now reassign the directories and files to root again pfexec chown root /usr/local/resin -R pfexec chown root /etc/init.d/resin cp opensolaris/* / -R svccfg -v import /var/svc/manifest/network/http-resin4.xml svcadm enable network/http:resin4 svcs | grep resin4 Simply start the Resin Application Server by executing the init-Script with the pfexec utility: pfexec /etc/init.d/resin start Make sure Resin is started by either typing these commands in your shell: ps -ef | grep java | grep resin should print exactly two lines like these domdorn 21479 21476 11 21:40:20 pts/2 0:05 /usr/jdk/instances/jdk1.6.0/bin/java -Xmx512m -Dresin.server=1 -Djava.util.logg domdorn 21476 1 0 21:40:17 pts/2 0:03 /usr/jdk/instances/jdk1.6.0/bin/java -Dresin.watchdog= -Djava.util.logging.mana or simply pointing your Web-Browser to http://localhost:8080/ Stopping the Resin Application Server works the same way like starting it, with the pfexec utility: pfexec /etc/init.d/resin stop make sure the server is stopped by executing the following command ps -ef | grep java | grep resin which should return no rows.