Basic Installation (required)
- Make sure your server complies with all the prerequisites.
- Extract the downloaded installation file into the
webapps directory of the Tomcat or the Catalina installation. If you
don't want to have it there or you're neither running Tomcat nor Catalina,
configure your servlet runner to have a context for FileLister, e.g.
named "filelister", and extract the installation file into the related
directory. For how to do this in Tomcat or Catalina, see Tip
- Create a database for FileLister's index, e.g.
named "filelister" (see Tip 2).
- FileLister needs a Servlet API jar file (at least
v2.1), typically named "servlet.jar". If your running Tomcat
or Catalina and you have set the TOMCAT_HOME or the CATALINA_HOME
environment variable, proceed to the next step. If you haven't set
such a variable, you need to edit the filelister_env.sh or the filelister_env.bat:
Look for the setting of the variable "SERVLETJAR" (about
line 20) and enter the path to the servlet.jar file located in the
Tomcat or Catalina installation directory (including the name of the
If you're running another servlet runner, locate its Servlet API jar
file and set it to the SERVLETJAR variable mentioned before.
- Decide where the root directory of the index shall
be located, create this directory, if necessary, and fill in the files
to be listed. Important: If you don't define a virtual root, the whole
file system of your host will be indexed which for sure leads into
the indexing of files which you either don't want to show or which
are system files that lead to access violations on indexing! For more
infos on defining a virtual root, see Tip
- Optionally, configure a server (e.g. a web or a
FTP server) which allows to access the indexed directory's contents.
For more infos on this feature, see Tip
- If you're running FileLister on a Win95 or Win98
host, set the FILELISTER_HOME variable in C:\autoexec.bat, pointing
to FileLister's installation directory. This means you need to reboot
- Run the setup.sh or setup.bat in the bin directory
of the installation. A graphical settings editor will show up and
you must configure the following things:
Finally, you have the possibility to test the JDBC
connection by selecting the "Test Connection" option from
the "Actions" menu. Note: All the other configuration settings
are optional and described in the bottom text area of the application
"on mouse over" of each setting.
- the JDBC environment (at least the connection
string, the user name and the password)
- the table name where FileLister stores the
index in (typically the name of the host that is indexed or a
descriptive name of the indexed directory)
- the virtual root directory if you decided to
- the URL prefix which is needed to make the
indexed directories browseable / files downloadable
- if you decided to allow the zipping of files:
the "zip.isallowedtozip" checkbox to checked and the
directory where the zip files shall be created in (typically "/tmp"
or "C:\temp"). Note: Activating the zipping of files
may be risky because FileLister bypasses the file system's security
(see Tip 5)!
- Run the InitialIndexer.sh or InitialIndexer.bat
in the bin directory of the installation. You'll see some messages
about the indexing and the data pumping process.
- Start your servlet runner and access FileLister's
virtual directory, typically http://localhost:8080/filelister.
Back to Index / Extended