Beruflich Dokumente
Kultur Dokumente
Page
Preface
vii
Related publications
Reader comments
vii
vii
viii
viii
Executable files
Home page
11
11
12
12
13
SG6104 1.2
11
iii
Contents
Procedure 2:
Example 1:
Upgrade steps
Upgrade example
14
14
16
17
18
19
22
23
24
24
24
Parsing of DWEB_HOST_ACL
Example 4:
Enabling authentication
Procedure 5:
Adding users
Procedure 6:
Verifying users
Procedure 7:
Deleting users
Authentication troubleshooting
25
25
26
26
27
27
28
Index
iv
21
29
SG6104 1.2
Contents
Page
Figures
Figure 1.
Tables
Table 1.
SG6104 1.2
Preface
Related publications
The following documents contain additional information that may be helpful:
Online Software Publications Installation Guide, publication SG6105
DynaWeb Client User Guide, an EBT publication, available from the URL
http://dynaweb.ebt.com/ebtdoc/client
SG6104 1.2
vii
Preface
Conventions
The following conventions are used throughout this document:
Convention
Meaning
command
variable
user input
Reader comments
If you have comments about the technical accuracy, content, or organization
of this document, please tell us. You can contact us in any of the following
ways:
Send us electronic mail from any system connected to the Internet, using
the following Internet address:
publications@timbuk.cray.com
viii
SG6104 1.2
Preface
SG6104 1.2
ix
SG6104 1.2
SG6104 1.2
data and send it to the browser. After sending the requested information, the
server terminates its connection.
As an alternative to running DynaWeb as a server, another HTTP server can
serve Online Library documents. In this case, the HTTP server runs the
DynaWeb SGML-to-HTML converter as a common gateway interface (CGI)
script. For information on running DynaWeb as a CGI script, see Section
2.1.2, page 12.1
Note: The Cray DynaWeb server has been tested using Netscape
Navigator 2.02. The server is also accessible using the Mosaic and Lynx
browsers; however, tables are not fully supported. Other browsers may
work but are not explicitly supported by the server.
Deferred implementation.
SG6104 1.2
path
binplatform
cgi-bin
data
logs
config
servroot
styles
security
docs
icons
images
library
alt
help
summary
a10528
Directory
Description
bin
Executable files.
cgi-bin
data/config
data/security
Licensing file.
SG6104 1.2
data/styles
logs
servroot
servroot/C
servroot/docs
servroot/icons
help
summary
servroot/images
servroot/library
SG6104 1.2
Program
Description
dynaweb
dwpasswd
SG6104 1.2
dwsgml2html
The log files can grow large and should be cleaned up as part of your regular
maintenance procedures. If you prefer, you may deactivate logging of
accesses by changing the value of DWEB_ACCESSLOG to OFF in the DynaWeb
Deferred implementation.
SG6104 1.2
Vendor
Hardware
OS and levels
Software file
DEC
Alpha series
OSF/1 3.x
dynaweb10_decosf.tar
Hewlett-Packard
HP 9000 series
HP-UX 9.x
dynaweb10_hp.tar
IBM
RS 6000
dynaweb10_ibm.tar
Deferred implementation.
SG6104 1.2
Vendor
Hardware
OS and levels
Software file
Silicon Graphics
IRIX 5.x
dynaweb10_sgi5.tar
Sun Microsystems
SPARC series
Solaris 2.x
dynaweb10_sun5.tar
SG6104 1.2
SG6104 1.2
11
You may need to restart the DynaWeb server manually. If you do, enter the
following commands:
# cd /path
# ./start.stop.dynaweb.sh
12
Deferred implementation.
SG6104 1.2
5. Check to see whether the icons and images directories already exist,
as follows:
# cd ../..
# ls -d icons images
If you get an error message for either directory, it does not exist.
6. For each directory that already exists, copy the contents of the
corresponding DynaWeb directory, as follows:
# cp - r /path/servroot/icons/* icons
# cp /path/servroot/images/* images
7. For each directory that does not exist, create links to the /path/
servroot/icons and /path/servroot/images directories:
# ln -s /path/servroot/icons .
# ln -s /path/servroot/images .
SG6104 1.2
13
you whether you want to upgrade the server or destroy the existing server
and replace it with the software and documents from the new CD-ROM.
6. When you are prompted, specify the full path name to the DynaWeb
server. This is the /path directory under which the DynaWeb
servroot directory exists.
14
SG6104 1.2
% ./install
Checking for system utilities the installation scripts need:
cat
cp
cut
fgrep
grep
ls
mkdir
mv
rm
sed
sh
sort
tar
uname
uncompress
Type the full path of the base DynaWeb directory
(RETURN quits): /var/tmp/dynaweb
It appears that DynaWeb is already installed in /var/tmp/dynaweb/
Do you want to upgrade that servers document base with the documents from
this CD, or destroy that existing DynaWeb server and documentation,
(*everything* under "/var/tmp/dynaweb"),replacing it all with the
software and documents from this CD?
U = Upgrade
(the default)
D = Destroy
u
Proceeding with upgrade
Install dynaweb_11 documents (1MB)? (y/n) [y] n
Install sws_200 documents (4 Mb)? (y/n) [y] y
First remove old sws 110 documents? (y/n) [y]
Unpackaging tar file... done
Updating local script paths... done
Updating and indexing DynaWeb collections...
SG6104 1.2
15
16
SG6104 1.2
SG6104 1.2
base_dweb_dir
dweb_hardware_bin_dir
17
[n]
[n]
The Craydoc files must be on a file system that is either mounted on the
machine running DynaWeb or cross-mounted so as to be accessible to it.
Is this the case? [n] y
You will need write permission to:
* Each Craydoc collection directory
* Each Craydoc book directory (.../{collection}/books/{book_number})
* Each Craydoc books style directory (
^--> /styles)
* The DynaWeb library directory (.../servroot/library)
* The DynaWeb all collection (.../servroot/library/all/books)
* The DynaWeb all book list (.../servroot/library/all/booklist.txt)
* The DynaWeb all index (.../servroot/library/all/libidx)
* The DynaWeb topics page (.../servroot/docs/topics.html)
This script checks for these permissions, but if you dont have them it
must quit in mid-conversion. Consequently, its best to be sure,
before starting, that you have these permissions. Do you? [n] y
Enter the full path name to the Craydoc installations master .ebtrc file:
/var/tmp/cdoc/.ebtrc
Processing "UNICOS Features 9.0.2" ...
Processing "Basic Admin & Operations 9.0.2" ...
18
SG6104 1.2
SG6104 1.2
19
SG6104 1.2
21
Function
DWEB_PASSWD_FILE
22
SG6104 1.2
Meaning
Host names with the exclamation point (!) in front of them are
not allowed to access the server.
Because the wildcard * (asterisk) is equal to all host names, using it means
that all hosts are allowed access. This is necessary if you wish to allow full
access to your server from the Internet, because you have no way to
determine ahead of time who will request access. To deny access to all hosts
but the ones you specify, remove the * and replace it with the names of the
hosts you want. Wildcards can be combined with partial host names to allow
or disallow groups of clients. For example, the line DWEB_HOST_ACL =
*.company.com allows any user from company.com to access your server.
You can also use the exclamation point (!) to name a specific host or group of
hosts you do not want to access the server. If you add the ! to the example
above, (DWEB_HOST_AUTH = !*.company.com), no one from company.com
can browse the server.
The following example shows the effect of various uses of the parameter:
SG6104 1.2
23
To allow everyone but the hosts at first.com to access the server, use the
following syntax:
DWEB_HOST_ACL = !*.first.com *
Ensure that you list exclusions first, as described in Example 4, page 24.
24
SG6104 1.2
Unfortunately, this syntax does not deny the competitor access. Because the
parser checks the list from left to right, the first thing it encounters is the
asterisk, which matches any host name by definition. Because the parser has
found an entry that it can match to the host requesting access, it stops
looking and accepts the request. The parser never encounters the qualifying
statement !*.competitor.com, which would have denied access to this
particular requestor.
A good rule of thumb when dealing with the DWEB_HOST_ACL parameter is
to start with the specific and end with the general. To deny the competitor
access, use the following syntax:
DWEB_HOST_ACL = !*competitor.com *
SG6104 1.2
25
4. Edit the password file as described in Section 3.3, page 26. The
password file is an NCSA-style password file.
5. Restart the DynaWeb server, as follows:
# cd /path
# ./start.stop.dynaweb.sh
26
SG6104 1.2
name of the user at the prompt, you do not need to enter quotation
marks. You do need quotation marks if you use the -a option.
3. After you have entered all of the information, the dwpasswd program
prompts you to repeat the process. This repetition ensures accuracy of
the information.
4. To exit the program, press ENTER without typing a user name.
SG6104 1.2
27
3. Write the file and exit the editor. That user no longer has access to the
server.
28
SG6104 1.2
Index
A
Access lists
adding users to . . . . . . .
deleting users from . . . . .
maintaining for HTTP
authentication . . . . . .
verifying users in . . . . . .
Access logs . . . . . . . . . .
maintaining . . . . . . . .
Adding documents to server . . .
alt subdirectory
contents . . . . . . . . . .
Authentication
HTTP
adding users to access lists .
deleting users in access lists
enabling . . . . . . . . .
maintaining access lists for .
troubleshooting . . . . . .
verifying users in access lists
. 26
. 27
.
.
.
.
.
26
27
. 8
19
13
. . 5
.
.
.
.
.
.
26
27
25
26
28
27
. 14
. 12
3, 8
. 12
. . 4
3, 8
. 12
. . 4
.
.
.
.
18
16
18
16
. 18
. 18
bin directory
contents . . . . . . . . . . . . 4
Book Summary pages
location in directory structure . . . 5
Browsers supported . . . . . . . . 3
SG6104 1.2
CD-ROM
mounting . . . . . . . . . .
CGI . . . . . . . . . . . . .
CGI scripts . . . . . . . . . .
running DynaWeb as . . . .
cgi-bin directory
contents . . . . . . . . . .
Common gateway interface (CGI)
scripts . . . . . . . . . .
running DynaWeb as . . . .
config subdirectory
contents . . . . . . . . . .
Converting CrayDoc files
example . . . . . . . . . .
CrayDoc file conversion . . . . .
example . . . . . . . . . .
CrayDoc graphics . . . . . . .
craydoc2dynaweb.pl program
example . . . . . . . . . .
running . . . . . . . . . .
data directory
config subdirectory . . . .
security subdirectory . . .
styles subdirectory . . . .
Directory contents
DynaWeb server . . . . . .
. . . 4
. . . 5
. . . 5
. . . 4
29
Index
Directory structure
DynaWeb server . . . . . . . . . 4
Document base
upgrading . . . . . . . . . . 13
DWEB_ACCESSLOG parameter
dynaweb.cfg file . . . . . . . . 21
DWEB_HOST_ACL parameter
dynaweb.cfg file
description . . . . . . . . . 22
parsing . . . . . . . . . . 24
syntax . . . . . . . . . . . 23
using wildcards . . . . . . . 24
DWEB_PASSWD_FILE parameter
dynaweb.cfg file . . . . . . . . 22
enabling HTTP authentication 25
dwpasswd program . . . . . . . . 6
dwsgml2html program . . . . . . . 7
dynaweb program . . . . . . . . . 6
starting . . . . . . . . . . . 11
DynaWeb software files
for supported hardware . . . . . 8
dynaweb.cfg file
creating links to
to run DynaWeb as CGI script 13
DWEB_HOST_ACL parameter
description . . . . . . . . . 22
parsing . . . . . . . . . . 24
syntax . . . . . . . . . . . 23
using wildcards . . . . . . . 24
DWEB_PASSWD_FILE parameter
22, 25
enabling HTTP authentication in 25
setting DWEB_ACCESSLOG
parameter . . . . . . . . 21
30
E
Error codes
servroot/C directory
Error logs . . . . .
maintaining . . .
Executable files . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 5
. 8
19
. 6
H
Hardware platforms supported . . . 8
help subdirectory
contents . . . . . . . . . . . . 5
Home page
changing/adding links
caution against . . . . . . . . 7
Online Library . . . . . . . . . 7
HTTP authentication
adding users to access lists . . . 26
deleting users from access lists . 27
enabling . . . . . . . . . . . 25
maintaining access lists for . . . 26
troubleshooting . . . . . . . . 28
verifying users in access lists . . 27
Hypertext mark-up language (HTML) 1
I
icons subdirectory
contents . . . . . . . . . . . . 5
images subdirectory
contents . . . . . . . . . . . . 5
creating links to
to run DynaWeb as CGI script 13
install script
SG6104 1.2
Index
. . . . . 14
L
library subdirectory
contents . . . . . . . . . . .
Links
changing/adding on home page
caution against . . . . . . .
creating to dynaweb.cfg file
to run DynaWeb as CGI script
creating to images subdirectory
to run DynaWeb as CGI script
Logs
access and error . . . . . . . .
maintaining . . . . . . . .
logs directory
contents . . . . . . . . . . .
Lynx support . . . . . . . . . .
. 5
Online Library
home page . . . . . . . . .
interface . . . . . . . . . .
location in directory structure .
Operating system levels supported
Overview of server . . . . . . .
.
.
.
.
.
.
.
.
.
.
7
2
5
8
1
. 7
P
13
13
. 8
19
. 5
. 3
M
Mosaic support . . . . . . . . . . 3
Mounting the CD-ROM . . . . . . 14
N
Netscape Navigator support . . . . . 3
Network connections
establishing on server . . . . . . 3
SG6104 1.2
Port number
server . . . . . . . . . . . . . 2
S
security subdirectory
contents . . . . . . . .
Server
connections . . . . . . .
features . . . . . . . .
overview . . . . . . . .
port number . . . . . .
root directory . . . . . .
upgrading document base
servroot directory
C subdirectory . . . . .
contents . . . . . . . .
docs subdirectory . . . .
help subdirectory . . .
summary subdirectory .
icons subdirectory . . . .
alt subdirectory . . . .
images subdirectory . . .
library subdirectory . . .
. . . . 5
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
. 1
. 1
. 2
. 5
13
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
5
5
5
5
5
5
5
5
5
31
Index
SGML
definition . . . . . . . . . .
SGML-to-HTML conversion . . .
Standard generalized mark-up
language (SGML) . . . . .
start.stop.dynaweb.sh script
enabling HTTP authentication
location . . . . . . . . . .
running . . . . . . . . . .
styles subdirectory
contents . . . . . . . . . .
summary subdirectory
contents . . . . . . . . . .
system.startup.dynaweb.sh script
32
location
. . . . . . . . . . . . 6
. . 1
1, 2
U
. . 1
. 26
. . 6
. 12
. . 5
. . 5
. 11
W
Web browsers supported . . . . . . 3
SG6104 1.2