Installation Guide
|
|
Installation Guide |
This chapter describes the SilverStream Application Server Installation program for Windows platforms.
See the Release Notes for the latest information on the following:
NOTE For updated information about installing SilverStream, see the Release Notes.
Before you install the SilverStream server, make sure that you have created and configured a database to be used as your SilverMaster database (unless you will use Cloudscape or Sybase Adaptive Server Anywhere as your SilverMaster; in this case, the Installation program can create the SilverMaster database). See the appropriate chapter in this guide for information on setting up your database type. See the Release Notes for the database versions and drivers supported for your platform.
The installation wizard is self-documenting. You can use the documentation provided by the wizard to respond to the prompts. This section describes the parts of the installation that might require additional information not provided by the wizard.
Exit all Windows programs, including Microsoft Outlook, before running the Installation program. Otherwise, the Installation program might not be able to proceed.
Insert the SilverStream CD into the CD-ROM drive. The Installation program automatically starts.
The Setup Welcome screen appears and the Release Notes are displayed.
The Release Notes contain important information. Please take the time to read these notes carefully before continuing.
The installation displays the SilverStream license agreement. To install SilverStream, you must accept this agreement.
Choose Install software and select Next to continue.
You come to a panel similar to the following.
NOTE You won't see the choice for Sybase Adaptive Server Anywhere if you are installing SilverStream Enterprise or Workgroup Edition; the authenticated version of Adaptive Server Anywhere is available only with SilverStream Developer Edition. If you want to use Adaptive Server Anywhere with SilverStream Enterprise or Workgroup Edition, you need to purchase the full DBMS from Sybase.
Choose Install SilverStream and optionally Fulcrum Search Server and Sybase Adaptive Server Anywhere.
Install Fulcrum Search Server if you want to create applications that are full-text searchable or if you want to use full-text search with the SilverStream help database (which also requires Sybase Adaptive Server Anywhere).
Fulcrum is installed into the SilverStream installation directory, so you cannot install Fulcrum without installing (or having previously installed) SilverStream.
Install Sybase Adaptive Server Anywhere if you want to use that DBMS as your SilverMaster or application database, if you want to access the online help using the help database, or if you want to run the SilverStream sample applications.
If you choose to install Adaptive Server Anywhere, the ASA Installation program will launch. You can choose all the defaults, including to install the Personal Server edition of ASA. Once that installation is complete, you will return to the SilverStream Installation program.
You come to a panel similar to the following (your choices may be different, depending on which edition of SilverStream you are installing). Choose the appropriate installation type and choose Next.
For information about when to choose each of these types, see
Choosing the installation type.
Continue through the install until you come to a panel that prompts you to configure the SilverStream server.
If you are running the Installation program for the first time, accept the defaults and choose Next to configure the server (run SilverMasterInit).
You will see a prompt about installing a new server configuration file (httpd.props) if you are installing this version over an existing version. Select the check box if you want to create a new httpd.props file; deselect the check box if you want to maintain your existing httpd.props file.
This panel also lets you install the SilverStream server as a service.
If you select the Install the SilverStream server as a Service option, see
Installing the SilverStream server as a service for more information.
When you encounter the prompt in the following panel, specify the database type of your SilverMaster database.
If you select Informix Cloudscape or Sybase Adaptive Server Anywhere, you can specify that the SilverStream installation wizard create a new database or use an existing database. For all other database types, you must use an existing database that you have already configured for use as a SilverMaster database. The configuration requirements are described in this guide in the database-specific chapters.
For more information about configuring each of the database types, click the Launch database help for databaseName button for the selected database. The corresponding chapter of this guide is opened.
If you are upgrading from a previous release of SilverStream and chose to upgrade your existing SilverMaster, you see the following panel.
If you choose Initialize the SilverMaster database, the install procedure upgrades the database to the current version and also removes any existing database tables and user information. You need to initialize SilverMaster in order to take advantage of security enhancements made in Version 3.7.
If you choose Upgrade your existing 2.5 or 3.x SilverMaster, the install procedure upgrades the database to the current version but retains all of the database tables and user information.
Choose the appropriate radio button, then choose Next.
Enter information about your SilverMaster database.
The following table describes the type of information that you will be asked for.
|
Database type |
Required information |
|---|---|
NOTE If you see a warning about AGCLASSPATH at this point, it is because you didn't add the database driver you are using to your AGCLASSPATH environment variable. See the chapter on your DBMS in this guide for details on defining AGCLASSPATH.
Choose the port that the server will listen on.
For more information, see the chapter on running the server in the Administrator's Guide.
If you are creating or initializing a SilverMaster database, you see a panel that concerns security.
Select Restrict access to the SilverStream server if you want to restrict initial access to the server as described on the panel (you can always change the security settings later).
For more information, see the chapter on using security in the Administrator's Guide.
If you are creating a new SilverMaster or initializing an existing SilverMaster, you will then be asked to define a user name and password for the SilverStream user who will administer the server. The Installation program will create a user with this name and password and assign this user Locksmith privileges. Your server's administrator will log in to the server using this account.
For more information, see the chapter on setting up users and groups in the Administrator's Guide.
Continue with the installation following the prompts. After you specify the program folder to create, you see the following panel listing your selections.
Review your selections. If they are correct, choose Next to begin the installation.
When the installation nears completion, you receive the message Creating Resources. This will take a few minutes. SilverStream builds the SilverMaster.
Once you are brought into License setup, enter your serial number and register the product.
If you chose Custom Install to install an Enterprise Data Connector, the installation procedure prompts you to install the server components.
For more information, see
Installing Enterprise Data Connectors.
To test your SilverStream server installation, start the SilverStream server and the Designer.
The SilverStream Designer and the SilverStream server are separate executables. You need to start each separately, unless you set up the server to run as an NT service.
For complete information about starting and stopping the SilverStream server, see the chapter on running the server in the Administrator's Guide.
To start SilverStream from the Start menu:
From the Start menu choose Programs, then choose the SilverStream program group.
Start the SilverStream server first. The SilverStream server must be running for you to connect the Designer to it. Your local machine is the default machine for running the server. It is called localhost. By default, the server listens to port 80 on the local machine.
SilverStream Server ... serving at: http://host_name:port
Go back to the SilverStream program group and select SilverStream Designer.
You see a splash screen, then the main SilverStream Designer.
NOTE As part of your testing, it is also good idea to verify that any services that the SilverStream server depends on are running and set to start automatically when the system reboots.
If you encounter a problem, see the troubleshooting chapter in the Administrator's Guide.
If you need to deploy an external Java client to a user machine, you can use the SilverStream Installation program to set up the runtime components required on that machine.
To set up the runtime environment on a user's machine:
Start the SilverStream Installation program and specify Custom Install.
This installs the required versions of:
For more information on deploying external Java clients, see the chapter on writing external Java clients in the Programmer's Guide of the server's Classic Development Help.
SilverStream is written for designing applications to run over the Web. Whether your machine is networked or not, the SilverStream server needs access to the TCP/IP protocol to function properly. If your machine is networked, verify that TCP is configured to run SilverStream properly.
This section describes how to verify that TCP/IP is installed on a computer running on Windows platforms.
To verify that TCP/IP is installed on Windows NT:
Select TCP/IP Protocol and click Properties.
If you do not see TCP/IP installed, you must install it. Check with your LAN administrator for the details of TCP/IP in your installation. If TCP/IP is not run at all on your LAN, see Installing a TCP/IP connection under Windows NT.
Once you have TCP/IP installed, from a DOS command prompt type ping localhost. You should see the replies from your machine indicating that TCP/IP is functioning properly to contact your local machine.
To verify that TCP/IP is installed on Windows 95/98:
Select TCP/IP Protocol and click Properties.
If you do not see TCP/IP installed, you must install it. Check with your LAN administrator for the details of TCP/IP in your installation. If TCP/IP is not run at all on your LAN, see Installing a TCP/IP connection under Windows 95/98 and add the MS Loopback adapter.
Type ping localhost from a DOS command prompt and verify that replies come back indicating that TCP/IP is installed and able to communicate with your machine (localhost).
To install a TCP/IP connection under Microsoft Windows NT:
Install the necessary files from the NT Workstation CD or NT Server CD (depending on NT configuration).
Install the necessary files from the NT Workstation CD or NT Server CD (depending on NT configuration).
It will install the hosts file and ping.exe along with other support files.
Click the DNS tab and enter the Host Name (for example, SilverHost).
Select the MS Loopback Adapter from the Adapter dropdown list.
Click on Specify an IP Address. Enter an IP Address (for example, 200.200.200.200).
Rename or copy the hosts.sam file to hosts, with no file extension. Using Notepad, edit the hosts file by adding an entry for the IP Address/Host Name that you defined previously (for example: 200.200.200.200 SilverHost).
To test this address, go to a DOS prompt and type: ping SilverHost. You should then see responses from the IP address that you defined. This will be the host name that the SilverStream server will use.
To install a TCP/IP connection under Microsoft Windows 95/98:
Install the necessary files from the Win95/98 CD.
It will install the lmhosts.sam file and ping.exe along with other supporting files.
Select DNS Configuration. You must enable DNS and supply a Host Name (for example, SilverHost). You must specify an IP address (for example, 200.200.200.200). You must also specify a Subnet Mask (for example, 255.255.255.0).
Rename or copy the lmhosts.sam file to hosts, with no file extension. Using Notepad, edit the hosts file by adding an entry for the IP Address/Host Name that you defined previously (for example, 200.200.200.200 SilverHost).
To test this address, go to a DOS prompt and type: ping SilverHost. You should then see responses from the IP address that you defined. This will be the host name the SilverStream server will use.
When you are running high-availability servers in a multiuser environment, it often makes sense to run servers as Windows NT services. Running both the SilverStream server and the database server as services on the same machine ensures that both services will restart automatically when the machine reboots. If the databases that the SilverStream server connects to do not reside on the same machine as SilverStream, you should also set these databases to restart automatically on reboot.
Before you install SilverStream as a service, review the recommendations in Guidelines on setting SilverStream to run as a service or a daemon. The following procedure assumes that you have already created and configured a database to be used as your SilverMaster database. Database configuration requirements are described in this guide in the database-specific chapters. Using the Installation program, proceed with the following steps.
To set up SilverStream to run as an NT service:
Insert the SilverStream CD into the CD-ROM drive. The Installation program automatically starts. For more information, see Installing SilverStream.
After the Setup Welcome and the license agreement screens, choose Install Software and select Next to continue. You should have already installed Fulcrum SearchServer and configured your database server to run as a service.
You see a screen similar to the following. Choose Custom Install and choose Next.
In the Components list box shown in the following screen, select the SilverStream Server check box and deselect all the others except Common. Choose Next.
From the following screen, choose Install the SilverStream Server as a Service. Deselect Configure SilverStream Server (execute SilverMasterInit) and Install a new Server configuration file. Choose Next to continue.
The following step assumes that both the SilverStream server and your database server are run on the same machine. If your database server runs on a different machine from the SilverStream server, make sure you can access it using an outside application before configuring it to run with the SilverStream service.
NOTE If you are using Sybase Adaptive Server Anywhere (or SQL Anywhere) and running the SilverStream server as a service or a daemon, you must configure the database as a service (since it must start before the SilverStream server). By default, these databases are not installed as a service and will not appear in the list of Available Services until configured (as described in Step 4: Run Sybase ASA or SQL Anywhere as a service).
Choose which database server the SilverStream server will use and then choose Next.
If the SilverStream server will connect to a database server running on the same machine, select the database from the Available Services list. When run as a service, the SilverStream server requires that the database also run as a service.
Follow the remaining steps presented by the installation wizard until the SilverStream server installation is completed. Since you have already installed the SilverStream server, no files are copied.
For more information on finishing the installation, see
Installing SilverStream.
NOTE The SilverStream server uses two startup properties to log information when it is being run as an NT service. For information about generating and storing server output, see the section on SilverStream server logging when run as a service in the Administrator's Guide.
When the Installation program is complete, open the Services dialog box from the NT Control Panel. The SilverStream server will appear in the list of available products that are installed on the NT system as a service.
Set the SilverStream server to start automatically when the system reboots. By default, the service startup setting is initially set to Manual not Automatic.
For more information about the operation and administration of services, see the Windows NT documentation.
For any Sybase Adaptive Server Anywhere (or SQL Anywhere) database that is configured to run as a service, verify that the ODBC Data Source entries match the service configuration. For example, the server name for the SilverHelp ODBC data source will need to be edited if it does not agree with the service configuration.
|
|
Installation Guide |
Copyright © 2001, SilverStream Software, Inc. All rights reserved.