Installation Guide

Chapter 1   Introduction

This chapter presents an overview of the SilverStream Application Server and the SilverStream installation program. The SilverStream installation program is self-documenting, that is, it includes documentation in the installation screens. There are some decisions you should make before installing SilverStream. This chapter helps you make those decisions.

The chapter includes the following sections:

    For the latest information on hardware and software requirements and supported databases, see the SilverStream Application Server release notes. In Windows, you can access the release notes from the SilverStream program group or from SilverStream online help.

SilverStream components and packaging   Top of page

The SilverStream Application Server Version 3 product family consists of the following:

    For more information about these editions, see Application server configurations.

The SilverStream distribution CD contains the following:

Application server configurations   Top of page

SilverStream is both a development and deployment product. It is available in these configurations:

About the installation program   Top of page

The Windows NT installation program is a wizard-based InstallShield program that allows you to select and install the various components of the SilverStream Application Server, Designer, documentation, and sample applications. This program also provides interfaces to Sybase Adaptive Server Anywhere and Fulcrum SearchServer.

The UNIX installation script starts a PERL script to install and configure the SilverStream Application Server on UNIX.

The SilverStream installation performs the following tasks.

Installation decisions   Top of page

Before you install SilverStream, you should decide the following:

Choosing a database for SilverMaster   Top of page

The SilverMaster database catalog is a database used by SilverStream. There is one SilverMaster catalog for each SilverStream Server or SilverStream cluster. The SilverMaster keeps track of all of the application databases used by the SilverStream Server and also holds the SilverStream system tables, for example, tables containing security group and user information.

NOTE   Do not put any other database objects in your SilverMaster database catalog, as you may lose SilverStream objects if you have to rebuild your SilverMaster database.

SilverStream provides Sybase Adaptive Server Anywhere as the default database for this purpose on Windows, though you can choose any supported DBMS. If you install on UNIX, you will have to choose another DBMS for your SilverMaster database.

The SilverStream Server is capable of communicating with multiple database engines at once. For example, you can install your SilverMaster database on Sybase Adaptive Server Anywhere and have all of your application databases in another database, such as Oracle.

Preparing the database to be a SilverMaster

The SilverStream Server must connect to a database that is to be used as the SilverMaster and any other databases you want to access from SilverStream. The SilverStream Server acts as a database client, so the server requires any database client software, ODBC driver, JDBC driver, and any configuration necessary for an application connecting to a particular database.

In all cases the SilverStream Server will need to access the database(s) through a database user account. If you do not install Sybase Adaptive Server Anywhere and will instead another DBMS as your SilverMaster, then you must also install the appropriate database drivers.

Your database may also require you to create an ODBC data source (DSN) for your database. SilverStream's Windows NT installation program will create an ODBC System DSN for a Sybase Adaptive Server Anywhere SilverMaster using the database user account dba.

The steps for setting up a database differ for each database type. See the appropriate chapter in this guide for more information about setting up your database type.

    For more information about the SilverMaster database, see the Administrator's Guide.

Choosing the installation type   Top of page

SilverStream provides several types of installation that let you tailor the environment to your needs. Your choices include:



Typical Install

Installs all the necessary SilverStream Software program files for the edition you are installing. For the Developer Edition, this includes the Help database (SilverHelp3, a Sybase Adaptive Server Anywhere database) and all of the sample applications. It creates any ODBC settings that are needed by the sample databases, but it does not add them to your server. You must perform an Add Database in order to access a particular sample application database. This installation is recommended for most users.

This option is available with all SilverStream products.

Full Install

Installs all the necessary software for your edition. For the Developer Edition it also adds all of the sample application databases to your server (if Sybase Adaptive Server Anywhere is found on your system). If you do this type of install, the SilverStream Server starts all of the database engines for the sample application databases as part of the server startup. A server running with all samples added should have at least 256 MB of memory available. This option is provided for the convenience of users who want to explore SilverStream's sample applications at once.

This option is available with all SilverStream products.

Designer Only

Installs the Silverstream Designer, SilverJRunner, and the file system-based version of Help. The SilverStream Server will not be installed. This option should be used only if you will be developing all of your applications against a SilverStream Workgroup or Enterprise Edition Server located on another computer.

This option is available for the SilverStream Developer Edition.


Allows end-users to run SilverStream Java forms and views without a browser. Users can also download SilverJRunner from the SilverStream Server.

This option is available for the SilverStream Developer Edition.

Cluster Managers

Installs the SilverStream Load Balancer, Dispatcher, and Cache Manager. This option is for server administrators who want to install the load balancing tools on a different computer than the SilverStream Server.

This option is available for the SilverStream Enterprise Edition.

Custom Install

Allows you to choose exactly which components are installed. Use this option to install the Enterprise Data Connector components.

This option is available with all SilverStream products.

About the sample applications

SilverStream provides a set of sample application databases that can be used as programming examples or can be run in a user environment. They are distributed as Sybase Adaptive Server Anywhere databases, so you must have Sybase Adaptive Server Anywhere installed in order to access them.

    For more information, see the description of the sample applications in Getting Started in online help.

Installing the SilverStream Server and programs to run as a service or a daemon    Top of page

When you are running high-availability servers in a multi-user environment it often makes sense to run servers as a Windows NT service or as a UNIX daemon. Running the SilverStream Server and the database server as a service or daemon on the same machine ensures that both services will restart automatically when the machine reboots. You can set the SilverStream Server to run as a service or a daemon using the Installation program. By default, the SilverStream Server runs as a desktop program, not as a service or a daemon.

Running the SilverStream Server as a service or a daemon allows you to

