FEBRUARY 99 ==============+========== WebSPIRS 4.03 Readme File ========================= This file contains instructions for connecting to the ERL server, starting WebSPIRS 4.03 and connecting with a web browser. In addition to this file, the WebSPIRS documentation set includes the following: * relnotes.txt: outlines the system requirements, basic installation instructions and known bugs for WebSPIRS 4.03 This file is distributed along with the WebSPIRS software package. * WebSPIRS 4.03 Implementor's Guide: provides detailed information on installing and configuring WebSPIRS. A local copy is installed on your machine (/webspirs/url/doc/wsig_toc.htm) along with the WebSPIRS software. * WebSPIRS 4.03 online Help system: provides detailed, user-oriented information on searching with WebSPIRS 4.03. * WebSPIRS 4.03 QuickStart Guide: shows users how to get started with basic WebSPIRS searching. =-=-=-=-= Contents =-=-=-=-= 1. Where to Find Additional WebSPIRS Documentation 2. Connecting to the ERL Server 3. Starting/Stopping WebSPIRS A. Starting WebSPIRS on UNIX B. Stopping WebSPIRS on UNIX C. Starting/Stopping WebSPIRS on Windows NT 4. Connecting to WebSPIRS with a Browser 5. Contacting SilverPlatter Technical Support =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 1. Where to Find Additional WebSPIRS Documentation =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= In addition to these release notes, please refer to the following WebSPIRS documentation for more information: * readme.txt: tells you how to connect to the ERL server, start WebSPIRS and connect with a browser. You'll find this file in the /webspirs/bin/ directory after you install the WebSPIRS software. * WebSPIRS 4.03 Implementor's Guide: provides detailed information on installing and configuring WebSPIRS. A local copy is installed on your machine (/webspirs/url/doc/wsig_toc.htm) along with the WebSPIRS software. * WebSPIRS 4.03 online Help system: provides detailed, user-oriented information on searching with WebSPIRS 4.03. * WebSPIRS 4.03 QuickStart Guide: shows users how to get started with basic WebSPIRS searching. You can find this guide on the SilverPlatter's home page (http://wwww.silverplatter.com). =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 2. Connecting to the ERL Server =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= WebSPIRS uses a configuration file (erlclnt.cfg) to connect to the ERL server. This file contains the port number and hostname (or IP address) of the ERL server you specified during installation. NOTE: Unless you specified another hostname (or IP address) during installation, erlclnt.cfg points to SilverPlatter's guest server (erl2.silverplatter.com) by default. You can test your new installation by running WebSPIRS and logging in using "guest" as your username and password. The WebSPIRS Database Selection page appears when you connect, displaying the databases available from the SilverPlatter guest server. (See "Connecting to WebSPIRS with a Browser" for more information.) Here's an example of the erlclnt.cfg file: /* /* example /* /* server_addr1 = /2/machinename/416 server_addr1 = /2/erl2.silverplatter.com/416 /* /* Specify server type (use type1 for single server) /* server_type1 = 3 In the server address entry (server_addr1): * 2 indicates a TCP/IP protocol connection. * erl2.silverplatter.com is the hostname of ERL server that WebSPIRS will connect to. You can use the IP address (192.80.71.114, for example) instead of the hostname. * 416 is the port number assigned to all ERL communications traffic. To change any entries or add additional ERL servers to the erlclnt.cfg file: 1. Go to the /webspirs/bin/ directory. 2. Open erlclnt.cfg in a text editor. 3. If necessary, change the hostname of the ERL server: server_addr1 = /2//416 If you have more than one server, create additional lines for each one. Increment n by one for each server: server_addrn = /2//416 server_typen = 3 4. Save erlclnt.cfg in text-only format. Once WebSPIRS is installed and the erlclnt.cfg file is pointing to the appropriate server(s), you can start WebSPIRS. See "Starting/Stopping WebSPIRS" for more information. =-=-=-=-=-=-=-=-=-=-=-=-=-=-= 3. Starting/Stopping WebSPIRS =-=-=-=-=-=-=-=-=-=-=-=-=-=-= Once WebSPIRS is installed and connected to the appropriate server(s), you must start the WebSPIRS process to give users access to the databases mounted on the ERL server(s). A. To Start WebSPIRS on UNIX: ----------------------------- 1. Change to the /webspirs/bin directory. 2. Type ./webspirs start [Enter] or ./webspirs restart. The WebSPIRS program (webspirsd) begins running in the background and a message is displayed. 3. If you check your system process status (using the ps command) you should see the webspirsd process running. As users log on to WebSPIRS, webspirsd starts a webspirs_user process for each new user. If you check the system process status when users are logged on, you will see these webspirs_user processes running. B. To stop WebSPIRS on UNIX: ---------------------------- 1. Change to the /webspirs/bin directory. 2. Type ./webspirs stop [Enter]. The webspirsd process stops running. C. To Start/Stop WebSPIRS on Windows NT: ---------------------------------------- WebSPIRS is installed as a service on Windows NT machines. You can start and stop WebSPIRS or change its startup status through the Windows NT Services dialog box. To start and stop WebSPIRS for Windows NT: 1. Open the Windows NT Control Panel (Windows NT Start menu > Settings > Control Panel). 2. Click on the Services icon to open the Services dialog box. 3. Scroll down the Services column until you find the webspirsd service and select it. The Status column contains "Started" when the service is running, and is blank when the service is stopped. 4. Start or stop the service as necessary: o Click the Start button to start webspirsd, or o click the Stop button to stop it. 5. Close the Services dialog box. =-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 4. Connecting to WebSPIRS with a Browser =-==-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Once you start WebSPIRS, you can use your web browser to test the software and your connection to your ERL server(s). * To Connect to WebSPIRS: ------------------------- 1. Type the WebSPIRS URL in the browser's address field: http://: NOTE: o Use the hostname (or IP address) and port number you specified during installation. You can use "localhost" for the WebSPIRS hostname if your browser and WebSPIRS server are running on the same machine. o Internet Explorer users must include http:// in the URL. 2. In the standard WebSPIRS installation, the Welcome to WebSPIRS page opens, allowing you to login to WebSPIRS. Type the WebSPIRS username and password in the appropriate fields (or accept the default "guest" entries if they are present), then click the Login to WebSPIRS button. The Select Databases page opens in a separate browser window, allowing you to open the databases you want to search. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= 5. Contacting SilverPlatter Technical Support =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= If you need further assistance with the WebSPIRS 4.01 software, please send an e-mail to support@silverplatter.com or contact one of SilverPlatter's regional offices: UNITED STATES: SilverPlatter Information, Inc. 100 River Ridge Drive Norwood, MA 02062 Tel: 800-343-0064 781-769-2599 Fax: 781-769-8763 ---------------------------------- LONDON: SilverPlatter Information LTD 10 Barley Mow Passage Chiswick, London W4 4PH England Tel: +44 (0) 181 585 6400 Fax: +44 (0) 181 585 6640 ---------------------------------- AMSTERDAM: SilverPlatter Information BV Nieuwe Herengracht 49 1011 RN Amsterdam The Netherlands Tel: +31 (0) 20 6259650 Fax: +31 (0) 20 6237408 ---------------------------------- BERLIN: SilverPlatter Information GmbH Uhlandstrasse 15 D-10623 Berlin Germany Tel: +49 30-315-2161 Fax: +49 30-315-2162 ---------------------------------- FEBRUARY 99