FacetWin Download Installation Instructions These instructions describe installing only the FacetWin Terminal emulator. This might be done if another CIFS/SMB system is already in use. To install the full FacetWin package. See INSTALL or install.txt. CONTENTS o FacetWin Features 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 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. The VTP server only install of FacetWin provides: 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. 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. Note that only the sections on the FacetWin terminal emulator will be relevant. 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 FacetWin Terminal product, your PCs must be running Windows 95/98/ME or Windows NT4.0/2000 FacetWin VTP daemon 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, 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. 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. 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. IF YOU WANT TO RELOCATE THE INSTALLATION DIRECTORY, WRITE DOWN THE NAME OF THE ALTERNAME INSTALLATION DIRECTORY THAT YOU WANT TO USE. 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_vtp_only.sh" script to a temporary directory, and then change to that direcory. For example: cp facetwin.z /tmp cp install_vtp_only.sh /tmp cd /tmp 2. Run the installation procedure with the command: sh install_vtp_only.sh 3. The installation procedure will begin. You will be prompted: You are ONLY installing the FacetWin Terminal portion of the FacetWin package. Is this what you want to do? [Y/N] (default N)? 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 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. 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] Network Adapter (or Dialup Adapter for PPP) [o] TCP/IP 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 Protocol / Microsoft / TCP/IP 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. 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. 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. 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. That is all of the TCP/IP configuration. Click OK on the TCP/IP property sheet and return to the main Network Properties sheet. 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 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. 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. 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 if you are using WINS for name resolution. 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] TCP/IP 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. 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. INSTALLING FACETWIN ON A PC If you are installing on an NT/2000/XP, you must login to the NT as an administrative user in order to install FacetWin. If you have a CIFS/SMB server running on the UNIX host on which FacetWin is installed, you may want to create a share for the PC installation software. This will allow you to install and update the PC software. See your CIFS/SMB server for details. Use the following info for the share: Share Name: FacetWinPC Path: /usr/facetwin/fwt (If you have installed FacetWin in a location other than /usr/facetwin, subsituted that location) Comment: FacetWin PC software For instance: [FacetWinPC] path = /usr/facetwin/fwt comment = FacetWin PC software guest ok = yes read only = yes 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. Unselect the FacetWin Administrator and/or the FacetWin Serial Port if they are offered, as they are not used in an emulator only install. If can not or do not want to create a FacetWinPC share, you can download the PC software directly to the PC from the web site: ftp://ftp.facetcorp.com/evals/facetwin/fwt/setup.exe Choose "open", or choose "save" and then double click the setup.exe file in the folder in which it was saved. The installation will begin on the PC. Follow the instructions on the screen to complete the installation. Unselect the FacetWin Administrator and/or the FacetWin Serial Port if they are offered, as they are not used in an emulator only install. 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 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. 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 have created a FacetWinPC share, the FacetWin PC software can be updated automatically the next time you start the terminal emulator. When you start the 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. If you do not have a FacetWinPC share, download the new PC software from the web site, as was done on the original installation. UNINSTALLING FACETWIN FacetWin provides removal procedures for both the UNIX and PC software. On the PC, exit all terminal emulation 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-2003 FacetCorp. All rights reserved.