Chapter 2   Installing SilverStream on Windows

This chapter describes the Installation program for Windows platforms.

The chapter includes the following sections:

• System requirements and supported databases

• Installing SilverStream

• Testing the install

• Installing the runtime environment for external Java clients

• Installing on a non-networked computer

• Installing the SilverStream Server as a service

System requirements and supported databases   

See the SilverStream Application Server release notes for the latest information on the following:

• The hardware and software needed to run the SilverStream products

• The supported databases

Installing SilverStream   

NOTE   For any updated information about installing SilverStream, see the release notes.

Before you install SilverStream, make sure that you have created and configured a database to be used as your SilverMaster database (unless you will use 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 your database type.

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.

1. To begin, insert the SilverStream CD into the CD-ROM drive. SETUP will automatically start.

2. The Setup Welcome screen appears and the release notes are automatically displayed.

   The release notes contain important information. Please take the time to read these notes carefully before continuing.

3. The installation displays the SilverStream license agreement. To install SilverStream, you must accept this agreement.

4. Choose Yes and continue with the installation.

5. 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.

6. Choose Install SilverStream and optionally Fulcrum Search Server and Sybase Adaptive Server Anywhere. Select Next to continue.
   • 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). You can choose all the defaults.

   • 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. You can choose all the defaults, including to install the Personal Server edition of Adaptive Server Anywhere.

7. After the optional Fulcrum or Sybase Adaptive Server Anywhere installation, you see 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.

   

8. After the Destination folder and Designer preferences panels, a panel prompts you to configure SilverStream Server and install a new configuration file.

   If you are running the Installation program for the first time, choose Next to configure the server and install new server properties. 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.

9. When you encounter the prompt in the following panel, specify the database type of your SilverMaster database.

   

   If you select Sybase Adaptive Server Anywhere, you can specify that the SilverStream installation wizard create a new Adaptive Server Anywhere 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.

10. After choosing the SilverMaster database type, choose Next.

11. 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 Version 3 and also removes any existing database tables and user information.

    If you choose Upgrade your existing 2.5 SilverMaster, the install procedure upgrades the database to Version 3, but retains all of the database tables and user information.

    Choose the appropriate radio button, then choose Next.

12. For new installations and for upgrades, the wizard then prompts you for information that is specific to the SilverMaster database type that you specified earlier.

    The following table describes the type of information that you will be asked for.

    Database type	Required information
    IBM DB2	Alias name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database
    Informix	The driver you want to use: Informix Type 4 or ODBC. Name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database Server hostname Server name JDBC port number
    Microsoft Access	ODBC name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database
    Microsoft SQL Server	ODBC name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database
    Oracle	Alias name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database
    Sybase Adaptive Server Anywhere 6 (when using an existing database)	The driver you want to use: jConnect 5 or ODBC. Name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database If using jConnect driver: host name and JDBC port number
    Sybase Adaptive Server Enterprise	The driver you want to use: jConnect 5 or jConnect 4.x. Name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database Host name JDBC port number
    Sybase SQL Anywhere 5	ODBC name of the SilverMaster database. The user name and password that SilverStream will use when connected to the database

13. Continue with the installation following the prompts. After you specify the program folder to create, you see the following panel, listing your selections.

    

14. Review your selections. If they are correct, click OK 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.

15. Once you are brought into License setup, enter your serial number and register the product.

16. 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.

Testing the install   

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:

1. From the Start menu choose Programs, then choose the SilverStream program group.

2. Select SilverStream Server.

   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.

3. Wait for this message:

     SilverStream Server ... serving at: http://host_name:port  
   

4. 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.

Installing the runtime environment for external Java clients   

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:

1. Start the SilverStream installation program and specify Custom Install.

2. Select only JRE with JBroker.

   This installs the required versions of:

   • Java 2 Runtime Environment (JRE)

   • Java HotSpot Performance Engine

   • JBroker

    For more information on deploying external Java clients, see the chapter on writing external Java clients in the Programmer's Guide.

Installing on a non-networked computer   

SilverStream is written especially 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.

Verifying that TCP/IP is installed on your computer   

This section describes how to verify that TCP/IP is installed on a computer running on Windows platforms.

Windows NT 4.0

1. Go to Control Panel and select the Network icon.

2. Click on the Protocols Tab.

3. Select TCP and click Properties.

   If you do not see TCP/IP 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 4.0.

4. Once you have TCP/IP installed from a DOS command prompt type ping localhost and you should see the replies from your machine indicating that TCP/IP is functioning properly to contact your local machine.

Windows 95/98

1. Go to the Control Panel and select the Network icon.

2. Select TCP and click Properties.

   If you do not see TCP/IP 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.

3. 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).

Installing a TCP/IP connection under Windows NT 4.0   

Follow these steps to install a TCP/IP connection under Microsoft Windows NT 4.0.

1. Go to the Control Panel and select the Network icon.

2. Click the Adapters tab.

3. Click Add.

4. Select the MS Loopback Adapter and click OK.

5. The value 802.3 appears in the Frame Type field. Click OK.

6. Install the necessary files from the NT 4.0 Workstation CD or NT 4.0 Server CD (depending on NT 4.0 configuration).

7. Click the Protocols tab.

8. Click Add.

9. Select TCP/IP Protocol.

10. Install the necessary files from the NT 4.0 Workstation CD or NT 4.0 Server CD (depending on NT 4.0 configuration).

    It will install the hosts file and ping.exe along with other support files.

11. Click the Properties button for the TCP/IP Protocol.

12. Click the DNS tab and enter the Host Name (for example SilverHost).

13. Select IP Address tab.

14. Select the MS Loopback Adapter from the Adapter dropdown list.

15. Click on Specify an IP Address. Enter an IP Address. For example: 200.200.200.200

16. Specify a Subnet Mask. For example: 255.255.255.0

17. Reboot your computer.

18. 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 SilverStream Server will use.

Installing a TCP/IP connection under Windows 95/98    

Follow these steps to install a TCP/IP connection under Microsoft Windows 95/98.

1. Go to Control Panel and select the Network icon.

2. Select the Configuration tab.

3. Click on Add/Protocols.

4. Select Microsoft/TCPIP.

5. Install the necessary files from the Win95/98 CD.

   It will install the lmhosts.sam file and ping.exe along with other supporting files.

6. Go back into Properties for TCP/IP.

7. 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.

8. Reboot your computer.

9. Rename or copy the lmhosts.sam file to hosts, with no file extension. Using Notepad, edit the hosts file by adding 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.

Installing the SilverStream Server as a service   

When you are running high-availability servers in a multi-user 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 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 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:

1. To begin, insert the SilverStream CD into the CD-ROM drive. SETUP will automatically start. For detailed information on starting the Installation program, see the section on Installing SilverStream.

2. After the Setup Welcome and the license agreement screens, choose Install Software and select Next to continue. You should have already installed Fulcrum Search Server and configured your database server to run as a service.

3. After the optional Fulcrum and Sybase Adaptive Server Anywhere installation, you see a screen similar to the following. Choose Custom Install and choose Next.

   

4. 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.

   

5. 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 two steps assume 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 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).

   

6. 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.

   

7. 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.

8. 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.

9. 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.

NOTE   For any Sybase Adaptive Server Anywhere (or an SQL Anywhere) databases that are configured to run as a service, verify that the ODBC Data Source entries match the service configuration. For example, the server name for SilverHelp3 ODBC data source will need to be edited if it does not agree with the service configuration.