SLIDE Installation Guide
The following guide assumes you have a Tomcat installation already installed. These instructions relate to the following release versions -
- Tomcat - 5.5.9
- J2SE - 5.0
- SLIDE 2.1
As all of these products are continuing to be developed you will need to adjust the following guidelines according to the releases you are installing.
Download the SLIDE implementation from here : http://jakarta.apache.org/slide/index.html. It is recommended that you get both a bundled and unbundled version.
- Unpack them both.
- Go to the Tomcat server and enter the Manager module.
- Upload the SLIDE.War to the apache server. This will unbundle the SLIDE library and implement SLIDE as a service within the server.
I have included a base build for you to use. You can deploy these files into your SLIDE environment as listed below and you will have a basic SLIDE repository set up. It is still worth reading the following configuration notes to allow you to customise your environment.
In the following instructions please refer to the following definitions -
- TOMCAT$ = home directory for the Tomcat installation
SLIDE$ = home directory for the SLIDE installation within the Tomcat environment
In the TOMCAT$/conf/server.xml file add the following code to the Host section :
<Context path="/slide" debug="0" privileged="true" useNaming="true"> <Realm name="Slide DAV Server" className="org.apache.catalina.realm.UserDatabaseRealm" debug="0" resourceName="UserDatabase"/> </Context>
This sets up the SLIDE implementation to run within its own realm. I have implemented this using the Tomcat user file, however implementations are available for JAAS.
If using the Tomcat user file you will need to add a user entry for each SLIDE user. Set the password to be the same as that defined for SLIDE.
For configuring JAAS please follow this link - http://jakarta.apache.org/slide/howto-jaas.html
You need to point the SLIDE servlet to the the file Domain.xml. To do this you need to edit the file SLIDE$/WEB-INF/web.xml. This defines the runtime environment for the SLIDE servlet.
You need to uncomment the security-constraint section to enable the authentication to SLIDE. If you don't do this, you will not authenticate to the servlet and will be treated as a 'guest', greatly reducing user priviledges.
I have attached a sample web.xml for you to use - Getting_Started_Web.XML.
If it is not already there you need to copy the file slide.properties from the unbundled SLIDE download to the following directory - TOMCAT$/conf
You will find a copy of this in either the source download or the deployment download.
This file sets the environment variables which are used by the SLIDE servlet. You need to change the following
#Default : Will look for domain.xml in current directory org.apache.slide.domain=TOMCAT$/webapps/slide/Domain.xml #Phil - apparently needed to bind the security #This was highlighted as a bug so may be corrected in future versions... org.apache.slide.binding=true
This is the critical file. It defines the initialisation for the SLIDE environment. In this file you define the following -
- bind actions to class implementations;
- define users;
- define user roles; and
- containers for the repository.
You will need to copy this file (and possibly rename it) to the SLIDE$ directory.
I have included a Domain.xml to get you started. It is a very simplified version with two users defined within one namespace and one namestore. With this you should be able to see the underlying structure - Getting_Started_Domain.XML.
From the Tomcat manager page you can initiate SLIDE. Start the process and you should have a SLIDE implementation up and running.
To test this you can load SLIDE using the following - http://localhost:8080/slide
This should prompt you for a user name and password. If you have used the provided Domain.xml you can enter the implementation with "user1/user1". You should now see a directory structure but no functionality.
To test the DAV aspects of SLIDE you will need to download an application and access the SLIDE servlet. I used WebDAVExplorer to test - http://www.ics.uci.edu/%7Ewebdav/