Installation Guide
|
|
Installation Guide |
This chapter describes how to install SilverStream on UNIX and Linux.
See the Release Notes for the latest information on the following:
This section describes how to install the SilverStream server. It includes the following sections:
NOTE For any updated information about installing SilverStream, see the Release Notes.
Before you install the SilverStream server, make sure you have created and configured a database to be used as your 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.
You must have Read or Execute rights for the installation directories; otherwise, you will receive an error message.
On UNIX, the SilverStream server listens on port number 8080 by default. If another process is occupying that port, the installation procedure lets you specify a different port. If you want to set the port numbers to values lower than 1024 (normally reserved for root on UNIX systems), you have to be identified as user root. After installing SilverStream, you can change the user name and ports used by the SilverStream server.
For more information, see
Changing the user account and ports.
HP-UX note Java programs can heavily use threads and sockets. HP-UX's default setting for the max_thread_proc kernel parameter is too low for Java applications. You need to increase its value to at least 2048. If you don't, the VM might silently crash. For more information, go to the HP Web site (http://www.hp.com) and search for max_thread_proc.
To install SilverStream, you must first mount the CD-ROM drive.
Create the /cdrom directory to be used as the mount point.
mkdir /cdrom
Start the pfs_mountd and pfsd daemons if they are not already running.
nohup /usr/sbin/pfs_mountd & nohup /usr/sbin/pfsd &
Mount the CD-ROM to the mount point.
/usr/sbin/pfs_mount -x unix -t rrip /dev/dsk/c1t2d0 /cdrom
where c1t2d0 is the CD-ROM device.
The Solaris Volume Management software automatically mounts the CD-ROM to the /cdrom mount point.
To install SilverStream, you must first mount the CD-ROM drive.
Create the /cdrom directory to be used as the mount point. For example:
mkdir /cdrom
Mount the CD-ROM to the mount point.
mount -vcdrfs -r /dev/drive mount-point
where drive is the CD-ROM drive (typically cd0) as seen in the first columns of the lsdev -Cc cdrom command and mount-point is the full path to the directory you created to mount the CD-ROM.
A typical statement is:
mount -vcdrfs -r /dev/cd0 /cdrom
Once the CD-ROM drive is mounted, you can install SilverStream. You do not need to run the Installation program with root privileges; you can install as any user.
Change the directory to the CD-ROM mount port.
cd /cdrom
Enter the following at the command prompt:
./install.sh
The installation script begins. It checks to see whether you have all required patches installed. If so, it continues; if not, it tells you what you need to do.
Specify the directory where you want to install the software or press Enter to accept the default.
Specify the DBMS you will use for your SilverMaster.
The information you need to provide depends on the database type you chose.
You are asked whether you want to upgrade a previous version of the SilverStream SilverMaster.
Select Yes to upgrade your previous SilverMaster to the current version.
If you are not upgrading an existing SilverMaster, you are asked whether the Installation program should configure the SilverStream server--that is, initialize the SilverMaster database. Choose Yes.
If you are upgrading or initializing a SilverMaster, you are asked whether you want to restrict access to the SilverStream server.
If you accept the default (yes), unauthorized users will not be able to access administration operations or browse directory listings. Access to administrative settings and resources will be limited to members of the Administrators group. Only members of the Administrators and Developers groups will be able to browse directory listings. All users will be required to log in whenever they access the server. All users will have Execute permission, which enables them to run application operations.
Installing the SilverStream server without restricting access means that all users will be able to perform administrative operations and browse directory listings until you lock down access by setting permissions.
SilverStream recommendation:
If you are developing SilverStream applications in a development environment, you probably do not want to restrict access to the server.
If you are administering a production environment where applications are deployed for use on the Web, you probably do want to restrict access to the server.
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 are 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.
You are asked to specify the HTTP port. Enter the port number or press Enter to accept the default.
The SilverStream server defaults to port 8080 on UNIX. You need to specify the port number when you connect to the server from the SilverStream Designer or when you specify URLs on that server. For example: from the SilverStream Designer, select the Choose Server icon and enter the name as hostname:portnumber. For example:
myserver:8080
For application URLs on the server, you need to tell the browser what port number the server is using (for example, http://myserver:8080/...).
If you instructed the Installation program to configure SilverMaster in Step 8, you are asked to specify the name service port number. This is the port that SilverStream starts the RMI name services on. Typically you can accept the default.
Enter the name service port number or press Enter to accept the default.
Enter your license string and press Enter.
The Installation program displays a screen that contains information about the changes the program will make, information about the SilverMaster and SilverStream server settings, and the license string.
If the information is correct, enter Yes to start the installation.
The program creates or edits your httpd.props file and sets environment variables in .agprofile. A list of the install directories appears, along with the message that SilverStream is creating resources. This portion of the Installation program, which runs SilverMasterInit, may take some time.
When the Installation program completes, you are asked if you want to start the SilverServer now.
If you choose Yes, the SilverStream server starts.
If you choose No, you can start the SilverStream server manually. See Testing the install.
If you want the server to start automatically when the machine boots, use the sample startup scripts that are installed on your system. The text preceding the final installation prompt tells you where to find the sample startup scripts.
For more information about using the startup scripts, see
Setting the SilverStream server and cluster components to run as daemons.
Installing and using online help If you did not install the SilverStream server online help during your server installation, you can install it later: It is located on the CD in docs.tar; install it by cd'ing into your SilverStream installation directory and executing the following:
tar xvf CDdrive/docs.tar
To start help, open Start_Core_Help.html, which is in the SilverStream Docs directory.
The Installation program installs sample startup scripts that your system can run to automatically start the SilverStream server or cluster components as daemons at boot time.
The paths to the server and cluster component startup scripts for each supported UNIX platform are listed in the following tables. See Step 4 of the following procedure for sample commands that install the server component for each platform.
|
|
Server path |
Cluster path |
|---|---|---|
NOTE As shown in the preceding table, the HP-UX server and cluster component scripts use link files.
A system administrator with root privileges must copy the sample server and cluster scripts from the install directory into your operating system's boot directory.
For more information, see
Setting up the SilverStream server to run as a daemon next and
Setting up the SilverStream cluster to run as a daemon.
To have the server startup script run the next time your system reboots, a system administrator with root privileges must copy the script from the install directory into your operating system's boot directory as shown in Step 4 of the following procedure.
To set up the SilverStream server to run as a UNIX daemon:
Before you install SilverStream as a daemon, review the recommendations in Guidelines on setting SilverStream to run as a service or a daemon.
The following procedure assumes that you have already run the Installation program and created and configured a database to be used as your SilverMaster database.
Locate the sample startup scripts as listed in the preceding table.
Edit the server and cluster components startup scripts if needed.
Copy the sample script from your install directory into the boot directory for your platform. The script will run from that directory the next time the system reboots.
For example, to copy the sample server script for Solaris from an install directory called $SILVERSTREAMROOT/etc/rc3.d to a boot directory called /etc/rc3.d, you would type:
cp $SILVERSTREAMROOT/etc/rc3.d/S90silverserver /etc/rc3.d
The following table shows platform-specific sample commands.
For more information, see the
Server and cluster sample startup scripts.
Start the SMC (SilverStream Management Console).
For more information, see the Administrator's Guide.
Use the Configuration/General panel to specify the user under whose account the server will be started at boot time. To provide security, set the Username for server property to your (or another user's) user account. By default, this property is set to root.
You should change privileges from root to a different effective user ID. Once a root process changes its ownership to become a nonroot process, it can't recover its former access privileges.
You can use the sample scripts to start a cluster component as a daemon. By default, the scripts run with root privileges. If you want the cluster to start as a user other than root, see your system administrator who can apply the setuid permission to the cluster component script files.
For a list of startup scripts, see the table in
Using the server sample startup scripts.
After installing SilverStream, you can change the user account that the server runs under. You can also change the ports used by the server. For example, you might want to use port 80 (the default port for SilverStream on NT) as the runtime port. That requires root access, but maybe you want the server to run under a different user account. You could perform the following procedure.
For more information about the runtime, design, and administration ports used by the SilverStream server, see the section on setting up separate ports in the chapter on running the server in the Administrator's Guide.
To change the user account and ports:
For more information about the SMC, see the Administrator's Guide.
Using a port less than 1024 If you specified a port lower than 1024 (such as 80) but a user name other than root, you need to do the following:
Log in as root and start SilverServer with the SilverServer shell script.
The server opens the specified port and switches the process UID to the user name you specified.
Tablespaces for Oracle databases The installation will use the default tablespace of the user name/password specified for your SilverMaster database. You can usually set the default tablespace with the following SQL statement:
ALTER USER username DEFAULT TABLESPACE mytablespace ;
Using different database types with the same SilverStream server If you install with a Sybase or Informix SilverMaster and want to add an Oracle database, you need to have $ORACLE_HOME set and have $ORACLE_HOME/LIB in your SHLIB_PATH (for HP-UX), LD_LIBRARY_PATH (for Solaris and Linux), or LIBPATH (for AIX).
If you installed with an Oracle SilverMaster and would like to add a Sybase or an Informix database, you need to add the jConnect classes or Informix JAR file to your AGCLASSPATH. Alternatively, you can modify the AGCLASSPATH in the environment file silverstream/.agprofile. Note that SilverServer sources .agprofile automatically; you do not need to source it manually.
You must perform all of these steps before starting the server.
To test your installation, you need to start the SilverStream server.
For complete information about starting and stopping the SilverStream server, see the chapter on running the server in the Administrator's Guide.
To start the SilverStream server:
Access the bin subdirectory (for example, /usr/local/silverstream/bin) in the directory where you installed SilverStream. Execute the following script:
./SilverServer &
The following message appears:
SilverStream Server loading properties from: /usr/silverstream/Resources/httpd.props
SilverStream Server ... serving at: http://host_name:port
You must have Read or Execute rights for the installation directories; otherwise, you will receive an error message.
NOTE It is also a 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
Troubleshooting.
You can access the SilverStream server running on UNIX from the SilverStream Designer.
To access a UNIX SilverStream server from the Designer:
Select the Choose Server icon from the SilverStream Designer toolbar or select File>Choose Server.
A dialog box appears, prompting you to enter the name of the server.
Specify hostname:portnumber and click OK.
A new server icon appears in the left pane of the Designer. This icon displays the name of the server you specified.
To see a list of databases that reside on the server, click the plus (+) sign that appears in front of the icon.
SilverStream creates the environment file .agprofile in the SilverStream installation directory during installation (since it is a "dot" file, you need to issue the ls -a command to see it). SilverStream sources this file automatically when starting.
The .agprofile file sets up a proper environment to launch the SilverStream server. It sets environment variables for the following:
Normally this file is only edited by SilverStream during installation. However, you might want to alter this file for the following reasons:
To update the AGCLASSPATH environment variable to include third-party classes
To update the AGCLASSPATH environment variable and the native search path (LD_LIBRARY_PATH, SHLIB_PATH, or LIBPATH) if you add a Sybase, Oracle, Informix, or DB2 application database to your SilverMaster, as described in Using different database types with the same SilverStream server
You must restart the server after changing the AGCLASSPATH and before adding the database.
This section describes known problems and their workarounds.
***Warning: License improperly installed: SilverStream Software; <licensenumber> ***Warning: No valid Licenses found defaulting to Single User License. SilverStream Server [Build Number: Number] serving at: http://servername: portnumber
This may occur if you run SilverMasterInit outside the installation.
You must reapply your license to the SilverMaster database. Go to your /cdrom/silverstream directory and run the following command:
./upldlic.sh your license number
Xlib: connection to "sunny:0.0" refused by server Xlib: Client is not authorized to connect to Server
Messages like these can occur if you are installing on a remote machine. The following command or a suitable variation should be run from a remote machine:
xhost + xhost + machinename_of_installation
If after executing the xhost command, you get the following error:
/usr/openwin/bin/xhost: must be on local machine to add or remove hosts.
you must execute the command at the server console and not remotely.
The following message may be caused by an incorrect DISPLAY variable.
Java exception occurred java.lang.InternalError: Can't connect to X11 window server using '222.111.99.333:0.0' as the value of the DISPLAY variable.
Try changing the value of the DISPLAY environment variable to one of the following:
DISPLAY=:0.0 export DISPLAY
DISPLAY=machinename:0.0
export DISPLAY
***Fatal Error, aborting com.sssw.srv.http.httpd: An unexpected exception occurred com.sssw.srv.daemon.ServerHandlerInitException: Unable to create server socket on port 80, details: Permission denied at com.sssw.srv.http.httpd.initializeServerSocket (httpd.java:1105) at com.sssw.srv.http.httpd.initialize (httpd.java:2344) at com.sssw.srv.http.httpd.mainBODY = (httpd.java:2437) at com.sssw.srv.http.httpd.main(httpd.java:2446)
You tried to start SilverServer on port 80 without root privileges.
Usually only the root user can start a server on port 80. Try logging on as root and starting SilverServer, or follow the procedure in Changing the user account and ports.
SilverStream Server loading properties from: /opt/silverstream/Resources/httpd.props *** Fatal Error, aborting com.sssw.srv.http.httpd: An unexpected exception occurred com.sssw.srv.daemon.ServerHandlerInitException: An exception occurred while attempting to initialize the connection to 'SilverMaster': Unable to find schema for database SilverMaster in AgInfo table. at com.sssw.srv.http.httpd.initializeProperties (httpd.java:1356) at com.sssw.srv.http.httpd.initialize(httpd.java:2287) at com.sssw.srv.http.httpd.mainBODY(httpd.java:2437) at com.sssw.srv.http.httpd.main(httpd.java:2446) ----------------------------------------------------- Java exception occurred java.lang.RuntimeException: An unexpected exception occurred -----------------------------------------------------
If after running SilverServer you see this error, the SilverMaster database has been corrupted and SilverMasterInit should be rerun.
If you would like to start SilverServer without checking the SilverMaster resources, you can start the server using the -nodbcheck startup option:
./SilverServer -nodbcheck
Unable to save a table with a field that is marked "Full Text Searchable".
Full-text search will fail if the directory in which SilverStream resides contains a hyphen (-) or a period (.).
Reinstall SilverStream into a directory that does not contain a hyphen or a period. (Renaming the SilverStream directory is not sufficient, since environment variables are set during the installation.)
|
|
Installation Guide |
Copyright © 2001, SilverStream Software, Inc. All rights reserved.