Home

Oracle Forms Server and Reports Server

Contents

1. Relinking Oracle Graphics To relink Oracle Graphics for the Oracle Forms Server and Reports Server enter cd SORACLE_HOME graphics60 lib make f ins graphics60w mk install 5 4 Oracle Forms Server and Reports Server Installation Guide 6 Creating User Exits User exits are subroutines that contain embedded SOL commands You can create user exits by modifying the sample source file This chapter describes a Creating User Exits Linking user exits to the Oracle Graphics Web cartridge is not currently supported Linking to Your User Exits Creating User Exits 6 1 Creating User Exits Creating User Exits The iapxtb cand ue xtb c sample files each declare an iapxtb user exit array Following are the files that describe which file is used to define exit tables Oracle Forms uses 0RACLE HOME forms60 lib ue xtb c Oracle Reports uses SORACLE_HOME reports60 lib c Oracle Graphics uses ORACLE HOME graphics60 lib iapxtb c To create user exits 1 Add entries to the sample source file for each user exit Here is a sample source file Define the user exit table extern exitr iapxtb Holds exit routine pointers Um OK ue ok XITCC UR ERR ue err XITCC UE MB ue mb XITCC UE EMP PLAN ue emp plan XITCC char 0 0 O zero entry marks the end e
2. sess 3 18 Testing Oracle Reports Server from the Web sss 3 18 Upgrading the Software ii mrt Eee ERE petet 3 19 Creating or Upgrading Database Objects sess eee eene 3 20 Completing the Installation Verifying Your Installation cessisset e i eene aei edre nnne 4 2 Setting Printer Configuration Files esses eene nene 4 2 Locating and Installing PPD and AFM Files for Your Printers esee 4 2 Setting Up the Default Printefs cuente ederent dette ene nies 4 4 Updating the Toolkit Font Mapping File esee eee eene enne 4 5 Setting Printer Commands Optional seen eene 4 7 Specifying a Default Printer eu ree eere tee irte ette Ga rib deest diia 4 8 Printing to HP PCL Printers m eonun Me iii lides cios 4 8 Testing Printing Capabilities and Fixing Errors esses eee 4 9 Setting Up the Environment deett tle aee ar Ee P dett ad 4 10 Setting Up the LD_LIBRARY_PATH Variable sse eene 4 10 Setting Up the GULES He ER Ena GETE SR 4 11 Getting Help with X and OSF Motif ssssssssseee eene nennen 4 11 Relocating the Key Definition File sees een nennen 4 11 Setting Up the X Window System and Motif Environments sess 4 12 Setting Up Windows Clients oet rte nderit bereit eret dete vedas 4 14 Setting Up Oracle Jinitiator inmenin o n nnne nene p 4 14 Setting Up an
3. Oracle Forms Server and Reports Server Installation Guide Release 6 for Compaq Tru64 UNIX Part No A83531 01 Oracle Corporation welcomes your comments and suggestions on the quality and usefulness of this publication Your input is an important part of the information used for revision Did you find any errors Is the information clearly presented Do you need more information If so where Are the examples correct Do you need more examples What features did you like most about this manual If you find any errors or have any other suggestions for improvement please indicate the chapter section and page number if available You can send comments to us in the following ways E mail osdwriteQus oracle com FAX 650 506 7304 Attn Tom Leah Martin Postal service Tom Leah Martin Platform Release Group Oracle Technology Network 500 Oracle Parkway Mailstop lop5 Redwood Shores CA 94065 USA If you would like a reply please provide your name address and telephone number If you have problems with the software please contact your local Oracle Support Services vii viii Preface Purpose This document provides installation and configuration information for Oracle Forms Server and Reports Server Release 6i This preface describes the following topics Audience Typographic Conventions Command Syntax Related Documentation Oracle Services and Support Audience This document is f
4. Most X servers prevent users on other machines from displaying windows on your screen unless you explicitly give them permission This is done by an access file etc Xn hosts where n is the number of the display The xhost utility allows you to interactively grant or deny systems access to the server To grant access to a remote system run xhost and specify the name with an optional leading plus sign To deny access use a leading minus sign A plus Completing the Installation 4 13 Setting Up Windows Clients sign without a host name gives access to all available systems even if they are not listed in etc Xn hosts A minus sign without a host name restricts access to systems listed in the etc Xn hosts file Running xhost without arguments prints the list of hosts in the etc Xn hosts file and tells you whether they have current access to your display For example assume your workstation is named bambi and you want to grant access to godzilla a remote machine Enter the following on bambi xhost godzilla To allow unlimited unspecified access enter xhost Attention When you grant another machine access all users of that machine have access to your machine s X server For example if you grant machine godzilla access to bambi all users of godzilla have access to the bambi X server Setting Up Windows Clients You can set up the Oracle Forms Oracle Reports and Oracle Graphics servers
5. Tru64 UNIX patches 1 8 Oracle Forms Server and Reports Server Installation Guide Disk Space and Memory Requirements Server Requirements for Oracle Forms Server and Reports Server Oracle Forms Server and Reports Server Release 6i only supports Oracle8 Server Release 8 0 6 Table 1 7 lists the Web server requirements when using Oracle Forms Server and Reports Server on Compaq Tru64 UNIX Table 1 7 Forms Web Server Requirements Database Item Requirements Web server For non cartridge implementations WebDB 2 2 Oracle Application Server 4 0 8 1 or any Web server that supports the transfer of the Java applet For cartridge implementations Oracle Application Server 4 0 8 1 Attention Do not install Oracle Forms Server and Reports Server and the Oracle Application Server in the same ORACLE HOME Relinking Requirements You can relink the Motif Oracle Forms Server and Reports Server tools using dynamic Motif and X11 libraries The Oracle Forms Server and Reports Server distribution provides all necessary components for relinking the character mode Oracle Forms Server and Reports Server tools Disk Space and Memory Requirements Table 1 8 lists disk space database space and memory requirements for Oracle Forms Server and Reports Server These are minimal estimates not precise calculations To calculate the total disk space requirement decide which products and options are required for your ins
6. For the Bourne or Korn shells DISPLAY machine name 0 0 export DISPLAY xhost For the C shell oe setenv DISPLAY machinename 0 0 xhost oe Note Oracle does not support PC Xserver emulators If you are having a problem with an emulator on a PC try to duplicate the problem on your server s console Setting Up the Environment 2 5 Setting Up Environment Variables For more information see Setting Up the DISPLAY Environment Variable on page 4 13 Setting Up the LD LIBRARY PATH Variable LD LIBRARY PATH should be set to include directories where shared libraries are located This variable should include ORACLE_HOME 1ib See Setting Up the LD LIBRARY PATH Variable on page 4 10 Setting Up the ORACLE AUTOREG Variable ORACLE AUTOREG points to the location of your toolkit automation registry file which is named autoprefs oar For the Bourne or Korn shell enter set ORACLE AUTOREG SORACLE HOME guicommon6 tk60 admin export ORACLE AUTOREG For the C shell enter setenv ORACLE AUTOREG SORACLE_HOME guicommon6 tk60 admin Setting Up the ORACLE_BASE Variable ORACLE_BASE is required for OFA compliant installations This variable defines the base of the directory structure for your Oracle installation The oracle operating system user must have read write and execute privileges on this directory If ORACLE BASE is unde
7. JDK Appletviewer 13 8 0 00 Oracle Jinitiator 8 9 0 00 Total Distribution Space Total Database Space Total Required Disk Space Distribution Space Database Space Issues and Restrictions This section describes a restriction that applies to installing Oracle WebServer and describes the languages available for Oracle Forms Server and Reports Server Oracle WebServer Installation If you are using the Oracle Forms Server and Reports Server options do not install Oracle Forms Server and Reports Server and the Oracle Application Server 4 0 8 1 in the same SORACLE HOME National Language Support NLS Message and resource files for Oracle Forms Server and message files for Oracle Reports Server are available for the following languages American English Arabic Chinese Simplified for mainland China Chinese Traditional for Taiwan and Hong Kong Features and Requirements 1 11 Issues and Restrictions a Croatian a Czech for the Czech Republic Danish a Dutch for the Netherlands a Finnish French Canadian a French European a German Greek a Hebrew a Hungarian a talian Japanese a Korean Norwegian Polish Portuguese Brazilian Portuguese Iberian Romanian a Russian Swedish a Slovak for Slovakia a Slovenian Spanish Iberian Spanish Latin American Thai a Turkish Resource files for Oracle Reports Server are available for
8. LETTER Testing Printing Capabilities and Fixing Errors To select a printer and test it perform the following tasks 1 Testthe printing capability Start up any Oracle Forms Server and Reports Server tool and print to the default printer 2 Select a printer from the Choose Printer dialog The Choose Printer dialog lists printers available on your system giving the type and a full description of each Oracle Toolkit obtains this list from the SORACLE HOME guicommon6 tk60 admin uiprint txt file You can choose a printer from the list of available printers You can also specify a new printer and its type To choose a new printer enter its name or choose a corresponding type from the Choose Printer dialog containing the drivers supported by Oracle Toolkit The Toolkit checks to see if the name Completing the Installation 4 9 Setting Up the Environment corresponds to a valid printer If the printer is valid Oracle Toolkit allows you to associate a PPD file with the printer through a file dialog If you do not want to associate a PPD file the Toolkit uses default ppd Setting Up the Environment This section describes how to set up the generic user environment for Oracle Forms Server and Reports Server The environment variable below is required to run Oracle Forms Server and Reports Server regardless of the chosen user interface character mode Motif or Web Setting up the Oracle Forms Server and Repor
9. Up the ORACLE TERM Variable sese nennen 2 6 Setting Up the TWO TASK Variable cisnes 2 8 Removing the ORA NL5393 Variable en es tte ie ere eed 2 8 3 Installation Tasks Mounting the Product Installation CD ROM 1 ccss eee nene 3 2 Installing Oracle Forms Server essent netten EEAS 3 3 Starting the Installer mnis ee e eet e ett po He IER s ed cip d E Eee e 3 3 Customizing Your Installation eee eene nennen 3 4 Selecting Installation Activities and Options sse eee nennen 3 5 Contirming Default Settings ire ete heo pee ae n e eet eo delves 3 7 Setting Up the Software Asset Manager eene enne nennen 3 8 Selecting a COMPONEN business 3 9 Selecting a Machine Configuration sse eee nnne nnne nennen 3 9 Setting Up a Single Machine Configuration sees eene 3 10 Setting Up a Multiple Machine Configuration sse 3 11 Setting Up fora Primary Node invicto 3 12 Setting Up for a Secondary Node cdi a esce tette deeds ded 3 13 Using Oracle Forms Server inicia t tute eem dee HR 3 15 Starting Up and Shutting Down Oracle Forms Server sess 3 15 Testing Oracle Forms Server from the Web esses 3 16 Setting Up Oracle Reports Server esses eee eene e nnns 3 16 Using Oracle Reports Server oi ee ee dte a tie entre 3 18 Starting Up and Shutting Down Oracle Reports Server
10. enable Oracle Forms Server and Reports Server to run in languages other than the default language English a Setting Up the NLS LANG Variable Setting Tk2Motif fontMapCs Note Oracle Forms and Oracle Graphics Runtime files may need to be regenerated if they were previously generated with a different NLS_LANG setting Setting Up the NLS_LANG Variable Oracle Forms Server and Reports Server products use the NLS_LANG environment variable to determine which language territory and terminal character set to use To set NLS_LANG use the following procedure For the Bourne and Korn shell enter NLS LANG language territory character set set export NLS LANG For the C shell enter 9 setenv NLS LANG language territory character set Completing the Installation 4 15 Enabling Use of Other Languages where language is a supported language territory is a supported territory character set isacharacter set supported by the user s terminal Note If NLS LANG is not set the default setting is us7ascii Table 4 1 lists the values supported by Oracle Forms Server and Reports Server products for NLS LANG Table 4 1 Settings for NLS LANG character set Language Name language Value territory Value Value American american america us7ascii Dutch dutch the we8dec netherlands Finnish finnish finland we8dec French french france we8dec German german germany we8dec Ttalian italian italy we8
11. entering su root passwd password 3 Enter the following nohup usr sbin pfs mountd amp 4 Enter the following nohup usr sbin pfsd amp 5 Insert to CD ROM in the tray 6 Enter the following 4 usr sbin pfs mount SD CDROM 3 2 Oracle Forms Server and Reports Server Installation Guide Installing Oracle Forms Server Exit the root account by entering exit Change directories to SD_CDROM A lowercase listing of the directories and files on the CD ROM is shown The mounted CD_ROM appears as a read only file system Installing Oracle Forms Server The Oracle Installer installs Oracle executables programs or software on the system s hard disk Certain Oracle products also require database objects which are stored in the database itself With the RDBMS product for example the database objects include those necessary to create a database such as the system tables and views This section describes performing an installation To upgrade existing software see Upgrading the Software on page 3 19 To create or upgrade database objects see Creating or Upgrading Database Objects on page 3 20 Starting the Installer After you mount the product installation CD ROM the Install Type dialog box appears WARNING Do not run the Installer as the root user Perform the following steps to begin the installation 1 Click OK The preamble txt dialog box appears Click OK The
12. in any form or by any means electronic or mechanical for any purpose without the express written permission of Oracle Corporation If this Program is delivered to a U S Government Agency of the Department of Defense then it is delivered with Restricted Rights and the following legend is applicable Restricted Rights Legend Programs delivered subject to the DOD FAR Supplement are commercial computer software and use duplication and disclosure of the Programs 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 14 Rights in Data General including Alternate III June 1987 Oracle Corporation 500 Oracle Parkway Redwood City CA 94065 Registered Trademarks of Oracle Corporation Oracle the Oracle logo Oracle Book SOL Net and SOL Plus are registered trademarks of Oracle Corporation Non Registered Trademarks of Oracle Corporation Oracle Applications Oracle Developer Oracle7 Oracle Browser Oracle Graphics Oracle Forms Oracle Reports Oracle Installer Oracle Procedure Builder Oracle Terminal Oracle WebServer Oracle Toolkit Oracle8 Oracle8i and PL SQL are trademarks of Oracle Corporation UNIX is a registered trademark in the United States and other countries license
13. page 3 3 Use the Installer provided with Developer 2000 Release 2 1 to de install the old version of Developer 2000 Use the new Installer to install the new version only 2 Atthe Installation Activity Choice dialog box select the Install Upgrade or De Install Software option Select one of the following a Select Default Install for the default options If after selecting Default Install you decide the default options are not adequate for your installation select the Back button and select Custom Install Select Custom Install if you do not want to use the default options The National Language Support NLS dialog box appears when you select Custom Install To use a language other than American English select either A11 Languages or select a language from the displayed list Installation Tasks 3 19 Creating or Upgrading Database Objects Installer prompts and messages are always displayed in American English Atthe Installation Options dialog box select the De Install Software option See Step 4 of Starting the Installer on page 3 6 Continue answering the Installer prompts Atthe Software Asset Manager dialog box select the products you want to upgrade and confirm that you want to delete the old products After the Developer 2000 Release 2 1 products are deleted start the new installer and install the Oracle Forms Server and Reports Server Release 6i products as described in the previous secti
14. the following languages 1 12 Oracle Forms Server and Reports Server Installation Guide Issues and Restrictions American English Chinese Simplified for mainland China Chinese Traditional for Taiwan and Hong Kong Dutch French German Italian Japanese Korean Spanish Iberian Features and Requirements 1 13 Issues and Restrictions 1 14 Oracle Forms Server and Reports Server Installation Guide 2 Setting Up the Environment Use this chapter to prepare your environment for installing Oracle Forms Server and Reports Server after you have verified that the system meets the requirements described in Chapter 1 Features and Requirements This chapter describes Performing Pre Installation Tasks Setting Up Environment Variables Setting Up the Environment 2 1 Performing P re Installation Tasks Performing Pre Installation Tasks Perform the following pre installation tasks Creating a UNIX Account to Own Oracle Software Deciding to Install or Upgrade Database Objects Setting Up the tnsnames ora File Creating a UNIX Account to Own Oracle Software Note You must have root access to your system to complete this step The oracle account is the UNIX account that owns the Oracle Forms Server and Reports Server software after installation You must run the Installer from this account On Compaq Tru64 UNIX log in as root and use the useradd operating system administra
15. version 6i dialog box appears Click OK The Install Type dialog box appears Select one of the following a Default Install Installation Tasks 3 3 Installing Oracle Forms Server Select this option if the Installer default values are appropriate for your installation If after selecting Default Install you decide the default options are not appropriate for your installation you can click the Back button and return to this dialog box If you select this option click OK and go to Selecting Installation Activities and Options Custom Install If you select this option click OK and go to Customizing Your Installation Customizing Your Installation Perform the following steps to customize your installation 1 Define the installation source Specify whether you are installing from a CD ROM or from a staging area You can only choose to install from a staging area during a custom installation When installing directly from the CD ROM you load and install the Oracle distribution in one session Select this option if you are performing a single installation or if you have insufficient disk space to support a staging area If you install from a staging area you can load and install the distribution in distinct phases You must choose between temporary and permanent staging areas If you choose a temporary staging area you load the software into a staging area and the Installer converts the contents into the i
16. weight width charset where the values are separated by periods and face specifies the name of the font the Toolkit uses for printing Common fonts include Palatino Helvetica Courier and Times size specifies the size of the font in points style specifies the style option plain italic oblique underline outline shadow inverted or overstrike If there is more than one style the list must be enclosed in parentheses for example plain italic weight specifies the weight options ultralight extralight light demilight medium demibold bold extrabold or ultrabold width specifies the width option ultradense extradense dense semidense normal semiexpand expand extraexpand or ultraexpand charset specifies the name of a character set This option is not supported in the current release The following rules apply Any Arial that has both italic and overstrike styles maps to a 12 point font Each font line may be continued to the next line by using the backslash Separate each element from the next by a period Combine styles using the plus sign to delimit parts of a style For example Helvetica 12 ItalictOverstrike Helvetica 12 Italic Bold maps any Helvetica 12 point font that has both italic and overstrike styles to a 12 point bold italic Helvetica font 4 6 Oracle Forms Server and Reports Server Installation Guide Setting P rinter Configuration Files Use quo
17. when used in regular text ellipses Ellipses indicate an arbitrary number of similar items CHKVAL fieldname valuel value2 valueN italics Italic type indicates a variable Substitute a value for the variable library name vertical line A vertical line indicates a choice within braces or brackets SIZE filesize K M Related Documentation For additional information related to Oracle Forms Server and Reports Server see Oracle Forms Developer and Reports Developer Guidelines for Building Applications This document describes Oracle Browser Oracle Forms Oracle Graphics Oracle Procedure Builder Oracle Project Builder and Oracle Reports Use your Web browser to view this document in SORACLE HOME doc60 admin manuals US guide60 atgtoc htm Oracle Services and Support A wide range of information about Oracle products and global services is available on the Internet from http www oracle com The sections below provide URLs for selected services Oracle Support Services Global Support Sales offices are listed at http vww oracle com support Templates are provided to help you prepare information before you call You will also need your CSI number if applicable or complete contact details including any special project information Products and Documentation Oracle Store for U S A customers is at http oraclestore oracle com Links to stores in other countries are provided from this site Cu
18. 2 Oracle Forms Server and Reports Server Release 6i Tools Oracle Product Character Mode Motif v1 1 Web Oracle Browser Release 6i No Yes No Oracle Forms Release 6i Yes Yes Yes Oracle Graphics Release 6i No Yes Yes Oracle Reports Release 6i Yes Yes Yes Oracle Procedure Builder Release 6i No Yes No Oracle Project Builder Release 6i No Yes No Note Oracle Forms Server and Reports Server does not have a character mode designer and there is no character mode runtime component for Oracle Graphics or Oracle Browser The designer component of all Oracle Forms Server and Reports Server products and the runtime component of Oracle Graphics and Oracle Browser support only the Motif graphical user interface Online Documentation and Help Installation Guide Oracle Forms Server and Reports Server for Compaq Tru64 UNIX documentation is included with this Oracle product distribution To access the documentation use your browser to open the unixdoc Server index htm file on the CD ROM The index htm file contains links to the platform specific documentation The browser you use to view Oracle product documentation should support HTML level 3 If you do not have a browser installed on the system use an Oracle supplied browser Your Oracle distribution includes both character mode and Motif browsers which you can install or run directly from the CD ROM The browsers are in the orainst directory To start a browser enter Features an
19. 386 console 386 AT386 xterm 386x UnixWare Terminal 386u Intel xterm 386s Data General 200 dgd2 Data General 400 dgd4 IBM High Function Terminal and aixterm monochrome hft IBM High Function Terminal and aixterm color hftc hpterm terminal emulator and HP 700 9x terminal hpterm IBM 3151 terminal 3151 for IBM NCD X Terminal with vt220 style keyboard ncd220 Sun cmdtool shelltool using a type 4 keyboard sun Sun cmdtool shelltool using a type 5 keyboard sun5 vt100 terminal vt100 vt220 terminal vt220 Wyse 50 or 60 terminal wy50 Wyse 150 terminal wy150 Setting Up the Environment 2 7 Setting Up Environment Variables Table 2 3 Supported Terminals for the Oracle Installer To Run Set ORACLE TERM to Sun xterm using a type 4 keyboard xsun Sun xterm using a type 5 keyboard xsun5 Setting Up the TWO TASK Variable When installing database objects set the TWO TASK environment variable to the correct alias for the database where you want to create the database objects Removing the ORA NLS33 Variable For the Installer to function properly the ORA NLS33 environment variable used in earlier releases cannot be set Check to see if the variable is set by entering echo SORA NLS33 If the variable is set to any value remove it For the Bourne or Korn shell enter unset ORA NLS33 For the C shell enter unsetenv ORA NLS33 2 8 Oracle Forms Server and Reports Server Installation
20. Applet Viewer eene nnne nnne nennen ronca canso 4 14 Enabling Use of Other Languages eese een n nnns 4 15 Setting Up the NLS LANG Variable esee nnns 4 15 Setting TK2Mouf fontMAapCs ceste tene rere e Eee e ie eher dee e adde ee dta e 4 16 Setting Up the Post Install Environment sees eee 4 17 Administration Administering Oracle Forms ninnu ieie a aa ap a a nenenens 5 2 Oracle Forms Executables rnice e ins 5 2 Deploying Oracle Forms on the Web eee nennen ennt 5 2 Relinking Oracl amp Porms ee noseDet enge e Debbie Ere eis 5 2 Administering Oracle Reports scossone irina eene I A veste i rente it at 5 3 Oracle Reports Executables iii ii ai cada dss 5 3 Deploying Oracle Reports on the Web sss eene nnne 5 3 Relinking Oracle Reports 1 idee Pie eet ePi e iere eei e pnt 5 3 Administering Oracle Graphics sese eene nnne nennen 5 4 Oracle Graphics Executables rite aio 5 4 Deploying Oracle Graphics on the Web ee eene 5 4 Relinking Oracl Graphics 5 1 erecto tee etre e ene patiens 5 4 6 Creating User Exits Creating User Exits c oorr pe te toot eet ee iot thes tof 6 2 Linking to Your User Exils oce e eue tee ree rrr ena 6 3 Linking to Oracle Forms iere n eire i ne eie e ner ere reete 6 3 Linking to Oracle Reports ee e nnne ia 6 3 Linking to Oracle Graphics eee eet ta eee erede 6 3 Index vi Send Us Your Comments
21. Guide 3 Installation Tasks This chapter describes the installation of Oracle Forms Server and Reports Server Before beginning this chapter complete the tasks described in Chapter 2 Setting Up the Environment This chapter describes the following topics Mounting the Product Installation CD ROM Installing Oracle Forms Server Using Oracle Forms Server Setting Up Oracle Reports Server Using Oracle Reports Server Upgrading the Software Creating or Upgrading Database Objects Installation Tasks 3 1 Mounting the Product Installation CD ROM Mounting the Product Installation CD ROM To install Oracle Forms Server and Reports Server use the version of the Installer that is supplied on the Oracle Forms Server and Reports Server CD ROM Note In the following instructions the CD ROM mount point is referred to as cdrom If your mount point is different substitute your mount point name for all references to cdrom Perform the following steps to mount your CD ROM 1 Use your system editor to edit the line in the etc pfs_fstab file that has the following syntax device file mount point filesystem type translation method For example enter the following dev dsk c5t2d0 SD CDROM pfs rrip xlat unix 0 0 where dev dsk c5t2d0 is the CD ROM device file SD CDROM is the mount point pfs rrip xlat unix 0 0 indicates the CD ROM is in Rockridge extension 2 Loginas root by
22. Oracle amp Forms Server and Reports Server Installation Guide Release 6 for Compaq Tru64 UNIX April 2000 Part No A83531 01 Topics Include Features and Requirements Setting Up the Environment Installation Tasks Completing the Installation Administration Creating User Exits ORACLE Oracle Forms Server and Reports Server Installation Guide for Compaq Tru64 UNIX Part No A83531 01 Release 6i Copyright O 1999 2000 Oracle Corporation All rights reserved The programs are not intended for use in any nuclear aviation mass transit medical or other inherently dangerous applications It shall be licensee s responsibility to take all appropriate fail safe back up redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes and Oracle disclaims liability for any damages caused by such use of the Programs This Program contains proprietary information of Oracle Corporation it is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright patent and other intellectual property law Reverse engineering of the software 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 No part of this document may be reproduced or transmitted
23. PD file default ppd Completing the Installation 4 3 Setting P rinter Configuration Files When an invalid PPD file is specified for the current printer for example when an incorrect file is specified or no file is specified the Oracle Toolkit uses default ppd Modifying the PPD Files Do not modify the PPD files unless you want to add fonts to the printer and you want these changes reflected in Oracle applications If you add fonts to your printer also add entries for these fonts to the printer s PPD file The format for a font entry is Font font name encoding version charset where font name specifies the Adobe font name as specified in PostScript encoding specifies the PostScript encoding name version specifies the font s version number charset specifies the Adobe character set name Setting Up the Default Printers To set up default printers for Oracle Forms Server and Reports Server products update the ORACLE_HOME guicommon6 tk60 admin uiprint txt file with entries for each of your printers Using this file enables you to obtain correct paper sizes and correct printer resolution and enables Toolkit application users to set print jobs to use various paper sizes available on the selected printer Oracle Toolkit uses the uiprint txt file located in the SORACLE HOME guicommon6 tk60 admin directory to display the list of printers available on your system Each printer is defined by a line in the uiprint
24. Printer Configuration Files Specifying a Default Printer Oracle Forms Server and Reports Server determines your default printer by searching for values of the following variables in the following order 1 TK6 PRINTER 2 ORACLE PRINTER 3 PRINTER 4 the first entry in your uiprint txt file To specify a default printer set TK6 PRINTER to the applicable printer Note The default printer must be specified in one of the ways listed above otherwise the Printing services and Saving output to file options may be disabled Printing to HP PCL Printers With Oracle Forms Server and Reports Server printing to PostScript ASCIL and HP PCL printers is fully supported Similar to PPD files for PostScript printers HPD or HP glue files provide information on what fonts are available for an HP PCL printer Many HP glue files are provided in SORACLE HOME guicommon6 tk60 admin HPD The HP AutoFont Support Installer available on PCs generates these files automatically Documentation for their file format is available in the HP PCL5 Developer s Guide As with PostScript s AFM files every HP font must have an associated TFM file TFM files should be provided by the font vendor and new fonts should be added to the glue file for your printer when installed The TFM files are located in SORACLE HOME guicommon6 tk60 admin TFM For a new font specify these fields in the glue file FONT fontname tfm
25. Reports Executables Component Executable Name Reports CGI Executable rwcgi60 Multi Tier Server rwmts60 Queue Viewer rwrqv60 Reports Client rwcli60 Reports WebCartridge rwows60 so Deploying Oracle Reports on the Web See Oracle Forms Developer and Reports Developer Guidelines for Building Applications in SORACLE HOME doc60 admin manuals US guide60 atgtoc pdf for information about deploying Oracle Reports on the Web Relinking Oracle Reports In Oracle Forms Server and Reports Server Release 6i Graphics is linked into the Oracle Reports executables automatically You cannot relink Oracle Reports without Oracle Graphics To relink Oracle Reports for the Oracle Forms Server and Reports Server enter cd SORACLE HOME reports60 1ib make f ins reports60w mk install Administration 5 3 Administering Oracle Graphics Administering Oracle Graphics Oracle Graphics Executables Table 5 3 lists the Oracle Graphics executables The executables are in the SORACLE HOME bin subdirectory Table 5 3 Oracle Graphics Executables Component Executable Name Graphics Web Cartridge g60webc so Graphics Web Cartridge Loader g60ldr so Deploying Oracle Graphics on the Web See Oracle Forms Developer and Reports Developer Guidelines for Building Applications in SORACLE_HOME doc60 admin manuals US guide60 atgtoc pdf for information about deploying Oracle Graphics on the Web
26. XKeysymDB file If you have a version of XKeysymDB in usr 1ib X11 decide whether to use the new file as is or merge it with the old file If you decide to use the new file you may want to rename the old file to preserve it a To preserve the original file enter cd usr lib X11 mv XKeysymDB XKeysymDB OLD cd SORACLE HOME guicommon6 tk60 admin a To merge the new file with the existing file add the old material you want to keep into the new file using your system editor To install the new file enter cp XKeysymDB usr lib X11 Note The application code reads the XKeysymDB file at startup time If the application code cannot find the file or if it does not contain all of the relevant OSF keysym values some function keys may not function properly In this case you may receive warning messages similar to the following Warning translation table syntax error Unknown keysym name osfUp Warning found while parsing lt Key gt osfUp ManagerGadgetTraverseUp 3 Exitthe root user account Oracle Motif applications running in an X11R4 environment do not have the capability of locating National Language Support NLS data files Except for this limitation Oracle Motif applications running in an X11R4 environment have the same capability as applications running in an X11R5 environment Setting Up the X Window System and Motif Environments This section describes the follow
27. alled Using Oracle Reports Server You can use scripts to start up and shut down Oracle Reports Server and to test Oracle Reports Server from the Web Starting Up and Shutting Down Oracle Reports Server Oracle Reports Server creates a shell script in the SORACLE_HOME reports60_server file that you can use to start up and shut down the server To start up the server enter reports60_server start To shut down the server enter reports60_server stop Testing Oracle Reports Server from the Web To test Oracle Reports Server go to the following URL 3 18 Oracle Forms Server and Reports Server Installation Guide Upgrading the Software http host name port dev60html runrep htm where host name is your system host name port is the port number running your HTTP listener Upgrading the Software This section describes upgrading from Developer 2000 Release 2 1 to Oracle Forms Server and Reports Server Release 6i It is assumed that Developer 2000 Release 2 1 is installed in your ORACLE HOME before you begin upgrading to Oracle Forms Server and Reports Server Release 6i You must de install old versions of Developer 2000 Release 2 1 products Note Upgrading Developer 2000 to Oracle Forms Server and Reports Server Release 6i does not require a Database Object upgrade Perform the following steps to upgrade the software 1 Start the Release 2 1 Installer as described in Starting the Installer on
28. art Oracle Forms Server at the end of the install No Clicking No will not start Oracle Forms Server at the end of the install The Forms Server parameters dialog box appears 4 Enter the number of the TCP IP port on which Oracle Forms Server will listen for Form execution requests Change the displayed port number if it is already being used by another program 5 Click OK The Forms Server parameters dialog box appears This dialog box has the same name as the previous dialog box 6 Select one of the following a Sockets Select this option to use socket protocols for communication between the Oracle Forms Server runtime engine and the Oracle Forms Server Java applet which runs in your Web browser a HTTP Select this option if communication needs to pass through a firewall For example if your machine is inside a firewall but your Oracle Forms Server applications need to be available to users outside the firewall a HTTPS Select this option if communication needs to pass through a firewall and use a Secure Sockets Layer encryption 7 Click OK 8 Goto the Using Oracle Forms Server section Setting Up a Multiple Machine Configuration If you selected part of a multiple machine configuration in the Selecting a Machine Configuration section the Forms Server Multiple Machine Confirmation dialog box appears Installation Tasks 3 11 Installing Oracle Forms Server Select one of the following to set
29. being used by another program Click OK The Reports Server Web listener dialog box appears Select one of the following a use Oracle WebDB listener Select this option is you want Oracle WebDB listener to be installed and configured for you Oracle WebDB is a light weight listener provided with Oracle Reports Server that supports Common Gateway Interface CGI use another Web listener Select this option to use another Web listener that supports CGI or if you are using Oracle Application Server If you choose this option after the installation is complete instructions will tell you how to configure virtual paths for your listener Click OK The Process Startup dialog box appears Click one of the following a Yes Clicking Yes will automatically start Oracle Reports Server at the end of the install Installation Tasks 3 17 Using Oracle Reports Server No Clicking No will not start Oracle Reports Server at the end of the install The Oracle dialog box appears Typically processing takes at least 20 minutes Then the Reports Security dialog box appears 8 Click one of the following a Yes Clicking Yes will install the Reports Security feature for WebDB No Clicking No will not install the Reports Security feature for WebDB The Configuration instructions for Developer Server dialog box appears 9 Click Yes A dialog box appears The heading of the dialog box indicates where the server was inst
30. ct one of the following Install New Product Create DB Objects Select this option for a new installation of a product This option creates a new SORACLE HOME Install New Product Do Not Create DB Objects Select this option if you have an existing Oracle database or plan to create database objects later Add Upgrade Software Select this option to install or upgrade software in an existing SORACLE HOME Build Oracle8 Staging Area Select this option to create a staging area For example if you will be performing more than one installation of the product A staging area allows you to load your software into a designated directory independent of the actual installation You can complete the installation at a later time Install Documentation Only Select this option to install online documentation You cannot install software when you select this option De Install Software 3 6 Oracle Forms Server and Reports Server Installation Guide Installing Oracle Forms Server Select this option to de install old products before upgrading products using the existing ORACLE HOME Migrate from ORACLE7 to ORACLE8 Select this option to migrate from Oracle7 to Oracle8 5 Click OK Confirming Default Settings After you complete the Selecting Installation Activities and Options section the Environment Variables dialog box appears You set up the environment variables in Chap
31. d Requirements 1 5 Online Documentation and Help cd mount point directory orainst oraview The oraview script invokes the appropriate browser for the system If you want more information about the oraview script enter oraview h Context Sensitive Online Help Oracle Forms Server and Reports Server provides a context sensitive online help system Access online help by selecting Contents from the Help menu For example if you are in a Reports property sheet and need information about a current setting select Help Contents A window containing one or more pages of information about the setting is displayed If the page shown extends beyond the window use Scroll Down to display the rest of the page When you have finished reading help files select Quit Cue Cards Cue cards provide step by step instructions of common tasks To access cue cards select the Help pull down menu then select Cue Cards On Compaq Tru64 UNIX cue cards support playing AVI video files using the Show Me buttons To play the video files you must have an external video player program such as xanim installed on your machine You also need to set the MMTK AVIFPLAYER environment variable to specify the video player program that will play the AVI video files Set MMTK AVIFPLAYER as follows For the Bourne or Korn shell enter MMIK AVIFPLAYER video player name s amp export MMIK AVIFPLAYER For the C shell ente
32. d exclusively through X Open Company Limited All other products or company names are used for identification purposes only and may be trademarks of their respective owners For more information about Oracle s trademarks and intellectual property policies contact the Oracle Legal Department at 650 506 5100 Contents Send US Your Comments 7 0er rettet tete rre te tette tta vii Preface nete test edt esti te t te d ee Ebrei he ER Ea ix Features and Requirements Introduction i ente oet te Hd Hee el che be aiv 1 2 Installation Qvetvlew ree iia 1 3 Client Only Installations ee ed ete et ita ee deri acia 1 3 Client Only Configuration eene etico fevasvestcsectnsssiersteoavalebcaevebsdteseessadsedentssbeseds 1 3 Server Based Installation uds 1 4 Supported User Interfaces A A a 1 5 Online Documentation and Help sees eee enne 1 5 Installati n Gtnde z A RA 1 5 Context Sensitive Online Help sse eene nennen nennen 1 6 Cue Cards seiten ee eset tu o eet dee eh ete E RD TR REOR de 1 6 Related Pu blications ute eese itia E Ud Hee un ion tete 1 7 Oracle8 Server for Compaq Tru64 UNIX Documentation seen 1 7 System Requirements estee o ae nennen nennt teen entente entente teen ennet 1 7 Hardware Requirements eene deo eo eee REED Ere aeter rne 1 7 Operating System RequireMents ccccccccseccssesesscsesesseseessssesesssssesesessscnesececsssesensesesesses
33. dec Japanese japanese japan jal6euc Korean korean korea kol6ksc5601 Spanish spanish spain we8dec Simplified simplified taiwan zhs32eus Chinese chinese Traditional traditional zhp zht32euc Chinese chinese Setting Tk2Motif fontMapCs This section explains how to add an entry to the Tk2Motif file so that the Toolkit can match Oracle character sets with X character sets The setting is called Tk2Motif fontMapCs Add the following line to the file to set k2Motif fontMapCs 4 16 Oracle Forms Server and Reports Server Installation Guide Setting Up the Post Install Environment Tk2Motif fontMapCs xset character set where xset is the name of an X character set character set is the name of an Oracle character set To list all the character sets available on your X Server enter xlsfonts awk F print 14 15 sort u Setting Up the Post Install Environment To define the environment variables for Oracle Forms Server and Reports Server use the script files that the installer creates For Oracle Forms use either the forms60 csh orthe forms60 sh script file For Oracle Reports use the reports60 csh orthe reports60 sh script file You can add lines at the end of the script files to customize them Completing the Installation 4 17 Setting Up the Post Install Environment 4 18 Oracle Forms Server and Reports Server Installation Guide 9 Administration This chapter provides infor
34. ditor to update the file with the information shown in Table 2 2 Table 2 2 tnsnames ora File Values Variable Replace with alias The aliased name of the service being described This is the name you will use to connect to the database hostname The name of the remote host server where the database resides service number The port number on which the Oracle Net8 listener process listens for data packets on the remote host where the database resides This is typically defined in the etc services file ORACLE SID The value of the system identifier sid This is the name of the instance on the host name defined above to which you want to connect Oracle products will look for the tnsnames ora file in the following order 1 The tnsnames ora file in the user s home directory Note the dot before the file name 2 STNS ADMIN tnsnames ora 3 var opt oracle tnsnames ora for Compaq Tru64 UNIX 4 SORACLE HOME network admin tnsnames ora Make sure you put the tnsnames ora file in one of these locations otherwise you cannot connect to the database through Net8 To place the tnsnames ora file in a location other than the default locations SORACLE HOM E network admin or var opt oracle set the TNS ADMIN environment variable to the directory where tnsnames ora is located For example if tnsnames ora resides in the tns directory set TNS ADMIN to tns 2 4 Oracle Fo
35. e of the following Sockets Select this option to use socket protocols for communication between the Oracle Forms Server runtime engine and the Oracle Forms Server Java applet which runs in your Web browser HTTP Select this option if communication needs to pass through a firewall For example if your machine is inside a firewall but your Oracle Forms Server applications need to be available to users outside the firewall HTTPS Select this option if communication needs to pass through a firewall and use a Secure Sockets Layer encryption 9 Click OK 10 Go to the Using Oracle Forms Server section Using Oracle Forms Server You can use scripts to start up and shut down Oracle Forms Server and to test Oracle Forms Server from the Web Starting Up and Shutt ing Down Oracle Forms Server Oracle Forms Server creates a shell script in the SORACLE HOME forms60 server file that you can use to start up and shut down the server To start up the server enter forms60 server start parameters Installation Tasks 3 15 Setting Up Oracle Reports Server where parameters passes Oracle Forms Server parameters to files For example the following script would log all Oracle Forms Server actions in the server log file forms60_server start log server log To shut down the server enter forms60_server stop Testing Oracle Forms Server from the Web To test Oracle Forms Server go to the fo
36. erating System Requirements Software Item Requirement Operating System Compaq Tru64 UNIX 4 0D 4 0E or 4 0F Features and Requirements 1 7 System Requirements To determine your operating system and processor type enter uname a sizer v User Interface Requirements Table 1 5 lists user interface requirements for installing and running Oracle Forms Server and Reports Server products on Compaq Tru64 UNIX Table 1 5 User Interface Requirements Software Item Requirements Window Manager Motif Window Manager mwm Desktop Workspace Manager dtwm X11 Server X11R5 or later Required Motif Patch for Release 6i on Compaq Tru64 UNIX Oracle Forms Server and Reports Server requires a patch to the Compaq Tru64 UNIX Motif runtime library Running without the patch can result in problems such as sporadic application crashes and excessive memory usage Table 1 6 lists the patch numbers for each operating system version kit Table 1 6 Patch Numbers Operating System Compaq Tru64 Version Kit Patch Number Found in Patch 4 0D OSF425X11 405016 4 and above 4 0D DUV40DAS0005 19991007 OSF425 n a 4 0E OSF435X11 405016 2 and above 4 0F OSF440X11 405016 1 and above 4 0F DUV40FAS0003 20000225 OSF440 n a If you have previously installed patches to your Compaq Tru64 UNIX system you can review them by using the dupatch utility Contact your Compaq representative for the latest versions of required Compaq
37. eseenees 1 7 User Interface Requirements seen nennen nennen nennen nennen 1 8 Required Motif Patch for Release 6i on Compaq Tru64 UNIX sse 1 8 Server Requirements for Oracle Forms Server and Reports Server sss 1 9 Relinking Requirerients eene eie teste eit ede fet eoe t ae RI Rede 1 9 Disk Space and Memory Requirements sees 1 9 Issues and Restrictions eite de Ret b tt ee a ete ce Ee tee ete oe GeO ees 1 11 Oracle WebServer Installation esee eene enne nennen tenen neri n tenete tese 1 11 National Language Support NLS sese ener nenne 1 11 2 Setting Up the Environment Performing Pre Installation Tasks s eese eee eee eee ene nne nnne 2 2 Creating a UNIX Account to Own Oracle Software sse 2 2 Deciding to Install or Upgrade Database Objects sss eee 2 3 Setting Up the tnsnames ora File sese eene nennen nennen 2 3 Setting Up Environment Variables sss eee 2 5 Syntax of Environment Variables sese eee eee 2 5 Setting Up the DISPLAY Variable ttr te treinta ied 2 5 Setting Up the LD_LIBRARY_PATH Variable sse eee 2 6 Setting Up the ORACLE AUTOREG Variable sse eee 2 6 Setting Up the ORACLE BASE Variable sss eee eee eene 2 6 Setting Up the ORACLE HOME Variable sss 2 6 Setting
38. fined the Oracle Installer derives the value of ORACLE_BASE from the mount point you provide mount_point app oracle If you define it before starting the Installer session the Installer takes the value of ORACLE BASE from the environment Setting Up the ORACLE HOME Variable ORACLE HOME should be set to the directory where the Oracle software will be installed If performing a client only installation this directory should not contain any Oracle Database Server software Setting Up the ORACLE TERM Variable You can run the Installer in either Motif or character mode If you want to run the Installer in character mode set the ORACLE TERM environment variable to the correct terminal type before installing Oracle Forms Server and Reports Server 2 6 Oracle Forms Server and Reports Server Installation Guide Setting Up Environment Variables Following are examples of using the Borne Korn and C shells for a vt220 terminal type For the Bourne or Korn shell enter set ORACLE TERM vt220 export ORACLE TERM For the C shell enter setenv ORACLE TERM vt220 If ORACLE TERM is not set the Installer uses the value of the TERM environment variable and searches for an equivalent ORACLE TERM resource file Table 2 3 lists common ORACLE TERM settings Table 2 3 Supported Terminals for the Oracle Installer To Run Set ORACLE TERM to ANSI terminal for SCO ansi AT
39. ing topics 4 12 Oracle Forms Server and Reports Server Installation Guide Setting Up the GUI Setting Up the DISPLAY Environment Variable Controlling Display Access with the xhost Utility Setting Up the DISPLAY Environment Variable If you run Oracle Forms Server and Reports Server on a machine that is not your local workstation set the DISPLAY environment variable on the remote machine to the name of your X Windows screen This tells the application which machine server and screen to display its windows The format for the name of the X Windows screen is machine name server screen where machine name specifies the name of the machine you will be using server specifies the sequential code number for the server Screen specifies the sequential code number for the screen optional For example assume your workstation is named bambi and you want to run Motif Forms from a larger machine named godzilla For the Bourne and Korn shell enter the following from godzilla set DISPLAY bambi 0 0 export DISPLAY For the C shell enter the following from godzilla setenv DISPLAY bambi 0 0 The first zero in this example refers to the first server running on bambi The second zero refers to the first screen managed by that server Typically there is just one server and one screen per workstation or X terminal In such cases you can omit the screen specification Controlling Display Access with the xhost Utility
40. irectory since the file is used by the Toolkit to calculate font metrics An AFM file specifies font metric information for Type 1 font programs Each AFM file lists the following information about one font font attributes such as style weight width and character set whether the font is fixed pitch or proportional and the size of each character Oracle provides PPD and AFM files for some common printers and fonts If you cannot find the appropriate file for your printer you can obtain PPD and AFM files from your printer vendor or from Adobe Systems You can also use the default ppd default printer definition file 1 To find the PPD file for your printer enter cd SORACLE_HOME guicommon6 tk60 admin PPD ls ppd more This lists all the PPD files that are included with the Oracle distribution 2 To determine the fonts listed in the PPD file enter grep Font PPD filename more 3 To check whether all the necessary fonts are in the SORACLE HOME guicommon6 tk60 admin AFM directory enter cd SORACLE HOME guicommon6 tk60 admin AFM ls more See your printer documentation to determine the fonts you need for your printer Changing the Default PPD File You can also specify a PPD file by creating a default ppd that is a copy of another PPD file to better describe the local default printer For example enter mv default ppd default ppd old cp another P
41. its to the Oracle Reports Web engine enter the following cd SORACLE HOME reports60 lib make f ins reports60w mk EXITS my iapxtb o userexit1 0 userexit2 0 rwrun60x Replace the default Reports Web engine with your newly relinked executable by entering mv rwrun60x SORACLE_HOME bin rwrun60 Linking to Oracle Graphics Linking user exits to the Oracle Graphics Web cartridge is not currently supported Creating User Exits 6 3 Linking to Your User E xits 6 4 Oracle Forms Server and Reports Server Installation Guide A account creating oracle account 2 2 administering Graphics 5 4 Reports 5 2 5 3 C character mode Developer tools supporting 1 5 client based diagram 1 3 installs 1 3 cue cards 1 6 D Database Objects 3 20 Developer 2000 introduction 1 2 overview 1 2 disk space and memory requirements 1 9 documentation online 1 5 Oracle7 Server 1 7 E executables Graphics 5 4 Reports 5 2 5 3 Index G Graphics administering 5 4 executables 5 4 introduction 1 2 overview 1 2 H hardware requirements 1 7 help context sensitive 1 6 online 1 5 home directory 2 2 implementations character mode 1 5 Motif 1 5 Web 1 5 installation client based 1 3 options 1 3 server based 1 3 Installation Tasks 3 1 introduction to Developer 2000 1 2 memory requirements 1 9 Motif Developer tools su
42. led Oracle Toolkit which provides a uniform programming interface to the underlying user interface Oracle Toolkit makes it possible to create applications that run against multiple user interfaces such as Motif or Windows while retaining the full native look and feel of the interface Installing Oracle Forms Server and Reports Server involves the following steps 1 Satisfy Prerequisites Make sure that the local system satisfies the hardware software memory and disk space requirements for the products you want to install These requirements and restrictions are described in this chapter 2 Check the UNIX Environment Make sure that the UNIX environment is properly set up for the products you want to install See Chapter 2 Setting Up the Environment 3 Install Use the Oracle Installer to install the Oracle software See Chapter 3 Installation Tasks 4 Post Installation Create database objects establish the user environment and configure the installed Oracle products for the local system See Chapter 4 Completing the Installation and Chapter 5 Administration 5 Create User Exits This optional step is described in Chapter 6 Creating User Exits With Oracle Forms Server and Reports Server Release 6i you can deploy applications on the World Wide Web Oracle Forms Server and Reports Server tools are built using standard application programming interfaces APIs allowing organizations to supplement the Oracle Fo
43. llowing URL http host name port dev60html runform htm where host name is your system host name port is the port number running your HTTP listener Setting Up Oracle Reports Server After you complete the Selecting a Component section the Default display for Reports Server dialog box appears Perform the following steps to set up Oracle Reports Server 1 Enter the name of your XWindow display value as follows machine name server number screen number where machine name is the host name of the server server number is the number of the X11 server you are using typically it has a value of zero screen number is the number of the X11 screen number you are using typically it has a value of zero 3 16 Oracle Forms Server and Reports Server Installation Guide Setting Up Oracle Reports Server Oracle Reports Server uses the XWindow display value of the X11 windowing system to set the DISPLAY environment variable For more information see the product documentation and your operating system documentation Click OK The Reports Server parameters dialog box appears Enter the following the TNS name used by Oracle Reports Server on the machine on which you are running This TNS name must be defined as an Oracle Net8 TNS name The installation process defines this name for you in the Net8 tnsnames ora file the TCP IP port number used by Oracle Reports Server Change the displayed port number if it is already
44. mation specific to administering Oracle Forms Server and Reports Server products This chapter describes the following topics Administering Oracle Forms Administering Oracle Reports Administering Oracle Graphics Administration 5 1 Administering Oracle Forms Administering Oracle Forms Oracle Forms Executables Table 5 1 lists the Oracle Forms executable names The executables are in the SORACLE HOME bin directory Table 5 1 Oracle Reports Executables Component Web Executable Name Oracle Forms CGI f60cgi Oracle Forms Listener f60webm Oracle Forms Server f60srvm Oracle Forms Web Cartridge f60webc so Deploying Oracle Forms on the Web See Oracle Forms Developer and Reports Developer Guidelines for Building Applications in SORACLE HOME doc60 admin manuals US guide60 atgtoc pdf for information about deploying Oracle Forms on the Web Relinking Oracle Forms To relink Oracle Forms with Oracle Forms Server and Reports Server enter cd SORACLE HOME forms60 lib make f ins forms60w mk install Documentation for relinking Oracle Forms is included in the ins forms60w mk file 5 2 Oracle Forms Server and Reports Server Installation Guide Administering Oracle Reports Administering Oracle Reports Oracle Reports Executables Table 5 2 lists the Oracle Reports executables The executables are in the SORACLE HOME bin subdirectory Table 5 2 Oracle
45. mn one must define a valid printer The Printing servicesand Saving output to file options may not work properly unless the uiprint txt file is configured properly Updating the Toolkit Font Mapping File The uifont ali file contains alias mappings from one Toolkit font to another and is used to map unavailable fonts to substitutes For example the Arial font is found only on Microsoft Windows and is mapped to Helvetica on Compaq Tru64 UNIX The uifont ali file resides in the SORACLE_HOME guicommon6 tk60 admin directory If you want to use another directory see the following section See Also Comments in the uifont ali file This file is updated for each new release Setting TK60 FONTALIAS Oracle Toolkit first looks for ui ont ali in the location specified by TK60 FONTALIAS If TK60 FONTALIAS is not set or if ui font aliis not in the specified location the Toolkit looks for uifont ali inthe SORACLE HOME guicommon6 tk60 admin directory Completing the Installation 4 5 Setting Printer Configuration Files Modifying the uifont ali File If you want to modify the uifont ali file make sure the general structure of each line is as follows new font existing font where new font is a font you want to add existing font is a font that already exists on your printer The format of each line in uifont ali is as follows face size style weight width charset face size style
46. n this section it is assumed you have a working knowledge of X Window and OSF Motif setup and administration including an understanding of the client server architecture of the X Window System and Motif Getting Help with X and OSF Motif Oracle customers can contact Oracle Support Services regarding any problems with Oracle products However Oracle Corporation does not offer technical support for the X Window System or Motif provided by your operating system vendor Refer your questions about the X Window System or Motif to your on site expert or to your operating system vendor or Motif vendor Note Oracle does not support PC Xserver emulators If you are having a problem with an emulator on a PC try to duplicate the problem on your server s console Relocating the Key Definition File When installation is complete the XKeysymDB X11 key symbol file is in the SORACLE HOME guicommon6 tk60 admin directory You must move the XKeysymDB file to the usr 1ib X11 directory on every machine on which Oracle Forms Server and Reports Server is running To move the file perform the following steps 1 As the root user change to the SORACLE HOME guicommon6 tk60 admin directory by entering cd SORACLE_HOME guicommon6 tk60 admin If the directory usr 1ib X11 does not exist create it by entering mkdir usr lib Xll Completing the Installation 4 11 Setting Up the GUI 2 Setup the
47. n your Web browser a HTTP Select this option if communication needs to pass through a firewall For example if your machine is inside a firewall but your Oracle Forms Server applications need to be available to users outside the firewall a HTTPS Select this option if communication needs to pass through a firewall and use a Secure Sockets Layer encryption 2 Click OK The Process Startup dialog box appears 3 Click one of the following a Yes Clicking Yes will automatically start Oracle Forms Server at the end of the install No Clicking No will not start Oracle Forms Server at the end of the install The Load Balancer Client parameters dialog box appears 4 Enter the following Data host This value is the name of the host where the load balancing server will run a Data Port This value is the TCP IP port on the data host where the load balancing server will receive load data for the load balancing clients 5 Click OK The Forms Server parameters dialog box appears 3 14 Oracle Forms Server and Reports Server Installation Guide Using Oracle Forms Server 6 Enter the number of the TCP IP port on which Oracle Forms Server will listen for Form execution requests Change the displayed port number if it is already being used by another program 7 Click OK The Forms Server parameters dialog box appears This dialog box has the same dialog box name as the previous dialog box 8 Sele ct on
48. nd iapxtb The first item in the entry is the name inside double quotes used by the tool to reference the user exit The second item is the actual name of the user exit routine Names of user exits cannot be more than 30 alphanumeric characters in length and must begin with a letter The last item XITCC indicates that the user exit is called using C calling conventions For other languages you would use one of the following a XITCOB COBOL XITFOR FORTRAN XITPLI PL I XITPAS Pascal XITAda Ada After modifying the source file compile it along with your user exit program Next link the resulting IAPXTB object file with the product executables 6 2 Oracle Forms Server and Reports Server Installation Guide Linking to Your User E xits Linking to Your User Exits To link to your user exits override the EXITS make file macro on the command line with the user exit table file and user exits you created The following sections describe linking to Oracle Forms Oracle Reports and Oracle Graphics Linking to Oracle Forms To link your user exits to Oracle Web Forms enter cd SORACLE HOME forms60 lib make f ins forms60w mk EXITS my iapxtb o Nuserexitl 0 userexit2 0 f60webmx Replace the default Web Forms f 60webm engine with your newly relinked copy by entering mv f60webmx SORACLE HOME bin f60webm Linking to Oracle Reports To link your user ex
49. nfiguration in which Oracle Forms Server and Reports Server is installed on client machines connecting to the database server with Oracle Net8 Features and Requirements 1 3 Installation Overview Figure 1 1 Client Only Installation UNIX server running Oracle RDBMS Database objects for Oracle Forms Server and Reports Server tools reside here Net8 Client machine Client machine running Oracle Forms running Oracle Forms Server and Reports Server and Reports Server Server Server Based Installation 1 4 For Oracle Forms Server and Reports Server Release 6i in a server based installation Oracle Forms Server and Reports Server and the Oracle Database Server release 8 0 6 are installed in the same ORACLE_HOME directory and the Oracle Forms Server and Reports Server tools connect to the local database This option was not available in previous releases Attention Oracle Forms Server and Reports Server only supports server based installations that use Oracle Database Server release 8 0 6 Oracle Forms Server and Reports Server Installation Guide Online Documentation and Help Supported User Interfaces Table 1 2 lists the Oracle Forms Server and Reports Server Release 6i tools and whether they support character mode Motif or Web interfaces on Compaq Tru64 UNIX Table 1
50. nstalled distribution during the Installer session A permanent staging area is neither removed nor converted during installation Therefore you can use it to perform multiple installations Installing from a permanent staging area requires approximately twice the disk space of installing from a temporary staging area or distribution medium See Chapter 1 Features and Requirements for space requirements Attention Do not attempt to add files to an existing staging area If it is necessary to recreate a staging area then you must delete all existing files before using the Installer to create the new one If you install a software patch from a staging area you must create a staging area for just the patch release 3 4 Oracle Forms Server and Reports Server Installation Guide Installing Oracle Forms Server Relink the executables Relinking regenerates a program from its component parts The Installer automatically relinks products that require relinking Specify relinking if you installa new Oracle protocol adapter link Oracle products together install user exits install patches or bug fixes Use the root installation script file If an earlier root sh file exists the Installer asks whether to append root related activities to that file or save the old file as root sho and overwrite root sh Unless you want to run old root sh activities with the present installation rename the old file
51. on unless you are requested to do so by an Oracle Support Services analyst 3 Press Return Selecting a Component After you complete the Setting Up the Software Asset Manager section the Component Selection dialog box appears From the following list of components tab to select the first component and use the space bar to deselect the other components Forms Server for Web deployment or Reports Multitier Server for Web deployment Select this option This option applies to Oracle Forms Server and Reports Server Motif Bitmapped Interface Deselect this option This options applies to the Oracle Forms Developer and Reports Developer Designer and Generator Executables or Reports Designer and Generator Executables Deselect this option This options applies to the Oracle Forms Developer and Reports Developer Character Mode Interface Deselect this option This options applies to the Oracle Forms Developer and Reports Developer Selecting a Machine Configuration After you complete the Selecting a Component section the Forms Server Installation dialog box appears Select one of the following single machine configuration Installation Tasks 3 9 Installing Oracle Forms Server This option indicates you are installing Oracle Forms Server on only one machine If you select this option click OK and go to Setting Up a Single Machine Configuration part of a multiple machine configuration Thi
52. ons Creating or Upgrading Database Objects To create or upgrade database objects perform the following steps 1 Make sure your environment is correctly set See Chapter 2 Setting Up the Environment Restart the Installer From the Installation Activity Choice dialog box choose the Create Upgrade Database Objects option to create new database objects for Oracle Forms Server and Reports Server or to upgrade database objects from a previous release to release 8i 3 20 Oracle Forms Server and Reports Server Installation Guide 4 Completing the Installation This chapter describes post installation and configuration tasks you perform to complete the installation The chapter describes the following Verifying Your Installation Setting Printer Configuration Files Setting Up the Environment Setting Up the GUI Setting Up Windows Clients Enabling Use of Other Languages Setting Up the Post Install Environment Completing the Installation 4 1 Verifying Your Installation Verifying Your Installation If you have startup problems use DEBUG_SLFIND to direct error messages to a file you choose To do this set DEBUG SLFIND to stdout stderr or another file name Rerun the tool Check for error messages in the file that indicate if a resource file is missing Unaligned access warning messages can be ignored For example Unaligned access pid 31990 rwbld60 va 0x140553776 pc 0x300000
53. or database administrators and others responsible for installing Oracle products on UNIX operating systems While command examples are provided this document does not attempt to teach Oracle or UNIX administration Typographic Conventions monospace brackets italics UPPERCASE Monospace type indicates UNIX commands directory names user names path names and file names Words enclosed in brackets indicate key names for example Press Return Note that brackets have a different meaning when used in command syntax Italic type indicates a variable including variable portions of filenames It is also used for emphasis Uppercase letters indicate Structured Query Language SQL reserved words initialization parameters and environment variables Because UNIX is case sensitive conventions in this document may differ from those used in other Oracle product documentation Command Syntax Command syntax appears in monospace font The following conventions apply to command syntax backslash braces brackets A backslash indicates a command that is too long to fit on a single line Enter the line as printed with a backslash or enter it as a single line without a backslash dd if dev rdsk c0O0tid0s6 of dev rst0 bs 10b count 10000 Braces indicate required items DEFINE macrol Brackets indicate optional items cvtcrt termname outfile Note that brackets have a different meaning
54. pporting 1 5 Index 1 N National Language Support 1 11 4 15 O online documentation 1 5 online help 1 5 Operating system requirements oracle account home directory 2 2 how to create 2 2 requirements 2 2 ORACLE BASE setting 2 6 ORACLE HOME and oracle account home directory setting 2 6 ORACLE TERM setting 2 6 Oracle7 Server documentation 1 7 overview Developer 2000 1 2 P Pre Installation Tasks 2 2 Printer Configuration Files setting 4 2 R relinking Forms 5 2 Graphics 5 4 Reports 5 3 Reports administering 5 2 5 3 executables 5 2 5 3 requirements CPU 1 7 database 1 9 disk space and memory 1 9 hardware 1 7 media device 1 7 memory 1 7 Index 2 operating system 1 7 oracle account 2 2 relinking 1 9 server 1 9 swap space 1 7 user interface 1 8 restrictions 1 11 S set required variables 2 5 setting up the environment 2 1 Software Upgrade 3 19 swap space requirements 1 7 T TWO TASK setting 2 8 U UNIX accounts how to create 2 2 user interface requirements 1 8 Using the Oracle Installer mounting the CD 3 2 verifying installation 4 2 W Web interface 1 5
55. r setenv MMTK AVIFPLAYER video player name s amp where video player nam Is the name of the AVI video player program ole S Is the name of the AVI video player program amp Forces the video player to run in the background 1 6 Oracle Forms Server and Reports Server Installation Guide System Requirements Related Publications Oracle8 Server for Compaq Tru64 UNIX Documentation The following documents provide additional information and are included on your product CD ROM in HTML format a Oracle Installation Guide for Compaq Tru64 UNIX a Oracle8 Administrator s Reference for Compaq Tru64 UNIX System Requirements This section describes the system requirements for installing Oracle Forms Server and Reports Server on Compaq Tru64 UNIX Hardware Requirements Table 1 3 lists hardware requirements for installing and running Oracle Forms Server and Reports Server on Compaq Tru64 UNIX Table 1 3 Compaq Tru64 UNIX Hardware Requirements Hardware Item Requirement CPU An Alpha based system Memory A minimum of 32 MB internal memory RAM Swap Space two to four times physical RAM Media Device A CD ROM drive that can read High Sierra standard format Display Device for GUI Tools A Compaq DEC Alpha Workstation Operating System Requirements Table 14 lists operating system requirements for installing and running Oracle Forms Server and Reports Server on Compaq Tru64 UNIX Table 1 4 Op
56. rading to Oracle Forms Server and Reports Server Release 6i you may need to upgrade the database objects to Release 8 0 6 Enter the following to determine if the database objects already exist for the products you want to install in the database on the server sqlplus system manager SQL gt SELECT table name 2 FROM dba tables 3 WHERE table name LIKE table name If these database tables already exist you can find them in the SYSTEM account in the database If these database tables do not exist then you must create them with the Installer Table 2 1 lists the tables Table 2 1 Database Tables Product Table Oracle Browser BROWSER Oracle Forms FRM50 Oracle Graphics GO Oracle Reports SRW2 Setting Up the tnsnames ora File If you are installing database objects you must set up the tnsnames ora file before you run the Installer The tnsnames ora file contains details of the remote databases available to the Oracle Forms Server and Reports Server products installed in a client only configuration A tnsnames ora file consists of the following alias DESCRIPTION ADDRESS Setting Up the Environment 2 3 Performing P re Installation Tasks PROTOCOL tcp HOST PORT hostname service_number CONNECT_DATA SID ORACLE_SID If you have Oracle Net8 Assistant you can use it to update the file Otherwise you need to use a text e
57. rms Server and Reports Server Installation Guide Setting Up Environment Variables Setting Up Environment Variables Oracle Corporation recommends that you set up the environment variables in the startup file of the user who will own the Oracle Forms Server and Reports Server installation Log into the oracle account and set up the environment variables according to the instructions in this section The startup file normally located in your UNIX login home directory will vary depending upon the shell used Typically profile is used for the Bourne and Korn shells and cshrc is used for the C shell Syntax of Environment Variables The syntax for setting an environment variable for the Bourne or Korn shell is set variable name value export variable name The syntax for setting an environment variable for the C shell is o setenv variable name value Setting Up the DISPLAY Variable Set to the machine name or IP address X server and screen being used by your workstation to connect to the system where the software will be installed Do not use the machine name or IP address of the system where the software is being installed Use the machine name or IP of your own workstation If you are not sure what the X server and screen should be set to use 0 zero for both If you get an Xlib error similar to Failed to connect to server or Connection refused by server when starting the Installer run one of the following commands
58. rms Server and Reports Server product set with tools from other vendors Table 1 1 describes the Oracle Forms Server and Reports Server products Table 1 1 Oracle Forms Server and Reports Server Supported Products Oracle Forms Use Oracle Forms to build and deploy interactive applications that Release 6i access Oracle8 Server data Oracle Graphics Use Oracle Graphics to create multimedia graphical displays Release 6i dynamically linked to a database 1 2 Oracle Forms Server and Reports Server Installation Guide Installation Overview Table 1 1 Oracle Forms Server and Reports Server Supported Products Oracle Reports Use Oracle Reports to build and generate reports that access Oracle8 Release 6i Server data Installation Overview This overview describes performing a client only installation a client only configuration and a server based installation Client Only Installation You can install Oracle Forms Server and Reports Server tools in a ORACLE HOME directory separate from the ORACLE HOME directory containing the Oracle Database Server software that the tools access A client only installation consists of Oracle Forms Server and Reports Server software database objects and Oracle Net8 Although you need to install the database objects only once for each server Oracle Forms Server and Reports Server tools must be installed on each system used to access the server Client Only Configuration Figure 1 1 illustrates a co
59. s option indicates you are installing Oracle Forms Server on more than one machine This option provides added scalability If you select this option click OK and go to Setting Up a Multiple Machine Configuration Setting Up a Single Machine Configuration If you selected single machine configuration in the Selecting a Machine Configuration section the Forms Server Web listener dialog box appears Perform the following steps to set up a single machine configuration 1 Select one of the following a use Oracle WebDB listener Select this option is you want Oracle WebDB listener to be installed and configured for you Oracle WebDB is a light weight listener provided with Oracle Forms Server that supports Common Gateway Interface CGI a use another Web listener Select this option to use another Web listener that supports CGI or if you are using Oracle Application Server If you choose this option after the installation is complete instructions will tell you how to configure virtual paths for your listener Click OK The WebDB Listener dialog box appears Enter the following The host name that will be used by Oracle Forms Server a The listener port that will be used by Oracle Forms Server Click OK The Process Startup dialog box appears 3 10 Oracle Forms Server and Reports Server Installation Guide Installing Oracle Forms Server 3 Click one of the following Yes Clicking Yes will automatically st
60. s rather than appending the new ones Use National Language Support NLS To use a language other than American English select either A11 Languages or select a language from the displayed list Installer prompts and messages are always displayed in American English Click OK Selecting Installation Activities and Options After you choose the Default Install option or after you choose the Custom Install option and complete the Customizing Your Installation section the Installer displays the preamble txt and README files included with this release Perform the following steps to select installation activities and options 1 Read these files for additional product information then click OK The Installation Activity Choice dialog box appears Select one of the following Install Upgrade or De Install Software Installation Tasks 3 5 Installing Oracle Forms Server Select this option to install or upgrade Oracle Forms Server and Reports Server software When you select this option you have the choice to create or upgrade database objects during this session Create Upgrade Database Objects This option creates database objects in an existing database without installing any new products Perform Administrative Tasks This option relinks product executables in an existing Oracle Forms Server and Reports Server installation 3 Click OK The Installation Options dialog box appears 4 Sele
61. s the existing files Storing log files from multiple installations in the same files hinders any subsequent debugging You can change the values displayed in the Defaults file by clicking the Back button Setting Up the Software Asset Manager After you complete the Confirming Default Settings section the Software Asset Manager dialog box appears Perform the following steps to set up the Software Asset Manager 1 For each product you will install a Scroll to the product in the Products available box b Press the space bar to highlight the product c Click the Install button to move the product to Products installed box Note If you chose the Install Documentation Only option of the Installation Options dialog box select the products corresponding to the documentation you are installing Only the documentation is installed the products themselves are not installed The Software Asset Manager tracks the size of the distribution you selected and the space available in the destination directory ORACLE HOME Click the Opt ions button if you want to bring up a dialog window that allows you to choose the dialog windows you will see during installation and whether you want to log the installer s actions 3 8 Oracle Forms Server and Reports Server Installation Guide Installing Oracle Forms Server Note Becausethe Log Installer ActionoftheOptions button generates a lot of data do not select this opti
62. stomer Service Global Customer Service contacts are listed at http support oracle com client relations Xi Xii Education and Training Training information and worldwide schedules are available from http education oracle com Oracle Technology Network Register with the Oracle Technology Network OTN at http technet oracle com OTN delivers technical papers code samples product documentation self service developer support and Oracle s key developer products to enable rapid development and deployment of applications built on Oracle technology 1 Features and Requirements Completing a quick successful installation depends on the local system satisfying the software dependencies and space requirements for Oracle software This chapter describes the requirements for installing Oracle Forms Server and Reports Server Release 6i on Compaq Tru64 UNIX Verify that the system meets these requirements before starting the installation This chapter describes the following topics Introduction Installation Overview Supported User Interfaces Online Documentation and Help Related Publications System Requirements Disk Space and Memory Requirements Issues and Restrictions Features and Requirements 1 1 Introduction Introduction Oracle Forms Server and Reports Server is an integrated set of database tools supporting multiple platforms user interfaces and data sources These tools are built on a layer cal
63. tallation Total the Distribution and DB Space columns adding only those products and options that are required for you installation Features and Requirements 1 9 Disk Space and Memory Requirements Combine the totals from the two columns to determine the total required disk space for your installation Table 1 8 Space Requirements Products and Options Distribution MB DB Space MB GUI Common Area 40 3 0 53 Oracle Forms 117 0 0 32 Runtime Char 20 0 0 00 Designer Motif 28 0 0 00 Runtime Motif 23 0 0 00 Generator Char 25 0 0 00 Generator Motif 27 0 0 00 Runtime Web 23 0 0 00 Oracle Reports 66 3 0 39 Converter 22 0 0 00 Builder Motif 28 0 0 00 Migration Utility 0 2 0 00 Runtime Char 20 0 0 00 Runtime Motif 28 0 0 00 CGI Executable 5 5 0 00 Multi tier server 6 0 0 00 Client Web 5 5 0 00 Webcartridge 7 5 0 00 Oracle Graphics 39 5 0 12 Designer Motif 29 5 0 00 Runtime Motif 29 5 0 00 Batch 29 5 0 00 Oracle Browser 28 0 0 04 Query Builder 12 0 0 00 Schema Builder 12 0 0 00 1 10 Oracle Forms Server and Reports Server Installation Guide Issues and Restrictions Table 1 8 Space Requirements Products and Options Distribution MB DB Space MB Oracle Procedure Builder 20 0 0 00 Procedure Builder Motif 17 0 0 00 Oracle Installer 57 3 0 00 Oracle Project Builder 11 5 0 00 Project Builder Motif 0 6 0 00 Oracle Documentation Library 504 0 0 00 Oracle Common 177 7 0 00 Oracle
64. ter 2 Setting Up the Environment Perform the following steps to confirm the values of the environment variables 1 Confirm the path name for the following environment variables ORACLE BASE If the value shown is incorrect enter the ORACLE BASE for your Oracle product directory structure This directory will contain the Oracle Forms Server and Reports Server software and associated administration files If you set ORACLE BASE before starting the installer this field defaults to the value you chose ORACLE HOME The Installer prompts you to complete the path name of the ORACLE HOME directory If you set ORACLE HOME before installation its value is used Otherwise the value shown is the OFA compliant value computed by the Installer The OFA compliant path is SORACLE BASE product release number Enter the release number of the distribution for example 6 0 ORACLE SID If the value shown is incorrect enter the value of the server identification Note For a list of environment variables used by the Installer see Setting Up Environment Variables on page 2 5 6 Click OK Installation Tasks 3 7 Installing Oracle Forms Server The Installer writes installation log information to the following content specific files in the SORACLE HOME orainst directory install log a sql log make log os log If log files already exist in the default location the Installer rename
65. tes to enclose element names that contain a space For example Avant Garde 12 ItalictOverstrike Helvetica 12 Italic Bold maps any Avant Garde font that has both italic and overstrike styles to a 12 point bold italic Helvetica font a Usea period as a place holder if you choose not to define an element Trailing periods may be truncated For example in the following statement the two sides are equivalent even though the size is not specified on the left side Arial Italic Overstrike Helvetica 12 Italic Bold Setting Printer Commands Optional You can set TK6_PRINT to store the print command and TK6_PRINT_STATUS to store the printer status command You must supply a print_string like lp s d n n c lpstat p Sn which allows you to embed the following strings ole n is the name of the printer 9e c is the number of copies printed as a decimal number If you do not set TK6 PRINT the value defaults to lp s d n n c If you do not set TK6 PRINT STATUS the value defaults to usr bin lpstat p n To set TK6 PRINT and TK6 PRINT STATUS for the Bourne shell enter set TK6 PRINT print string export TK6 PRINT set TK6 PRINT STATUS print string export TK6 PRINT STATUS To set TK6 PRINT and TK6 PRINT STATUS for the C shell enter oe setenv TK6 PRINT print string setenv TK6 PRINT STATUS print string oe Completing the Installation 4 7 Setting
66. tfm filename where fontname is a descriptive name for the font tfm filename is the base file name for the TFM file 4 8 Oracle Forms Server and Reports Server Installation Guide Setting P rinter Configuration Files You can also specify these fields in the glue file after the FONT field if the TFM file isn t specific enough by entering ptsize size size If the font is a bitmapped font but is listed in the TFM file as a scalable font you can limit the point sizes used by listing all acceptable size by entering symset symset symset This field limits the supported symbol sets to those listed on the field See the HP PCL documentation for a list of recognized symbol sets Oracle Forms Server and Reports Server also supports the defaultpaper field for printing to PCL format This field can be used to set the defaultpaper to be used by the Toolkit The format of this field is lt defaultpaper papername For example lt defaultpaper A4 will set the default paper to A4 The papername is case insensitive If the user specifies this field in more than one place then the final de aultpaper field s papername will be used as the defaultpaper If the user has specified a defaultpaper and the papername is not supported by the printer the defaultpaper setting will be ignored and the defaultpaper will be set to LETTER If the papername specified in this field is incorrect then the de aultpaper will be set to
67. tion utility to create an oracle account with the following properties Login Name Any name This document refers to it as the oracle account Default GID Corresponds to the OSDBA group Home Directory Choose a home directory consistent with other user home directories The home directory of the oracle account does not have to be the same as the ORACLE HOME directory Login Shell The default shell can be bin sh bin csh or bin ksh The examples in this document assume the Bourne shell bin sh Note Use the oracle account only for installing and maintaining Oracle software Never use it for purposes unrelated to Oracle Software Do not log in to the database when using the oracle UNIX account Do not use root as the oracle account Ensure that the hostname and domainname UNIX commands return valid values not empty values on your system 2 2 Oracle Forms Server and Reports Server Installation Guide Performing P re Installation Tasks Deciding to Install or Upgrade Database Objects Database objects are tables views and sequences that Oracle Forms Server and Reports Server uses to store Oracle Forms Server and Reports Server objects such as Oracle Forms applications in the database Database objects must exist in each database where you are storing Oracle Forms Server and Reports Server objects If you have already installed the database objects on your database do not install them again If you are upg
68. to deploy to either Oracle Jinitiator or an Applet Viewer This section describes both of these options Setting Up Oracle Jinitiator You can use the Oracle Jinitiator plugin with either the Netscape Navigator or Microsoft Internet Explorer browser If you are running one of these browsers and use Oracle Forms CGI to execute an Oracle Form the Oracle Forms Server automatically downloads and installs the Jinitiator plugin in your browser Setting Up an Applet Viewer Included with Oracle Forms Server and Reports Server Release 6i is an applet viewer for Windows This applet viewer for Windows can be installed on a 4 14 Oracle Forms Server and Reports Server Installation Guide Enabling Use of Other Languages Windows platform and used as a client to the Oracle Forms Server and Reports Server See Also The Release Notes have instructions on installing and running the applet viewer on Windows Release Notes are located in ORACLE HOME guicommon doc See Oracle Forms Developer and Reports Developer Guidelines for Building Applications for information about configuring Oracle Forms Oracle Reports and Oracle Graphics for the Web This documentation is in the SORACLE HOME doc60 admin manuals US guide60 atgtoc htm directory Enabling Use of Other Languages This section explains how to set up your environment so that you can run the tools using various languages Perform the following tasks to
69. ts Server Environment requires the following task Setting Up the LD LIBRARY PATH Variable To run the Oracle Forms Server and Reports Server products you must set up the LD LIBRARY PATH environment variable Oracle Forms Server and Reports Server products use dynamic or shared libraries Therefore you must set up LD LIBRARY PATH so that the dynamic linker can find the libraries To determine if your LD_LIBRARY_PATH is set enter echo SLD LIBRARY PATH Set the LD LIBRARY PATH environment variable for the first time to SORACLE HOME lib You can reset the LD LIBRARY PATH To reset it for the Bourne shell enter set LD LIBRARY PATH SORACLE HOME lib S LD LIBRARY PATH export LD LIBRARY PATH To reset it for the C shell enter setenv LD LIBRARY PATH SORACLE HOME lib LD LIBRARY PATH Note If youset LD LIBRARY PATH in a previous Developer 2000 installation and you are now setting it for the current installation be sure to remove the old SORACLE_HOME 1lib entry from the path 4 10 Oracle Forms Server and Reports Server Installation Guide Setting Up the GUI Setting Up the GUI This section explains how to prepare the GUI environment for Oracle Forms Server and Reports Server This section describes Getting Help with X and OSF Motif Relocating the Key Definition File Setting Up the X Window System and Motif Environments I
70. txt file containing five fields separated by colons For each of your printers enter the following line into the uiprint txt file printer printer driver Toolkit driver printer descr printer descr file where printer contains the name of the printer as used with 1pr or 1p commands This parameter also specifies the default printer if both the ORACLE PRINTER and PRINTER environment variables are not set on your system 4 4 Oracle Forms Server and Reports Server Installation Guide Setting P rinter Configuration Files printer driver specifies the type of print driver used for the printer The Toolkit supports the PostScript ASCII and PCL selections for the printer driver Toolkit driver specifies the version of the printer driver that should be used by the Toolkit The Toolkit supports 1 for ASCII or Level 1 PostScript 2 for Level 2 PostScript printers and 5 for HP PCL printers printer descr contains a free format description of the printer It can show for example the location and speed of the printer printer descr file specifies the printer definition file to be used with the printer The format of this file is dependent on the driver specified for the printer The Toolkit supports the Adobe PPD and the HP HPD file formats See Locating and Installing PPD and AFM Files for Your Printers on page 4 2 for complete instructions Attention The first non commented line line without a number in colu
71. up a multiple machine configuration Primary node If you select this option click OK and go to Setting Up for a Primary Node Secondary node If you select this option click OK and go to Setting Up for a Secondary Node Setting Up for a Primary Node If you selected Primary node in the Setting Up a Multiple Machine Configuration section the Forms Server Primary Node dialog box appears Perform the following steps to set up a primary node 1 Select one of the following On the secondary node and this primary node a Only on the secondary nodes Click OK The Forms Server Web listener dialog box appears Select one of the following a use Oracle WebDB listener Select this option is you want Oracle WebDB listener to be installed and configured for you Oracle WebDB is a light weight listener provided with Oracle Forms Server that supports Common Gateway Interface CGI use another Web listener Select this option to use another Web listener that supports CGI or if you are using Oracle Application Server If you choose this option after the installation is complete instructions will tell you how to configure virtual paths for your listener Click OK The WebDB Listener dialog box appears Enter the following The host name that will be used by Oracle Forms Server 3 12 Oracle Forms Server and Reports Server Installation Guide Installing Oracle Forms Server a The listener port that will be used b
72. y Oracle Forms Server 6 Click OK The Process Startup dialog box appears 7 Click one of the following Yes Clicking Yes will automatically start Oracle Forms Server at the end of the install No Clicking No will not start Oracle Forms Server at the end of the install The Load Balancer Server parameters dialog box appears 8 Enter the following a Data Port This value is the TCP IP port where the load balancing clients will send load data Request Port This value is the TCP IP port where Oracle Forms Server CGI and Oracle Forms Server Cartridge will request load data 9 Click OK The Forms Server parameters Secondary nodes dialog box appears 10 Enter the number of the TCP IP port on which Oracle Forms Server will listen for Form execution requests Change the displayed port number if it is already being used by another program 11 Click OK 12 Go to the Using Oracle Forms Server section Setting Up for a Secondary Node If you selected Secondary node in the Setting Up a Multiple Machine Configuration section the Forms Server parameters Secondary nodes dialog box appears Perform the following steps to set up a secondary node Installation Tasks 3 13 Installing Oracle Forms Server 1 Select one of the following a Sockets Select this option to use socket protocols for communication between the Oracle Forms Server runtime engine and the Oracle Forms Server Java applet which runs i
73. z7410 ra 0x300000Z73d0 inst 0xa4d10000 These warning messages can be suppressed on the machine where the messages are displayed by the command uac p For more information on unaligned access warnings refer to the Compaq Tru64 UNIX 4 0D User s Manual Setting Printer Configuration Files After running the Oracle Installer set your printer configuration files to prepare your system for printing by performing the following tasks a Locating and Installing PPD and AFM Files for Your Printers Setting Up the Default Printers Updating the Toolkit Font Mapping File Setting Printer Commands Optional a Specifying a Default Printer Printing to HP PCL Printers Testing Printing Capabilities and Fixing Errors Locating and Installing PPD and AFM Files for Your Printers This task provides instructions for choosing an appropriate PostScript Printer Definition PPD file for your printer Oracle Toolkit uses the PPD files to determine which fonts are available on a PostScript printer since Compaq Tru64 UNIX does not allow the Toolkit to obtain this information from the printer directly 4 2 Oracle Forms Server and Reports Server Installation Guide Setting P rinter Configuration Files Each PPD file provides paper sizes available fonts and default resolution for a printer If this file lists a PostScript font a corresponding Adobe Font Metrics AFM file must exist in the SORACLE_HOME guicommon6 tk60 admin AFM d

Download Pdf Manuals

Related Search

Related Contents

Ficha Técnica de: VJ88 Lavavajillas Limpiahornos automáticos  SERVICE MANUAL  PDF:4397KB  Honeywell Thermostat RTH111 User's Manual  User Manual - Leading Edge Turbines  HP GbE2c User's Manual  家庭用プロパストップ取扱説明書  ADL GT40 USB DAC  KROY K4452/K4453 Thermotransfer - / Thermodirekt    

Copyright © All rights reserved. Failed to retrieve file