Add Jserver option

Question

Hi
I'am working remote on a AIX 5.2 thru Putty with a Oracle 8.1.7.
My problem is that I'am going to add Jsever to the db, but i can't start dbassist thru Putty, so is there any way I can do this without using dbassist?
/Mikkel

Answer 1

PURPOSE: ========= To assist with the manual installation of the Java Virtual Machine (JVM) into an 8.1.7 version database. Prior to the installation of the JVM, the "readme.txt" found in the ORACLE_HOME/javavm directory should be reviewed so that a broad understanding of the task can be understood. Multiple scripts will need to be run to enable full JVM functionality. All JVM related scripts must be run under the SYS AS SYSDBA account. This bulletin will provide the following pieces of information: SECTION A) The suggested resource settings needed for a successful JVM installation. SECTION B) The name and location of the scripts needed for a full JVM installaton where "full" is defined as all java-related functionality within the rdbms. A brief summary of the functionality added by each script will also be given in this section. SECTION C) Basic checks (queries) to be used to verify a successful JVM installation. SECTION D) Suggested reading material in order to gather a better understanding of the functionality that each script provides. NOTE: If the database was upgraded from an earlier version of 8i AND possessed the JVM from that previous 8i release, please see the 8.1.7 Migration manual in the official Oracle documentation for the steps needed to upgrade the JVM. SECTION A) RESOURCES: ======================== Rollback segment space- ---------------------- Allocate at least 100MB worth of rollback segment space for the JVM install, this is in addition to the rollback segment space allocated for any other activity on the database. System tablespace- ----------------- Combined, all of the scripts will consume approximately 130MB of free space in the system tablespace. The objects introduced by the initjvm.sql script will consume approximately 90MB of the system tablespace by itself. Shared_pool_size- ---------------- At least 50MB of free shared_pool space is needed. That is a minimum for the JVM installation. Java_pool_size- -------------- 30MB should be adequate for the installation. The pool sizes can be monitored by querying V$SGASTAT. Eg: SQL> select * from v$sgastat where name = 'free memory'; Please refer to Note:204935.1 for a script that will automatically check the system requirements of your database and inform you if it does not meet them. SECTION B) NAME, LOCATION, AND BRIEF DESCRIPTION OF THE JVM SCRIPTS: ======================================================================= ***INITJVM.SQL*** To execute- SQL>set echo on SQL>spool jvminst.log SQL>@?/javavm/install/initjvm.sql SQL>spool off Summary of the added functionality: ----------------------------------- The initjvm.sql script loads the initial set of Java classes necessary to support Java, it initializes the tables for supporting Java and for the CORBA namespace, and it publishes top-level entry points through call-specifications. The support Java classes include the following: The standard Java runtime Bytecode verifier and optimizer Java and SQLJ compilers JDBC runtime CORBA ORB and EJB runtime Some additional support classes, such as DBMS_JAVA, which are described in "Package DBMS_JAVA" The initjvm.sql script also performs the following actions: 1.Loads the classes to the SYS schema. 2.Creates public synonyms for the loaded classes to be accessible to all users. 3.Alters some of these classes to run with definer's rights to support CORBA callouts. 4.Defines database start up and shut down triggers. Additional sources of information: ---------------------------------- Oracle8i Java Developer's Guide The file, $ORACLE_HOME/javavm/readme.txt NOTE: If the initjvm.sql script fails to successfully complete for any reason, the JVM removal script (rmjvm.sql, found in the same location as the initjvm.sql script) MUST be run prior to another attempt at JVM installation. Additionally, after the JVM removal script has been successfully executed, the instance must be bounced prior to the next attempt to install the JVM via the initjvm.sql script. In short, there is no "moving forward" with a failed JVM installation, the only option is to remove and reinstall the JVM. Lack of resources (memory and space) are the most common culprits for a failed JVM installation so ensuring that there are no deficiencies in this regard will greatly improve the success rate of the installation. See "SECTION C" below for the sql statements used to check for installation success. ***INITXML.SQL*** To execute- SQL>set echo on SQL>spool initxml.log SQL>@?/oracore/admin/initxml.sql SQL>spool off Summary of added functionality: ------------------------------- This script loads xml components into the JServer. The XML Parser for PL/SQL makes developing XML applications with Oracle8i a simplified and standardized process. With the PL/SQL interface, Oracle shops familiar with PL/SQL can extend existing applications to take advantage of XML as needed. The XML Parser for PL/SQL supports the W3C XML 1.0 specification. Additional sources of information: ---------------------------------- Note:103872.1 XML Parser for Java Version 2 - Frequently Asked Questions Oracle8i Application Developer's Guide - XML ***CATXSU.SQL*** To execute- SQL>set echo on SQL>spool catxsu.log SQL>@?/rdbms/admin/catxsu.sql SQL>spool off Summary of added functionality: ------------------------------- This script loads the XMLSQL Utility (XSU) into the database. The utility serves to transform "relational" data to XML for purposes of communication. The XML-SQL Utility (XSU) provides a simple way of achieving data transformation, by mapping, canonically, any SQL query result to XML and vice versa. Additional sources of information: ---------------------------------- Note:120841.1 XML SQL Utility Oracle8i Application Developer's Guide - XML ***INIT_JIS.SQL*** To execute- SQL>set echo on SQL>spool init_jis.log SQL>@?/javavm/install/init_jis.sql SQL>spool off Summary of added functionality: ------------------------------- This is the script to install the Oracle Servlet Engine (OSE). The Oracle Servlet Engine works as a specialized Web server, designed as a scalable servlet server inside the Oracle8i database. The servlet classes are loaded into Oracle8i with a loadjava command and published in a namespace inside the database. A servlet runner handles HTTP requests, instantiates published servlets in sessions, and invokes servlet methods. Additional sources of information: ---------------------------------- Oracle8i Oracle Servlet Engine User's Guide Note:133391.1 Configuring Oracle Servlet Engine (OSE) for HTTP access to Oracle 8i Note:139639.1 HOW to Run Servlet in oracle servlet engine (OSE) through MOD_OSE ***JISJA.SQL*** To execute- SQL>set echo on SQL>spool jisja.log SQL>@?/javavm/install/jisja.sql SQL>spool off Summary of added functionality: ------------------------------- This script will turn on the JAccelerator (ncomp) for JIS. Adding this functionality will increase performance. JServer Accelerator, implemented within the ncomp tool, natively compiles all classes within the specified JAR, ZIP, or list of classes. JServer Accelerator natively compiles these classes and places them into shared libraries according to their package. Additional sources of information: ---------------------------------- Oracle8i Java Tools Reference Note:134985.1 JServer Accelerator and the NCOMP Utility. ***JISAEPHC.SQL*** To execute- SQL>set echo on SQL>spool jisaephc.log SQL>@?/javavm/install/jisaephc.sql SQL>spool off Summary of added functionality: ------------------------------- Adds the set of default end points to the server with hardcoded values for the admin service (after the OSE install). This script is for an installation default purpose only. It is advised that security conscious installations change these endpoint values with 'rmendpoint' and 'addendpoint' from the session shell. For an example, see section 3 of [NOTE:133391.1]. ***INITPLGS.SQL*** To execute- SQL>set echo on SQL>spool initplgs.log SQL>@?/rdbms/admin/initplgs.sql SQL>spool off Summary of added functionality: ------------------------------- This script loads the PLSQL Gateway Servlet jar files into the database. This allows for the running of PL/SQL stored procedures as servlets, (known as the embedded PL/SQL gateway). PL/SQL procedures can then run over the Web without any code changes or loading/publishing steps for each procedure. Additional sources of information: ---------------------------------- Oracle8i Oracle Servlet Engine User's Guide Note:132127.1 JAVA: How to Configure PL/SQL Servlets for Stateful Connections ***INITJSP.SQL*** To execute- SQL>set echo on SQL>spool initjsp.log SQL>@?/jsp/install/initjsp.sql SQL>spool off Summary of added functionality: ------------------------------- This script installs the ORACLE Java Server Pages (JSP) Functionality. Excerpt taken from the Oracle JavaServer Pages Developer's Guide and Reference... JavaServer Pages(TM) is a technology specified by Sun Microsystems as a convenient way of generating dynamic content in pages that are output by a Web application (an application running on a Web server). This technology, which is closely coupled with Java servlet technology, allows you to include Java code snippets and calls to external Java components within the HTML code (or other markup code, such as XML) of your Web pages. JavaServer Pages (JSP) technology works nicely as a front-end for business logic and dynamic functionality in JavaBeans and Enterprise JavaBeans (EJBs). JSP code is distinct from other Web scripting code, such as JavaScript, in a Web page. Anything that you can include in a normal HTML page can be included in a JSP page as well. In a typical scenario for a database application, a JSP page will call a component such as a JavaBean or Enterprise JavaBean, and the bean will directly or indirectly access the database, generally through JDBC or perhaps SQLJ. A JSP page is translated into a Java servlet before being executed (typically on demand, but sometimes in advance), and it processes HTTP requests and generates responses similarly to any other servlet. JSP technology offers a more convenient way to code the servlet. Furthermore, JSP pages are fully interoperable with servlets--JSP pages can include output from a servlet or forward to a servlet, and servlets can include output from a JSP page or forward to a JSP page. Additional sources of information: ---------------------------------- Oracle Java Server Pages Developer's Guide and Reference Note:121766.1 Oracle 8.1.7 (Release 3) New features Summary ***JSPJA.SQL*** To execute- SQL>spool jspja.log SQL>@?/jsp/install/jspja.sql SQL>spool off Summary of added functionality: ------------------------------- This script loads the JAccelerator classes for the JSP functionality. Jaccelerator allows for native compilaton of java code. Additional sources of information: ---------------------------------- Oracle8i Java Tools Reference Release 3 ***INITPLSJ.SQL*** To execute- SQL>spool initplsj.log SQL>@?/rdbms/admin/initplsj.sql SQL>spool off Summary of added functionality: ------------------------------- Initializes the Java library needed by PL/SQL Additional sources of information: ---------------------------------- Oracle8i Java Stored Procedures Developer's Guide Oracle8i Java Developer's Guide ***INITJMS.SQL*** To execute- SQL>spool initjms.log SQL>@?/rdbms/admin/initjms.sql SQL>spool off Summary of added functionality: ------------------------------- This script is used to load AQ/JMS jar files into the database. Oracle Java Messaging Service (JMS): Oracle Java Messaging Service provides a Java API for Oracle8i Advanced Queuing based on the JMS standard. Oracle JMS supports the standard JMS interfaces and has extensions to support the AQ administrative operations and other AQ features that are not a part of the standard. Additional sources of information: ---------------------------------- Oracle8i Application Developer's Guide - Advanced Queuing Release 2 (8.1.6) Oracle8i Supplied Java Packages Reference Release 3 (8.1.7) Note:112928.1 An overview of JMS in 8.1.6 ***INITREPAPI.SQL*** To execute- SQL>spool initrepapi.log SQL>@?/rdbms/admin/initrepapi.sql SQL>spool off Summary of added functionality: ------------------------------- This script loads RepAPI server classes and publishes the 'repapi' objects. $ORACLE_HOME/rdbms/jlib/repapi_s.jar is loaded to the database. Loading this file is required for Java RepAPI Server side functionality. The RServer.class and its helper class are published in /etc namespace. RepAPI is a runtime library that enables clients to replicate data with Oracle servers. Additional sources of information: ---------------------------------- Oracle8i Replication Release 2 (8.1.6) ***INITSOXX.SQL*** To execute- SQL>spool initsoxx.log SQL>@?/rdbms/admin/initsoxx.sql SQL>spool off Summary of added functionality: ------------------------------- This script loads objects, extensibility and xml related java classes into the database. Additional sources of information: ---------------------------------- Oracle8i Application Developer's Guide-XML Oracle 8i Data Cartridge Developer's Guide Release 2 (8.1.6) ***JISAEP.SQL*** To execute- The following is an example. SQL>spool jisaep.log SQL>@?/javavm/install/jisaep admin 8080 9090 SQL>spool off Summary of added functionality: ------------------------------- This script configures the OSE default admin Web Service. Uses the shell to add the two default endpoints for the predefined services. It requires two or three arguments: 1) Name of the service 2) Plain TCP port number to use 3) SSL port number to use Additional sources of information: ---------------------------------- Oracle8i Migration Release 3 (8.1.7) Oracle8i Oracle Servlet Engine User's Guide Release 3 (8.1.7) SECTION C) POST-INSTALLATION CHECKS / CONFIRMATION OF SUCCESSFUL EXECUTION(S): ================================================================================ On a freshly created database (or a database having just catalog.sql and catproc.sql run upon it) there should be no "java objects" within the database. The "java objects" being identified by a query of DBA_OBJECTS where OBJECT_TYPE like 'JAVA%'. The java-related scripts mentioned within this bulletin will install both java objects and generic database objects such as indexes, functions, and views etc. The most critical script of the list in "SECTION B" is the initjvm.sql script. After an execution of that script a count of the java related objects should be performed. NOTE: The numbers of objects given in the samples below is approximate, and may not exactly match your results. Use the numbers for APPROXIMATION ONLY, and remember that having zero invalid JAVA objects is the other important test. The intent is to show that the running of all jvm-related scripts will yield significantly more java objects than running initjvm.sql by itself. The KEY is to ensure that no java objects are invalid after the installation.      select count(*) from DBA_OBJECTS where OBJECT_TYPE like 'JAVA%';      This should return a count of 6785.      None of them should be invalid....      select count(*) from DBA_OBJECTS where OBJECT_TYPE like 'JAVA%' and STATUS = 'INVALID'; If the count is smaller than the one mentioned in the first query OR if there are invalids returned from the second query, it would be worthwhile to investigate any errors in the spooled log and/or the alert log before proceeding with the rest of the JVM installation. An itemized breakdown of the objects added by each script will now be provided. A count from DBA_OBJECTS where OBJECT_TYPE like 'JAVA%' will be given after the execution of the initjvm.sql script, and again, after the execution of the final script. INITJVM.SQL CREATES: -------------------- 3 functions 4 indexes 6438 java classes 290 java data 57 java resources 6 packages 1 sequence 6443 synonyms 8 tables 2 triggers 3 views SQL> select count(*), object_type from dba_objects where object_type like 'JAVA%' group by object_type; 6438 JAVA CLASS 290 JAVA DATA 57 JAVA RESOURCE ------------------- 6785 INITXML.SQL CREATES: -------------------- 2 indexes 272 classes 31 java resources 1 lob 19 packages 272 synonyms 2 tables     CATXSU.SQL CREATES: ------------------- 29 classes 30 java resources 3 packages 3 synonyms INIT_JIS.SQL CREATES: --------------------- 12 indexes 2384 classes 10 java resources 1 lob 13 packages 5 sequences 2400 synonyms 17 tables 1 trigger 1 view JISJA.SQL CREATES: ------------------ 154 classes 8 java sources 1 procedure 3 tables JISAEPHC.SQL CREATES: --------------------- No new objects...... INITPLGS.SQL CREATES: --------------------- 1 class 1 synonym INITJSP.SQL CREATES: -------------------- 275 classes 2 java resources 275 synonyms JSPJA.SQL CREATES: ------------------ 20 classes INITPLSJ.SQL CREATES: --------------------- 2 classes INITJMS.SQL CREATES: -------------------- 159 classes 159 synonyms INITREPAPI.SQL CREATES: ----------------------- 71 classes 71 synonyms INITSOXX.SQL CREATES: --------------------- 37 classes 37 synonyms JISAEP.SQL CREATES: ------------------- No new objects..... TOTALS AFTER THE EXECUTION OF ALL SCRIPTS: ------------------------------------------ SQL>select count(*) from dba_objects where object_type like 'JAVA%' and owner = 'SYS'; COUNT(*) ---------- 10270 SQL>select count(*) from dba_objects where object_type like 'JAVA%' and status = 'INVALID' and owner = 'SYS'; COUNT(*) ---------- 0 SECTION D) SOURCES OF JVM-RELATED DOCUMENTATION: ==================================================== Separate hardcopy and on-line documentation are provided for the major Java-related components of this release. The online documentation for the later version of 8i and the current version of 9i have been greatly enhanced. There now exists a search utility available on http://technet.oracle.com. The search tool allows for keyword searches within the span of the official Oracle documentation for 8.1.7 and 9i. Additionally, this is the same search utility found on http://tahiti.oracle.com/pls/tahiti/tahiti.homepage - Oracle8i Java Developer's Guide - Oracle8i Java Tools Reference - Oracle Java Server Pages Developer's Guide and Reference - Oracle8i Enterprise JavaBean Developer's Guide and Reference - Oracle8i CORBA Developer's Guide and Reference - Oracle8i Oracle Servlet Engine User's Guide - Oracle8i JDBC Developer's Guide and Reference - Oracle8i SQLJ Developer's Guide and Reference - Oracle8i JPublisher User's Guide - Oracle8i Java Stored Procedures Developer's Guide - Oracle8i Application Developer's Guide-XML - Oracle8i Application Developer's Guide - Advanced Queuing - Oracle8i Supplied Java Packages Reference Release 3 (8.1.7) Other References [NOTE:175472.1]How to Cleanup the JVM in 8.1.7
Joel P�rez