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.
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:
The Enterprise Data Connectors are included in the Developer Editions and can be used to develop only. They are sold separately for deployment in a production environment in the Enterprise Edition.
You don't have to use the compiler SilverStream ships; you can install a different compiler if you choose. You specify the compiler you are using by setting a preference in the Main Designer. See the release notes for the list of supported compilers.
SilverStream is both a development and deployment product. It is available in these configurations:
In a multi-developer environment, the recommended configuration is for each developer to have a SilverStream Server and Designer running on the same machine. Each developer should also have a Sybase Adaptive Server Anywhere database on their machine, so that each server can store its own version of the design data. In addition, you should install a source control system to ensure that changes made by developers are not overwritten by other developers.
The chief benefit of configuring one server per designer is that each developer can have a sandbox environment, that is, a space to develop, test, and build applications independently. A developer is not affected by changes made by other developers on a shared server, until that developer chooses to get those changes from source control.
If this multi-developer model is not appropriate for you, you can use the Developer Edition along with the Workgroup or Enterprise Edition to do development using a shared server: You would install the Designer (tools) component from the Developer Edition and use the server from the Workgroup or Enterprise Edition.
It includes the SilverStream Application Server, SilverCmd, SilverJRunner, the SilverStream Management Console, Fulcrum SearchServer, and the JBroker ORB. It does not include development tools, Sybase Adaptive Server Anywhere, or sample databases.
The Workgroup Edition server is licensed by number of users.
As with the Workgroup Edition, you can also use Enterprise Edition in group development environments.
The Enterprise Edition server is licensed by CPU.
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 install.sh starts a PERL script to install and configure the SilverStream Application Server on UNIX.
The SilverStream installation performs the following tasks.
The installation creates an ODBC data source (DSN) for the SilverMaster and the sample applications being installed. (Windows only)
The SilverMasterInit program creates the SilverMaster database tables and uploads the SilverStream resources needed to support both the design-time and runtime environments into the SilverMaster database.
Before you install SilverStream, you should decide the following:
The SilverStream Server requires that one database be set up as the SilverMaster database.
For more information about SilverMaster, see the next section.
The Fulcrum SearchServer engine allows you to use full text search in applications or in the SilverStream Help database.
The sample databases shipped with the SilverStream product are Sybase Adaptive Server Anywhere databases. You must install Sybase Adaptive Server Anywhere to access these databases (Adaptive Server Anywhere is not available on UNIX).
SilverStream delivers the help system as a file system and/or as a Sybase Adaptive Server Anywhere database. Installing the help system as a database lets you use Fulcrum's full text search. You must install Adaptive Server Anywhere to access it (Adaptive Server Anywhere is not available on UNIX).
You can install the full SilverStream product or just specified components.
For more information, see Choosing the installation type.
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.
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.
SilverStream provides several types of installation that let you tailor the environment to your needs. Your choices include:
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.
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.
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.
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.
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.
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.
The following table lists the SilverStream programs that can also run as services or daemons.
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.
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:
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.
Because you already installed the server as a program in step 1, no files are copied when you change the server to run as a service. You also will not need to run SilverMasterInit or create any properties files.
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.
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.
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.)
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.
If you want to maintain both SilverStream Version 2 and Version 3, then you must:
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.
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.
In addition, please be prepared to provide the following information about the problem you have.