Forms Server Release 6i Deploying Forms Applications to the Web with Oracle Internet Application Server for Windows and UNIX May 2000 Part No. A83591-01 This book contains the information you need to deploy Forms applications to the Web using the Oracle Internet Application Server. Deploying Forms Applications to the Web with Oracle Internet Application Server, for Windows and UNIX Part No. A83591-01 Copyright © 1996, 2000, Oracle Corporation. All rights reserved. Primary Authors: Tony Wolfram, Cathy Godwin Contributing Author: Joan Carter Contributors: Ken Chu, Steve Button, Chris Barrow, Nigel Ferris, Alex Bryant, Hubert Bakker, Duncan Mills The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark of Oracle Corporation. All other company or product names mentioned are used for identification purposes only and may be trademarks of their respective owners. Contents Send Us Your Comments .................................................................................................................. xiii Preface........................................................................................................................................................... xv Intended Audience ............................................................................................................................... xv Structure................................................................................................................................................. xv Related Documents............................................................................................................................. xviii Part I Deploying Forms Applications to the Web 1 Introduction 1.1 The Internet Changes Everything ....................................................................................... 1-1 1.1.1 Improvements in Business............................................................................................ 1-1 1.1.2 Improvements in the Underlying Technology .......................................................... 1-1 1.2 The Oracle Internet Platform ............................................................................................... 1-2 1.3 Oracle Internet Application Server..................................................................................... 1-3 1.4 How This Guide Can Help .................................................................................................. 1-5 2 Overview of Forms Server 2.1 Introduction............................................................................................................................ 2-1 2.2 Forms Server Architecture ................................................................................................... 2-2 2.3 Forms Server Components................................................................................................... 2-3 2.3.1 Forms Applet .................................................................................................................. 2-4 2.3.2 Forms Listener ................................................................................................................ 2-4 iii 2.3.3 Forms Runtime Engine.................................................................................................. 2-4 2.4 Forms Server in Action ......................................................................................................... 2-5 3 Preview of Configuration Choices 3.1 Introduction............................................................................................................................ 3-1 3.2 Sockets, HTTP, or HTTPS..................................................................................................... 3-1 3.2.1 Sockets.............................................................................................................................. 3-2 3.2.2 HTTP ................................................................................................................................ 3-2 3.2.3 HTTPS .............................................................................................................................. 3-3 3.3 Oracle JInitiator or AppletViewer....................................................................................... 3-4 3.3.1 Oracle JInitiator............................................................................................................... 3-4 3.3.2 AppletViewer.................................................................................................................. 3-5 3.4 Load Balancing or standalone configuration .................................................................... 3-5 3.5 Oracle HTTP Server or another Web server ...................................................................... 3-5 3.6 What’s Next............................................................................................................................ 3-6 4 Installing Forms Server 4.1 Introduction............................................................................................................................ 4-1 4.2 About the Oracle Universal Installer .................................................................................. 4-1 4.3 Starting Forms Server............................................................................................................ 4-2 4.4 What’s Next............................................................................................................................ 4-2 5 Configuring the Forms Server 5.1 Introduction............................................................................................................................ 5-1 5.2 Configuring Your Web Server............................................................................................. 5-2 5.3 Customizing Environment Variables ................................................................................. 5-2 5.4 Description of Forms Server Startup Parameters ............................................................. 5-4 5.4.1 Port Parameter ................................................................................................................ 5-4 5.4.2 Mode Parameter ............................................................................................................. 5-4 5.4.3 Pool Parameter................................................................................................................ 5-4 5.4.4 Log Parameter................................................................................................................. 5-5 5.5 Customizing Configuration Files ........................................................................................ 5-5 5.5.1 formsweb.cfg................................................................................................................... 5-5 5.5.1.1 Parameters in the formsweb.cfg File .................................................................... 5-6 iv 5.5.1.2 Default formsweb.cfg File...................................................................................... 5-9 5.5.2 base.htm and basejini.htm .......................................................................................... 5-12 5.5.2.1 Parameters and variables in the base HTML file ............................................. 5-13 5.5.2.2 Usage Notes ..........................................................................................................