File manager setup

The Waterken^TM server includes a web application for creating, editing, and deleting any of the configuration files in your installation. This section explains how to set up and use this browser-based file manager.

Enabling the file manager

To enable the file manager, the Waterken^TM server must be configured with a secret random string that will be used to generate capability URIs. To generate a secret and a capability URI for the root folder of the Waterken^TM server installation, run the following java command from the root of your installation:

java -cp jar/File/safe/file.jar com.waterken.file.dir.Init

This command will produce output like:

Secret: pklbuymy5vmpuczmjgh4kdg5t4

Cap: https://hostname/file/msgzh5rjtsbfyzm5prmlstncmq.html

Default configuration files for the Waterken^TM server web applications are located at: config/xdb/. Images and javascript code used by the file manager are located at: www/en-US/.

The configuration file for the example code file manager is config/xdb/www.example.com/file/https.xml. Copy the generated secret into the element epoch/key/ in the file manager configuration file. For example, the element:

<key schema="http://waterken.com/Void"/>

becomes:

<key>pklbuymy5vmpuczmjgh4kdg5t4</key>

You can now access your file manager using your browser and the generated capability URI. Make sure you've started the Waterken^TM server before trying to connect to it.

Using your browser

Waterken^TM web applications, and the Waterken^TM server itself, are truly web-based applications. Everything you build and use is addressable with a URI, and viewable in your browser. Effective use of your browser's built-in web navigation features will improve your productivity.

Bookmarks

Use your browser's "Bookmarks" or "Favorites" list to keep track of and organize capability URIs.

History sidebar

Many popular browsers support an editable history sidebar. Keep this sidebar open as you work in your browser, treating it as an active and graphical "working set" of the resources you are using.

Notice that the HTML pages generated by the Waterken^TM server have a page title based on the document comment in the represented XML. Your history sidebar uses the page title as the hypertext for a listed link. As you create new documents, give each a document comment that will help you recognize its link in your history sidebar.

The next page explains adding a database to your Waterken^TM server installation.

Copyright 2002 - 2003 Waterken Inc. All rights reserved.