NOTE   To view or log server debugging information when running the SilverStream Server as service or a daemon, use the Server Console in the Designer. For more information, see the section on Using the Server and Java consoles in the online Tools Guide. For information about generating and storing server logs, see the section on SilverStream Server logging when run as a service in the Administrator's Guide.

SilverStream programs that can run as services or daemons

The following table lists the SilverStream programs that can also run as services or daemons.



Runs as

SilverStream Server

Serves applications.

By default, runs as a desktop program.

Load Manager

Manages the activity of the servers in a cluster.

Usually run as a desktop program.


Monitors the server status and attempts to restart the server if it terminates abnormally.

Usually run as a desktop program.


Redirects requests to SilverStream Servers.

Usually run as a desktop program.

Cache Manager

Keeps server caches for clusters in synch.

Usually run as a desktop program.

NOTE   By default, Sybase Adaptive Server Anywhere or Sybase SQL Anywhere run as desktop programs though they can also be run as services. For more information, see Configuring Sybase Adaptive Server Anywhere and SQL Anywhere Databases.

Guidelines on setting SilverStream to run as a service or daemon

You can configure the SilverStream Server to run as a service or daemon when you initially install the server using the Installation program. However, it's often easier to install the SilverStream Server as a desktop program, then test it before configuring it to run as a service or daemon. The following steps are recommended when installing the server as a service or daemon.

To set up the SilverStream Server to run as a service or daemon:

  1. Install the SilverStream Server as a program (not a service or a daemon) and create a SilverMaster database as described in Installing SilverStream on Windows or Installing SilverStream on UNIX.

  2. After your SilverMaster database has been created or updated, configure your database server to start as an automatic service using NT services.

    NOTE   The SilverStream Server service requires that the database is running when the server starts. By default, the Sybase Adaptive Server Anywhere database is not installed as a service. For more information, see Step 4: Run Sybase ASA or SQL Anywhere as a service.

  3. If you haven't already done so, set up any other services that you want to run with the SilverStream server such as Fulcrum or SNMP.

  4. Verify that the SilverStream Server is running properly. For more information, see Testing the install for NT or Testing the install for UNIX.

  5. Run the SilverStream Installation program a second time using one of the following procedures:

  6. If you are using NT security in your application, you should change the NT Security settings on your machine using the NT User Manager.

    NOTE        For more information on setting User Rights Policy for SilverStream, see the section on NT Security in the Administrator's Guide. For more information about the operation and administration of services, see the Windows NT documentation.

Migrating to Version 3   Top of page

You cannot upgrade directly from SilverStream Version 1.x to Version 3. You must first upgrade to SilverStream 2.0. Contact your sales representative to obtain the appropriate software.

Migrating a SilverMaster   Top of page

During installation (on Windows and Solaris platforms only), you are asked if you want to upgrade a Version 2 SilverMaster. To migrate from Version 2 to Version 3, choose "use an existing database for your SilverMaster." (If, instead, you specify to create a new SilverMaster, you will need to respecify all your previous server properties, including your users and groups, and re-add databases to the server.)

Upgrading application databases   Top of page

When you start the Version 3 SilverStream Server, it upgrades every database referenced by the SilverMaster. Once upgraded to Version 3, you cannot access it with a Version 2 Designer or Server.

Once you have successfully started your Version 3 SilverStream Server and all of the databases have been upgraded to Version 3, you can turn off the auto-upgrade feature to reduce server startup time. Set the following line in the SilverStream\resources\httpd.props file: 

    For information about migrating from SilverStream Version 2 to Version 3 post-installation, see the migration document in Getting Started in online help.

Maintaining multiple versions of SilverStream   Top of page

If you want to maintain both SilverStream Version 2 and Version 3, then you must:

  1. Create a new SilverMaster database for the SilverStream Version 3 server.

  2. Create an ODBC DSN entry for the new database (if required for that database type).

  3. During the installation procedure choose "Use an existing database for SilverMaster" and "Initialize the SilverMaster database" and point the installation program to the new SilverMaster database.

  4. Continue with the install and respond to the installation wizard as appropriate for you database type.

If you install a new version of the help database or the sample applications, you will not be able to use them from an earlier version of the product.

If you want to run both servers at once, you must specify different ports.

    For more information, see the chapter on running the server in the Administrator's Guide.

Contacting Technical Support   Top of page

SilverStream provides extensive online product support at its Web site: 

In the Services section of the SilverStream Web site, you can learn about the Technical Support programs and how to contact Technical Support. You can also access FAQs, tips and tricks, known customer issues, patches, links to related information, and so on. You can also use this area to submit problems, questions, and enhancement requests.

To access the member area, you must provide a user ID and password, which you receive when you register your product. The Installation program provides the opportunity to register the product after you complete the install.

If you contact SilverStream Technical Support for assistance, you will be asked to provide the information about your environment contained in the following checklist.



SilverStream version

You can obtain the build number by right-clicking the microhelp line at the bottom of the Main Designer. Also:

  • The build number is displayed at server startup.

  • The build number is displayed in the SMC in the General panel in Configuration options.

Product type

Developer Edition, Workgroup Edition, or Enterprise Edition.

Operating system

The platform for your Designer and Server (NT or UNIX platform).

Database platform for SilverMaster

The DBMS you are using for your SilverMaster.


Type or types of DBMSs you are using with the SilverStream Server, including versions.

Database driver

The type and version of the database driver you are using.

Browser and Designer configuration

Whether the Designer and browser are running on the same machine.


The version of Internet browser you are using.

Java Virtual Machine version (JVM)

Display the version of your JVM by starting the SilverStream Server with the -jvmversion startup option.

Proxy servers and firewalls

Whether you are using a proxy server or firewall in your system configuration.

In addition, please be prepared to provide the following information about the problem you have.

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