----------------------------------- INSTALLING DATALENS FOR WINDOWS ----------------------------------- This document explains how to install DataLens® for Lotus Notes® and 1-2-3 for Windows. To use DataLens, you must be running Lotus Notes Release 3 and/or 1-2-3 Release 4 for Windows and Miscrosoft® Windows(tm) 3.0 or higher. ----------------------------------- INSTALLING DATALENS FOR WINDOWS ----------------------------------- 1. Insert the DataLens for Windows "Disk" into your disk drive. TIP Copy the contents of the DataLens disk onto your computer's hard disk, so you can easily install additional drivers and reconfigure data sources later. 2. In the Program Manager Select File Run, type A:SETUP and press OK. The "DataLens for Windows Installation" dialog box appears. NOTE Replace "A" with the letter that represents the appropriate disk drive. If you copied the DataLens files to your hard disk,use that letter instead; for example: C:\DLENSKIT\SETUP. 3. Select "OK". The "DataLens for Windows product choice" dialog box appears. 4. To use with Lotus Notes proceed to step 5. To use with 1-2-3 Release 4 for Windows Select "No" and the "Select DataLens Drivers dialog box appears; skip to step 9. 5. SELECT "YES". The "Type of Installation" dialog box appears. 6. Select an installation method: * "Standard" -- Installs the complete DataLens software on your computer. * "Public" -- installs a public copy of the DataLens drivers on a file server. If you choose this method, be sure to tell users to select "Node" when installing DataLens, in order to use the public DataLens drivers. * "Node" -- Select this method if you want to use publicly installed DataLens drivers. Before you use the Node installation, your Notes administrator must install a Public copy of DataLens for Windows on a file server that you can access. You'll need to know the path to the DataLens files on that server. If you selected "Standard", the "Select DataLens Drivers" dialog box appears; skip to step 9. If you selected "Public" or "Node", the "Location of DataLens files on server" dialog box appears; continue with step 7. 7. Enter the path where the shared DataLens application files will be (or already are) stored on the Notes server. If you're performing a "Node" installation, you can get this information from your Notes administrator. If you're performing a "Public" installation, you must assign a path now. 8. Select "OK". The "Select DataLens Drivers" dialog box appears. 9. Select one or more drivers to install. For a Standard or Node installation, check the total space used by the drivers to make sure you'll have room for them on your hard drive. Since several drivers share information, the total size of the selected drivers may in fact be smaller than you'd expect; however, the "Total Size of Selected Files" shown in the dialog box is correct. For 1-2-3 Release 4 for Windows users the installation procedures automatically updates the Lotus.bcf file. The installation is complete. For a Public installation, all drivers are selected by default. 10. Select "OK". The "Configure Data Source" dialog box appears. 11. Select a driver from the "Drivers" list (this list shows you which drivers have been installed). 12. Select "Add new source". The "Data Source" dialog box appears. NOTE This dialog box looks slightly different for each driver, because each driver requires different information for configuring its data sources. 13. Enter the data source information required for the current driver. Use this chart when filling in the dialog box: Dialog box option Enter this information ----------------- ------------------------------------------ Source name The data source name. This name represents the location where the database tables are stored; you'll reference this name in the Notes formula that activates the DataLens driver. The data source name can be up to 30 alpha- numeric characters; it is case insensitive. In the DATALENS.INI registration file or Lotus.bcf, the data source name appears enclosed in square brackets; for example: [PUBLISHERS]. Caution! - You cannot use the same data source name twice, even with different drivers. - The names "DataLens Drivers" and "DataLens Data Sources" are already in use by the DataLens software, so don't use them as data source names. Path to files For dBASE IV® and Paradox®, the database tables are stored in a directory on the computer's hard drive. Enter the path to that directory. For example, if your personnel tables are stored in a directory called EMPS, and this directory is stored below your dBASE IV directory on drive C, the path is: C:\DBASE\EMPS Server name For SQL Server, enter the name of the SQL server by which the database will be accessed. Follow the SQL Server naming conventions. Database name For INFORMIX®, IBM® Database Manager, ORACLE, and SQL Server, enter the name of the database containing the tables you want to access. Follow the naming conventions for the DBMS you are using. Stored on network? This option appears only when you're configuring a data source for the Paradox driver. If the database tables will be accessed across a network, select "Yes"; Install then copies the "Path to files" information into the "level2" registration entry for the database, to ensure that you can access the tables across the network. 14. To add more data sources, return to step 11. Otherwise, skip to step 15. 15. Select "OK" to complete the installation. ------------- DOCUMENTATION ------------- Lotus Notes Install also copies the "DataLens for Lotus Notes" database to the \DOC directory in your Notes data directory. "DataLens for Lotus Notes" is an online book; it explains: * How to install DataLens for Lotus Notes (for future reference) * How to install additional DataLens drivers * How to add, reconfigure, and delete data sources * How to use the Notes @DbColumn, @DbLookup, and @DbCommand functions with DataLens * How to modify the DATALENS.INI registration file for each driver. You can read "DataLens for Lotus Notes" in Notes (just add it to your workspace and browse it like any other database. You can also print the book; following the printing instructions in the database's "Using DataLens for Lotus Notes" document. 1-2-3 Release 4 for Windows Also, in addition to your 1-2-3 Release 4 for Windows DataLens Drivers booklet we have installed a copy of the Ora123.txt a text file with information on installing and using the ORACLE DataLens Driver. --------- COPYRIGHT --------- Under the copyright laws, neither the documentation nor the software may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form, in whole or in part, except in the manner described in the documentation. Copyright 1993 Lotus Development Corporation 55 Cambridge Parkway Cambridge, MA 02142 All rights reserved. Printed in the United States. DataLens, Lotus, Lotus Notes, and 1-2-3 are registered trademarks of Lotus Development Corporation. dBASE IV, and Paradox are registered trademarks of Borland International, Inc. IBM, is a registered trademark of International Business Machines Corporation. INFORMIX is a registered trademark of Informix Software, Inc. Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation. ORACLE, is a registered trademark of Oracle Corporation.