WebSPN archive files are provided with scripts a user can use to easily configure the system with an system wide installation.
Installation scripts could be tried following the instructions according to the used distribution. If it doesn’t work, manual installation can be used.

Script assisted installation

• Debian

• Ubuntu

• Fedora

• Gentoo

• Suse

 

How to uninstall

As superuser (root) within the installation dir webspn, execute this command:

./install.sh -u

Manual Installation

These are the steps to install webspn without using the installer

You should use this guide only if the installer for your distribution doesn’t work.

Run these commands as (root) superuser.

• If you have webspn 32 bit version

tar zxvf ./webspn32.tar.gz; cd webspn

• if you have webspn 64 bit version

tar zxvf ./webspn64.tar.gz; cd webspn

• Create the installation dir

mkdir /opt/webspn
mkdir /opt/webspn/bin

mkdir /opt/webspn/bin/client

• Change permissions to dir

chmod 777 /opt/webspn
chmod 777 /opt/webspn/bin
chmod 777 /opt/webspn/bin/client

• Copy the executables in the correct dir

cp ./webspnclient ./WebSPNClient.jar /opt/webspn/bin/client/

cp ./webspn ./simul ./WebSPNServer.jar /opt/webspn/bin/

• Change permissions to the executables

chmod 777 /opt/webspn/bin/webspn
chmod 777 /opt/webspn/bin/simul
chmod 777 /opt/webspn/bin/WebSPNServer.jar
chmod 777 /opt/webspn/bin/client/WebSPNClient.jar
chmod 777 /opt/webspn/bin/client/webspnclient

• Create dirs for the libs

mkdir /opt/webspn/lib
mkdir /opt/webspn/lib/simul
mkdir /opt/webspn/lib/tool

• Copy all libs in the correct dirs

cp ./lib/simul/* /opt/webspn/lib/simul/

cp ./lib/tool/* /opt/webspn/lib/tool/

• Create the symbolic link for all the libs

ln -s /opt/webspn/lib/simul/libQtGui.so.4.8.2 /opt/webspn/lib/simul/libQtGui.so.4

ln -s /opt/webspn/lib/simul/libQtCore.so.4.8.2 /opt/webspn/lib/simul/libQtCore.so.4

ln -s /opt/webspn/lib/simul/libQtXml.so.4.8.2 /opt/webspn/lib/simul/libQtXml.so.4
ln -s /opt/webspn/lib/simul/libaudio.so.2.4 /opt/webspn/lib/simul/libaudio.so.2

ln -s /opt/webspn/lib/simul/libpng12.so.0.49.0 /opt/webspn/lib/simul/libpng12.so.0

ln -s /opt/webspn/lib/tool/libmpich.so.3.2 /opt/webspn/lib/tool/libmpich.so.3

ln -s /opt/webspn/lib/tool/libmpl.so.1.1.0 /opt/webspn/lib/tool/libmpl.so.1

ln -s /opt/webspn/lib/tool/libopa.so.1.0.0 /opt/webspn/lib/tool/libopa.so.1

ln -s /opt/webspn/lib/tool/libcr.so.0.5.5 /opt/webspn/lib/tool/libcr.so.0

• Change permissions to the libs

chmod -R 777 /opt/webspn/lib

• Set LD_LIBRARY_PATH

echo export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/webspn/lib/simul:/opt/webspn/lib/tool >> /etc/profile

• Set PATH

echo export PATH=$PATH:/opt/webspn/bin:/opt/webspn/bin/client >> /etc/profile

• If you have debian or ubuntu

if you have sysv

cp ./webspnd /etc/init.d/
chmod 755 /etc/init.d/webspnd
update-rc.d webspnd defaults
/etc/init.d/webspnd start

if you have systemd

cp ./webspnd /opt/webspn/bin/
chmod 755 /opt/webspn/bin/webspnd
cp ./webspn_sysd.service /lib/systemd/system/
systemctl enable webspn_sysd.service
systemctl start webspn_sysd.service

• if you have fedora

if you have sysv

cp ./webspnd_fedora /etc/init.d/
chmod 755 /etc/init.d/webspnd_fedora
chkconfig –add webspnd_fedora
service webspnd_fedora start

if you have systemd

cp ./webspnd_fedora /opt/webspn/bin/
chmod 755 ./webspn/bin/webspnd_fedora
cp ./webspn_fedora_sysd.service /lib/systemd/system/
systemctl enable webspn_fedora_sysd.service
systemctl start webspn_fedora_sysd.service

• if you have suse

if you have sysv

cp ./webspnd_suse /etc/init.d/
chmod 755 /etc/init.d/webspnd_suse
chkconfig –add webspnd_suse
service webspnd_suse start

if you have systemd

cp ./webspnd_suse /opt/webspn/bin/
chmod 755 /opt/webspn/bin/webspnd_suse
cp ./webspn_suse_sysd.service /lib/systemd/system/
systemctl enable webspn_suse_sysd.service
systemctl start webspn_suse_sysd.service

• if you have gentoo

If you have openrc

cp ./webspnd_gentoo_openrc /etc/init.d/
chmod 755 /etc/init.d/webspnd_gentoo_openrc
rc-update add /etc/init.d/webspnd_gentoo_openrc default
rc-service /etc/init.d/webspnd_gentoo_openrc start

if you have systemd

cp ./webspnd_gentoo /opt/webspn/bin/
chmod 755 /opt/webspn/bin/webspnd_gentoo
cp ./webspn_gentoo_sysd.service /usr/lib/systemd/system/
systemctl enable webspn_gentoo_sysd.service
systemctl start webspn_gentoo_sysd.service

if you have SystemV:

update-rc.d -f <name_of_service> remove

where <name_of_service> is webspnd(for debian or ubuntu)/webspnd_fedora/webspnd_suse/ according to your distribution. If you don’t know the name of service, you can do:

ls /etc/init.d/webspn*

if you have systemd:

 systemctl disable <name_of_service>.service

Where <name_of_service> is webspn_sysd.service/webspn_sysd_fedora/webspn_sysd_suse according to your distribution.

If you don’t know the name of the service, you can do:

ls /lib/systemd/system

ls /usr/lib/systemd/system

If you have OpenRC:

rc-update del <name_of_service> default

Probably for you <name_of_service> is /etc/init.d/webspnd_gentoo_openrc.

 

 

How to manually start or stop WebSPN Server

/etc/init.d/<name_of_service> start

/etc/init.d/<name_of_service> stop

<name_of_service> should be webspnd(for debian or ubuntu)/webspnd_fedora/webspnd_suse  according to your distribution

If you use gentoo you can do this:

rc-service /etc/init.d/webspnd_gentoo_openrc start

rc-service /etc/init.d/webspnd_gentoo_openrc stop

 

What is my system/service manager?

Usually, service manager is the process with PID 1.

SysV:

ps aux|grep init

If you see something like this:

root         1  0.1  0.0  10644   824 ?        Ss   18:35   0:00 init

You have installed SysV

Systemd:

ps aux|grep systemd

if you see something like this

root         1  0.7  0.2  41008  4172 ?        Ss   18:17   0:00 /bin/systemd

You have installed systemd

OpenRC:

If you use Gentoo this is default service manager.