Oracle Configurator Implementation Guide Release 11i January 2001 Part No. A87531-01 The tasks presented here are required to set up and support developers and users of run-time Oracle Configurators. Oracle Configurator Implementation Guide, Release 11i Part No. A87531-01 Copyright © 1996, 2001, Oracle Corporation. All rights reserved. Primary Author: Denise Boyer Contributing Authors: Mark Sawtelle, Tina Brand Contributors: Ashot Khachatryan, Serge Kudravtsev, Sarit Manna, Helen Reznik, Michael Sheehy, Alexander Siaston, Andrew Wolfe The Programs (which include both the software and documentation) contain proprietary information of Oracle Corporation; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs is prohibited. Program Documentation is licensed for use solely to support the deployment of the Programs and not for any other purpose. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this document is error free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation. If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on behalf of the U.S. Government, the following notice is applicable: Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial computer software" and use, duplication, and disclosure of the Programs, including documentation, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement. Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR 52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the Programs. Oracle is a registered trademark, and Oracle Application Object Library, SQL*Net, SQL*Loader, SQL*Plus, Net8, SellingPoint, Oracle8, and Oracle8i are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners. Contents List of TablesFigures Send Us Your Comments ................................................................................................................... xi Preface........................................................................................................................................................... xiii Intended Audience ............................................................................................................................... xiii Structure................................................................................................................................................. xiii Related Documents.............................................................................................................................. xiv Conventions........................................................................................................................................... xv Product Support.................................................................................................................................... xv 1 Introduction 1.1 Run-time Oracle Configurators........................................................................................... 1–1 1.2 Oracle Configurator Schema................................................................................................ 1–2 1.3 Overview of Oracle Configurator Implementation.......................................................... 1–2 1.3.1 Concurrent Programs .................................................................................................... 1–3 1.4 Terms....................................................................................................................................... 1–4 1.5 Requirements ......................................................................................................................... 1–5 1.6 Oracle Configurator Environments .................................................................................... 1–5 1.6.1 Development................................................................................................................... 1–6 1.6.2 Testing.............................................................................................................................. 1–8 1.6.3 Production....................................................................................................................... 1–8 1.6.4 Maintenance.................................................................................................................... 1–9 1.7 Oracle Configurator Architecture Overview ................................................................. 1–10 1.8 Implementation Tasks ....................................................................................................... 1–11 iii 1.8.1 Commonly Performed Implementation Tasks ....................................................... 1–12 1.8.1.1 Server Administration ........................................................................................ 1–12 1.8.1.2 View the Status of Oracle Configurator Concurrent Process Requests ....... 1–16 1.8.1.3 Query Registered Oracle Configurator Concurrent Programs ..................... 1–18 1.8.1.4 Connect to a Database Instance.......................................................................... 1–21 1.8.1.5 Verify Oracle Configurator Schema Version ................................................... 1–21 2 The Spx.ini File 2.0.1 Parameters in spx.ini..................................................................................................... 2–2 2.0.1.1 [Merlin] .................................................................................................................... 2–3 2.0.1.2 [DSN] ....................................................................................................................... 2–3 2.0.1.3 [dsn].......................................................................................................................... 2–4 2.0.1.4 [Design Chart]......................................................................................................... 2–5 2.0.1.5 [Test]......................................................................................................................... 2–6 3 The Oracle Configurator Schema 3.1 Characteristics of the Oracle Configurator Schema......................................................... 3–1 3.1.1 CF Configuration........................................................................................................... 3–2 3.1.2 GN General Use Tables ................................................................................................ 3–2 3.1.3 IM Item-Master .............................................................................................................. 3–2 3.1.4 LC Logic for Configuration (Active Model).............................................................. 3–2 3.1.5 PB Publication................................................................................................................ 3–3 3.1.6 PS Project Structure....................................................................................................... 3–3 3.1.7 RP Repository ................................................................................................................ 3–3 3.1.8 UI User Interface (Active UI)....................................................................................... 3–4 3.1.9 XF Transfer Specifications and Control ..................................................................... 3–4 3.2 Oracle Configurator Schema Settings................................................................................ 3–4 3.2.1 CZ_DB_SETTINGS for SCHEMA............................................................................... 3–7 3.2.2 CZ_DB_SETTINGS for ORAAPPS_INTEGRATE .................................................... 3–8 3.2.3 CZ_DB_Settings for IMPORT...................................................................................... 3–9 3.3 Editing the CZ_DB_SETTINGS Values .......................................................................... 3–10 3.3.1 Modify Configurator Parameters.............................................................................. 3–11 3.3.2 View Configurator Parameters.................................................................................. 3–12 3.4 Oracle Configurator Schema Maintenance....................................................................