CVW Server Installation Instructions

1. Installing the CVW Server Software

• Create the directory for the CVW Server

  cd /opt
  mkdir CVWserver

This directory must be created on the local file system and must not be exported to other systems.

• Change to the CVWserver directory and extract the CVW Server software using the following procedure:
  
  

cd /opt/CVWserver
uncompress - < cvw-moo-server-3.2.*.tar.Z | tar xvf -

(Use the correct path to the tar file appropriate for your OS.)

• Modify the cvw.boot (S99cvw) Startup/Shutdown Script

Change to the CVW Server directory and edit the cvw.boot script so the settings below reflect your CVW Server settings. This script is used to start and stop the CVW Server (e.g., ./cvw.boot start, ./cvw.boot stop).

cvwuser = cvw CVW Document Server user account name
serverdir = /opt/CVWserver CVW Server software directory
cvwname = CVW CVW database file name
portnumber = 8888 CVW Server port
num_fd = unlimited maximum number of simultaneous user connections

It is recommended that you accept the default values.

• Copy the updated cvw.boot script from the CVW Server directory to /etc/init.d/cvw and ensure execute permissions. Then link the file to /etc/rc3.d/S99cvw so the server will be started upon system boot.

cp /opt/CVWserver/cvw.boot /etc/init.d/cvw
ln /etc/init.d/cvw /etc/rc3.d/S99cvw

2. Installing the CVW Document Server

It is recommended that the CVW Document Server be installed on the same host system as the CVW Server. If you opt to install the Document Server on an alternate host system, install it into the recommended location of /opt/CVWserver. If you choose not to install the CVW Document Server in the recommended location, make a symbolic link from the recommended location to the actual location.



• Change to the CVWserver directory and extract the CVW Document Server software using the following procedure:

  cd /opt/CVWserver
  uncompress - < cvw-doc-server-3.2.*.tar.Z | tar xvf -

  (Use the correct path to the tar file appropriate for your OS.)

• Modify the docserver.cfg Configuration File

  Change to the CVW Server directory and edit the docserver.cfg file so the settings below reflect your Document Server settings.

  port = 8889 CVW Document Server port
  docstore = /opt/CVWserver/doc-store Document store directory
  logfile = docserver.log CVW Document Server log file name

  It is recommended that you accept the default values.

• Modify the cvwds.boot (S99cvwds) Script

  Edit the cvwds.boot script so the settings below reflect your Document Server settings. This script is used to start and stop the CVW Document Server (e.g., ./cvwds.boot start, ./cvwds.boot stop).

  cvwdsuser = cvw CVW Document Server user account name
  serverdir = /opt/CVWserver CVW Server software directory

  It is recommended that you accept the default values.

• Copy the updated cvwds.boot script from the CVW Server directory to /etc/init.d/cvwds and ensure execute permissions. Then link the file to /etc/rc3.d/S99cvwds so the document server will be started upon system boot.

cp /opt/CVWserver/cvwds.boot /etc/init.d/cvwds
ln /etc/init.d/cvwds /etc/rc3.d/S99cvwds

3. Creating the CVW Unix User Account and Setting File Ownership

• Create a Unix user account to use to run the CVW server and Document server processes.

user name: cvw
user ID: 101 (unless already in use)
group ID: 2

You can use the following in your /etc/passwd file.

cvw:x:101:2:CVW Server:/opt/cvw:/bin/sh

You can use the following in your /etc/shadow (if your system uses shadow passwords.)

cvw:NP:6445::::::

• Set the ownership of all files in the CVWserver directory to the new cvw user.

cd /opt/CVWserver
chown -R cvw .
chgrp -R 2 .
chmod 750 .
chmod -R go-w *

4. Starting and Testing the Operation of the CVW Server

• To start the CVW Server, run the following command as root:

/etc/init.d/cvw start

• To test the CVW Server, log into the server with telnet.

telnet <host name> <CVW port number>
Example: telnet server.mitre.org 8888

You will receive connection feedback similar to the following:

Trying 129.9.9.209...
Connected to server.mitre.org.
<!--YourMOO-->
<!--

Welcome to the Collaborative Virtual Workspace.
This is version 3.2 of the CVW server.

-->

To disconnect from the CVW Server, type:

quit

5. Starting and Testing the Operation of the CVW Document Server

• To start the CVW Document Server, run the following command as root:

/etc/init.d/cvwds start

• The operational status of the CVW Document Server can be tested from any workstation on the network that is running a Web browser. Enter the following URL:

http://<doc-server-hostname>:<doc-server-port-number>
Example: http://server.mitre.org:8889

If the Document Server is operational, a web page indicating the operational status will appear.

The CVW Document Server
The Document Server can be accessed only through the CVW at this time. Please use your CVW client to access documents and document information. Thank you.
Administrators can click here to log in.

Last update: 31 October 2000

This work, including the source code, documentation and related data, is placed into the public domain.
The original author is The MITRE Corporation.

THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, AS TO THIS SOFTWARE, OR TO THE ACCURACY, CAPABILITY, EFFICIENCY, OR FUNCTIONING OF THIS SOFTWARE OR ANY DERIVATIVE WORK OR OTHER ITEM MADE, USED, OR SOLD THAT INCORPORATES THIS SOFTWARE. THE AUTHOR OF THIS SOFTWARE ASSUMES NO RESPONSIBILITY FOR ANY CONSEQUENCE RESULTING FROM THE USE, MODIFICATION, OR REDISTRIBUTION OF THIS SOFTWARE.

Information in this document is subject to change without notice.
Other products and companies referred to herein are trademarks or registered trademarks of their respective companies or mark holders.