HowTo:The 10 min. test-setup

From iFolder

This how-to will run you through the steps on how to get an iFolder Enterprise Server running on VMWare, providing you with an easily accessable test environment for iFolder.
(Updated to 3.6 client/server - only compatible to 3.6 !!)
Have phun! --Dl9pf 16:37, 31 May 2007 (EST)

Table of contents
1 Preparing

1.1 Requirements
1.2 Importing installation source

2 Installation
3 Post-Installation

3.1 Login

4 Security
5 ToDo
6 Troubleshooting

6.1 Configuration issues

[edit]

Preparing

[edit]

Requirements

  • openSUSE 10.2 VMWare image from www.mono-project.com (Please use the torrent!)
    or an openSUSE 10.2 installation
  • apache2 - Preinstalled on the VMWare image
  • mono >= 1.1.18 - Preinstalled on the VMWare image
  • mod_mono - Preinstalled on the VMWare image
[edit]

Importing installation source

Start the image and after it finished loading start yast2. Open "Installation Source" and add 

HTTP ->
Server:                 software.opensuse.org
Directory on Server:    /download/repositories/home:/dl9pf/openSUSE_10.2/

Finish.

Alternatively in a terminal as root: 

zypper sa -r http://software.opensuse.org/download/home:/dl9pf/openSUSE_10.2/home:dl9pf.repo
[edit]

Installation


Then go to "Install Software"

Turn "Autocheck" on! And search and add these packages for installation:

  • ifolder3-svn (3.6 client built from svn)
  • ifolder3-server-svn (3.6 server build - not for production use)

Dependencies (auto):

  • libflaim
  • log4net
  • simias-svn


[edit]

Post-Installation

This is no in-depth article about the configuration. A default configuration was installed automagically (/etc/apache/conf.d/ifolder_apache.conf) All the data is stored in /var/lib/simias .

Apache is already installed on the VMware-Image, if you did a fresh install, don't forget "mod_mono" !

Now we can restart apache: 

rcapache2 restart

or 

/etc/init.d/apache2 restart


Hint #1: 

httpd2-prefork: Syntax error on line 180 of /etc/apache2/httpd.conf: Syntax 
error on line 102 of /etc/apache2/default-server.conf: Syntax error on line 1 
of /etc/apache2/conf.d/ifolder_apache.conf: Could not open configuration file 
/etc/apache2/mod_mono.conf: No such file or directory

This happens because the path of mod_mono.conf changed.

Just do: 

 ln -s /etc/apache2/conf.d/mod_mono.conf /etc/apache2/

rcapache2 restart


[edit]

Login


The Admin-Frontend: 

http://localhost/admin

The Web-Frontend (like webmail ;-) ): 

http://localhost/ifolder

First, we login to the Admin-Frontend. 

http://localhost/admin
  • default user: admin
  • default pass: simias


And ? Yesssssss ... thats nice !

  • create user accounts
  • create iFolders and assign them to users

ENJOY !


Hint #2: If it doesn't work ... do this: 

ldconfig
rcapache2 restart
[edit]

Security

This setup is *NOT* secure. So take care it's not accessible from the internet.

ToDo: How to secure the installation ...

[edit]

ToDo

  • Security
  • Advanced configuration
  •  ? Other Distros ?
[edit]

Troubleshooting

If the client on the VMware-Image fails to start, open 2 console windows:

Window 1: 

/opt/novell/ifolder3/bin/simias --verbose --showconsole

Window 2: 

sleep 8
/opt/novell/ifolder3/bin/ifolder --verbose --showconsole
[edit]

Configuration issues

First of all ... locate the file Simias.log4net

It's in /var/lib/simias

Change all "INFO" to "DEBUG" .

Then you can look at the file 

tail -f /var/lib/simias/log/Simias.log

And view the error messages.

Read last sections of the Howto: Configuring iFolder Enterprise Server on SUSE Linux 9.3, 10.x, and SLES 9

Retrieved from "http://www.ifolder.com/index.php/HowTo:The_10_min._test-setup"