HowTo:Configure iFolder Enterprise Server on SUSE Platforms
From iFolder
| Table of contents |
|
1.1 SLES 9 |
QuickStart Guide
Below are all of the steps needed to get iFolder Enterprise Server running on various SUSE platforms. The links to the server RPMs work, but the 3.5 builds are unstable/alpha and don't work with the old 3.4 clients shipped with most distros. For experimental test-systems there are old "3.4" packages here (http://software.opensuse.org/download/home:/dl9pf/).
SLES 9
yast -i apache2-worker glib2 unzip wget wget http://www.go-mono.com/download/sles-9-i586/mono-1.1.zip wget http://www.go-mono.com/download/sles-9-i586/webserver.zip unzip mono-1.1.zip unzip webserver.zip rpm -Uvh mono-core-*.i586.rpm mono-data-1*.i586.rpm mono-web*.i586.rpm xsp*.rpm mod_mono*.rpm wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SLES9-i586/rpms/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm Configure the Server's Firewall to allow http traffic /etc/init.d/apache2 stop /etc/init.d/apache2 start
SUSE Linux 9.3
yast -i apache2-worker unzip wget wget http://www.go-mono.com/download/suse-93-i586/mono.zip wget http://www.go-mono.com/download/suse-93-i586/webserver.zip unzip mono.zip unzip webserver.zip rpm -Uvh mono-core-*.i586.rpm mono-data-1*.i586.rpm mono-web*.i586.rpm xsp*.rpm mod_mono*.rpm wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SUSE9.3-i386/rpms/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm Configure the Server's Firewall to allow http traffic /etc/init.d/apache2 stop /etc/init.d/apache2 start
OpenSUSE 10.0 (formerly SUSE Linux 10.0)
yast -i apache2-worker unzip wget wget http://www.go-mono.com/download/suse-100-i586/mono.zip wget http://www.go-mono.com/download/suse-100-i586/webserver.zip unzip mono.zip unzip webserver.zip rpm -Uvh mono-core-*.i586.rpm mono-data-1*.i586.rpm mono-web*.i586.rpm xsp*.rpm mod_mono*.rpm wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SUSE10.0-i586/RPMS/i586/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm Configure the Server's Firewall to allow http traffic /etc/init.d/apache2 stop /etc/init.d/apache2 start
OpenSUSE 10.1 (formerly SUSE Linux 10.1)
yast -i apache2-worker mono-core mono-web mono-data mod_mono wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SUSE10.1-i586/RPMS/i586/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm Configure the Server's Firewall to allow http traffic /etc/init.d/apache2 stop /etc/init.d/apache2 start
Detailed Guide
Run the following commands as root or use sudo depending on your personal preference and environment setup.
Install Mono and Apache2
The following step(s) will install Mono, Apache2 and a few utility and dependency packages.
NOTE: If YaST fails complaining that it can't find one of the packages, you may need to setup an additional YaST repository with the necessary packages. Information about setting up additional YaST repositories can be found [here (http://en.opensuse.org/Additional_YaST_Package_Repositories)]
SLES 9
yast -i apache2-worker glib2 unzip wget wget http://www.go-mono.com/download/sles-9-i586/mono-1.1.zip wget http://www.go-mono.com/download/sles-9-i586/webserver.zip unzip mono-1.1.zip unzip webserver.zip rpm -Uvh mono-core-*.i586.rpm mono-data-1*.i586.rpm mono-web*.i586.rpm xsp*.rpm mod_mono*.rpm
SUSE Linux 9.3
yast -i apache2-worker unzip wget wget http://www.go-mono.com/download/suse-93-i586/mono.zip wget http://www.go-mono.com/download/suse-93-i586/webserver.zip unzip mono.zip unzip webserver.zip rpm -Uvh mono-core-*.i586.rpm mono-data-1*.i586.rpm mono-web*.i586.rpm xsp*.rpm mod_mono*.rpm
SUSE Linux 10.0
After initial testing, the Mono 1.1.8.3 that ships with SUSE Linux 10.0 is just too buggy for reliable server usage. As such, the Mono team has done a great job of resolving a lot of the issues in the latest release of Mono. So we will need to download and install the latest Mono for SUSE Linux 10.0 from the go-mono.com site.
yast -i apache2-worker unzip wget wget http://www.go-mono.com/download/suse-100-i586/mono.zip wget http://www.go-mono.com/download/suse-100-i586/webserver.zip unzip mono.zip unzip webserver.zip rpm -Uvh mono-core-*.i586.rpm mono-data-1*.i586.rpm mono-web*.i586.rpm xsp*.rpm mod_mono*.rpm
SUSE Linux 10.1
yast -i apache2-worker mono-core mono-web mono-data mod_mono
Note: SUSE 10.1 DVD from opensuse.org seems to be missing mod_mono and xsp. If this is the case for you then download them from opensuse.org directly:
wget http://download.opensuse.org/distribution/SL-10.1/inst-source/suse/noarch/xsp-1.1.13.7-4.noarch.rpm wget http://download.opensuse.org/distribution/SL-10.1/inst-source/suse/i586/mod_mono-1.1.13.5-7.i586.rpm rpm -Uvh xsp*.rpm mod_mono*.rpm
Download and Install Log4net, libflaim and iFolder Enterprise Server
SLES 9
wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SLES9-i586/rpms/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm
SUSE Linux 9.3
wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SUSE9.3-i386/rpms/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm
SUSE Linux 10.0
wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SUSE10.0-i586/RPMS/i586/ rpm -Uvh log4net*.rpm ifolder3-server*.rpm libflaim-4*.rpm
SUSE Linux 10.1
wget -r -np -nH -nd --accept=rpm http://forgeftp.novell.com/ifolder/server/3.5/current/linux/SUSE10.1-i586/RPMS/i586/
Since rpm will stop if a newer version of a package is installed, it is recommended to enter the rpm statements separately to make sure everything installs:
rpm -Uvh log4net*.rpm rpm -Uvh ifolder3-server*.rpm rpm -Uvh libflaim-4*.rpm
Configure the Server's Firewall to allow http traffic
If your running a firewall on this machine, your going to need to allow incoming traffic on port 80 (http). Eventually port 443 (https) will also need to allow incoming traffic once the iFolder Enterprise Server builds support it.
yast firewall
If the Firewall is enabled, select the Allow Services tab and add HTTP Server and HTTPS Server to the Allowed Services. Save the settings and then restart the firewall service
rcSuSEfirewall2 restart
Restart Apache
Once the iFolder Enterprise Server is installed, Apache must be restarted.
Stop the Apache service
/etc/init.d/apache2 stop
Start the Apache service
/etc/init.d/apache2 start
Configure the Apache service so it restarts automatically on system startup
chkconfig apache2 on
NOTE: Attempting to issue a /etc/init.d/apache2 restart command will more then likely fail. This is a known issue (https://bugzilla.novell.com/show_bug.cgi?id=85539&GoAheadAndLogIn=1#c18).
Using the iFolder Enterprise Server
Your now ready to provision addtional users or begin accessing your server with the default admin account.
Trouble Shooting
Apache Fails to restart properly
If you try to restart Apache with this command
/etc/init.d/apache2 restart
Chances are you will get this error and Apache fails to start up
Starting httpd2 (worker) [Wed Apr 05 15:04:22 2006] [warn] module mono_module is already loaded, skipping [Wed Apr 05 15:04:22 2006] [warn] module mono_module is already loaded, skipping (98)Address already in use: make_sock: could not bind to address [::]:80 no listening sockets available, shutting down Unable to open logs startproc: exit status of parent of /usr/sbin/httpd2-worker: 1
As a work around, stop and then start Apache using the following commands:
/etc/init.d/apache2 stop /etc/init.d/apache2 start
Apache throws warning messages when it is started
When starting Apache the following warning messages are thrown
Starting httpd2 (worker) [Wed Apr 05 15:09:22 2006] [warn] module mono_module is already loaded, skipping [Wed Apr 05 15:09:22 2006] [warn] module mono_module is already loaded, skipping
This is a known issue (http://bugzilla.ximian.com/show_bug.cgi?id=75560) and the steps to resolve the problem can be found here (https://bugzilla.novell.com/show_bug.cgi?id=96764)
Unable to login to iFolder Enterprise Server
If your able to access http://host/ifolder or http://host/admin, but unable to login and you see errors like this "ERROR Simias.Service.Manager - Local database object does not exist." in your server's /var/lib/simias/Simias.log, then you will need to do the following steps as root:
- Stop Apache
/etc/init.d/apache2 stop
- Remove the following directories
rm -rf /tmp/.wapi rm -rf /tmp/apache-temp-aspnet-0 rm -rf /var/lib/simias/*
- Start Apache
/etc/init.d/apache2 start
