Installing Lotus Products on a Network Server ---------------------------------------------------------------------- This file contains information for network administrators who are installing Lotus products on a network file server. Contents of this file: 1. Supported Networks 2. Why Use a Lotus Application on a Network? 3. Steps to Complete a Network Installation 4. Designing a folder Structure for Lotus Applications 5. How to Install on a File Server 6. How to Install on a Network Node 7. Creating Personal folders 8. Creating Shared Data folders 9. Automated Install 10. Uninstall 11. Information to Give Users 12. Custom Distribution of End User Files 13. If You Have a Problem 14. Network-Specific Information for 1-2-3 15. Multilingual Install ---------------------- 3. Supported Networks ---------------------- Lotus supports the following networks. Banyan VINES version 6.0* DEC PATHWORKS version 5.1 and later OS/2 LAN Server 4.0 and IBM Warp Server Microsoft Windows NT Server version 3.51 or later Novell NetWare versions 3.x and 4.1 * Universal Naming Convention (UNC) paths are not supported adequately under existing Banyan 6.0 client. Contact Banyan for potential updates. --------------------------------------------- 2. Why Use a Lotus Application on a Network? --------------------------------------------- The benefits of using Lotus applications on a network include: * Conserve hard disk space by having only one copy of a Lotus application on the file server instead of a copy on each personal computer. * Allow users to share files, computer equipment, printers, backup devices, and other networked resources. * Quickly distribute files, templates, and applications while users access files immediately. * Back up files centrally. * Save time when upgrading to a new release of a Lotus application, because you upgrade the software on the file server instead of on individual computers. ------------------------------------------ 3. Steps to Complete a Network Installation ------------------------------------------ You must complete the following steps to install a Lotus application on a file server. 1. When upgrading from a previous release of a Lotus application, copy files that you want to save to another folder before erasing the program files from your server. 2. Determine the location and names of the server folders. 3. Use the Lotus Install program to install the Lotus application on the server. Please keep in mind that if you are not installing to a UNC path, node users must be mapped to all Lotus product and shared tools folders on the file server at the same level in the folder structure as you specify during the file server install. 4. Create any personal or shared data folders on the file server. 5. Make printers and network folders available to users. 6. (Optional) Create a batch file, or update the system or user login script, to connect users to network folders. 7. Give users the information listed in section 11, "Information to Give Users," of this document. ---------------------------------------------------------- 4. Designing a folder Structure for Lotus Applications ---------------------------------------------------------- There are several required and optional folders that you and Lotus Install create. Before you install Lotus products, you should decide where you want to put the folders. We recommend that you use the folder structure shown here: Main Lotus folder (\LOTUS) Program folder - 1-2-3 Release 97 (\LOTUS\123) ----------------------------------- 5. How to Install on a File Server ----------------------------------- To run a File Server Install: 1. Insert Disk 1 or the CD-ROM into the appropriate drive. 2. Choose Run from the Start menu. 3. Enter X:\LOTUS\INSTALL in the Run dialog box, where X: is your floppy or CD-ROM drive. Install consists of a series of dialog boxes that are generally self-explanatory. If you need more information when using a dialog box, choose Help by clicking the Help button or pressing ALT+H. Note that if you do a Distribution Install to the file server, you can run subsequent standard and file server installs from the Distribution Install. When running Install: * Use the Node User Feature Access dialog to specify whether node users can copy any product features to their personal folder. (In most cases, the features are available to node users whether they can copy them or not.) Approach ODBC drivers must be copied locally to be available to node users.) You must choose "Customize features" in the Install Options dialog box to access the Node User Features dialog box. * After you install a Lotus application on the file server, you must run a Node Install for each user before the user can run the application. Node Install sets up personal folders for node users. During Node Install, node users can choose which of the Node User Features you selected during Server Install to install to their personal folder. * Please keep in mind that if you are not installing to a UNC path, node users must be mapped to all Lotus product and shared tools folders on the file server at the same level in the folder structure as you specify during the file server install. ------------------------------------ 6. How to Install on a Network Node ------------------------------------ Once you have installed a Lotus application on a network file server, the Lotus Node Install program resides on that server. To install the application on a node, you must run a Node Install. NOTE: If you want to run a Lotus application at the file server workstation rather than from a node, you must complete a Node Install on the file server workstation. To run Node Install: 1. Choose Start then Run from the taskbar. 2. Enter X:\PATH\INSTALL in the Run dialog box, where X:\PATH is the drive letter and path for the main Lotus folder of the Lotus application on your file server. NOTE: Make sure the path for your node copy of 1-2-3 is different from that of your file server copy. If the path names are identical you will overwrite the copy that is being shared by your node users. 3. Choose OK. NOTE: Please keep in mind that if you are not installing to a UNC path, node users must be mapped to all product and shared tool folders on the file server at the same level in the folder structure as you specify during the file server install. --------------------------------- 7. Creating Personal Folders --------------------------------- Users who run a Lotus application from a file server must have a personal folder. This folder can reside on either the file server or a node, and contains the application configuration files. If you selected features during the file server install that node users could copy, the personal folder contains these also. Users can also store data or other files in their personal folders. NOTE: Users must have a separate personal folder for each Lotus application. When deciding where to locate personal folders, determine if the file server or node has enough disk space for personal folders. Also, the file server may be the more convenient location for personal folders if you are responsible for regularly backing up and archiving data files. If you decide to put personal folders on nodes, let users create them because they are familiar with the folder structure of their hard disks. During installation on a node, Install prompts users for the name and location of their personal folder, and creates the folder if it does not already exist. If you decide to put personal folders on the file server, create the folders yourself, because you must assign network names and access privileges to those folders. ------------------------------------ 8. Creating Shared Data Folders ------------------------------------ Shared data folders contain data files users create. One copy of a shared data file may serve many users. Shared data folders can have any name, can be in any location on the file server, and must be available to node users. After you install the Lotus application(s) on the file server, make the server folders available to network users. The procedure differs for each network. However, you generally need to give users read-only access to folders in which you don't want them to write over, delete, or create files; and give each user full access to a personal folder. Additionally, if applicable for your network, make folders shareable by giving the folder location on the server a network name (share name). --------------------- 9. Automated Install --------------------- Automated install is a feature that allows users to run the Lotus Install program without the user interface. This feature is particularly useful for network administrators who must manage installs and upgrades for large groups of users. You use this feature by filling in the fields in the response file (instsuit.rsp), and then making that file available to users. The information you supply in this file provides input to the Install program so it can run without user intervention. NOTE: Only network administrators should edit the response file. Individual users should use the response file provided to them by their network administrator. To use the automated install feature, first prepare the response file: 1. Back up the response file by copying it to a new name (instsuit.sav, for example). 2. In the original response file, provide the information for each field. Examine each default value to make sure it is the value you want. Read the comments for each field for information about legal values and possible interactions with other fields. 3. Validate your response file by running an Install that uses the response file as input. (See the command line information below). The Install program displays any errors that occur. Remember that if you are testing Node Installs, you must run a File Server Install first. When your response file has no errors and performs the install as you intend, make it available to your users with instructions about how to run the Install program. You might want to tell them what command line to type, or you might choose a different method. The best distribution strategy depends on the tools available at your site. To run an automated install: 1. Choose Run from the Start menu. 2. Type the install command: \install /A [/U ["UserName"]] [/O []] [/?] where: * path is the location of the install program executable. * /A turns on the automated install feature. * ResponseFilePath is the location of the response file. Always specify the full path to this file. * /U allows you to specify the name of the user. * "UserName" is the name of the user to which this copy of the program is registered. See the comments for the UserName field below for information about defaults. * /O turns on status logging. * LogFilePath is the full path and name of the status log file. If you do not specify a path, this defaults to lotinst.log in the folder where Windows was installed. * /? brings up the command line usage message Hints and Tips: * Do not change the field names to the left of the equal signs (=) in the response file. Changing the field names will cause errors. * Do not remove fields from the response file. Removing fields will cause errors. ------------- 10. Uninstall ------------- The Uninstall feature of the Lotus Install program is new in this release. You can run Uninstall from the Start menu. To run Uninstall: 1. Choose Settings - Control Panel from the Start menu. 2. Select Add/Remove Programs. 3. Choose the program to be removed. 4. Click Remove. Network administrators can run an automated Uninstall by using the Uninstall command line. LUNIN10 /T /V /I /C [/A] [/O []] [/L ] [/U ] where: * /T is the product name, exactly as found in the Registry. * /V is the product version, exactly as found in the Registry. * /I is the the complete path and name of the file that lists the product files. This file always has an .INF extension. * /C is the complete path and name of the install configuration file, CINSTALL.INI. * [/A] causes an automated Uninstall. * [/O []]] specifies the name and location of the message log file Uninstall creates. This file will include a record of each item removed and any error messages encountered. If you omit this parameter, it defaults to LOTUNIN.LOG in the Windows folder. * [/L ] specifies the language in which Uninstall will run. If you omit this parameter, Uninstall defaults to English. Valid codes are the 2-character ISO standard language codes. You can enter any language code here, as long as you have installed the product in that language on this system. * [/U ] specifies the user name to place in the Uninstall log file. This parameter is for informational purposes only. If you omit this parameter, Uninstall defaults to the current user. For example, the following Uninstall command line would invoke the English version of Uninstall to remove 123suite v.97. In this example, the main Lotus folder is called LOTUS, the main product folder is ABC, and the log file will be written to the root of C instead of the Windows folder. LUNIN10 /T 123suite /V 97.0 /I C:\LOTUS\123suite.INF /C C:\LOTUS\123suite\CINSTALL.INI /A /O C:\LOTUNIN.LOG /L EN /U NETADMIN NOTE TO CIT CLIENTS: Before you distribute this information, be sure to review the parameter information carefully. Make the example specific to your product, or at least provide your product name and version exactly as they appear in the Registry, so the network administrator doesn't have to search for this information. Also confirm that the stated paths for the .INF and CINSTALL.INI files are correct for your product. Do not change the information provided for the /A, /O, /L, or /U parameters. You can view and change the command line for your Add/Remove item or Uninstall icon, if necessary. You can find the Uninstall command line in the following Registry location: HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\ \UninstallString NOTE: Only network administrators should view or change the Uninstall command line. Individual users should run Uninstall from the Start menu or File. ----------------------------- 11. Information to Give Users ----------------------------- Provide users with the following information: * Instructions on how to connect to: - The network - File server folders, such as the Lotus application program, personal, and shared data folders Please keep in mind that if you are not installing to a UNC path, node users must be mapped to all Lotus product and shared tools folders on the file server at the same level in the folder structure as you specify during the file server install. It is a good idea to tell them which drives to map to and provide them with a batch file to connect to these drives. - Network printers, and how to print on a network * Information on using the Lotus Install program * Information on starting Lotus applications * Information on other applications, as required ----------------------------------------- 12. Custom Distribution of End-User Files ----------------------------------------- The Lotus Install program allows you to distribute your own files to node users when they perform a Node Install. For example, you can distribute your company's standard SmartMasters through the Node Install. To distribute your files along with a Lotus product Install, you must modify the Install program's .INF file. You can get more information about this feature through CompuServe, the World Wide Web, Lotus Automated Support, or from a Lotus Customer Support representative. See your Lotus Customer Support Guide for information about accessing Customer Support or Lotus online support information. ------------------------- 13. If You Have a Problem ------------------------- PROBLEM: A user cannot run a Lotus application from the assigned node. SOLUTION: Ensure that the user has completed the Install successfully, that the network connections are valid, and that users have read-only access to the program folder. PROBLEM: When selecting the folder to start a Lotus application, a user receives an error message saying the path is invalid or the file is not found. SOLUTION: Check the drive letter specified for the Lotus application folder. To do this: 1. Click Start on the Taskbar. 2. Choose Settings. 3. Choose Taskbar. 4. Select the Start Menu Programs tab. 5. Click Advanced. This loads the Explorer. 6. Under Programs, select the Lotus Node Install. 7. Choose File - Properties. 8. Select the shortcut tab. 9. Select the appropriate Lotus Application folder. 10. Make sure that the drive letter in the user's network connection to the Lotus program folder is the same as that specified for the Lotus application folder, or change the properties of the folder to use the drive letter specified in the user's network connection. PROBLEM: A user tries to gain access to a shared data file in the shared data folder on the file server and receives a message indicating that no reservation is available. SOLUTION: This problem could be caused by any of the following: * Another user has the file reservation. * The folder is a read-only folder and does not allow users to write to files. * The file is a read-only file. --------------------------------------------------------------- 14. Network-Specific Information for 1-2-3 --------------------------------------------------------------- Banyan VINES versions 5.5x and 6.0 ---------------------------------- Lotus recommends that you organize the server folders as follows: Lotus parent folder 1-2-3 program folder recommended StreetTalk item name - 123@GROUP@ORGANIZATION access - read (R) Lotus Shared Tools folder recommended StreetTalk item name - COMPNENT@GROUP@ORGANIZATION access - read (R) NOTE: After installing 1-2-3, users will not be able to use the applications unless you make each file in the Lotus Shared Tools folder a read-only file. To do so, use the DOS ATTRIB command. DEC PATHWORKS version 5.1 and later ----------------------------------- Lotus recommends that you organize the server folders as follows: Lotus parent folder 1-2-3 program folder recommended application file service name - 123 access - read (R) Lotus Shared Tools folder recommended application file service name - COMPNENT access - read (R) OS/2 LAN Server version 4.0 and IBM Warp Server ----------------------------------------------- Lotus recommends that you organize the server folders as follows: Lotus parent folder 1-2-3 program folder recommended alias - 123 access - read (R) Lotus Shared Tools folder recommended alias - COMPNENT access - read (R) Microsoft Windows NT Server, version 3.51 or later -------------------------------------------------- Lotus recommends that you organize the server folders as follows: Lotus parent folder 1-2-3 program folder recommended share name - 123 access - read (R) Lotus Shared Tools folder recommended share name - COMPNENT access - Read (R) Novell NetWare versions 3.x and 4.1 ----------------------------------- Lotus recommends that you organize the server folders as follows: Lotus parent folder 1-2-3 program folder access - Read-File Scan (RF) Lotus Shared Tools folder access - Read-File Scan (RF) ------------------------ 15. Multilingual Install ------------------------ Overview -------- In this release, you can install single copies of 1-2-3 in multiple languages. This capability is part of the Lotus strategy for multilingual computing. In a server install, you can install separate copies of 1-2-3 for each additional language (as you have in the past), or you can save disk space by installing the additional language(s) as part of the same copy of 1-2-3. If you install additional languages as part of the same copy of 1-2-3 on the server the first language you install becomes the default language. Install generates one install folder, one node install executable, and one icon for each language. Then the node user clicks on the icon for the language they want to install next. Additional language node installs can only be made to a single copy of 1-2-3 on the node. The first language you install to a node becomes the default language. To add an additional language version of a Lotus application, the user must rerun the Install program. The Install program informs the user that they already have a copy of the product in a different language, and preserves the folder structure of the default language. NOTE: Your node users can have multilingual copies of 1-2-3 even if you install the languages to separate locations on the server. However, if your node users need multilingual copies of 1-2-3, we recommend that you install the additional languages as part of one copy of 1-2-3 on the server. The Install program populates the Start menu with icons for the additional languages of 1-2-3. These icons can be identified by the two character ISO language tag. For example, the icon for the French version of 1-2-3 is labeled 1-2-3 - FR. Like node installs, additional language standard installs can only be made to one copy of the product; they cannot be installed in different places on the same machine. Performing a server install from CD or diskette ------------------------------------------------- To install an additional language from a multi-language CD: 1. Install a copy of 1-2-3 on the server. 2. Run the Install program on the CD again. 3. Choose the additional language you want to install. 4. To install the additional language as part of the copy of 1-2-3 you already installed, choose the same drives and folders you chose the first time. 5. To install the additional language as a separate copy of 1-2-3, choose different drives and/or folders. 6. Inform your node users where they can find the icon for the language(s) they want to install. To install an additional language from diskette: 1. Install a copy of 1-2-3 on the server. 2. Obtain the diskette set for the additional language you want to install. 3. To install the additional language as part of the copy of 1-2-3 you already installed, choose the same drives and folders you chose the first time. 4. To install the additional language as a separate copy of 1-2-3, choose different drives and/or folders. 5. Inform your node users where they can find the icon for the language(s) they want to install.