Citrix Winview Application Note PC-DOCS, Inc. PC DOCS OPEN Windows and SQL Database Server-Based Document Management Solution Version 2.0c This application note is for informational use only and Citrix makes no representations or warranties with respect to the contents or use of this document or of any of third-party products discussed within. (January 18, 1994) Citrix Systems 210 University Drive Suite 700 Coral Springs, FL 33071 Phone (305) 755-0559 FAX (305) 341-6880 Overview: ------------- This application note facilitates the configuration of the PC DOCS Open Windows client with Citrix "WinView for Networks" Application Server Software. The PC DOCS Open for Windows software is a document management package, that utilizes either a stand-alone local SQL Database Engine (Watcom SQL for Windows), or a Network SQL Server (Sybase SQL Server for NetWare, or the Microsoft/Sybase SQL Server for OS/2). This document assumes drive C: is the WinView boot drive. Substitute your drive letter accordingly. The system is comprised of three major elements: 1. A WinView Application Server, running Citrix WinView for Networks Version 2.3 and PC DOCS Open software Version 2.0c. 2. A Novell Fileserver running NetWare version 3.12 3. A supported SQL Local Engine/Network Server as follows: a. Watcom SQL for Windows as a local SQL Engine. b. Sybase SQL Server Version 4.22 running on a NetWare version 3.12 server. c. Sybase/Microsoft SQL Server for OS/2 version 4.2 running on the WinView Application Server. Disclaimer: ---------------- The scenarios described in this document have been tested by Citrix Systems. Other variations to the scenarios described in this document may work, however they have not specifically been tested by Citrix. In order to recreate the configurations, you should use the specified revision levels of all software products described in this document and stay within the bounds of the features and functions described in this document. Please note that this application note is a living document and will be modified as new information and versions of the software described herein become availiable. Make sure you have the latest version of this document before you begin. The latest version is always available in the Citrix Forum on Compuserve. Requirements: --------------------- Software 1. Citrix WinView for Networks Version 2.3 2. PC DOCS Open Software Version 2.0c software 3. A WinView and PC DOCS Supported SQL Local Engine/Network Server as described under SQL Server/Local Engine Installation The tested configuration is outlined below: 1. 80386/33 based File Server, 16MB RAM, 500MB SCSI, Novell NetWare 3.12 2. Sybase SQL Server for NetWare Version 4.22 (Installed on File Server). 3. Compaq ProSignia VS, 80MB RAM, 1GB SCSI, WinView for Networks V2.3. Setup -------- PC DOCS Open Software Installation -------------------------------------------- 1. Install PC DOCS software as per the installation guide. NOTE: If using a networked SQL server, the PC DOCS software must be installed on a network drive. 2. Make a directory named SAVE under DOCSOPEN\PROGS and move following the files from the DOCSOPEN\PROG directory to the previously created SAVE directory. NWIPXSPX.DLL NWNETAPI.DLL SQL Server/Local Engine Installation ------------------------------------ 1. If you have not done so yet, install your SQL Engine/Server. The supported SQL packages at this time are: Watcom SQL Server for Windows V3.2c as local engine for single user use. If PC DOCS is to be used on WinView with multiple users, a SQL server listed above must be used. Sybase SQL Server for NetWare V4.22 (This can be ordered from PC DOCS, Inc.) This is a package of .NLM's that run on the NetWare Fileserver. Sybase/Microsoft SQL Server for OS/2 ver 4.2 (Uses Named Pipes, Server software runs on WinView as system process. See WinView README for Microsoft SQL Server (under the Application Notes Section). WinView for Networks Installation/Configuration ----------------------------------------------- 1. Install WinView as per the Installation Guide. Make sure that all network transports were installed (IPX, SPX, NetBIOS, Named Pipes). 2. If utilizing Sybase/Microsoft SQL Server for OS/2, verify that the CONFIG.SYS file contains the following section: REM -- Named Pipes Server Support DEVICE=C:\NETWARE\NMPIPE.SYS DEVICE=C:\NETWARE\NPSERVER.SYS DEVICE=C:\NETWARE\NPDAEMON.SYS HOSTNAME** **NOTE: Where HOSTNAME is the name given to the AppServer during the WinView software installation. 3. Modify the WinView Application Server \NETWARE\NET.CFG file to include the following options: Link Support BUFFERS 20 1516 NOTE: if using Token Ring, TCNS, or FDDI, raise Named Pipes the Packet Size (1516) accordingly (4202 CLIENT SESSIONS 16 is normal in the case of Token Ring) SERVER SESSIONS 238 ADVERTISE BOARD 1 Protocol Stack SPX SESSIONS 254 Including all the above options will allow the use of either Server-based SPX transport SQL servers, or Named Pipes based servers. NOTE: under a DOS/ Windows session on WinView for Networks, Utilizing Sybase/Microsoft SQL Server for OS/2, the Microsoft DBNMPIPE.EXE Named DOS extender is not needed. If you plam to run the Sybase/Microsoft SQL Server for OS/2, contact Citrix Systems, Inc. for a later version of the NMPIPE.SYS driver for WinView which has some corrections for using Named Pipes in a WinView DOS session. Operation -------------- 1. Run RLINK, LANLINK, or IPLINK to attach to the WinView Application Server Load and run PC DOCS as per the User's guide, and the Implementation guide for your SQL Server/Local Engine. Notes --------- 1. The .DLL files that need to be moved MUST be moved. If they are not moved, PC DOCS Open will not function correctly. 2. Review the PC DOCS Implementation guide for your SQL Server for correct installation and database initialization procedures.