Picture Perfect 2.0 Web Browser Version 1.4 Operator`s Guide
Transcription
Picture Perfect 2.0 Web Browser Version 1.4 Operator`s Guide
Picture Perfect 2.0 Web Browser Version 1.4 Operator’s Guide GE Interlogix, CASI Division 791 Park of Commerce Boulevard Suite 100 Boca Raton, Florida 33487 (561) 998-6100 Part Number: 460436004A January 2003 This publication may contain examples of screens and reports used in daily operations. Examples include fictitious names of individuals and companies. Any similarity to names and addresses of actual business enterprises and persons is entirely coincidental. Copyright 1999 - 2003 GE Interlogix All Rights Reserved Printed in the USA Access Vision, Picture Perfect, Secure Area Manager, and MicroProx are trademarks of GE Interlogix. AIX, AIX Windows, IBM, IBM Multiport Adapter, IBM 7855 Modem Model 10, Informix, RISC System/6000, and Token-Ring, are registered trademarks of International Business Machines Corporation. Internet Explorer, Microsoft, and Windows are registered trademarks of Microsoft Corporation. Java is a trademark of Sun Microsystems, Inc. in the United States and other countries, and is used under license. Linux is a registered trademark of Linus Torvalds. Netscape and Netscape Navigator are registered trademarks of Netscape Communications Corporation in the United States and other countries. SPARC is a registered trademark of SPARC International, Inc. The Tarantella logo, and Tarantella are trademarks or registered trademarks of Tarantella, Inc. VeriSign is a trademark of VeriSign, Inc. Digital ID and Digital ID Center are servicemarks of VeriSign, Inc. Contents Contents 1. Using This Manual.................. 1.1 Purpose ................................................... 1.1 Who Should Read this Manual ........... 1.1 Related Documentation........................ 1.2 Terminology........................................... 1.3 Click................................................... 1.3 Select.................................................. 1.3 Press .................................................. 1.4 Command......................................... 1.4 Notational and Typographical Conventions........................................ 1.5 2. System Overview.................... 2.1 Introduction ........................................... 2.1 System Requirements ........................... 2.3 Servers Supported ........................... 2.3 Server Requirements (Picture Perfect Host)................ 2.3 Client Requirements ....................... 2.6 Network Transport ......................... 2.6 Firewalls and Tarantella Ports....... 2.6 Web Browsers Supported .............. 2.7 Connectivity ........................................... 2.8 Use of Java Archives ..................... 2.11 3. Licensing, Installation, and Removal.................................. 3.1 Licensing................................................. 3.1 Picture Perfect Terminal License... 3.1 Installation.............................................. 3.2 Picture Perfect Web Browser Interface Operator’s Guide iii Contents Installing on an Enterprise (Network) Picture Perfect System .........................................3.3 Installing on a Redundant Picture Perfect System...............3.4 Installing the Picture Perfect Web Browser Software..............3.5 Installing the Security Package (Optional)..................................3.13 Generating a Certificate Signing Request (CSR)...........................3.14 Setting up the Browser Workstations.............................3.20 Removal ................................................3.22 Removing the Picture Perfect Web Browser Software............3.22 4. Getting Started........................ 4.1 Initial Setup.............................................4.1 Logging in and Using the Picture Perfect Web Browser ............4.5 Follow-Me Printing .............................4.10 Follow-Me Printing Limitations ..4.11 5. System Administration .......... 5.1 Tarantella Log Files ...............................5.1 Starting/Stopping the Tarantella Server Application .............................5.3 Web Server Documentation .................5.5 Starting/Stopping the Web Server......5.5 Administrative Tools.............................5.9 Data Flow........................................5.11 Firewall Configuration..................5.13 iv Picture Perfect Web Browser Interface Operator’s Guide 00_coverTOC.fm Page v Monday, January 13, 2003 4:26 PM Contents 6. Secure Socket Layer .............. 6.1 Security ................................................... 6.1 Configuring the Secure Socket Layer (SSL) ................................. 6.3 SSL Status indication ...................... 6.9 How to Obtain a Certificate for your Picture Perfect Web Server ... 6.14 Proof of Organization Name ....... 6.15 Customer Survey Software Defect Report Picture Perfect Web Browser Interface Operator’s Guide v Contents vi Picture Perfect Web Browser Interface Operator’s Guide Using This Manual Chapter 1 Purpose This manual provides instructions for installation, initial setup, and configuration of the Picture Perfect Web Browser interface. It also contains information for operating the system once it is installed. Who Should Read this Manual This manual is intended for system administrators who are responsible for the planning and implementation of the system design, and who perform system configuration and setup using Picture Perfect forms that are accessible only to the master-level operator. Operators using the system should read the chapters which relate to their duties. The material in this manual has been prepared for persons responsible for, and familiar with the security needs of the customer facility. Picture Perfect Web Browser Interface Operator’s Guide 1.1 Related Documentation Related Documentation For detailed information on Picture Perfect. Picture Perfect Administration Guide For information on how to use Picture Perfect. Picture Perfect Operator’s Guide ! ! For detailed information about installing and upgrading Picture Perfect on a Risc System. ! 1.2 This manual provides information for Picture Perfect operators who do not have the administrative responsibilities of the system administrator. It covers aspects of the system they are likely to encounter during normal operations. Picture Perfect AIX Edition Installation Guide This manual is a step-by-step guide to help the system administrator connect hardware (HFT subsystem, serial port adapters, ASCII terminals, modems, printers, tape drives, X-Terminals, micros); boot/install AIX; configure AIX for the network, micro communication lines, printers and X-Terminals; install Picture Perfect software and set up X-Terminals. — OR — For detailed information about installing and upgrading Picture Perfect on a Linux System. ! This manual provides information for the system administrator to set up, configure, and manage the Picture Perfect database for the customer’s facility. Picture Perfect Linux Edition Installation Guide This manual is a step-by-step guide to help the system administrator connect hardware (PCs, serial port adapters, modems, printers, tape drives, X-Terminals, micros); boot/install Linux; Picture Perfect Web Browser Interface Operator’s Guide Using This Manual 1 configure Linux for the network, micro communication lines, printers and X-Terminals; install Picture Perfect software and set up X-Terminals. Terminology Click To “click” means to press and release a mouse button while the pointer is on a designated area of the screen in order to display a window or select an option. The press-and-release makes a clicking sound. The term “double-click” means to press and release a mouse button twice in rapid succession. “Left-click” and “right-click” mean to click the button on the left or right side of the mouse. Select The word “select” indicates that you choose an item from the current menu, submenu, form, or picklist displayed on the screen. Use the mouse or the cursor keys to select the item. For example: Select Devices, then Terminals. The statement above tells you to select a certain submenu (Devices) and then to select a certain form (Terminals) from that submenu. If you make the selections with a mouse, you will point to the Devices icon and click the left Picture Perfect Web Browser Interface Operator’s Guide 1.3 Terminology mouse button. When the submenu icons appear, you will point and click on the Terminals icon to select this form. If you make the selections with a keyboard, you will use the cursor keys instead of a mouse pointer, and the Enter key instead of the left mouse button. Press The phrase “press the _____ button” means to use the mouse (or the keyboard) to “press” a designated button on the screen. To press a button with the mouse, point then click the left button. To press a button with the keyboard, use the Tab key and press Enter or Spacebar . Command The word “command” indicates a command which would be typed as specified. 1.4 Picture Perfect Web Browser Interface Operator’s Guide Using This Manual 1 Notational and Typographical Conventions This manual uses certain notational and typographical conventions to make it easier for you to identify important information. Table 1-1: Notational and Typographical Conventions Item Menu Titles, Menu Items, Field Names, Form Titles, Buttons Keys Text you enter Example Administration Enter Micro 1 To reduce the confusion between similar numbers and letters, namely the number 1 and the lowercase letter l along with the number 0 and the letter O, refer to the following list: 1234567890 ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz ! Provides important information in a concise manner. The graphic is displayed on the left side of the page followed by the information. Picture Perfect Web Browser Interface Operator’s Guide 1.5 Notational and Typographical Conventions Table 1-1: Notational and Typographical Conventions (Continued) Item Example Notes Provides additional information. The following graphic is displayed on the left side of the page: Caution Provides information you should know to avoid potential problems, before continuing. The following graphic is displayed on the left side of the page: Warnings Provides information you MUST know to avoid consequences of a disastrous nature, before continuing. The following graphic is displayed on the left side of the page: Operating System AIX Linux Default Entries 1.6 Information for an AIX® system follows this symbol. Information for a Linux™ system follows this symbol. During the installation of the software, you will be prompted with questions. Following the question, a default answer may be shown in brackets, for example: [y] To accept the default answer, you may either press Enter or you may type y and press Enter . For clarity, in this manual we will instruct you to type y Enter . Picture Perfect Web Browser Interface Operator’s Guide System Overview Chapter 2 Introduction The Picture Perfect Web Browser package is a Web interface to Picture Perfect. When implemented, a Picture Perfect operator has the ability to access Picture Perfect using a Web browser, thereby eliminating the need for X-emulation software. By installing the Picture Perfect Web Browser on the Picture Perfect host, all desktops with a Web browser can be given access to Picture Perfect by performing the following steps: 1. Point your browser at the Picture Perfect host address. Result: An authentication applet is automatically downloaded. 2. Enter your login and password. 3. Click Ok. Result: The Picture Perfect Web Browser is launched from which you can access Picture Perfect. Picture Perfect Web Browser Interface Operator’s Guide 2.1 Introduction The Picture Perfect Web Browser is made up of the following components: ❐ Tarantella™ software. ❐ Picture Perfect specific HTML files. Picture Perfect Host Desktop Client Tarantella Picture Perfect Web Server Web Browser: Internet Explorer® Netscape Navigator® Tarantella is an off-the-shelf product available for both Linux and IBM AIX. It was designed to Web-enable UNIX-based applications without requiring the code to be re-written. A Web Server and Tarantella are both installed on the Picture Perfect host. Tarantella opens a session with Picture Perfect and converts the X-display, using AIP (Adaptive Internet Protocol), into a Java™ applet. It then passes the applet to the Web server application. The Picture Perfect operator sees the exact same screens he sees using the traditional X-emulation solution. The functionality of Picture Perfect is basically the same as it is with X-emulation software with the following exceptions: 2.2 Picture Perfect Web Browser Interface Operator’s Guide System Overview 2 • Since the Picture Perfect Web Browser is designed around the concept of client-less client server computing, you no longer define Picture Perfect terminals for specific client PCs. The number of terminals defined in Picture Perfect controls the number of concurrent connections allowed. • Picture Perfect 2.0 Web Browser Version 1.4 allows you to control which virtual terminal is assigned to each operator. Follow the instructions in the Picture Perfect Administration Guide, Appendix F, to configure your virtual terminals for Alarm Routing, Alarm Bumping, and Swipe and Show functionality. System Requirements Servers Supported ❐ Red Hat Linux 7.3 or later ❐ IBM AIX 5L or later Server Requirements (Picture Perfect Host) ❐ 120 MB of space in /root 100 MB temporary space in /usr 52 MB in /tmp for installation files. Picture Perfect Web Browser Interface Operator’s Guide 2.3 System Requirements NOTE AIX An AIX operating system will automatically resize the root filesystem as necessary. Linux If a Linux system does not have the required disk space in the root file system, you have the option of installing in the Photo partition. ❐ At least 128MB RAM (256MB recommended) ❐ 450 MHz minimum processing power ❐ Additional requirements per user: Additional disk space, memory, and processor speed are required for each Tarantella user on the host. ❐ 2.4 # 2.5 MB for each user # 5 MHz for each user # For multiprocessor systems, one processor for every 20 users, assuming 100 MHz processors. Processing Power: 100MHz minimum - Requires 5MHz per concurrent user. Additional requirements per application: Additional memory is required on the host, depending on the number and type of applications you plan to use. Picture Perfect Web Browser Interface Operator’s Guide System Overview 2 # For each X application, 1.5 MB for each user # For each X application displayed using Client Window Management, 2.5 MB for each user # For a full Windows session, 1.7 MB for each user # For character applications, 0.9 MB for each user # For each 3270 or 5250 application, 1.5 MB for each user. Picture Perfect Web Browser Interface Operator’s Guide 2.5 System Requirements Client Requirements ❐ PC clients: 166 MHz processor or greater ❐ 64MB RAM minimum, 128MB recommended ❐ Client devices must support TCP/IP Network Transport ❐ Must support TCP/IP Firewalls and Tarantella Ports In addition to the standard ports necessary to run HTTP traffic, there is another port required for the client to communicate with the server. This port number depends on whether you are using SSL or standard connections. 2.6 • For a standard connection, use port 3144. • For an SSL connection, when the Tarantella Security Pack is installed, use the secure port 5307. It is recommended that the Tarantella Security Pack be used when firewall traversal is required. In this case only, port 5307 should be opened, as well as the ports necessary for HTTP traffic, typically port 80. Picture Perfect Web Browser Interface Operator’s Guide System Overview 2 Web Browsers Supported ❐ NOTE Must support Java, HTML 3.2 and Frames. In general, use the latest released version of JVM (Java Virtual Machine) build and Web browser with configurable JIT (Just in Time) compiler enabled. Do not use beta or preview versions of Web browsers. Table 2-1: Web Browsers Client Operating System Supported Web browsers Windows 98, and Windows NT 4 Netscape Navigator®4.7x, 6.x Microsoft Internet Explorer 4.01, 5.0, 5.01, 5.5, 6.0. Windows ME Netscape Navigator 4.7x, 6.x Microsoft Internet Explorer 5.5, 6.0. Windows 2000 Professional Netscape Navigator 4.7x, 6.x Microsoft Internet Explorer 5.0, 5.01, 5.5, 6.0. Windows XP Professional Netscape Navigator 4.7x, 6.x Microsoft Internet Explorer 6.0. Other Client Types that may be on your Company Network Supported Web browsers Linux® 2.2+ Netscape Navigator 4.7x HP-UX 11.00+ Netscape Navigator 4.7x Picture Perfect Web Browser Interface Operator’s Guide 2.7 Connectivity Table 2-1: Web Browsers (Continued) Client Operating System Supported Web browsers IBM AIX 5L+ Netscape Navigator 4.7x SPARC® Solaris 2.6+ Netscape Navigator 4.7x OS/2 Warp 4.51 Netscape Navigator 4.61 Connectivity The Picture Perfect Web Browser can be used in several different environments: ❐ Intranet An intranet is a company wide LAN (Local Area Network). To implement the Picture Perfect Web Browser for use on an intranet, load the Picture Perfect Web Browser software onto an existing Picture Perfect host. See “Installation” on page 3.2. Once the software is installed, Picture Perfect can be accessed using a Web browser from any client on the intranet. Performance is considerably better than with X-emulation software. The reasons for this are: 1. There is no longer any X-traffic being sent over the network. 2. Screen images are now cached in your local browser. ❐ Extranet An extranet is any extension of the company 2.8 Picture Perfect Web Browser Interface Operator’s Guide System Overview 2 network, that is WAN (Wide Area Network) or remote dial-up access using a modem. If the company has a remote-access server that you can dial into and access the Picture Perfect host, you can launch your browser and connect to Picture Perfect. The requirement for this connection is that it be a PPP (Point-to-Point Protocol) connection with TCP/IP. CAUTION Depending on your network environment, the necessary steps to implement a dialup connection may vary. Your company Information Systems (IS) department must be consulted for setup and configuration. ❐ Internet To connect using the Internet, a Picture Perfect operator needs to connect to their local ISP (Internet Service Provider), and point their browser to the Picture Perfect host. WARNING Configuring a Picture Perfect host to be accessible from the Internet requires the implementation of a properly configured firewall and router. Although the Picture Perfect server is password protected and the communications between it and a browser are SSL encrypted, an improperly configured network and/or firewall can result in a compromise to your system security. Proper setup and configuration requires expert knowledge of the Internet and information such as your company network environment and firewall configuration. Consult your IS department prior to attempting to configure Picture Perfect for use over the Internet. Picture Perfect Web Browser Interface Operator’s Guide 2.9 Connectivity Tarantella makes optimal use of a network to ensure the best performance for a given network load and client type. In a network with low load, Tarantella uses the network bandwidth to service clients ensuring each client has optimal performance. When the network load is high or close to capacity, Tarantella adapts to perform more processing on the server and reduce the amount of information sent to the client. When a client is connected over a slower link such as a WAN, Tarantella can give improved performance over alternative solutions. The Adaptive Internet Protocol (AIP) constantly monitors the network load and client and 'self-tunes' automatically; no intervention is required by the user or the administrator. If the modem connection drops during the course of operation, the unique Tarantella Session Resume Facility will return the user to the exact point at which they were cut off, down to the very last keystroke. This unique capability can even be used to eliminate time wasted by restarting applications when waiting for an application to execute. The Tarantella system administrator can arrange for the application to continue running, no matter how the user accesses the network. For dial-up connection using a modem, the minimum speed required is 28.8k bps; however, a 56k connection is recommended. 2.10 Picture Perfect Web Browser Interface Operator’s Guide System Overview 2 Use of Java Archives Tarantella uses Java applets for a variety of purposes. These Java archives are downloaded from the Tarantella server and either installed or cached locally to the client device's Web browser. Java archives are useful for the following reasons: ❐ They may be compressed, which makes them faster to download. ❐ They may include more than one applet. ❐ Web browsers can keep local copies of Java archives by locally caching or installing them, thus avoiding the need to download them again during future Picture Perfect Web Browser sessions. Installing Versus Caching Java Archives Caching a Java archive means the browser stores the archive in its cache. However, when the cache is full, or if an applet isn't used for a while, the browser may delete the archive. Similarly, if a user manually clears their browser's cache, the archive is deleted. Installing a Java archive is more permanent. Once installed, the archive can only be removed by the user. When a Web browser caches a Java archive, it usually does so without prompting the user. The user may never be aware that the browser has cached the archive. However, when an Picture Perfect Web Browser Interface Operator’s Guide 2.11 Connectivity archive is installed locally, the user will usually be prompted before installation takes place. In most cases, users will have to acknowledge that they want to install the archive locally. Tarantella installs the core Java applets the first time a user connects to the server, and uses caching to provide users with recently accessed information avoiding the need to burden the application server with the same request. Therefore, this can actually reduce the network traffic and amount of processing required on an application server. The Java archives will work correctly with all supported browsers. However, some browsers have settings that can disable support for Java archives. If you have changed a particular browser's configuration, the browser may be unable to install Java archives. You can always re-enable Java archive support by returning the browser to its default configuration. NOTE 2.12 Netscape Navigator 4 users will see a dialog box when they log into the Picture Perfect Web Browser. This dialog box asks users to grant additional privileges to the Java archive, so that a connection can be opened to the server. Users must grant permission for this, otherwise the Picture Perfect Web Browser will be unable to continue. Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal Chapter 3 Licensing To license your Picture Perfect Web Browser, you must add the appropriate Picture Perfect terminal license obtained from GE Interlogix. The Picture Perfect terminal license controls how many Picture Perfect web browser terminals you can define. For more information on setting up the web browser terminals, refer to “Setting up the Browser Workstations” on page 3.20. Picture Perfect Terminal License ➤ To add or change the Picture Perfect terminal license, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type: cd /cas/bin 3. Type: ./pplicense Enter Enter 4. When prompted, enter the Picture Perfect license obtained from GE Interlogix, CASI. Picture Perfect Web Browser Interface Operator’s Guide 3.1 Installation Installation The Picture Perfect Web Browser interface can be installed at the same time the Picture Perfect system is installed or any time thereafter. If installing the Picture Perfect Web Browser at the same time that the BASE Picture Perfect system is being installed, follow the BASE installation instructions in the Picture Perfect Installation Guide to install the BASE package and then refer to this document for the Picture Perfect Web Browser installation. In either case, the Picture Perfect Web Browser will be included on the Picture Perfect installation CD. NOTE Enterprise or Redundant Picture Perfect systems must be completely configured prior to installing the Picture Perfect Web Browser. Installation of the Picture Perfect Web Browser interface on the RS/6000 or Linux server for Picture Perfect involves the following steps: ❐ Installing the Picture Perfect Web Browser software. ❐ Installing the Security Package. ❐ Generating a Certificate Signing Request. These steps are detailed in the following sections. 3.2 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Installing on an Enterprise (Network) Picture Perfect System Read this section before installing on a Picture Perfect enterprise (network) host. ! When the Web Browser package is installed on a Picture Perfect enterprise (network) host, follow this sequence: 1. Stop Picture Perfect on the enterprise (network) host. 2. Verify that Picture Perfect is up and running on all sub-hosts. 3. Continue the installation of the Web Browser package on the enterprise (network) host. 4. Install the Web Browser package on the sub-hosts. NOTE If a subhost is added after Picture Perfect Web Browser is installed on the network host, the following script will need to be run on the network host: /cas/bin/hostterm_cfg.sh This allows the Picture Perfect Network form to recognize the newly added subhost for Picture Perfect Web Browser. Picture Perfect Web Browser Interface Operator’s Guide 3.3 Installation Installing on a Redundant Picture Perfect System Read this section before installing on a Picture Perfect redundant system. ! When the Web Browser package is installed on a Picture Perfect redundant system, follow this sequence: 1. Complete the installation on the primary system first, before performing the installation on the backup system. 2. On the primary system, stop PPRS. Result: A failover to the backup system will occur. 3. Install the Web Browser package on the primary system. 4. Bring up the primary system as backup. 5. Stop PPRS on the original backup system. Result: A failover to the original primary system will occur. 6. Install the Web Browser package on the original backup system. 3.4 Picture Perfect Web Browser Interface Operator’s Guide 3 Licensing, Installation, and Removal Installing the Picture Perfect Web Browser Software 1. Log in to the host as the root user. 2. Type the following to shut down Picture Perfect: . /cas/bin/profile rc.pperf -k Enter Enter Insert the CD-ROM into the drive and mount it with the command appropriate for your host operating system: AIX mntCD Enter If this command is not found, type: mount -v cdrfs -o ro /dev/cd0 /mnt Linux mount /mnt/cdrom Enter Enter 3. Change to the root directory and display a list of installation options by typing: cd / AIX Linux Enter /mnt/INSTALL -o Enter /mnt/cdrom/INSTALL -o Enter Picture Perfect Web Browser Interface Operator’s Guide 3.5 Installation Result: A screen similar to the following will display: Figure 3-1. Installation Options 4. Type 8 to install the Picture Perfect Web Browser package and press Enter . Result: You will be asked to confirm your choice. You have selected the following product(s): 8 ppwb Picture Perfect Web Browser package Is this correct (y/n)? [y] 5. Enter y to confirm the package selection. Result: You will be asked to confirm the installation. 3.6 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Installing ppwb Picture Perfect Multi-package Installation - 1.10 7/9/01 Copyright (C) 1991 thru 2001 GE Interlogix Installing from image in /mnt/cdrom/pp ... 661 blocks Do you want to install the Picture Perfect Web Browser package (y/n)? [y] 6. Type y and press Enter to confirm that you want to install the Picture Perfect Web Browser package. Result: Messages similar to the following will appear on the screen. Figure 3-2. Installation Procedures Picture Perfect Web Browser Interface Operator’s Guide 3.7 Installation 7. Enter y to continue the installation, or n to cancel installation. Result: Messages similar to the following will appear on the screen. Figure 3-3. Sample Installation If the Web Browser package is installed on a Picture Perfect enterprise (network) host, then you will also see messages similar to the following: Preparing to install PPWB package on network host mercury. The network host installation requires that database connectivity is up and running on both the network host and subhosts, and that the '/.rhosti' and '/etc/hosti.equiv' files on the subhosts contains the following entries respectively: /.rhosti file contains the entry 'mercury' /etc/hosti.equiv file contains the entry 'mercury' 3.8 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Checking for database connectivity between mercury and venus... OK. Checking for database connectivity between mercury and mars... OK. If you are installing on a Linux operating system, messages similar to the following will display. Figure 3-4. Tarantella for Linux Setup The installation will now display the Tarantella Software License Agreement. Figure 3-5. Tarantella Software License Agreement Picture Perfect Web Browser Interface Operator’s Guide 3.9 Installation 8. To proceed, enter y. Result: Messages similar to the following will appear on the screen: The 30-day evaluation license will be overwritten with the appropriate licensing information. Figure 3-6. Setting up Tarantella Enterprise 3 9. You must enter y at this prompt. If you change these settings, the Picture Perfect Web Browser will not function properly. Result: Messages similar to the following will appear on the screen as the system configures your installation. 3.10 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Figure 3-7. Tarantella Installation Configuration Picture Perfect Web Browser Interface Operator’s Guide 3.11 Installation Figure 3-8. Tarantella Server Installation Complete Additionally, on an enterprise (network) host, messages similar to the following will display: Creating Web Browser terminals to support Networking... 3.12 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Installing the Security Package (Optional) NOTE For more information on the Security Package, refer to Chapter 6 - Secure Socket Layer. After the successful installation of the Tarantella server, type y to install the Tarantella Security Package, if you plan on using this feature. Figure 3-9. Installing the Tarantella Security Package Picture Perfect Web Browser Interface Operator’s Guide 3.13 Installation Generating a Certificate Signing Request (CSR) A certificate is an electronic form of ID used to identify the holder. Certificates are issued by CAs, whose function is to issue and manage certificates and vouch for the certificate holder. NOTE Before proceeding, please review Chapter 6 Secure Socket Layer for more information regarding CSRs and how they work. In order to use the SSL feature of Picture Perfect Web Browser, you will need to generate a CSR which contains unique information specific to your Picture Perfect host. You will need to copy the CSR that will be generated and present it to a Certificate Authority (CA). When the CA returns the certificate to you, you will need to install it. This section will guide you through the steps to generate the CSR. To copy and install it, please refer to “How to Obtain a Certificate for your Picture Perfect Web Server” on page 6.14 3.14 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 ➤ To generate the CSR: After the installation of the Security Package license key, you will be prompted to generate the certificate request key, or CSR. Figure 3-10. Generating the Certificate Request Key (CSR) 1. Enter y, to generate the CSR now or enter n to generate it later. Result: If you answer n you can generate the CSR later by typing the following: cd /opt/tarantella/bin ./ppwbcert.sh Enter Enter If you answer y, messages similar to the following will display: Picture Perfect Web Browser Interface Operator’s Guide 3.15 Installation Figure 3-11. CSR Settings 2. Answer the questions with the appropriate information for your system, and confirm that each entry is correct. Enter y, to continue. Result: The system will assign a hostname for the certificate, similar to the following example. 3.16 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Figure 3-12. CSR Hostname 3. Verify that the complete host name, including domain, are exactly the way you will be accessing this server. Once you obtain the Server Certificate, it cannot be changed. 4. Press Enter to continue. Result: Messages similar to the following will display: Picture Perfect Web Browser Interface Operator’s Guide 3.17 Installation Figure 3-13. CSR Summary 5. Press Enter to continue. Result: Messages similar to the following will display: Figure 3-14. Completed CSR 3.18 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 This information is copied to a log file: /opt/tarantella/bin/ppwbcert.txt You will need to print this file and send to the CA to obtain your certificate. When you are ready to do this, refer to “How to Obtain a Certificate for your Picture Perfect Web Server” on page 6.14. The following screens will display, as the installation continues. Figure 3-15. Web Browser Installation Complete Picture Perfect Web Browser Interface Operator’s Guide 3.19 Installation 6. The Web Browser installation is now complete and you will be asked to reboot the system. 7. Type y Enter to reboot the system. Setting up the Browser Workstations Traditional X-emulation workstations required that you define a Picture Perfect terminal to correspond with the host name of the terminal. Similarly, with the Picture Perfect Web Browser, you need to define a Picture Perfect terminal for each concurrent browser workstation. However, on a stand-alone system or on a sub-host of an enterprise (network) system, since the browser workstation is not a fixed host name, you do not define the terminal to correspond with a host name of the terminal. Instead, the Picture Perfect terminal names are defined as unix. In these instances, use the following naming convention: • First browser workstation • Second browser workstation unix:11 • Third browser workstation unix:10 unix:12 When installing the Web Browser on a Picture Perfect enterprise (network) host or on a primary or backup redundant host, you will define the terminal to use the host name of the 3.20 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 server to which you are connected. For example, for a server named mercury, the Web Browser workstations would be named mercury:10, mercury:11, and so on. In these instances, use the following naming convention: • First browser workstation hostname:10 • Second browser workstation hostname:11 • Third browser workstation hostname:12 You can create as many terminals for which the system is licensed by incrementing the port number. These terminals do not correspond to specific browser workstations; instead, they work on a first-come first-serve basis. For instance, the first browser that connects uses :10, the second :11. ➤ To define the terminals for the browser workstations: 1. Log in to the host Picture Perfect system as the System Administrator. 2. From the main menu, select Devices, then Terminals. 3. For the Description, type, for example: ppwb1 4. In the Server field, type: Picture Perfect Web Browser Interface Operator’s Guide 3.21 Removal # Standalone system, for example: unix:10 # Network or redundant system, for example: <hostname>:10 5. Press Save. 6. Repeat for each additional web browser workstation. Removal Removing the Picture Perfect Web Browser Software ➤ Follow these steps to remove the Picture Perfect Web Browser interface: 1. Log in as root. Result: You should see a # prompt. 2. Type the following to shut down Picture Perfect: . /cas/bin/profile rc.pperf -k 3. Type: cd / 3.22 Enter Enter Enter Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 4. Start the removal program by typing: ppr Enter Result: Messages similar to the following will appear on the screen. Figure 3-16. Removal Warning 5. To continue, type: yes Enter Result: If you entered yes, a list of the Picture Perfect packages currently installed will be displayed. You will then be asked which package you would like to delete. For example: base graph image impexp ppwb Picture Perfect Web Browser Interface Operator’s Guide 3.23 Removal tours visitor Enter the name of the package to delete: 6. Type: ppwb Enter Result: Messages similar to the following will be displayed. Figure 3-17. Picture Perfect Web Browser Removal 7. Press y Enter to confirm. Result: The removal process will continue, and messages similar to the following will display. 3.24 Picture Perfect Web Browser Interface Operator’s Guide Licensing, Installation, and Removal 3 Figure 3-18. Removal Process Complete 8. Press y Enter . Result: The system will restart. Picture Perfect Web Browser Interface Operator’s Guide 3.25 Removal NOTES 3.26 Picture Perfect Web Browser Interface Operator’s Guide Getting Started Chapter 4 Initial Setup Before logging in for the first time, please verify that the following items have been set up: ❐ AIX The Web server must be up and running. On an AIX system, type: /usr/HTTPServer/bin/apachectl start Linux On a Linux system, type: /etc/init.d/httpd start ❐ Enter The Tarantella server must be up and running. Type: /opt/tarantella/bin/tarantella status Enter For more information, refer to “Starting/Stopping the Tarantella Server Application” on page 5.3 ❐ In order to log into Picture Perfect from the Web Browser, operators must have Enable Remote Login permission set under Control/Permission in Picture Perfect. Picture Perfect Web Browser Interface Operator’s Guide 4.1 Initial Setup ❐ Specific fonts are required for the Common Desktop Environment (CDE) and by Picture Perfect. These fonts are available from the Font Server running on the host and will be set up during the installation process. If, however, you need to manually set up the Font Server, follow the instructions below: ➤ To set up Picture Perfect Web Browser to use the Font Server: 1. Log in as root to the Picture Perfect host using your Web Browser. Click Array Manager. Click the server directory folder. Click X-Protocol Engine. Figure 4-1. Font Server Setup 2. From the menu on the left, click the Array Manager. 3. With your mouse, click on the server name to expand the directory. 4.2 Picture Perfect Web Browser Interface Operator’s Guide Getting Started 4 Click X Protocol Engine. Click Properties. Figure 4-2. X-Protocol Engine Properties 4. Next, click X Protocol Engine and then Properties. Result: A screen similar to the following will display. Picture Perfect Web Browser Interface Operator’s Guide 4.3 Initial Setup Figure 4-3. Font Path 5. In Font Path, on the right, enter a new line, as in the following example: tcp/<hostname>:7100 where <hostname> is the name of your host. 6. Click Apply to save your changes. 4.4 Picture Perfect Web Browser Interface Operator’s Guide Getting Started 4 Logging in and Using the Picture Perfect Web Browser 1. Point your browser to the Picture Perfect host (this document will assume your hostname is pphost) by typing into your browser's location/address box: http://pphost/ppwb/ Result: You will be presented with the login screen. NOTE If http://pphost/ppwb does not give the expected results, try typing the full path: http://pphost/ppwb/index.html NOTE If you are not using a Domain Name Server (DNS) to acquire and resolve the host names of hosts and clients, then you must include the server’s hostname in the clients’s local hosts file. If not, you will not get the Log in screen. Picture Perfect Web Browser Interface Operator’s Guide 4.5 Logging in and Using the Picture Perfect Web Browser Figure 4-4. Picture Perfect Web Browser Login Screen 2. Enter a valid Picture Perfect operator login and password and click Login. Result: The login and password provided is authenticated, access is granted, and you are presented with the Picture Perfect Web Browser welcome screen. (See Figure 4-5.) NOTE 4.6 In order to log into Picture Perfect from the Web Browser, operators must have Enable Remote Login permission set under Control/Permission in Picture Perfect. Picture Perfect Web Browser Interface Operator’s Guide Getting Started 4 For information on how to use Picture Perfect, refer to the Picture Perfect Administration Guide. ! Figure 4-5. Welcome Screen 3. From the Welcome screen, you can access electronic versions of the Picture Perfect Web Browser documentation: • PPWB Release Notes • PPWB Operator’s Guide (this book) Picture Perfect Web Browser Interface Operator’s Guide 4.7 Logging in and Using the Picture Perfect Web Browser Figure 4-6. Release Notes 4. From the Menu frame on the left, you may choose from the following: Click to launch Picture Perfect in a Common Desktop Environment (CDE) window. See Figure 4-9. Click to launch the online help for Tarantella. See Figure 4-10. Figure 4-7. Menu Frame 4.8 Picture Perfect Web Browser Interface Operator’s Guide Getting Started 4 Once a selection has been made, and the application has launched, a green object will appear in the lower left corner of the icon in the Menu frame, indicating that this session is running. Figure 4-8. Picture Perfect Running Figure 4-9. Picture Perfect in a CDE Window Picture Perfect Web Browser Interface Operator’s Guide 4.9 Follow-Me Printing Figure 4-10. Tarantella Help Screen Follow-Me Printing The most common printing requirement is for print jobs to be directed to a local printer, but for mobile workers, 'local' changes from day to day. To address this problem, Tarantella uses a unique print subsystem called Follow-Me Printing. With Follow-Me Printing, upon installation, the Picture Perfect Web Browser creates a Picture Perfect printer that, when print jobs are directed to it, Tarantella re-routes the print job to the local Print Manager on the user’s PC. This means that if a user has a PC running Windows 98, Windows 2000, or Windows NT 4.0, and has a printer defined on that PC, the Picture Perfect Web Browser could be used to 4.10 Picture Perfect Web Browser Interface Operator’s Guide Getting Started 4 connect to Picture Perfect, and reports could be printed from the local PC. . Pause printing Cancel print job Local printer status Figure 4-11. Follow Me Printing Follow-Me Printing Limitations ❐ NOTE In an enterprise (network) or redundant environment, Follow-Me printing is limited to the session of the host to which you are logged in. For example, in Picture Perfect, when logged into an enterprise (network) host, you can access a menu from a subhost. However, if you attempt to use Follow-Me printing from the subhost menu, no report will be printed. Although the Picture Perfect Browser Printer will display on the list of available printers on the Picture Perfect host, it will only be functional for users logged on through the Picture Perfect Web Browser client, not for users logged on through any other terminal. Picture Perfect Web Browser Interface Operator’s Guide 4.11 Follow-Me Printing NOTES 4.12 Picture Perfect Web Browser Interface Operator’s Guide System Administration Chapter 5 Tarantella Log Files ➤ To check the log files of the Tarantella Server, type the following: cd /opt/tarantella/bin Enter ./tarantella query errlog Enter Messages similar to the following will display: Figure 5-1. Error Log File Picture Perfect Web Browser Interface Operator’s Guide 5.1 Tarantella Log Files ➤ To check the uptime of the Tarantella Server, type the following: cd /opt/tarantella/bin Enter ./tarantella query uptime Enter Messages similar to the following will display: Figure 5-2. Uptime File ➤ To check the status of the Tarantella Server, type the following: cd /opt/tarantella/bin ./tarantella status Enter Enter Messages similar to the following will display: Figure 5-3. Status File 5.2 Picture Perfect Web Browser Interface Operator’s Guide System Administration 5 Starting/Stopping the Tarantella Server Application ➤ To start the Tarantella server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: cd /opt/tarantella/bin/ ./tarantella start Enter Enter Result: Messages similar to the following will display: Starting Tarantella server (version 3.20.907). Please wait... Tarantella services are now available on this host. ➤ To stop the Tarantella server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: Picture Perfect Web Browser Interface Operator’s Guide 5.3 Starting/Stopping the Tarantella Server Application cd /opt/tarantella/bin/ ./tarantella stop Enter Enter Result: Messages similar to the following will display: Tarantella services have been stopped. ➤ To restart the Tarantella server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: cd /opt/tarantella/bin/ ./tarantella restart Enter Enter Result: Messages similar to the following will display: Tarantella services are not currently running. Starting Tarantella server (version 3.20.907). Please wait... Tarantella services are now available on this host. 5.4 Picture Perfect Web Browser Interface Operator’s Guide System Administration 5 Web Server Documentation The Web server online documentation can be accessed by pointing your Web browser to: http://<hostname>/manual/mod/ where <hostname> is the name of the Picture Perfect server where the Web server is installed. For more information, go to: www.apache.org Starting/Stopping the Web Server ➤ To start the Web server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: AIX On an AIX system, type: /usr/HTTPServer/bin/apachectl start Linux Enter On a Linux system, type: /etc/init.d/httpd start Enter Picture Perfect Web Browser Interface Operator’s Guide 5.5 Starting/Stopping the Web Server Result: Messages similar to the following will display: apachectl start: httpd started ➤ To stop the Web server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: AIX On an AIX system, type: /usr/HTTPServer/bin/apachectl stop Linux Enter On a Linux system, type: /etc/init.d/httpd stop Enter Result: Messages similar to the following will display: apachectl stop: httpd stopped 5.6 Picture Perfect Web Browser Interface Operator’s Guide 5 System Administration ➤ To restart the Web server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: AIX On an AIX system, type: /usr/HTTPServer/bin/apachectl restart Linux Enter On a Linux system, type: /etc/init.d/httpd restart Enter Result: Messages similar to the following will display: apachectl restart: httpd restarted Picture Perfect Web Browser Interface Operator’s Guide 5.7 Starting/Stopping the Web Server ➤ To check the status of the Web server, execute the following commands: 1. Log in as root. Result: A # prompt will display. 2. Type the following commands: AIX On an AIX system, type: /usr/HTTPServer/bin/apachectl status Linux Enter On a Linux system, type: /etc/init.d/httpd status Enter Result: Messages similar to the following will display: httpd (pid 9395 9394 9393 9392 9391 9390 9389 9388 945) is running... 5.8 Picture Perfect Web Browser Interface Operator’s Guide System Administration 5 Administrative Tools Tarantella provides the following comprehensive graphical management tools, implemented in Java technology, for the administrators of the Tarantella server: ❐ Array Manager ❐ Object Manager Only the designated administrative users can run these tools. Use Array Manager to perform these tasks: • Set up and manage an array of Tarantella servers, for emulator session load balancing. • Configure array-wide settings, and settings for each array member. Use Object Manager to perform these tasks: • Create and configure objects representing the people, hosts, applications and documents within your organization. • Define Webtops for all users of Tarantella, and see whose Webtop any object is on. • Monitor who's running which applications on which application servers, and shadow or end those application sessions. • Find out who's cached passwords for which application servers, and delete password cache entries. Picture Perfect Web Browser Interface Operator’s Guide 5.9 Administrative Tools For complete, detailed, instructions on using these tools, refer to the Tarantella Administration Guide. ➤ To access these tools: 1. Log in to your Picture Perfect Web browser as root. Result: A screen, similar to the following displays. Click here to access the Tarantella Administration Guide Click here to access the Array Manager. Click here to access the Object Manager. Figure 5-4. Tarantella Webtop 2. Click on the icon for the tool you wish to access. 5.10 Picture Perfect Web Browser Interface Operator’s Guide System Administration 5 Data Flow Figure 5-5 outlines the mechanism used by Tarantella to allow clients to connect, deliver their webtop, and run Picture Perfect. The easiest way to explain this route is to go through the steps the client and server take and map these steps according to the figure. Figure 5-5. Data Flow Diagram The user connects using a Web browser to a Picture Perfect host on which the Picture Perfect Web Browser is running. The Web server returns a page containing the Tarantella Picture Perfect Web Browser Interface Operator’s Guide 5.11 Administrative Tools boot-strap applet. This applet connects with the datastore engine on port 3144, which then provides the login applet. The user is authenticated using this applet. If the correct login and password are supplied, a request is issued to the datastore engine to search and find the webtop for that user. A Web page is dynamically created using the objects associated with the user stored in the datastore and then loaded into the browser. This is the webtop. When the user clicks on Picture Perfect, the Web page associated with that object is downloaded, and the correct display engine is downloaded. The display engine issues a request to the datastore engine to find the application. This request is passed onto the Session Manager which checks to see if Picture Perfect is running and needs to be resumed to the user. If Picture Perfect is running, then that session is resumed to the user. If Picture Perfect is not running, the display engine issues another request to the datastore engine to create that application object. This request is forwarded to the Session Manager which invokes the application on the network using a password stored in an encrypted cache if the password has already been supplied. If the password has not been supplied, the user is prompted for a password which is then stored in the encrypted cache. The Session Manager then invokes the correct protocol engine which in turn invokes the application. The Session Manager stores the information about the 5.12 Picture Perfect Web Browser Interface Operator’s Guide System Administration 5 protocol engine used with the application object inside the datastore. The display engine connects to port number 3144, and authenticates itself. The Status Manager receives notice of authentication and passes it onto the Session Manager which then connects the display engine to the right protocol engine. This is the Adaptive Internet Protocol link. The first phase in this link is to pass parameters identifying the characteristics of the client device and network connection. The AIP then tunes itself for optimal performance. Finally, Picture Perfect is displayed on the client, and the AIP monitors any changes in the network characteristics. Firewall Configuration In order to establish communications through a firewall, it is necessary to assign a port to allow the appropriate protocols to pass through the firewall. To ensure that the security of your firewall is not compromised, open only those ports needed for your specific system configuration. Port Number Assignment It is recommended that SSL be used when firewall traversal is required (For more information on SSL, refer to Chapter 6 - Secure Socket Layer). The SSL Picture Perfect Web Browser port number assignment is usually 5307, and this port should be opened. Picture Perfect Web Browser Interface Operator’s Guide 5.13 Administrative Tools The standard (non SSL) Picture Perfect Web Browser port number assignment is usually 3144. ➤ To change the port assignment: 1. Log into the Picture Perfect Web browser as the root user. 2. From the menu on the left, click the Array Manager icon. Click here to display the Array Manager. Figure 5-6. Array Manager Icon 3. In Array Manager, click Array, then Properties. Result: A screen similar to the following will display. 5.14 Picture Perfect Web Browser Interface Operator’s Guide System Administration 5 Click Array Click Properties Figure 5-7. General Array Properties 4. In the connections box of the port you wish to change, type the new value, and click Apply. 5. Click Exit to close the Array Manager. Result: A confirmation dialog will display. 6. Click Yes. Picture Perfect Web Browser Interface Operator’s Guide 5.15 Administrative Tools NOTES 5.16 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer Chapter 6 Security In the real world, we are often asked to prove who we are by using a trusted certificate such as a passport, ID card, or driver's license. We may be called upon to prove we are who we say we are. The same is true in the world of data communications. The emergence of Certificate technologies and Certificate Authorities (CAs) addresses these concerns. A certificate is an electronic form of ID used to identify the holder. Certificates are issued by CAs, whose function is to issue and manage certificates and vouch for the certificate holder. The type of certificate used in the Picture Perfect Web Browser is an X.509 Server Certificate. A Server Certificate is issued by a CA for a particular server (Distinguished Name) and contains the server's Public Key, the owner's organization name, expiry information, and the signature of the issuing body (the CA). When presented to an application, the digital signature is verified by examining the CA signature using the Public Key of the CA, which is built into the requesting client application. The client can then check that it is connecting to the expected server, and not to an Picture Perfect Web Browser Interface Operator’s Guide 6.1 Security impostor inserting itself into the communication stream. The Secure Sockets Layer (SSL) is a protocol, developed by Netscape Communications Corporation, which establishes a secure connection between a client and server using the technologies previously described. The actual encryption algorithm used is developed and licensed by RSA (named after its inventors, Ron Rivest, Adi Shamir and Leonard Adleman). RSA is the only universally accepted Cryptosystem. After completing the steps outlined in “Configuring the Secure Socket Layer (SSL)” on page 6.3, SSL will be enabled for all communication between the Picture Perfect host and the browser client. Although we do not recommend it, the security feature can be turned off completely. However, you can specify when the SSL should and should not be used through settings available to the Picture Perfect Administrator in the Control Center. For example, if you only wanted to use SSL when connecting remotely through a dial-up or internet connection, but did not want to use SSL when connecting through your LAN, you would specify the LAN network segment to be excluded from SSL. This way, when connecting through the LAN, you would not get an SSL connection, but when connecting through any other means, you would. 6.2 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 Configuring the Secure Socket Layer (SSL) 1. Log into the Picture Perfect Web browser as the root user. 2. From the menu on the left, click the Array Manager icon. Click here to display the Array Manager. Figure 6-1. Array Manager Icon 3. In Array Manager, click Security, then Properties. Result: A screen similar to the following will display. Picture Perfect Web Browser Interface Operator’s Guide 6.3 Security Click Security Click Properties Figure 6-2. Array Manager - Security Properties 4. For Connection Types, make sure that Apply when users log in is checked. 5. Click Apply, then Exit to exit the Array Manager window. Result: A confirmation dialog will display. 6. Click Yes to confirm that you want to close the Array Manager. 7. From the menu on the left, click the Object Manager icon. 6.4 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 Click here to display the Object Manager. Figure 6-3. Object Manager Icon 8. From the Object Manager window, click the Browse tab. Result: A screen similar to the following will display. Picture Perfect Web Browser Interface Operator’s Guide 6.5 Security Click Tarantella System Objects Click Properties Figure 6-4. Object Manager - Properties 9. Click Tarantella System Objects, then Properties. 10. On the Attributes tab, click on the button labeled General and from the list displayed, select Connections. Result: A screen similar to the following will display. 6.6 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 Figure 6-5. Object Manager - Connections 11. Click New and fill in the details for the connection. For example, to assign a standard connection to all client devices logging into the domain ge.com, fill in the following: • Client Device: ............. *.ge.com • Tarantella Server: ...... * • Connection: ................ Standard To assign a secure connection to all client devices logging in over the internet, fill in the following: • Client Device: ............. * Picture Perfect Web Browser Interface Operator’s Guide 6.7 Security • Tarantella Server: ......* • Connection: ................Secure 12. Click Apply, then Exit to exit the Object Manager window. Result: A confirmation dialog will display. 13. Click Yes to confirm that you want to close the Object Manager. For more complete, detailed information on customizing your SSL settings, refer to the Tarantella Administration Guide, which can be accessed from the root login menu. 6.8 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 SSL Status indication The first indication that you have installed and properly configured SSL will be on the login screen. Directly beneath the Username/Password entry fields, you should see the words SSL connections available. If you do not see this indication, the Security Package is not installed, not configured properly, or not turned on. See Figure 6-6. Login - SSL Installed. Indicates SSL is installed Figure 6-6. Login - SSL Installed NOTE Regardless of whether or not a particular client gets an SSL, the Username and password will always be SSL encrypted as long as you have the Security Package installed and properly configured. Picture Perfect Web Browser Interface Operator’s Guide 6.9 Security However, this does mean that SSL is available. Depending on your preferences defined earlier in Object Manager, you may or may not be given an SSL connection depending on the IP Address of the machine you are connecting from. There are two ways of determining your connection type once you are logged in. 1. Move your mouse over an object in the left menu bar and then into the narrow yellow area to the left of the object, as indicated in Figure 6-7. Result: The status bar on the bottom of your browser will tell you what type of connection that object will use. See Figure 6-7. Welcome Screen - SSL Installed. Figure 6-7. Welcome Screen - SSL Installed 6.10 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 2. Click the ? icon in the lower left hand corner of your screen and then select Detailed information helpful to diagnose problems. See Figure 6-8. Diagnostics. Click to access the diagnostic screen. Figure 6-8. Diagnostics Result: A screen displaying diagnostic information, similar to the following, will display. Picture Perfect Web Browser Interface Operator’s Guide 6.11 Security Figure 6-9. Diagnostic Information 6.12 Picture Perfect Web Browser Interface Operator’s Guide 6 Secure Socket Layer Although GE Interlogix does not recommend you do so, you can disable the SSL feature of the Picture Perfect Web Browser. ➤ To disable SSL: 1. Log in to the Picture Perfect host as root. 2. Open a new window. 3. Type the following commands: cd /opt/tarantella/bin Enter ./tarantella security stop Enter ➤ To re-enable the SSL: 1. Type the following command: cd /opt/tarantella/bin Enter ./tarantella security start Enter Picture Perfect Web Browser Interface Operator’s Guide 6.13 How to Obtain a Certificate for your Picture Perfect Web Server How to Obtain a Certificate for your Picture Perfect Web Server When you install the Picture Perfect Web Browser, you will be given the opportunity to generate a Certificate Signing Request (CSR). You can then obtain a Certificate for your Picture Perfect server from a CA by providing them with the CSR along with the necessary paperwork. There are a number of certificate authorities that will issue a certificate for your server. The most well known and trusted authorities are Verisign™ (http://www.verisign.com) and Thawte Consulting (http://www.thawte.com). Obtaining a certificate from Verisign is significantly more expensive than obtaining a certificate from Thawte. The reason for this is that a Thawte certificate will not work with older-version Web browsers. However, in order to use the Picture Perfect Web Browser, you must be using a current-version Web browser. Any browser that works with the Picture Perfect Web Browser will not have a problem with a Thawte certificate. Therefore a certificate from either CA will work. In order to obtain a Certificate, you will need to provide the CA with the following: ❐ Proof of organization name. ❐ Proof of right to use domain name. ❐ Letter of Authorization. ❐ 6.14 CSR (Certificate Signing Request). Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 Proof of Organization Name Companies, Corporations, Incorporations For example: Inc., (Pty) Ltd., Plc., B.V., S.A. GmbH You will be required to provide a copy of your official company registration documents or certificate of incorporation in your state or country. CAs are generally very strict, and will not waive these requirements. Partnerships You should be registered with national, state or local authorities. You will be required to provide a copy of a form of verifiable proof of the partnership name. Proprietorships and DBA's If you are a sole proprietor or DBA (Doing Business As), you we will be required to provide a copy of your DBA registration papers for local levies and taxes. Any official correspondence indicating your right to use the name given on your request will generally be sufficient, as long as the CA is able to cross-check with the relevant authority. Picture Perfect Web Browser Interface Operator’s Guide 6.15 How to Obtain a Certificate for your Picture Perfect Web Server Proof of Right to use Domain Name Generally, you will not need proof that your domain is registered to your company exactly as it appears in your CSR. If you will not be using the Picture Perfect Web Browser on the Internet, you probably will not need this. If your domain is registered to a person, the CA will generally require a letter authorizing your organization to use the domain for business purposes from the person to which the domain is registered. If you are a subdivision of the company who owns the domain, the CA will require a letter of proof. If your domain is registered to a company and you have subsequently changed the organization name in any way, the CA will require documentation of proof. Letter of Authorization You will need a signed letter from a high-ranking individual in the organization authorizing the use of a Certificate to authenticate the company during secure online communications. This letter must be printed on the organization's letterhead. The CA requires this proof to prevent unauthorized individuals within an organization from creating an authenticated electronic presence for the organization without proper clearance. The letter needs to establish that the organization's decision-makers have agreed to the use of a 6.16 Picture Perfect Web Browser Interface Operator’s Guide 6_security.fm Page 17 Monday, January 13, 2003 4:22 PM Secure Socket Layer 6 Certificate, and must be signed by the decision-maker and not by someone on their behalf. The letter may also be required to authorize a credit card charge to cover the cost of the certificate. The CSR (Certificate Signing Request) A CSR is a block of encrypted code generated by your server, which contains the unique information about your server that is necessary for the CA to generate your certificate. Once you obtain your certificate, you will need to install the certification on your server before you can use the SSL feature. ➤ To copy your CSR: 1. Log in to the server as root. 2. A # prompt will display. 3. Type the following to open the log file containing the CSR that was generated in the section, “Generating a Certificate Signing Request (CSR)” on page 3.14. cd /opt/tarantella/bin ./ppwbcert.txt Enter Enter 4. Using FTP or a diskette, transfer the file to a Windows PC. Picture Perfect Web Browser Interface Operator’s Guide 6.17 How to Obtain a Certificate for your Picture Perfect Web Server 6. From the Windows PC, open the file in Notepad and using your mouse, select the text indicated in Figure 6-10. Figure 6-10. Sample CSR Log File 7. From the Edit menu, select Copy. 8. Paste the selected text into a file and forward it as instructed by your CA: Verisign™ (http://www.verisign.com) or Thawte Consulting (http://www.thawte.com). 9. When you receive the certificate from the CA, you will need to install it. For instructions on installing your certificate, refer to “The CSR (Certificate Signing Request)” on page 6.17. 6.18 Picture Perfect Web Browser Interface Operator’s Guide Secure Socket Layer 6 ➤ To install your certificate: Your certificate will either be e-mailed to you or you will be instructed to download it. 1. Once you have received your certificate from the CA, save the certificate as a text file somewhere on the Picture Perfect host. For example: /tmp/cert.txt Enter 2. Type the following three commands on your Picture Perfect host: cd /opt/tarantella/bin Enter ./tarantella security certuse </tmp/cert.txt ./tarantella security start NOTE Enter Enter The path to the certificate file should be to the directory in which it was saved, as in our example: /tmp/cert.txt Picture Perfect Web Browser Interface Operator’s Guide 6.19 How to Obtain a Certificate for your Picture Perfect Web Server NOTES 6.20 Picture Perfect Web Browser Interface Operator’s Guide Customer Survey Title of this book: Picture Perfect 2.0 Web Browser Version 1.4 Operator’s Guide My overall rating of this book: ❐ ❐ ❐ ❐ ❐ ❐ Excellent Very good Good Satisfactory Fair Poor What I liked most about this book: What I would change, add, delete, etc. in future editions of this book: Please return this form to: Attn: Technical Writing GE Interlogix, CASI Division 791 Park of Commerce Blvd. Suite 100 Boca Raton, FL 33487 or e-mail your comments to: [email protected] Despite rigorous product testing, some problems cannot be detected in advance. Please let us know if you discover any defects in our software. We value your feedback and want to ensure that our software meets your expectations. Software Defect Report Date:_________________ First Name:_________________ Last Name:________________________ Company Name:_______________________________________________ Phone:_____-_______________ e-mail:____________________________ GE Interlogix Business Partner:__________________________________ Contact:______________________________________________________ Application Software:_______________________ Version:__________ HW Model:__________________________ OS Version:________________ Hardware Platform: Operating System: Severity: Replication: ❐ Intel PC ❐ RS/6000 ❐ Windows ❐ Linux ❐ AIX ❐ Cosmetic ❐ Undesirable ❐ Application Crash ❐ System Crash ❐ Data Loss ❐ Every Time ❐ Frequent ❐ Intermittent ❐ One Occurrence Only Problem Description: (Please be as specific as possible, and explain what you were doing when the problem occurred.) Please fax this form to: GE Interlogix Customer Support (561) 998-6233