BRIDGE tutorial

We will eventually have a more complete tutorial on bridge...

To start the server, run the follow command anywhere OTHER THAN on java.cs.vt.edu:

java -Dauth=true -Dcodebase=http://localhost:23466/live   edu.vt.chci.demo.DemoServer 23456
Setting auth to false should cause the server to allow you to log in as anybody. Otherwise you can log in as user id "guest" with password "guest". You can also switch to a different port by changing 23456 to any valid, unused port. (The port in the codebase property should be 10 greater than the port that the server listens on, e.g., 23456 and 23466 in the example above.) When a client connects via webstart, the server passes configuration information via a jnlp file. When launching the client from the command line you can just point it at a configuration file that the server creates on startup. For example if I start the server in /home/isenhour/work/linc/edu/vt/chci/demo/, the following command can be used to start the client: 
java 
-Dpropsfile=/home/isenhour/work/linc/edu/vt/chci/demo/DEMO-DATA/server.properties 
-Dcodebase=http://127.0.0.1:23466/live 
edu.vt.cs.collab.bridge.apps.web.WebSiteEditor

(You only need the \'s if you split the command across multiple lines. If you put the entire command on a single line, the \'s should be removed.)

Change the path to match the path to wherever you start the server. If you change the port that the server listens on, you should change the port in the client's codebase property and add -Dport=XXXX.

Setting up directories

When the server starts up for the first time, the database is essentially empty. We will eventually automate setup of basic structures, but for now you will have to set up some directories to avoid exceptions on client startup. Directories can be added by logging into the client (use "guest"/"guest" if no accounts have been set up) and selecting the root directory ("/") in the folder tree. Then go to the "Edit" menu, choose "Temp admin tools", "New", and "WebSite sub-directory". This will make a new (empty) directory that you can select and rename.
  1. User directories. A directory named "users" at the top level holds home directories for each user. First make a directory named "users", then make a directory inside "users" for each account. (Initially you should just make one for "guest".) If the server is actually to be used, the permissions on these directories should be changed (by selecting them and choosing "Edit Permissons..." from the file menu).
  2. Template directories. In order for the "Add to..." menu item in the "File" menu to work, a top level "templates" directory should be added. Sub-directories within this directory will appear as categories in the "Add to..." dialog. Inside the category directories, a directory for each template should be added. Within the directory for each template, a text object (Web page) named "Description" will be shown in the description field, and the contents of a directory named "Contents" will be copied when the user selects and instantiates the template.

/public/chci/howto/bridge.html Login | Web Editor | Full Editor
Last modified 5/22/03 4:01 PM by isenhour (history)
Site contents