Administrator's Guide



Contents


Preface

Purpose
Audience
Organization

Chapter 1: Administration Quick Reference

SMC panels
Configuration options
Security options
Monitor options
Administration tasks
Database configuration
General server management
Security
Tuning and performance
Load balancing and failover
Using the Server Administration API
Troubleshooting

Part I    Administration Basics

Chapter 2: Administration Overview

The SilverStream Application Server
Three-tiered communications
Application Server environments
SilverStream administration
Client administration
Database administration
Server administration
The SilverStream Management Console (SMC)
Running the SMC
The SMC user interface
Logging in
Logging out
Online help

Chapter 3: Server Configuration

Server configurations
Production environment
Development environment
Firewalls and proxy servers
Configuration with a firewall and proxy server
Network configurations
Simple intranet configuration
Intranet cluster configuration
Simple Internet configuration
Internet cluster configuration
Demilitarized Zone Internet configuration
Group development configuration
HTTP server and Web basics
Uniform Resource Locators (URLs)
SilverStream resources
HTTP communications
Session management
Cookies
Application Server features
Client connections
Servlet support
Application presentation

Chapter 4: Database Configuration

Setting up a supported database
Setting up the database
Setting up database accounts
Communicating with the SilverStream Server
SilverStream database configuration
Supported databases
Database access
The SilverMaster database catalog
SilverMaster functions
Data access and queries
Data source objects
JDBC and SilverStream queries
Connecting to the database
Configuring the database
General database administration
Moving the SilverMaster database
Moving an added database
Database-level administration

Part II    Administering the Server

Chapter 5: Running the Server

Starting the SilverStream Server
Starting the server in Windows NT
Using startup options
Starting the server on UNIX
Starting the server on a specific IP address or hostname
Shutting down the SilverStream Server
Restarting the SilverStream Server
Specifying general server properties
Using server logging
SilverStream Server logging properties when run as a service
Specifying RMI settings
Running multiple servers on one host
Specifying unique ports
Properties shared by all servers in a cluster

Chapter 6: Setting Up Users and Groups

About Silver Security users and groups
Managing Silver Security users and groups
Adding Silver Security users
Editing user properties
Adding Silver Security groups
Using the Locksmith privilege

Chapter 7: Maintaining the Server

Administering a SilverStream Server remotely
Setting up mail on the server
Managing licenses
About licenses
Setting the AGCLASSPATH variable
Maintaining Enterprise JavaBeans
Setting Fulcrum full text properties
Monitoring server activity
Displaying charts of server activity
Displaying logs
Displaying views of server statistics
Integrating with existing Web servers
Using SilverJunction

Chapter 8: Setting Security

Security configuration
Security architecture
Security functions
Establishing a secure connection to the server
Establishing a secure connection between a Java client and the SilverStream Server
Establishing a secure connection between an HTML client and the SilverStream Server
Accessing security provider systems
Adding security provider access
Using NT security
Using LDAP security
Using NisPlus security
Accessing users and groups
Security provider login formats
Overriding defaults for login name components
Using certificates
About certificates
Creating and installing server certificates
Viewing server certificates
Enabling RSA/DSA ports
Turning off HTTP communications
Restricting SSL cipher suites
Managing Certificate Authorities
Installing and managing client certificates
Enabling authentication
Setting up access control
Permission types
Default object security
How access works
Changing access
Setting permissions
Excluding robots
Locking down an application or a server
Locking down an application
Locking down a server
Security checklist
Securing the production server
Securing the development server
Securing server administration

Chapter 9: Tuning the Server

Managing database connections
About database connections and performance
Setting the maximum and minimum number of database connections
Using prefetch buffers
Setting performance parameters
Managing client connections
Client sessions and threads
Client connection parameters
Managing the server content cache

Chapter 10: Administering a Cluster

Server clustering
Cluster components
The Cache Manager
The Load Manager
The Dispatcher
Component failover
Persistent failure
Setting up a server cluster
Starting the clustering components
Installing cluster servers
Creating the cluster profile
Restarting the clustered servers
Administering a server cluster
About properties in a clustered environment
Setting cluster-level properties
Setting server-level properties in a cluster
Specifying a server's relative load weight
Managing failover
Cache Manager properties
Load Manager properties
Dissolving a cluster
Changing the clustering components' properties
Installing certificates in a cluster
Setting up Fulcrum in a cluster
Setting up Fulcrum on Windows NT
Setting up Fulcrum on UNIX

Chapter 11: Using the Server Administration API

Introduction to the Administration API
How the Administration API is organized
How server objects are organized
More about containers and elements
The programming environment
Getting started with the Administration API
Obtaining a server object from a client application
Obtaining a server object from a server application
Getting a server's properties
Working with server elements
Where to go from here

Chapter 12: Troubleshooting

Using error logging
Low-level debugging
Setting JDBC/ODBC tracing
Using the Watcher
Problems starting the SilverStream Server
Business object generating errors
Database not synchronized
Using SilverMonitor
Using the SilverMasterInit program
Command-line options
Using SilverMasterInit to recreate or refresh SilverMaster
Regaining access to SilverMaster
Handling a stack overflow
Miscellaneous issues
Browser issues
Server appears to be hung
Socket exceptions
Calling Technical Support

Part III    Appendixes

Appendix A: The httpd.props File

Server properties

Appendix B: The SilverStream SNMP Agent

SNMP implementation overview
How the SilverStream components work
Process flow and terminology
Setting up SNMP for the SilverStream Server
Installing SNMP as a service
Installing SilverStream on the server
Enabling the scheduled business object
Testing the program
SilverStream ID and OIDs

Appendix C: SilverStream System Tables and URLs

SilverStream internal system tables
SilverStream database URLs





Copyright © 2000, SilverStream Software, Inc. All rights reserved.