Related Manuals for Oracle Retail Place 12.2
Summary of Contents for Oracle Retail Place 12.2
- Page 1 ® Oracle Retail Place Installation Guide Release 12.2 November 2008...
- Page 2 ® Oracle Retail Place Installation Guide, Release 12.2 Copyright © 2006, 2008, Oracle. All rights reserved. Primary Author: Anirudha Accanoor The Programs (which include both the software and documentation) contain proprietary information; 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.
- Page 3 Value-Added Reseller (VAR) Language Oracle Retail VAR Applications The following restrictions and provisions only apply to the programs referred to in this section and licensed to you. You acknowledge that the programs may contain third party software (VAR applications) licensed to Oracle.
-
Page 5: Table Of Contents
Contents Preface ................................. ix Audience............................... ix Related Documents ............................. ix Customer Support ............................Review Patch Documentation ........................Oracle Retail Documentation on the Oracle Technology Network ............. Conventions ..............................Overview Overview of Place............................. 1-1 Place Enterprise Components ......................1-1 Roadmap for Implementing Place ......................1-4 Planning Your Installation Overview of the Planning Process ...................... - Page 6 Setting Up the WebLogic Startup Script....................4-4 Setting Up the Maximum Message Size ....................4-5 Installing Place Overview of the Installation Process....................5-1 About Password Security Management ..................5-1 Installing Place............................5-2 Accessing the Installation Software....................5-2 Setting Up Your Installation Properties File .................. 5-3 Installing Place in the Silent Mode ....................
- Page 7 Setting Up a Foreign JMS Server on WebLogic Server..............6-6 Files and Directory Structure Application Directory Structure ......................A-1 Modules Deployed On WebLogic Server ................... A-4 Index...
- Page 8 viii...
-
Page 9: Preface
Preface This guide enables you to install the Oracle Retail Place application, along with the server-side components required for the application. Audience This guide is intended for system administrators and assumes that you are familiar with the following: Installing and configuring application server software ■... -
Page 10: Customer Support
Customer Support https://metalink.oracle.com ■ When contacting Customer Support, please provide: Product version and program/module name ■ Functional and technical description of the problem (include business impact) ■ Detailed step-by-step instructions to recreate ■ Exact error message received ■ Screen shots of each step you take ■... -
Page 11: Overview
Overview This chapter provides an overview of Oracle Retail Place and a roadmap for implementing the application. It contains the following sections: Overview of Place ■ Overview of Oracle Configuration Manager ■ Roadmap for Implementing Place ■ Overview of Place ®... - Page 12 Overview of Place Figure 1–1 Typical Configuration for Place Client System Tier The Client System tier contains the systems that connect to the Place application using a Web browser. It includes systems with the following components: Microsoft Windows ■ Microsoft Office ■...
- Page 13 Overview of Place Database Server Tier The Database Server tier contains the systems configured with the database management systems (Oracle 10g Database) along with the necessary database software. The following essential schemas are created during the Place installation: AUDIT schema – contains information that helps you better track objects, events ■...
-
Page 14: Roadmap For Implementing Place
Roadmap for Implementing Place Roadmap for Implementing Place This guide explains how you can install and set up the Place application, along with the required and optional software. The instructions in this guide assume knowledge of application servers, databases, and application installation, and are intended for system administrators and experienced IT personnel. -
Page 15: Planning Your Installation
Planning Your Installation Before installing the Place application, you must first determine the performance and availability goals for your business, and then plan the hardware, network, and storage requirements accordingly. This chapter provides some basic considerations for the implementation. It also includes the list of hardware and software requirements. This chapter includes the following sections: Overview of the Planning Process ■... -
Page 16: Planning For Optimal Place Performance
Supported Configurations Planning for Optimal Place Performance Consider the following steps to plan and prepare the product environment. Determine the Place metrics relevant to your business needs. Determine your relevant business policies. The business policy is a statement of what rules govern the application processes. You need to develop a business policy based on your business rules. -
Page 17: Database Requirements
Supported Configurations Database Requirements Place requires the use of the Oracle database as described in the following table: Table 2–1 Oracle Database Requirements Software Requirement Database Oracle 10g Release 2 (10.2.0.2) Oracle 10g Release 2 (10.2.0.3) Operating System HP-UX 11i v2 (11.23) Enterprise Solaris 10 for SPARC platform and x86 Release on Itanium-based systems platform... -
Page 18: Client System Requirements
Supported Configurations Client System Requirements The following table lists the supported client system options: Table 2–3 Client System Environment Software Requirements Windows XP Pro SP2 Microsoft Office XP ■ (with Office XP) Microsoft Internet Explorer 7.0 ■ Windows XP Pro SP2 Microsoft Office 2000 ■... -
Page 19: Setting Up The Database
Setting Up the Database Before you run the Oracle installer to install the application, you must set up the database to include certain necessary tablespaces, and a database user account. This chapter describes how you can set up your database, and the various database components. -
Page 20: Creating The Default Tablespaces
Creating the Default Tablespaces Creating the Default Tablespaces When you run the Oracle installer, schemas and tables for the application get installed on the database you create. For the schemas and tables to install successfully, the database must include certain default tablespaces. Use the Oracle 10g Database Configuration Assistant to create a default database with the tablespaces mentioned in Table... -
Page 21: Creating The Database Links
Creating the Database Links Creating the Database Links If you plan to install the Place application across two database instances, you must create the instances in the following manner, and then set up the database links between the two instances: Set up the ELM schema (historical data) on a database instance ■... - Page 22 Creating the Database Links 3-4 Oracle® Retail Place Installation Guide...
-
Page 23: Setting Up The Application Server
Setting Up the Application Server Before installing the Place application, you must set up a domain on the application server. Based on your business need, you must set up the domain to include one or more server instances, and logically related resources and services. This chapter describes how you can set up a domain on the WebLogic server. -
Page 24: Setting Up A Weblogic Domain
Setting Up a WebLogic Domain Setting Up a WebLogic Domain Use the BEA WebLogic Configuration Wizard to create and set up a domain on the WebLogic Server. This section describes how you can create and set up a domain. It also includes the steps to configure the managed servers and clusters on the application server. - Page 25 Setting Up a WebLogic Domain Table 4–1 Steps to Set Up a WebLogic Domain Step Window Task a. Configure Managed Servers Window Click Add, and then enter appropriate information in the following fields: Name – Valid server name. (String of characters that can ■...
-
Page 26: Setting Up The Weblogic Startup Script
Setting Up the WebLogic Startup Script Table 4–1 Steps to Set Up a WebLogic Domain Step Window Task Configure Administrative Username and Password Window Set up an administrative user name and password. Important: Please keep a note of the user name and password. You must specify this user name and password in the install.properties file. -
Page 27: Setting Up The Maximum Message Size
Setting Up the Maximum Message Size After the CLASSPATH statement, add the following statement to set up the LD_LIBRARY_PATH environment variable: export LD_LIBRARY_PATH=$<PRODUCT_INSTALL_BASE>/modules/Engine/lib/linux_ i686:$LD_LIBRARY_PATH You can choose to set up this environment variable as part of the Note: automation process (for example, .bash_profile) defined for your business. On the last line, update the JAVA_HOME statement to read as the following: ${JAVA_HOME}/bin/java ${JAVA_VM}${MEM_ARGS]${JAVA_OPTIONS} -Djava.awt.headless=true -Dweblogic.Name=${SERVER_NAME}... - Page 28 Setting Up the Maximum Message Size 4-6 Oracle® Retail Place Installation Guide...
-
Page 29: Installing Place
Installing Place After you have set up your database and application server, you can install Place using the guidelines provided in this chapter. This chapter contains the following sections: Overview of the Installation Process ■ Installing Place ■ Install.properties Parameters Reference ■... -
Page 30: Accessing The Installation Software
Installing Place Installing Place Installing Place consists of the following tasks: Accessing the Installation Software ■ Setting Up Your Installation Properties File ■ Installing Place in the Silent Mode ■ Installing Place Using the Graphical Oracle Installer ■ Installing the Sample Dataset ■... -
Page 31: Setting Up Your Installation Properties File
Installing Place Oracle E-Delivery writes a ZIP file to the default location you have selected for downloads. Unpack the ZIP file to a temporary directory. In this guide, the directory that contains the installation media is referred to as the <PLACE_CD_IMAGE> directory. -
Page 32: Installing Place Using The Graphical Oracle Installer
Installing Place Argument Description -p <path-to- install.properties> Optional. Specifies an alternate path to the install.properties file. Defaults to ./install.properties. -l, --log-config Optional. Specifies an alternate log4j configuration file (to change the verbosity level or the log file output location). Defaults to ./Install/conf/log4j.properties. The log4j log file is used for troubleshooting. - Page 33 Installing Place bash install.sh For more information about this command, see Installing Place Note: in the Silent Mode. The Welcome screen appears. Figure 5–1 Welcome Screen Click Next. The Place Installation Destination screen appears. On the Place Installation Destination screen, specify the paths for the following: Destination Directory - path to the Place installation target directory.
- Page 34 Installing Place Figure 5–2 Place Installation Destination Screen Click Next. The Place Selections screen appears. On the Place Selections screen, select the component you want to install, and click Next. Figure 5–3 Place Selections Screen On the Application Server Selections screen, click BEA WebLogic, and then click Next.
- Page 35 Installing Place Figure 5–4 Application Server Selections Screen On the WebLogic Application Server screen, enter the relevant information (such as host, port, user name, password) to connect to the WebLogic server set up for the application. Figure 5–5 WebLogic Application Server In case the installation does not proceed ahead, check the Note: WebLogic server information or the status of the application server.
- Page 36 Installing Place Figure 5–6 Java Message Server Properties Screen Click Next. The Database Selections screen appears. On the Database Selections screen, click Oracle, and then click Next. Figure 5–7 Database Selections Screen On the Database Properties screen, enter the following database information for the Place Front End, Actual History, Application, Audit, and Plan Front End databases: Database server address –...
- Page 37 Installing Place Database alias – Enter the database alias, which is typically the same name as ■ the database. Tables – Select one of the following options: ■ – No Change – Select this option if you have an existing database schema that you do not want to modify.
- Page 38 Installing Place Figure 5–9 Schema Link Properties Screen Review the Selection Verification screen, and click Install. Figure 5–10 Selection Verification Screen The Installation Progress screen appears. If the installation resulted in issues, see Troubleshooting Installation Issues page 5-24. Once the installation is complete, before you restart the application server, you must edit the WebLogic startup script and source the Application Development Framework (ADF) libraries in the WebLogic Server Home directory.
-
Page 39: Setting Up Adf Libraries
Installing Place Setting Up ADF Libraries For the Online Help to work, you must invoke the ADF libraries in the WebLogic Server Home directory. Although the ADF libraries are part of the product installation and they get installed along with the product, you must source the setupadf.sh file in the WebLogic startup script. - Page 40 Installing Place Table 5–1 Servername and Portnumber Description Where servername The name of the application server where the application is installed. portnumber The port number that the application server uses for the application. On the WebLogic Server Console, under Service Configurations, click Servers in the JMS column.
-
Page 41: Installing The Sample Dataset
Installing Place Installing the Sample Dataset The Place installation comes along with a sample dataset that can be used during implementation and demonstrations. This dataset contains generic data and is designed to work along with the default product configuration. The data files, along with the necessary data load scripts, are included as part of the installation media. -
Page 42: Install.properties Parameters Reference
Install.properties Parameters Reference Install.properties Parameters Reference The install.properties file enables you to set up the following parameters before you install Place: Installation Target Directories ■ Command Shell Settings ■ Last Session Properties Files ■ Application Server and Database Settings ■ Connection Pools Settings ■... -
Page 43: Last Session Properties Files
Install.properties Parameters Reference Last Session Properties Files The Last Session Properties Files settings enable you to specify the location where you want to store the last-session.properties and missing-entries.properties files. The following table describes the Last Session Properties Files settings: Table 5–4 Last Session Properties Files Parameter Description... -
Page 44: Calc Engine User Setting
Install.properties Parameters Reference Table 5–6 Connections in the Connection Pools Parameter Description weblogic.dbcpool.historicalconnectionpool.min Use this parameter to specify the minimum database connections in the historical connection pool. weblogic.dbcpool.historicalconnectionpool.max Use this parameter to specify the maximum database connections in the historical connection pool. weblogic.dbcpool.analyticalconnectionpool.min Use this parameter to specify the minimum database connections in the analytical connection pool. -
Page 45: Oracle Database Settings
Install.properties Parameters Reference Table 5–8 WebLogic Application Server Settings Parameter Description weblogic.managedserver.address Indicates the URL to connect to the managed server. The value defaults to the URL specified in the weblogic.server.address parameter. For a clustered-based installation, ensure that you set the appropriate managed server address. - Page 46 Install.properties Parameters Reference Table 5–9 Connection and Authentication Settings Parameter Description dbms.oracle.alias Use this parameter to specify the database alias name. dbms.oracle.user Use this parameter to specify the user name to connect to the database. dbms.oracle.pass Use this parameter to specify the password to connect to the database.
-
Page 47: Audit Database Properties
Install.properties Parameters Reference Audit Database Properties The Audit Database properties enable you to specify the connection and authentication parameters for the Audit database. The following table describes the Audit Database properties: Table 5–10 Audit Database Properties Parameter Description database.AuditDB.oracle.dbname Use this parameter to specify the name of the Audit database. -
Page 48: Place Schema Properties
Install.properties Parameters Reference Place Schema Properties The Place Schema properties enable you to specify the connection and authentication parameters for the Place schema in the Place database. The following table describes the Place Schema properties: Table 5–11 Place Schema Properties Parameter Description Properties to Define the Place Database... -
Page 49: Elm Schema Properties
Install.properties Parameters Reference Table 5–12 Plan Front End Database Properties Parameter Description database.plandb.oracle.create Use this parameter to indicate that a new Plan database be created. Valid values are Yes or No. database.plandb.oracle.upgrade Use this parameter to indicate that the existing Plan database be upgraded. -
Page 50: Place-Specific Suite Properties
Install.properties Parameters Reference Place-specific Suite Properties The Place-specific Suite properties enable you to specify properties that apply across the product suite. The following table describes the Place-specific Suite properties: Table 5–14 Place-specific Suite Properties Parameter Description http.protocol Use this parameter to specify to specify the type of http protocol. ce.url Use this parameter to specify the URL where the Calculation Engine is installed. -
Page 51: Microstrategy Properties
Install.properties Parameters Reference Table 5–15 Cluster Properties Parameter Description jndi.host Use this parameter to specify the host name of the JNDI server. jndi.port Use this parameter to specify the port to connect to the JNDI server. integration.jndi.host Use this parameter to specify the host name of the JNDI server that is used as an external queue. -
Page 52: Troubleshooting Installation Issues
Troubleshooting Installation Issues Table 5–16 Last Session Properties Files Parameter Description mstr.users.max Use this parameter to specify the maximum number of users that can connect to the MicroStrategy server at a time. bi.server Use this parameter to specify the Business Intelligence (BI) server version. Valid values are MS7 or MS8. - Page 53 Troubleshooting Installation Issues Installation Aborts Because of Incompatible Components When upgrading to the Plan Release 12.2 and Place Release 12.2 on a co-deployed environment, in case the installation does not complete because of the incompatible components, you must run the first product upgrade with "-P" argument. For more information, see Upgrading a Co-deployed Environment.
- Page 54 Troubleshooting Installation Issues 5-26 Oracle® Retail Place Installation Guide...
-
Page 55: Installing Place Over Plan
Installing Place Over Plan This chapter describes how you can install the Place application to work along with an existing installation of Plan. It includes the procedures you can use to deploy the Place application in the same WebLogic domain used by Plan. It includes the following sections: Setting Up the Plan Installation ■... -
Page 56: Setting Up The Place Installation
Setting Up the Place Installation database.<schema_name>.oracle.upgrade=yes For more information on the installation properties file and the Plan installation procedure, see the chapter Installing Plan. Setting Up the Place Installation Before you start installing the Place application, you must edit the installation properties file and direct the installer to create a new Place schema. -
Page 57: Configuring Place
Configuring Place Configuring Place Once the Place application is installed, you must load the user roles and business rules used between Place and Plan. You must also run certain scripts that load seed data for the Place application. This section includes the following tasks you must perform to load the business rules, user roles, and seed data: Loading Business Rules ■... - Page 58 Configuring Place load the seed data. For more information on the scripts, see Reference to the Data Load Scripts. To load the seed data: At the SQL prompt, run the following scripts: custom_ir_objects.sql (Custom script) ■ pl_dd_attributes.sql (Generic script) ■ data_levels_tbl.sql (Custom script) ■...
-
Page 59: Reference To The Data Load Scripts
Configuring Place Reference to the Data Load Scripts The following table describes the scripts (required for the data load), and lists their location in the AESample directory: Table 6–1 Data Load Scripts for Place and Plan Script Location Script Name (Place_Install\DataSets\AESample) Script Description Custom Scripts custom_ir_objects.sql... -
Page 60: Upgrading A Co-Deployed Environment
Upgrading a Co-deployed Environment Upgrading a Co-deployed Environment When upgrading to the Plan Release 12.2 and Place Release 12.2 on an existing co-deployed environment, the installation may abort because of the incompatible components. The following example (Example 6–1) displays an error message that lists the incompatible components (Alert 1.3.1 and Suite 1.5.0). - Page 61 Setting Up a Foreign JMS Server on WebLogic Server Local JNDI Name: CommonConnectionFactory Remote JNDI Name: CommonConnectionFactory Configure a new Foreign JMS Topic and point it to the topic created under the CommonJMSServer deployed on Plan. For example, Name: RemoteNotificationTopic Local JNDI Name: com.profitlogic.notification.topic Remote JNDI Name: com.profitlogic.notification.topic The 'com.profitlogic.notification.topic' used above is the JNDI...
- Page 62 Setting Up a Foreign JMS Server on WebLogic Server 6-8 Oracle® Retail Place Installation Guide...
-
Page 63: Application Directory Structure
Files and Directory Structure This appendix provides a reference to the directory structure of a typical Place installation. It includes information on the locations of the various enterprise archive (EAR) modules that get deployed over the WebLogic server. This appendix includes the following sections: Application Directory Structure ■... - Page 64 Application Directory Structure Table A–1 Application Directory Structure First Second Third Fourth Level Level Level Level Description <Place_Installation> The Place Installation Base folder. |------ integration Contains the configuration files for the Integration module. This includes the integration.properties file. testharness |----- |----- translators |-----...
- Page 65 Application Directory Structure Table A–1 Application Directory Structure First Second Third Fourth Level Level Level Level Description <Place_Installation> The Place Installation Base folder. |------ Database Contains the scripts that help set up the application database. Datasets Contains the scripts and control files that help set up a sample |------ (AESample) dataset.
-
Page 66: Modules Deployed On Weblogic Server
Modules Deployed On WebLogic Server Modules Deployed On WebLogic Server The following table lists the application modules EARs deployed on the WebLogic server: Table A–2 Modules Deployed on WebLogic Server Module Name Description EAR File Name and Location allocating4p Place application /modules/Place/allocating4p.ear BRMHelp Business Rule Management Online Help... - Page 67 Index ADF libraries, 5-11 E-delivery, 5-2 application server enterprise components requirements, 2-3 application server tier, 1-2 application server and database settings, 5-15 client system tier, 1-2 database server tier, 1-3 brmadmin, 6-3 bulk loader, 6-3 generic scripts, 6-5 business rules, 6-3 graphical mode, 5-4 guidelines implementing plan, 1-4...
- Page 68 webLogic application server settings, 5-16 custom, 6-5 install.properties file, 5-3 generic, 6-5 setup audit, 6-1 seed data, 6-3 setup ADF libraries, 5-11 database last session properties files, 5-15 tablespaces, 3-2 load user account, 3-2 business rules, 6-3 installation properties file, 5-3 seed data, 6-3 place installation, 6-2 user roles, 6-3...