FacetWin Download Installation Instructions CONTENTS o FacetWin Features o What's New in Version 3 o FacetWin Documentation o FacetWin Requirements o Preparing the UNIX Host o Preparing UNIX Installation Notes o Installing FacetWin on a UNIX Host o Preparing a Windows 95/98/ME PC for FacetWin o Preparing a Windows NT 4.0 PC for FacetWin o Preparing a Windows 2000 PC for FacetWin o Gaining Access to Shares on the UNIX Server o If the UNIX Server Does Not Appear in the Network Neighborhood o Installing FacetWin on a PC o Installing FacetWin on Additional Servers o Updating Your FacetWin Software o Uninstalling FacetWin o Getting Started With FacetWin o FacetWin Support FACETWIN FEATURES FacetWin brings your UNIX system into your Windows network environment by providing server software that makes the resources of the UNIX server available to the Windows PCs on the network. The product is designed for the Windows 95/98/ME and Windows NT 4.0/2000 environments, but some of the services can also be used by older versions of Windows. FacetWin provides: o File and Print Services. The file and printer shares that you define on the UNIX system appear in the PC's Network Neighborhood just like any other Windows network resource share. Each user's home directory on the UNIX system is automatically defined as his own file share. File shares support file and record locking, long file names, and Windows drag and drop interface. UNIX printer shares allow the UNIX printers to be used from Windows. A UNIX printer can be setup as the default printer for a Windows PC. A printer attached to a PC can be made available to UNIX applications as part of the UNIX printer spooler system. Access to file and printer shares can be limited to certain users or PCs. No additional software is installed on the PC for file and print services. File and printer sharing is supported for all versions of Windows. o Terminal Emulation. Your character-based UNIX applications are turned into icons on the Windows desktop and menu. Double-click the icon and your application is run in a terminal emulation window. The setup required to configure a UNIX application to be invoked by this QuickLaunch(tm) method takes less than 1 minute. Emulation families include VT, Wyse, SCO ANSI, and IBM. The terminal emulator has a native Windows interface including property sheet configuration. Terminal emulator features include keyboard mapping, function key programming, and copy & paste. The Window Watch(tm) feature provides automatic monitoring of terminal activity to provide notification when user-defined events have occurred. The MouseKeys(tm) feature allows the user to input keystrokes using the mouse. The terminal emulator is only supported on Windows 95/98/Me and Windows NT 4.0/2000. o Modem Server. You can install the FacetWin virtual serial port driver on a PC to allow Windows applications to access the modems on the UNIX server. For example, you can configure Windows Dial-up Networking to use the UNIX modems in order to give PC users access to the Internet. You may also use the modem server with many other Windows applications that use a modem. Fax appications are not currently supported. This driver is currently only available for Windows 95/98/ME. o PC Backup/Restore. FacetWin allows one or more PCs to be backed up on the UNIX tape drive or to a disk archive on the UNIX server. This backup/restore facility requires the FacetWin Agent program to be running on the PC being backed up or restored (see below). The FacetWin Agent is supported on Windows 95/98/ME and Windows NT/2000. It is not supported on Windows Terminal Server. o E-Mail Server. FacetWin includes a POP3 mail server which can transfer e-mail from the UNIX/Internet mail system to a Windows mail program such as Microsoft Outlook. The FacetWin e-mail server may be used with any mail client program that uses the POP3 protocol. o Remote Computing. FacetWin supports PCs that dial into the UNIX server using Windows dial-up networking. All FacetWin features are provided to dialed-up PCs. In fact, the entire network, including the other PCs, is made available to the remote PC. o Windows Administration Tool. You may administer FacetWin either by directly editing the configuration files on the UNIX server, or by using the FacetWin Administrator program. The FacetWin Administrator is a Windows based program that organizes all of the administration details in an easy to use Windows property sheet. The FacetWin Administrator program is only supported on Windows 95/98/ME and Windows NT/2000. o FacetWin Agent The FacetWin Agent is a program that runs on your PC and cooperates with the backup server on the UNIX host to allow the PC to be backed up. The Agent also provides a way for enhanced error messages to be reported to the user from the file and print server. Finally, the Agent's user interface, the "FacetWin Agent Control Panel", allows the user to configure his FacetWin virtual serial port(s) for use with the modem server, configure his own backups, and configure other minor features of FacetWin. The Agent is supported on Windows 95/98/ME and Windows NT/2000. WHAT'S NEW IN VERSION 3 o Modem Server. The new modem server feature provides a virtual serial port driver for Windows 95/98/ME PCs that allows a modem on the UNIX host to appear as a directly connected modem. Most Windows applications that use a modem will be able to use a modem from a modem pool on the UNIX server. For example, you can configure a Windows Dial-up Networking connection that uses a modem on the UNIX server. The previous modem server feature that used the FacetWin terminal emulator to access the modem pool on the server has been made obsolete. However, if you have been using this older feature, it will continue to work with FacetWin Version 3. o PC Backup. The new PC backup feature provides many enhancements over the older PC backup. Administrators may backup multiple PCs to disk or tape archives. Tape archives may span multiple tape volumes. Users may be enabled to backup their own PCs. Backups may be full or incremental, compressed or not, and may include large files over 2GB. A graphical interface to backup configurations is included in the FacetWin Administrator program and in the FacetWin Agent Control Panel (described below). Backups can be run from the command line or from the graphical interface. The previous PC backup feature that used the fct_client program has been made obsolete. The fct_client program should now only be used as a file transfer program for performing CIFS file copies from a UNIX command line. o FacetWin Agent. The FacetWin agent is new in Version 3. The FacetWin Agent is a program that runs on the PC in the Windows System Tray. The Agent must be running on the PC in order for the PC to be backed up. The agent also provides a "Control Panel" user interface that allows users to manage their modem server and PC backup configurations. The Agent also allows the FacetWin file and print servers to send coherent error messages to the user. FACETWIN DOCUMENTATION The FacetWin help file is the primary documentation for the FacetWin product. After FacetWin is installed on a PC, the help file is available through the Start menu in the FacetWin program group. It is also available by selecting Help on the menu of the FacetWin terminal emulator. The property sheets in the terminal emulator and the Administrator programs support the "What's this?" help feature of Windows. Information about any item on a property sheet may be obtained by clicking on the "?" icon on the title bar, and then moving the help cursor pointer over the item in question and clicking again. A pop-up help window will be presented with information about the item. There are "man pages" installed with FacetWin on the UNIX server. These man pages describe each of the programs and configuration files installed on the server. To read the overview man page and see a list of the other pages, use the command: man facetwin The printed manual contains the same information as the help file, and is available with the purchase of a FacetWin license. Additional printed manuals may be purchased separately. The on-line help may be more up-to-date than the printed manual since the on-line documentation can be updated with each version of software with which it is included. The printed manual is also supplied in Adobe Portable Document Format (PDF). This file (Fwmanual.pdf) may be downloaded from the FacetCorp website as an optional component when you download the FacetWin software. If you have the Acrobat Reader installed on your PC, you can double-click the Fwmanual.pdf file to open it in Acrobat Reader. If you want to print a copy of the manual, you can do it from Acrobat Reader. Note the number of pages in the manual - you may not want to print the entire manual at once. If you do not have Acrobat Reader installed, the download page has a link to the Adobe web site where you can download it. FACETWIN REQUIREMENTS In order to use the complete FacetWin product, your PCs must be running Windows 95/98/ME or Windows NT4.0/2000 (although the virtual serial port driver required for the modem server functionality is not currently available for NT/2000). The file, print, and e-mail, features of FacetWin are available to PCs running older versions of Windows if they have the Microsoft TCP/IP software installed and configured. The TCP/IP software is included in Windows NT 3.51, but for Windows for Workgroups 3.11, you must download the TCP/IP from Microsoft's web site. FacetWin is installed on each UNIX server that you want included in your Windows network. FacetWin will use 6-8 megabytes of disk space on the UNIX server depending on the platform. Additionally, software is installed on each Windows 95/98/ME and Windows NT 4.0/2000 PC on which you wish to have the terminal emulation, modem server (Windows 95/98/ME only), backup, or FacetWin Administrator functionality. There is no PC installation for older versions of Windows. The FacetWin PC installation uses about 5 megabytes of disk space on the PC. You will complete the UNIX installation first. Then you will install the PC part across the network from a UNIX server which has the FacetWin software installed. FacetWin requires the UNIX server(s) to have TCP/IP operational. In addition, in order to use the FacetWin remote (dial-up) functionality, you must have PPP operational. These services are part of your operating system and should be supported by your operating system vendor. FacetWin is licensed by the number of concurrent PCs that are using FacetWin services. If you have 25 PCs on your network using FacetWin services, then it does not matter how many UNIX servers are providing the services, you only need a 25 user license. Therefore, you will probably eventually want to install FacetWin on all the UNIX servers on your network. However, the general installation plan is to install on one UNIX server first, then on a PC, and ensure that the software is operating properly. Once this first server and PC are using the FacetWin services properly, you can proceed to install on the other servers and PCs. Before you buy a FacetWin license, the software will run up to 50 concurrent users for a period of 30 days. We encourage you to deploy it to as many servers and PCs as you like in order to evaluate its effectiveness in your computing environment. PREPARING THE UNIX HOST Before installing FacetWin on a UNIX server, you should ensure that it is running TCP/IP properly. If you need help getting this accomplished, refer to the operating system documentation, or contact your operating system vendor's support department. If you plan to use the FacetWin remote computing features, it will be necessary to have PPP services installed and working properly on the UNIX server. However, FacetWin can be installed and used on the network without having PPP operational. The PPP configuration can be done at a later time, before beginning use of the remote computing features. PREPARING UNIX INSTALLATION NOTES The following will guide you through decisions that you must make before installing FacetWin on the UNIX server. You will be instructed to create a set of notes that will be used while running the installation procedure. o Determining the Installation Directory for FacetWin. The default installation directory on the UNIX server is /usr/facetwin. You may specify a different location during the installation procedure if you want to relocate it to a different partition with more disk space. The FacetWin installation only uses about 6-8 megabytes of disk space. As you add configuration information, additional space is used, although this is usually small. However, the default location for PC backup disk archives created from the Administrator program is in a subdirectory beneath the installation directory. You may give a disk archive a full path name and locate it anywhere you like, but if you think you might use the default location for large disk archives, then you may need to relocate the installation directory to a larger disk partition. IF YOU WANT TO RELOCATE THE INSTALLATION DIRECTORY, WRITE DOWN THE NAME OF THE ALTERNAME INSTALLATION DIRECTORY THAT YOU WANT TO USE. o Determining the FacetWin File and Print Services Security Mode. You must choose a security method before using FacetWin File and Print Services. Recent changes in Windows have made this choice more complicated. In fact, choosing a security method is probably the most difficult part of configuring FacetWin. Still, it is not hard to do once you read and understand this section. We will walk you through the decision step-by-step and explain the implications of each of the four security methods. The first security method is NT SERVER. This is available to you if you have a Windows NT or Windows 2000 machine on your network that knows the Windows user names and passwords of all of your users. This will usually be your Primary Domain Controller. If you have such a server, then NT SERVER is the recommended security method. Users who connect to shares on the UNIX machine through FacetWin File and Print Services will be authenticated by checking with the NT server that you specify. This method does not expose plain-text passwords on the network, and will work with all Windows clients without the need for any further configuration changes. If you do not have an NT server that has the list of user names and passwords, or if you do not want to trust an NT server to authenticate users who connect to your UNIX machine, you will have to choose one of the other three methods. One of the remaining methods (UNIX) will require you to make a registry change on most Windows client workstations to allow plain-text passwords to be exchanged. The LANMAN security method checks the password that the user entered against an encrypted password that is stored in a file called "fctpasswd" on the UNIX machine. If you choose this method, you will have to enter every user's PC password into this file using the "fct_encrypt" command, and you will have to update it every time the user's Windows password changes. This method does not expose plain-text passwords on the network, and will work with all Windows clients without the need for registry changes. The RHOST security method is not used very often, because it requires fixed IP addresses and a clear understanding of the "$HOME/.rhosts" and "/etc/hosts.equiv" files. It checks the DNS name or IP address of the workstation against these files to decide whether or not to allow access. This method does not expose plain-text passwords on the network, and will work with all Windows clients without the need for registry changes. This method is not recommended unless you have a good understanding of how to use the rhosts and hosts.equiv files on your server. Finally, the UNIX security method is the easiest in some respects, and the hardest in others. It allows your users to use their UNIX user names and passwords to log in. Passwords that are changed using the standard UNIX utilities will be changed for FacetWin access. However, the UNIX security method requires plain-text passwords to be exchanged over the network. This is because Microsoft's password encryption methods are incompatible with the UNIX password file. To compound this problem, some Windows 95 machines and most Windows NT/2000 and Windows 98/ME machines will not work with servers that require plain-text passwords. A registry entry on these workstations must be changed to allow them to connect to a UNIX machine that is using the UNIX security method. Changing the registry is quick and easy, but it must be done to every PC on the network. The real problem with the UNIX security method is the lack of a good error message on workstations that need the registry change. Instead of a message like: "Cannot connect to a server that requires plain-text passwords", Windows 9x gives a message like "Password required for /IPC$". Any password you enter will get the message "Password Incorrect, try again". Once you recognize this Windows behavior, you will know that this workstation needs its registry changed. After evaluating these security options and the consequences of each, choose the security method that you want to use: NT SERVER, UNIX, LANMAN, or RHOST. WRITE DOWN THE METHOD THAT YOU CHOOSE. ALSO, IF YOU HAVE CHOSEN THE NT SERVER SECURITY METHOD, WRITE DOWN THE NAME OF THE NT SERVER THAT WILL BE USED TO AUTHENTICATE USERS. o Determining the Workgroup or Domain to Which the UNIX Server Will Belong. During the installation procedure, you will also be asked to supply the name of the Workgroup or Domain to which the UNIX server will belong. The Workgroup is a Microsoft networking concept for grouping computers together in the Network Neighborhood. The Domain is a security concept for authenticating users. However, once you join an NT domain, you no longer belong to a Workgroup, and your PC will be grouped with other PCs in the same domain in the Network Neighborhood. If you already have PCs configured together on the network and you want the UNIX server to appear in the Network Neighborhood with these PCs, you must determine what name they are already using for the Workgroup or Domain. If you have multiple Workgroups/Domains on your network, at least 1 PC must be in the same Workgroup/Domain as the UNIX server. On a PC that is in the workgroup or domain that the UNIX server will join: Right click on the Network Neighborhood icon. Choose the Properties item on the menu, and the network property sheet will be presented. Choose the Identification tab. WRITE DOWN THE NAME OF THE WORKGROUP OR DOMAIN TO WHICH THE UNIX SERVER WILL BELONG. INSTALLING FACETWIN ON A UNIX HOST At the UNIX server, perform the following steps in order to install FacetWin on the server. 1. Login as root. Copy the "facetwin.z" file and the "install.sh" script to a temporary directory, and then change to that direcory. For example: cp facetwin.z /tmp cp install.sh /tmp cd /tmp 2. Run the installation procedure with the command: sh install.sh 3. The installation procedure will begin. You will be prompted: Have you prepared the UNIX installation notes as described in the installation instructions [Y/N] (default N)? You should have the notes that you created in the previous section. If you do not, answer N and the installation procedure will exit. Next the procedure will prompt: Specify destination directory (Press Enter for /usr/facetwin): Press Enter to accept the default, or choose an alternate FacetWin installation directory. The next prompt will be: Which security method do you want to use for file and print services? Enter 1 for NT SERVER 2 for UNIX 3 for LANMAN 4 for RHOST Select Method [1-4] (or "Q" to quit): Select the method that you have chosen. If you select NT SERVER mode, the next prompt will be: Enter the name of the NT server that will be used to authenticate PC users: The next prompt will be: Enter name of the workgroup or domain that should include this machine (or "Q" to quit): Enter the workgroup or domain name that you wrote down on your installation notes. If your system already has another SMB server installed, you will be given the choice of disabling the existing SMB server or canceling the FacetWin installation. Multiple SMB servers cannot be used on a system at the same time. If you choose to disable the current SMB server, the FacetWin un-installation procedure will restore its configuration if you remove FacetWin. If your system already has another POP3 server installed, you will be asked if you want to replace it with the FacetWin POP3 server. The installation procedure will continue with no further interaction. After the installation procedure is finished, the FacetWin server software should be completely installed. The installation procedure will log all of its output to a file named log.txt which is in the FacetWin installation directory (/usr/facetwin by default). It is a good idea to inspect this file to be sure that there were no error messages that you missed on the screen output. Note that if you install FacetWin multiple times on the same server (as when updating your FacetWin software), that the output from each installation will be appended to this file. Therefore, this file will contain the output from every FacetWin installation that has occurred on this server. PREPARING A WINDOWS 95/98/ME PC FOR FACETWIN Before you can use FacetWin with a PC running Windows 95/98/ME you must have the Windows network system configured properly, especially in regard to the TCP/IP configuration. If you are setting up an NT 4.0 PC or a Windows 2000 PC, you should proceed to one of the following two sections. NOTE: If a PC is running a version of Windows older than Windows 95 then you will not be able to install the FacetWin PC software on that PC. However, by configuring the PC's network properties as described below, it will be able to use the FacetWin file and print services. To examine your PC's network configuration: Right click on the Network Neighborhood icon on your desktop. Choose the Properties option on the menu, and you will be presented with the Network property sheet. The following network components will need to be installed: [o] Client for Microsoft Networks [o] Network Adapter (or Dialup Adapter for PPP) [o] TCP/IP [o] File and printer sharing for Microsoft Networks ** ** Required for sharing local drives or printing to local printers. To add a component that is not already present, press the "Add" button, select the component type, then manufacturer, and finally the network service being added. Each of the required components can be found in: o Client / Microsoft / Client for Microsoft Networks o Protocol / Microsoft / NetBEUI o Protocol / Microsoft / TCP/IP o Service / Microsoft / File and printer sharing for Microsoft Networks o The Adapter must be configured properly for your hardware configuration. If this is not the case, you must get the hardware configured before proceeding with the PC installation of FacetWin. When all of the necessary components are installed, select each one and click the Properties button to bring up its property sheet. The following descriptions indicate the proper settings for each of these. If you have a need to set an option differently than indicated below (except in the case of names specific to your network), then check with the FacetCorp support staff for possible effects this may have on the operation of FacetWin. Client for Microsoft Networks: [x] Logon and restore network connections Select this option if you want mapped network drive connections to be restored when you logon the PC. The settings of the other items on this tab do not affect FacetWin. All of the following are tabs on the TCP/IP property sheet: IP Address Tab: [x] Specify an IP address Supply the IP address that has been assigned to your PC. Each computer on the network must have its own unique IP address. If you are using a DHCP server on your network, then you may select the option "Obtain an IP address automatically" instead of specifying a specific address. WINS Configuration: [x] Enable WINS Resolution Primary WINS Server: [ ] Secondary WINS Server: [ ] Set the either the primary or secondary WINS server address to the IP address of a UNIX server that has FacetWin installed. If you are already using an NT server as your primary WINS server, then make the FacetWin enabled UNIX host your secondary WINS server. If not, then you can set the UNIX host as your primary WINS server. If you do not have another server to be your secondary WINS server, then enter the same address for both the primary and secondary WINS servers. The Scope ID is not supported by FacetWin and its field should be left blank. On Windows 98/ME, rather than having a primary and secondary WINS selection, it has a WINS server search order. Enter the primary WINS server first, and any backup WINS servers afterwards. Gateway: If your local area network is connected to other networks, you will need to specify the address of a computer that is able to perform the routing to the other networks as a gateway. Otherwise, you can leave the list of Installed gateways empty. DNS Configuration: If you have a server on your local area network configured as the Domain Name Server, you can enable DNS and supply that server's address here. However, this is not required for FacetWin operation. NOTE: If you have the DNS configuration set up to point to your Internet provider, and you access that provider via Dial-up Networking, you should take the DNS address out of the Network properties, and put it in the TCP/IP properties of the Dial-up Networking configuration that is used to dial-up your Internet provider. Bindings: [x] Client for Microsoft Networks [x] File and printer sharing for Microsoft Networks The "Client for Microsoft Networks" item must be checked. The "File and printer sharing for Microsoft Networks" item must be checked if you want the UNIX system to be able to access the PC's network resources. This is necessary if you want to use the FacetWin remote printing feature to allow a printer attached to your PC to function as a UNIX printer. It is also necessary if you want to use the FacetWin fct_client program to copy files to or from your PC from a UNIX command prompt. NOTE: If you use Dial-up Networking to access an Internet provider, you may be warned and asked if you want to turn off the File and Printer sharing before connecting to the Internet. Do not turn this off if you want FacetWin browsing, remote printing and remote access features to work properly. Advanced: The check box "Set this protocol to be the default protocol" at the bottom of the tab should be checked (it may be disabled and checked). The remainder of the Advanced tab may be left unaltered. NetBIOS: On later versions of Windows 95 and on Windows 98/ME, there is a NetBIOS tab on the TCP/IP Properties. If your PC has this tab, be sure that the box labeled "I want to enable NetBIOS over TCP/IP" is checked (it may be disabled and checked). That is all of the TCP/IP configuration. Click OK on the TCP/IP property sheet and return to the main Network Properties sheet. On the main Network Properties sheet, select File and printer sharing for Microsoft Networks and click on Properties. The "Browse Master" item must be set to "Automatic" or "Enabled" on at least one PC on each subnet for browsing to work. The "LM Announce" item should be set to "NO" unless you have a legacy Lan Manager 2.x domain on the network. In that case set the LM Announce item to "YES". Click OK on the Network Properties to save any changes you made. If you are given a message about rebooting, you must reboot before the changes will take effect. PREPARING A WINDOWS NT 4.0 PC FOR FACETWIN Before you can use FacetWin with a PC running Windows NT 4.0, you must have the Windows network system configured properly, especially in regard to the TCP/IP configuration. To examine your PC's network configuration: Right click on the Network Neighborhood icon on your desktop. Choose the Properties option on the menu, and you will be presented with the Network property sheet. Select each of the tabs and configure as instructed. The following descriptions indicate the proper settings for each of these. If you have a need to set an option differently than indicated below (except in the case of names specific to your network), then check with the FacetCorp support for possible effects this may have on the operation of FacetWin. Services: The following network components will need to be installed: o Computer Browser o NetBIOS Interface o Server o Workstation To add one of these services that is not already present, click on the Add button and select the service that you need to add from the list presented. Protocols: You must have the TCP/IP Protocol in the list. If you do not, click on the Add button and select TCP/IP form the list presented. Select the TCP/IP Protocol in the Network Protocols list, then click on the Properties button. The TCP/IP properties will be presented. All of the following are tabs on the TCP/IP property sheet: IP Address: Supply the IP address that has been assigned to your PC. Each computer on the network must have its own unique IP address. If you are using a DHCP server on your network, then you may select the option "Obtain an IP address from a DHCP server" instead of specifying a specific address. If your local area network is connected to other networks, you will need to specify the address of a computer that is able to perform the routing to the other networks as a gateway. Otherwise, you can leave the Default Gateway address empty. DNS: If you have a server on your local area network configured as the Domain Name Server, you can enable DNS and supply that server's address here. However, this is not required for FacetWin operation. NOTE: If you have the DNS configuration set up to point to your Internet provider, and you access that provider via Dial-up Networking, you should take the DNS address out of the Network properties, and put it in the TCP/IP properties of the Dial-up Networking configuration that is used to dial-up your Internet provider. WINS Address: Set the either the primary or secondary WINS server address to the IP address of a UNIX server that has FacetWin installed. If you are already using an NT server as your primary WINS server, then make the FacetWin enabled UNIX host your secondary WINS server. If not, then you can set the UNIX host as your primary WINS server. Routing: The Routing tab of the TCP/IP properties has no settings that are relevant to FacetWin. DHCP Relay: You may have a DHCP Relay tab on your TCP/IP property sheet. If so, there are also no settings on this tab that are relevant to FacetWin. That is all of the TCP/IP configuration. Click OK on the TCP/IP property sheet and return to the main Network Properties sheet. After returning to the Network screen, Choose the Adapters tab of the Network property sheet. The Adapter must be configured properly for your hardware configuration. If this is not the case, you must get the hardware configured before using the PC with FacetWin. Bindings: In the "Show bindings for" drop down box, choose "all services". Expand the Workstation node in the tree. The "WINS Client (TCP/IP)" item must be enabled. To enable, click once on WINS Client(TCP/IP) under the Workstation node, then click the Enable button at the bottom. Click OK on the Network Properties to save any changes you made. If you are given a message about rebooting, you must reboot before the changes will take effect. PREPARING A WINDOWS 2000 PC FOR FACETWIN Before you can use FacetWin with a PC running Windows 2000, you must have the Windows network system configured properly, especially in regard to the TCP/IP configuration. To examine your PC's network configuration: Right-click on the "My Network Places" icon on your desktop. Choose the Properties option on the menu, and the "Network and Dial-up Connections" folder will be presented. Right click on the "Local Area Connection" icon in this folder. Choose the Properties option on the menu, and the Local Area Connection property sheet will be displayed. The following network components will need to be installed: [o] Client for Microsoft Networks [o] File and printer sharing for Microsoft Networks ** [o] TCP/IP ** Required for sharing local drives or printing to local printers. These components should already be installed on your PC. If any component is missing, click on the Install button, select the component type, click ADD, select the component that is needed, and then click OK. Once all the necessary components are present, select the TCP/IP Protocol in the list, and click on the Properties button. The TCP/IP properties will be presented. Supply the IP address that has been assigned to your PC. Each computer on the network must have its own unique IP address. If you are using a DHCP server on your network, then you may select the option "Obtain an IP address automatically" instead of specifying a specific address. If your local area network is connected to other networks, you will need to specify the address of a computer that is able to perform the routing to the other networks as a gateway. Otherwise, you can leave the Default Gateway address empty. If you have a server on your local area network configured as the Domain Name Server, you can supply that server's address. However, this is not required for FacetWin operation. Click on the Advanced button and another property sheet will be presented. Select the WINS tab. Add the IP address of a UNIX server that has FacetWin installed to the WINS server list. If you are already using an NT server as your primary WINS server (first in the list), then add the FacetWin enabled UNIX host somewhere below the primary server in the list. If you are not using another WINS server, then you can add the UNIX host as the first WINS server. That completes the TCP/IP configuration. Click OK on the Advanced TCP/IP Settings property sheet and return to the main TCP/IP property sheet. Click OK on the TCP/IP property sheet and return to the Local Area Connection property sheet. Click OK on the Local Area Connection property sheet and then close the Network and Dial-up Connections window. GAINING ACCESS TO SHARES ON THE UNIX SERVER Your choice of security method and your network configuration may require that you do some additional configuration before your PC can access file and printer shares on the UNIX server. If your Windows user names are different from your UNIX user names. If your users have Windows user names that are different from their user names on the UNIX server, then you must specify which Windows user names should be mapped to which UNIX user names. This is done in the fct_alias file. This file is in the FacetWin installation directory on the UNIX server (/usr/facetwin by default). Each line in this file associates a UNIX user name with one or more PC user names. Lines beginning with "#" are comments. Instructions for setting up the file are included in the file as comments. If you chose the UNIX security method and you have Windows 95 Build 950 C, Windows 98/ME, or Windows NT/2000 PCs on your network. If you chose the UNIX security method and you have Windows 95 Build 950 C, Windows 98/ME or Windows NT/2000 PCs on the network, then these PCs must be enabled to send plain text passwords before they can access the UNIX file shares. The older versions of Windows 95 do not require this fix unless you have installed a security patch from Microsoft. In general, any PC that gets the message "Password required for /IPC$" when trying to connect to a FacetWin share requires this patch. FacetWin includes four registry scripts, one for Windows 95/98, one for Windows ME, one for Windows NT 4.0 and one for Windows 2000. When you apply the appropriate registry script to a PC it will enable that PC to send plain text passwords across the network. The registry script for Windows 95/98 is named w98.reg, the one for Windows ME is named wme.reg, the one for NT 4.0 is named nt4sp3.reg and the one for Windows 2000 is named w2k.reg. These scripts are located in the fwt/registry subdirectory of the FacetWin installation directory on the UNIX server. If you have a way of copying files from the UNIX system to your PC (floppy disk, ftp, etc.) then copy the appropriate script to your PC. You may also download the scripts from our web site at www.facetcorp.com/registry. You apply the registry change by double clicking on the ".reg" file from within Windows. If you chose the LANMAN security method. The LANMAN security method requires that users' DES encrypted passwords be kept up to date in the fctpasswd file. This file is in the FacetWin installation directory on the UNIX server (/usr/facetwin by default). The installation procedure will have built an initial fctpasswd file with user names but no passwords. The passwords must be added using the fct_encrypt program. For information about this program run the command: man fct_encrypt on the UNIX server. If you chose the RHOST security method. If you have chosen the RHOST security method, then you must add the DNS host name of each PC that will access file and print shares to the /etc/hosts.equiv and .rhosts files. For information on these files see the UNIX man pages for hosts.equiv and rhosts. The PC host names must be resolvable by the UNIX system. Once you have completed any of these configuration steps that apply to your situation, then you are ready to test access to shares on the UNIX server. After the PC has been correctly configured for a few minutes, you should be able to see the UNIX server running FacetWin in your PC's Network Neighborhood. Double-click on the Network Neighborhood icon. You should see the UNIX server that is running FacetWin along with the PCs that are in the same workgroup or domain with the server. If the "Details" option is turned on in the View menu of the Explorer window, you should see the server comment "UNIX Server". If the UNIX server does not appear in the Network Neighborhood, proceed to the next section. Double click on the UNIX server's icon in the Network Neighborhood. If you are on a Windows NT 4.0/2000 PC, it may prompt you for a user name and password to use on the UNIX server. Enter a user name and password combination that is valid on the UNIX server. Otherwise, it should present the two shares that are initially defined for the server; FacetWinPC and MyHomeDir. IF THE UNIX SERVER DOES NOT APPEAR IN THE NETWORK NEIGHBORHOOD If the UNIX host where FacetWin is installed does not automatically show up in the Network Neighborhood on your PC, try to find it with the "Find" command on the Start menu. Click on the Start button on the task bar, and then point to the Find command on the main menu. A submenu will be presented, and you should click on the "Computer" item on that menu. A window will be presented prompting for the name of the computer you want to find. Enter the name of the UNIX host where FacetWin is installed, and click on the "Find Now" button. The computer name is case insensitive, so you may enter it in either lower or upper case. If this does not find the server, you can also use the IP address of the server in the find command. Once the UNIX server is found, it will appear in the list at the bottom of the Find Computer window. Open the Network Neighborhood window, and drag the icon for the computer from the Find Computer window into the Network Neighborhood window. That way you can access this computer in the future by double-clicking on its icon in the Network Neighborhood. Another way to try to access the server is to use the "Run" command on the Start menu. Enter two backslashes and the name of the server as the program to run: \\myserver This should cause an explorer window to be opened showing the shares available on the requested server. If you cannot access the FacetWin server with the Network Neighborhood, the Find command, or the Run command, or if you get an error when trying to display the shares on the UNIX server, then contact FacetCorp technical support for help. INSTALLING FACETWIN ON A PC If you do not have Windows 95/98/ME or Windows NT 4.0/2000 on your PC, then you cannot install the PC portion of FacetWin, and you should skip this section. If you are installing on an NT/2000, you must login to the NT as an administrative user in order to install FacetWin. The PC software will be installed from a UNIX host which has FacetWin installed and running: In order to install from the UNIX server, you must have successfully gained access to the file and printer shares on the UNIX server as outlined in the previous section. On your PC, double-click on the Network Neighborhood icon, find the UNIX server on which FacetWin has been installed, and double-click on its icon. If you are installing on a Windows NT 4.0/2000 PC, it may prompt you for a user name and password to use on the UNIX server. Enter a user name and password combination that is valid on the UNIX server. The shares that are currently defined on the server will be displayed. One of the shares will be named "FacetWinPC". Double-click on this icon and the contents of that share will be displayed. Double-click on the "setup.exe" item. The installation will begin on the PC. Follow the instructions on the screen to complete the installation. After the PC software has been installed, a "FacetWin" group will have been added to the Windows Start menu. The items contained in the FacetWin menu group depend on which components you chose to install. If you installed everything, then the following items will have been added: o The "Add a UNIX Application" item is used to create and configure a new FacetWin terminal emulator configuration to run an application on a UNIX server. o The "FacetWin Administrator" item will run the Windows based administration program. o The "FacetWin Agent" item will run the agent program that must be running to backup the PC or display enhanced messages from the FacetWin servers. o The "FacetWin Agent Control Panel" item will run the configuration program that allows users to configure user definable FacetWin features on their PC. o The "FacetWin Help" item will open a help window that displays the contents of the FacetWin help file. The entire FacetWin product is documented in this help file. o The "FacetWin Terminal Configurations" item will open an Explorer window in the folder where all the configurations are kept. You can right click on the configurations displayed there in order to change their properties. You can double click a configuration to start the UNIX application it describes. o The "FacetWin Uninstall" item is used to remove the FacetWin PC software. Run this only when removing FacetWin from the PC permanently. INSTALLING FACETWIN ON ADDITIONAL SERVERS When installing FacetWin on additional UNIX servers on the network, you will follow the same procedure outlined in the Installing FacetWin on a UNIX server section. Since FacetWin is licensed by PC users, there is no additional cost to install it on as many UNIX servers as you want. You should check the Systems file on each of the FacetWin servers to ensure that it has entries for each of the other servers with the desired cooperation between systems setup properly. See the on-line help section "System Coop Tab of the FacetWin Administrator". You must have license sharing set up between the servers in order for all the servers to use the same license. UPDATING YOUR FACETWIN SOFTWARE You can update your FacetWin installation with a new version of the software by installing over your current installation. Do not remove the FacetWin software first, as this will cause you to lose your license registration (or demo license). There is no difference in the software between the FacetWin evaluation and a fully licensed installation. Therefore, you can update your FacetWin software by obtaining a new FacetWin evaluation package, or by downloading a new evaluation from the FacetCorp web site at www.facetcorp.com. Begin by installing the new software on the UNIX server, following the same instructions as for a new installation. As with a new installation, you must be logged in as root. Be sure to accept the default installation directory, which will be your current installation directory. You will not be asked for the security method or the workgroup/domain name when updating the software. All of your configuration files will be left intact. The new default configuration files will have been installed with a file extension of ".default". If you configure FacetWin by editing the configuration files, you can inspect these default files for new settings that you may want to use. If you configure FacetWin with the FacetWin Administrator program, it will update your configuration files with the default values for any new settings the first time you run the new version of the Administrator program. The FacetWin PC software can be updated automatically the next time you start the terminal emulator, agent control panel, or Administrator program. When you start one of these programs, they will determine that there is newer software available for installation and you will be asked you if you want to update your PC software. If you answer yes, then your PC will be updated with the newer FacetWin software automatically. This way, you will always be sure that your PC has FacetWin software which matches the version of the server software. If you get the error: "Could not access the setup program. New software will not be installed.", then you do not have file services access to the FacetWinPC share on this server for some reason. Review the section Gaining access to shares on the UNIX Server to determine what might have caused you to have lost access to this file share on the server. The Administrator program will not run until it is upgraded because it must match the version of the UNIX server software in order to work properly. UNINSTALLING FACETWIN FacetWin provides removal procedures for both the UNIX and PC software. On the PC, exit all terminal emulation and administration sessions. Right click on the FacetWin Agent icon in the Windows system tray on the task bar. Choose item "Close FacetWin Agent". Choose the FacetWin Uninstall item in the FacetWin group of the Start menu. This procedure will remove anything that was installed by the PC installation procedure. It will not remove anything that you have created since installation, such as terminal description files. Therefore, you may need to finish the uninstallation by removing the FacetWin installation directory, and the UNIX Applications group in the Start menu. On the UNIX server, removal is accomplished by logging in as root and running the script: /usr/facetwin/bin/unstall.sh If your FacetWin installation directory is something other than /usr/facetwin, you should use that path when executing the "unstall.sh" script. At the end of this procedure, it will notify you of any other commands that are needed to finish the removal. After you remove FacetWin from the UNIX server, it will lose any license registrations that it previously had. GETTING STARTED WITH FACETWIN The on-line help section "Using FacetWin" provides information from a user's perspective about how to use and configure the various FacetWin components. This section is for anyone who will be using the FacetWin services. After you have installed FacetWin, you will probably want to proceed with further configuration in order to define additional file and printer shares, setup terminal emulator sessions, etc. See the on-line help section "Configuring FacetWin" for detailed instructions on all aspects of configuring the FacetWin servers. The configuration section is primarily for the system administrator. FACETCORP TECHNICAL SUPPORT Please call the FacetCorp Technical Support Department if you have any questions or trouble setting anything up: FacetCorp Voice #: 1-800-235-9901 or 1-972-985-9901 1820 Preston Park Blvd Fax #: 1-800-982-9901 or 1-972-612-2035 Plano, Texas, 75093 Email: support@facetcorp.com USA WWW: http://www.facetcorp.com Copyright (c) 1996-2001 FacetCorp. All rights reserved.