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 Preparing UNIX Installation Notes o Installing FacetWin on a UNIX Host 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 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. INSTALLING FACETWIN ON A PC 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. 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-2007 FacetCorp. All rights reserved.