oracle® value chain planning...oracle value chain planning installation guide, release 12.2 part...

126
Oracle® Value Chain Planning Installation Guide Release 12.2 Part No. E48790-03 July 2014

Upload: others

Post on 12-Aug-2020

8 views

Category:

Documents


0 download

TRANSCRIPT

  • Oracle® Value Chain PlanningInstallation GuideRelease 12.2Part No. E48790-03

    July 2014

  • Oracle Value Chain Planning Installation Guide, Release 12.2

    Part No. E48790-03

    Copyright © 2008, 2014, Oracle and/or its affiliates. All rights reserved.

    Primary Author:     Gary O'Hara, Greg Watkins

    Contributing Author:     Ganesh Iyer, Christine Chen

    Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

    Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

    This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

    The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

    If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

    U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

    This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

    This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

  •     iii

     Contents

    Send Us Your Comments

    Preface

    1 Oracle Value Chain Planning InstallationAbout this Document................................................................................................................ 1-1Before Applying the Feature Pack............................................................................................ 1-2Product-Specific Installation Tasks.......................................................................................... 1-3Post Installation Tasks.............................................................................................................. 1-3Oracle Value Chain Planning - Oracle Transportation Management (OTM) Integration...... 1-4

    2 Advanced Planning Command CenterSetting Up Advanced Planning Command Center Reports and Dashboards......................... 2-1Configuring Single Sign-on...................................................................................................... 2-9Troubleshooting...................................................................................................................... 2-11Using WebCenter for APCC....................................................................................................2-12

    3 Advanced Supply Chain PlanningPerforming Pre-Configuration Setup....................................................................................... 3-1Performing Configuration ........................................................................................................3-2Upgrading ASCP..................................................................................................................... 3-26Troubleshooting...................................................................................................................... 3-28

    4 Production SchedulingStandalone, Non-Integrated Production Scheduling Installations..........................................4-1Production Scheduling Implementation.................................................................................. 4-1

  • iv

    Mandatory Prerequisite Patches............................................................................................... 4-1Post Installation ........................................................................................................................ 4-2Post Installation Settings.......................................................................................................... 4-2Special Instructions................................................................................................................... 4-3

    5 Strategic Network OptimizationStandalone, Non-Integrated Strategic Network Optimization Installations.......................... 5-1Strategic Network Optimization Integration........................................................................... 5-1Mandatory Prerequisite Patches for Oracle Process Manufacturing (OPM) Users.................5-1Post Installation......................................................................................................................... 5-2Post Installation Settings.......................................................................................................... 5-2Special Instructions................................................................................................................... 5-3

    6 Service Parts PlanningService Parts Planning Installation Updates............................................................................ 6-1

    7 Demand Signal RepositoryDemand Signal Repository (DSR) Implementation.................................................................7-2Prerequisites.............................................................................................................................. 7-2Setting Up Oracle Data Integrator (ODI)..................................................................................7-2Configuring the Physical Architecture in Topology Manager.................................................7-5Configuring the Context and Logical Architecture in Topology Manager..............................7-7Executing Scenarios................................................................................................................... 7-8Setting Up Oracle Business Intelligence Enterprise Edition (OBIEE)..................................... 7-8Setting Up Oracle Business Intelligence Enterprise Translations......................................... 7-10Setting Up the Exception Management Dashboard Feature.................................................. 7-11Configuring a Web Service in OBIEE..................................................................................... 7-14Setting Up Web Services......................................................................................................... 7-19Setting Up Demand Signal Repository - Demantra Integration............................................7-20Setting up Demand Signal Repository - Retail Merchandise System (RMS) Integration.... 7-21Configuring the User Parameters in DSR Lookups............................................................... 7-23Creating the Directories Defined in the DDR_R_LKUP_MST Table....................................7-24Copying the Class and DTD Files ..........................................................................................7-24Importing the DSR - RMS Project Objects in the ODI Designer.......................................... 7-25Configuring the Physical Architecture in Topology Manager...............................................7-27Configuring the Context and Logical Architecture in Topology Manager............................7-27Copying the EDIDLPRD.dat File............................................................................................ 7-28Executing the Scenario............................................................................................................ 7-28

  •     v

    8 Rapid PlanningRapid Planning Installation...................................................................................................... 8-1

    9 Other Useful InformationTroubleshooting........................................................................................................................ 9-1

    Index

  •     vii

     Send Us Your Comments

    Oracle Value Chain Planning Installation Guide, Release 12.2Part No. E48790-03

    Oracle welcomes customers' comments and suggestions on the quality and usefulness of this document. Your feedback is important, and helps us to best meet your needs as a user of our products. For example:

    • Are the implementation steps correct and complete? • Did you understand the context of the procedures? • Did you find any errors in the information? • Does the structure of the information help you with your tasks? • Do you need different information or graphics? If so, where, and in what format? • Are the examples correct? Do you need more examples?

    If you find any errors or have any other suggestions for improvement, then please tell us your name, the name of the company who has licensed our products, the title and part number of the documentation andthe chapter, section, and page number (if available).

    Note: Before sending us your comments, you might like to check that you have the latest version of the document and if any concerns are already addressed. To do this, access the new Oracle E-Business Suite Release Online Documentation CD available on My Oracle Support and www.oracle.com. It contains the most current Documentation Library plus all documents revised or released recently.

    Send your comments to us using the electronic mail address: [email protected]

    Please give your name, address, electronic mail address, and telephone number (optional).

    If you need assistance with Oracle software, then please contact your support representative or Oracle Support Services.

    If you require training or instruction in using Oracle software, then please contact your Oracle local officeand inquire about our Oracle University offerings. A list of Oracle offices is available on our Web site at www.oracle.com.

  •     ix

     Preface

    Intended AudienceWelcome to Release 12.2 of the Oracle Value Chain Planning Installation Guide.

    See Related Information Sources on page x for more Oracle E-Business Suite product information.

    Documentation AccessibilityFor information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

    Access to Oracle SupportOracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

    Structure1  Oracle Value Chain Planning Installation2  Advanced Planning Command Center3  Advanced Supply Chain Planning4  Production Scheduling5  Strategic Network Optimization6  Service Parts Planning7  Demand Signal Repository8  Rapid Planning9  Other Useful Information

  • x

    Related Information SourcesOpen Source Disclosure

    The Advanced Planning applications have embedded within them a variety of third party software components, each of which has its own copyright and licensing terms. The Advanced Planning applications containing third party components from the development organizations identified below are identified in the parenthetical following the name of the organization.

    Apache Software Foundation

    Copyright (c) 2000 The Apache Software Foundation. All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

    1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

    2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

    3. The end-user documentation included with the redistribution, if any, must include the following acknowledgment:

    "This product includes software developed by the Apache Software Foundation (http://www.apache.org/)."

    Alternately, this acknowledgment may appear in the software itself, if and wherever such third-party acknowledgments normally appear.

    4. The names "Apache" and "Apache Software Foundation" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].

    Products derived from this software may not be called "Apache", nor may "Apache" appear in their name, without prior written permission of the Apache Software Foundation.

    THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION ORITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOTLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

    http://www.apache.org/

  •     xi

    LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation. For more information on the Apache Software Foundation, please see .

    Portions of this software are based upon public domain software originally written at the National Center for Supercomputing Applications, University of Illinois, Urbana-Champaign.

    ptmalloc

    Copyright (c) 1999 Wolfram Gloger

    Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the name of Wolfram Gloger may not be used in any advertising or publicity relating to the software.

    THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL WOLFRAM GLOGER BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

    Sleepycat Software

    Copyright (c) 1990, 1993, 1994 The Regents of the University of California. All rights reserved.

    Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

    • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

    • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

    • All advertising materials mentioning features or use of this software must display the following acknowledgement:

    This product includes software developed by the University of California, Berkeley and its contributors.

  • xii

    Neither the name of the University nor the names of its contributors may be used toendorse or promote products derived from this software without specific prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOTLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    Tool Command Language (TCL)

    This software is copyrighted by the Regents of the University of California, Sun Microsystems, Inc., Scriptics Corporation, ActiveState Corporation and other parties. The following terms apply to all files associated with the software unless explicitly disclaimed in individual files.

    The authors hereby grant permission to use, copy, modify, distribute, and license this software and its documentation for any purpose, provided that existing copyright notices are retained in all copies and that this notice is included verbatim in any distributions. No written agreement, license, or royalty fee is required for any of the authorized uses. Modifications to this software may be copyrighted by their authors and need not follow the licensing terms described here, provided that the new terms areclearly indicated on the first page of each file where they apply.

    IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, ANDTHE AUTHORS AND DISTRIBUTORS HAVE NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

    GOVERNMENT USE: If you are acquiring this software on behalf of the U.S. government, the Government shall have only "Restricted Rights" in the software and related documentation as defined in the Federal Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you are acquiring the software on behalf of the Department ofDefense, the software shall be classified as "Commercial Computer Software" and the

  •     xiii

    Government shall have only "Restricted Rights" as defined in Clause 252.227-7013 (c) (1)of DFARs. Notwithstanding the foregoing, the authors grant the U.S. Government and others acting in its behalf permission to use and distribute the software in accordance with the terms specified in this license.

    Independent JPEG Group

    This product includes software developed by the Independent JPEG Group. Copyright (c) 1991-1998 The authors make NO WARRANTY or representation, either express or implied, with respect to this software, its quality, accuracy, merchantability, or fitness for a particular purpose. This software is provided "AS IS", and you, its user, assume the entire risk as to its quality and accuracy.

    Henry Spencer's Regular Expression Library (REGEX)

    This product includes software developed by Henry Spencer. Copyright (c) 1992, 1993, 1994, 1997 This software is not subject to any license of the American Telephone and Telegraph Company or of the Regents of the University of California. Permission is granted to anyone to use this software for any purpose on any computer system, and to alter it and redistribute it, subject to the following restrictions:

    • The author is not responsible for the consequences of use of this software, no matterhow awful, even if they arise from flaws in it.

    • The origin of this software must not be misrepresented, either by explicit claim or by omission. Since few users ever read sources, credits must appear in the documentation.

    • Altered versions must be plainly marked as such, and must not be misrepresented as being the original software. Since few users ever read sources, credits must appear in the documentation.

    • This notice may not be removed or altered.

    XBAE

    Copyright (c) 1991, 1992 Bell Communications Research, Inc. (Bellcore)

    Copyright (c) 1995-99 Andrew Lister

    All Rights Reserved.

    Permission to use, copy, modify and distribute this material for any purpose and without fee is hereby granted, provided that the above copyright notices and this permission notice appear in all copies, and that the name of any author not be used in advertising or publicity pertaining to this material without the specific, prior written permission of an authorized representative of Bellcore and current maintainer.

    BELLCORE AND OTHER CONTRIBUTORS MAKE NO REPRESENTATIONS AND EXTEND NO WARRANTIES, EXPRESS OR IMPLIED, WITH RESPECT TO THE INFORMATION, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR ANY PARTICULAR

  • xiv

    PURPOSE, AND THE WARRANTY AGAINST INFRINGEMENT OF PATENTS OR OTHER INTELLECTUAL PROPERTY RIGHTS. THE SOFTWARE IS PROVIDED "AS IS", AND IN NO EVENT SHALL ANY AUTHOR OR ANY OF THEIR AFFILIATES BE LIABLE FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES RELATING TO THE INFORMATION.

    Oracle

    Oracle takes no responsibility for its use or distribution of any open source or shareware software or documentation and disclaims any and all liability or damages resulting from use of said software or documentation.

    Integration RepositoryThe Oracle Integration Repository is a compilation of information about the service endpoints exposed by the Oracle E-Business Suite of applications. It provides a complete catalog of Oracle E-Business Suite's business service interfaces. The tool lets users easily discover and deploy the appropriate business service interface for integration with any system, application, or business partner.

    The Oracle Integration Repository is shipped as part of the E-Business Suite. As your instance is patched, the repository is automatically updated with content appropriate for the precise revisions of interfaces in your environment.

    Users who are granted the Integration Analyst role can navigate to the Oracle Integration Repository through the Integration Repository responsibility. Users who have the Integration Developer role or the Integration Administrator role can access the Oracle Integration Repository through the Integrated SOA Gateway responsibility.

    Do Not Use Database Tools to Modify Oracle E-Business Suite DataOracle STRONGLY RECOMMENDS that you never use SQL*Plus, Oracle Data Browser, database triggers, or any other tool to modify Oracle E-Business Suite data unless otherwise instructed.

    Oracle provides powerful tools you can use to create, store, change, retrieve, and maintain information in an Oracle database. But if you use Oracle tools such as SQL*Plus to modify Oracle E-Business Suite data, you risk destroying the integrity of your data and you lose the ability to audit changes to your data.

    Because Oracle E-Business Suite tables are interrelated, any change you make using an Oracle E-Business Suite form can update many tables at once. But when you modify Oracle E-Business Suite data using anything other than Oracle E-Business Suite, you may change a row in one table without making corresponding changes in related tables.If your tables get out of synchronization with each other, you risk retrieving erroneous information and you risk unpredictable results throughout Oracle E-Business Suite.

    When you use Oracle E-Business Suite to modify your data, Oracle E-Business Suite

  •     xv

    automatically checks that your changes are valid. Oracle E-Business Suite also keeps track of who changes information. If you enter information into database tables using database tools, you may store invalid information. You also lose the ability to track whohas changed your information because SQL*Plus and other database tools do not keep arecord of changes.

  • Oracle Value Chain Planning Installation    1-1

    1Oracle Value Chain Planning Installation

    This chapter covers the following topics:

    • About this Document

    • Before Applying the Feature Pack

    • Product-Specific Installation Tasks

    • Post Installation Tasks

    • Oracle Value Chain Planning - Oracle Transportation Management (OTM) Integration

    About this DocumentNote: Application Install - Oracle Value Chain Planning 12.2. Information in this document applies to any platform.

    This document contains instructions for customers who plan to upgrade an existing Oracle Value Chain Planning system to 12.2.

    You should read and understand all the tasks described in these installation instructionsbefore you begin the installation.

    Complete the tasks in the following sections in the order listed. Updated versions of the patches and documents listed in this section may be available. Check My Oracle Support or contact Oracle Support Services for the latest versions.

    Tasks included in these instructions require use of the AutoPatch, AD Administration, and other AD utilities. Tasks included in these instructions upgrade the following Oracle Value Chain Planning products to Release 12.2 level:

    • Advanced Planning Command Center (APCC)

    • Advanced Supply Chain Planning (ASCP)

  • 1-2    Oracle Value Chain Planning Installation Guide

    • Demand Planning (DP)

    • Demantra Demand Management

    • Inventory Optimization (IO)

    • Global Order Promising (GOP)

    • Collaborative Planning (CP)

    • Production Scheduling (PS)

    • Strategic Network Optimization (SNO)

    • Service Parts Planning (SPP)

    • Demand Signal Repository (DSR)

    • Rapid Planning (RP)

    Before Applying the Feature PackTo purchase this feature pack, contact an Oracle Sales Representative, by calling 1-888-ORACLEi (1-888-672-2534).

    You must have already applied the 12.2 EBS upgrade OR performed a fresh install of 12.2 EBS applications.

    VCP 12.2.3 is only supported with the following ERP versions: EBS 12.2.3, EBS 12.1.3, and E1 9.1. In the event that the EBS source instance is on 12.2.x, then both the EBS source instance and VCP destination instance must be on matching release version (for example, 12.2.3).

    Refer to My Oracle Support Document 1361221.1, Oracle Value Chain Planning Installation Notes, Release 12.2 - FAQ And Latest Patch Information, for information on installation / upgrading to VCP 12.2.

    If the source (ERP) system version from which data would be collected is lower than theVCP version being installed, then refer to My Oracle Support Document 1361221.1 for the supported integrations and patches required.

    Demantra

    Before performing the upgrade, create backups of the following tables if you are running Demantra, upgrading to VCP 12.2, and have changed the content of any of the following tables:

    • MSD_DEM_QUERIES

    • MSD_DEM_SERIES

  • Oracle Value Chain Planning Installation    1-3

    • MSD_DEM_ENTITY_QUERIES

    After the upgrade is complete, check the tables above and reapply any customizations.

    Product-Specific Installation TasksAfter you apply E-Business Suite Application Release 12.2 Media Pack, for each productthat you intend to use, follow the product-specific installation steps in this document.

    Post Installation TasksProfile Updates

    Set the following profile option:

    • MSC: Share Plan Partitions = No

    Demantra

    For customers using Demantra with EBS, perform the following:

    • After Demantra is installed on the VCP database, run concurrent program 'Update Synonyms'. (Navigation: Demand Management System Administrator > Other > Requests > Submit a New Request > Single Request)

    Refer to My Oracle Support, Document 1061331.1, for more details.

    Demand Planning

    This section is meant for existing Oracle Demand Planning (ODP) customers who are upgrading to 12.2.

    The exception granted to Oracle Demand Planning URLs has been removed. This results in an HTTP 400 error while trying to access ODP Plan UI. To correct this issue, manually modify the file security2_conf_FMW.tmp and uncomment the line:#SecRule REQUEST_FILENAME "!^/oa_html/oowa/aw92/" chain

    To do this, perform the following:

    1. Stop all mid-tier services.

    2. Back up the file $FND_TOP/admin/template/security2_conf_FMW.tmp.

    3. Edit $FND_TOP/admin/template/security2_conf_FMW.tmp and uncomment the line: #SecRule REQUEST_FILENAME "!^/oa_html/oowa/aw92/" chain

    toSecRule REQUEST_FILENAME "!^/oa_html/oowa/aw92/" chain

  • 1-4    Oracle Value Chain Planning Installation Guide

    4. Run AutoConfig.

    5. Re-start the required mid-tier services.

    Refer to My Oracle Support for the latest information.

    Oracle Value Chain Planning - Oracle Transportation Management (OTM) Integration

    Setting Up Oracle Transportation Management (OTM) v60 to integrate with EBS 12.2All customers using OTM version 6 in order to integrate with EBS 12.2 need to perform the following on the OTM side:

    1. The following steps need to be performed once on the OTM instance to have the XSL file available for use:

    Get a copy of the "GLogXML v60 to v55 DateTime.xsl" and "GLogXML v60 to v55.xsl" files, the files are shipped with OTM in the {otm_install}/utils/integration/transform directory

    Place the xsl files on the OTM server. There are two options:

    • Manually copy the files to the XSL file location {otm_install}/glog/integration/client/xsl. Note that the actual location is indicated by the following OTM property : glog.integration.stylesheetRoot.

    • Upload the XSL files in the Integration Manager.

    • In OTM, log in as DBA.ADMIN (you can only upload the XSL files as DBA.ADMIN).

    • Navigate to Business Process Automation > Integration >Integration Manager > Upload an XML/CSV Transmission.

    • Upload each of the XSL files.

    2. The following steps need to be performed for the External Systems configured to send to the BPEL flow:

    • In OTM, log in to the domain.

    • Go to the External System you are using to send to BPEL, menu: Business Process Automation > Communication Management > External Systems.

    • In the External System Manager, in the External System Translations section, enter the following:

  • Oracle Value Chain Planning Installation    1-5

    • Sequence Number:1 (increase for each entry)

    • Stylesheet Name : GLogXML v60 to v55 DateTime.xsl

    • XML Element ID: Choose the outbound interface or select "*" for all interfaces.

    • Leave the other fields in the grid empty and click Save to save the translation entry.

    • Click Finished at the top of the page to save the External System.

  • Advanced Planning Command Center    2-1

    2Advanced Planning Command Center

    This chapter covers the following topics:

    • Setting Up Advanced Planning Command Center Reports and Dashboards

    • Configuring Single Sign-on

    • Troubleshooting

    • Using WebCenter for APCC

    Setting Up Advanced Planning Command Center Reports and DashboardsThis section provides information on setting up Advanced Planning Command Center (APCC) reports and dashboards.

    Installation PrerequisitesBefore performing Advanced Planning Command Center Planning (APCC) installation and setup procedures in this document, verify the following application prerequisites:

    • If you are planning to integrate Oracle Business Intelligence Enterprise Edition (OBIEE) with Oracle E-Business Suite (EBS) using Single Sign-on (SSO), make sure your EBS and OBIEE servers are in the same domain and use the same security protocol.

    • Oracle Business Intelligence Enterprise Edition 11 (OBIEE 11.1.1.7.0) must be installed. APCC is certified with OBIEE 11.1.1.7.0. Refer to My Oracle Support, Document 1542578.1, OBIEE 11.1.1.7.0 is Available for BI Enterprise, for informationon applying patch set updates.

    • Copy mscrpd.zip and mscwebcat.zip files, which will be placed in $MSC_TOP/patch/115/obiee directory, to a temporary directory.

    • Refer to Using WebCenter for APCC, page 2-12 for WebCenter and SOA BPEL flows.

  • 2-2    Oracle Value Chain Planning Installation Guide

    Configuring the tnsnames.ora FileConfigure the tnsnames.ora file so the BI Server can connect to the database.

    In OBIEE 11g, the software itself contains database client. When you connect to the database through the Repository or BI Server, it locates the tnsnames.ora entry in the Oracle Client of OBIEE 11g instead of your database.

    The tnsname.ora file is in the following location:

    MW_HOME/Oracle_BI1/network/admin/tnsnames.ora

    Note: If file does not exist, create a new one.

    The file entry format is not fixed, but follows standard Oracle tnsnames.ora format.

    Sample File Format:

    =(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)HOST=)(PORT=))(CONNECT_DATA=(SID=)))

    Example:

    mz1dv220=(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=rws60147rems.us.oracle.com)(PORT=1524))(CONNECT_DATA=(SID= mz1dv220)))

    Configuring and Deploying RPD and Webcat FilesPerforming the procedure below to configure and deploy RPD and Webcat files.

    1. Download the mscrpd.zip, mscwebcat.zip, and the language file you need to set up (for example, apcc-obiee-ja.zip for Japanese) from $APPL_TOP to a temporary directory.

    The table below provides the names of the available language files.

    File Name Language File Name Language

    apcc-obiee-ar.zip Arabic apcc-obiee-ko.zip Korean

    apcc-obiee-cs.zip Czech apcc-obiee-nl.zip Dutch

    apcc-obiee-da.zip Danish apcc-obiee-no.zip Norwegian

    apcc-obiee-de.zip German apcc-obiee-pl.zip Polish

  • Advanced Planning Command Center    2-3

    File Name Language File Name Language

    apcc-obiee-el.zip Greek apcc-obiee-pt.zip Portuguese

    apcc-obiee-en.zip English apcc-obiee-pt_BR.zip Brazilian Portuguese

    apcc-obiee-es_ES.zip Spanish apcc-obiee-ro.zip Romanian

    apcc-obiee-fi.zip Finnish apcc-obiee-ru.zip Russian

    apcc-obiee-fr.zip French apcc-obiee-sk.zip Slovak

    apcc-obiee-he.zip Hebrew apcc-obiee-sv.zip Swedish

    apcc-obiee-hr.zip Croatian apcc-obiee-th.zip Thai

    apcc-obiee-hu.zip Hungarian apcc-obiee-tr.zip Turkish

    apcc-obiee-it.zip Italian apcc-obiee-zh_CN.zip Simplified Chinese

    apcc-obiee-ja.zip Japanese apcc-obiee-zh_TW.zip Traditional Chinese

    2. Unzip mscwebcat.zip to OBIEE server ORACLE_INSTANCE/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/.

    3. Unzip mscrpd.zip and place the AdvancedPlanning.rpd file in a temporary location.

    4. Open Fusion Middleware control using following URL:

    http://hostname.domain:port/em

    1. Log in with WebLogic user and password.

    2. In left tree structure, select Business Intelligence > coreapplication > Overviewtab.

    3. Click Stop. All services are stopped.

    5. Open Fusion Middleware control using following URL:

    http://hostname.domain:port/em

    1. Log in with WebLogic user and password.

  • 2-4    Oracle Value Chain Planning Installation Guide

    2. In left tree structure, select Business Intelligence > coreapplication > Deployment tab > Repository tab.

    3. In Presentation Service Repository, verify the absolute path for the PlanningAnalytics directory.

    Example:

    /slot/ems1395/fmw/instances/instance1/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/catalog/PlanningAnalytics

    4. If the path needs to be changed, then click Lock & Edit Configuration at top of page. Change catalog path, click Apply, and then click Activate Changes at the top of the page.

    6. Open AdvancedPlanning.rpd in the Oracle Business Administration Tool (from Windows client), and change the database connection information in MSC_Conn, MSC_INIT_Conn under Planning Analytics in the Physical.

    If you are setting up a Single Sign-On environment (most common setup), perform the following:

    1. Enable Connection Scripts for MSC_Conn and MSC_INIT_Conn.

    2. Set the translations initialization variables as follows:

    • Navigate to Manage > Variables > Session > Initialization Blocks.

    • Enable Manage Translation and Set Translation.

    • Disable Set Translations without SSO.

    3. Save changes.

    If you are not setting up a Single Sign-On environment, perform the following:

    1. Disable Connection Scripts for MSC_Conn and MSC_INIT_Conn.

    2. Set the translations initialization variables as follows:

    • Navigate to Manage > Variables > Session > Initialization Blocks.

    • Disable Manage Translation and Set Translation.

    • Enable Set Translations without SSO.

    3. Save changes.

    7. Open Fusion Middleware control using following URL:

  • Advanced Planning Command Center    2-5

    http://hostname.domain:port/em

    1. Log in with WebLogic user and password.

    2. In left tree structure, select Business Intelligence > coreapplication > Deployment tab > Repository tab.

    3. Navigate to upload BI Server Repository section.

    4. Use the Browse button to select AdvancedPlanning.rpd from temporary location.

    5. Enter password.

    6. Click Apply.

    7. Click Activate Changes at top of page.

    8. Perform the following procedure to refresh GUIDs.

    This information is also available from the following URL:

    http://download.oracle.com/docs/cd/E14571_01/bi.1111/e10543/privileges.htm#BIESC721

    If you change the directory server used as the identity store for the authentication provider, then you must refresh the user GUIDs as described below. If you do not refresh the GUIDs and the same user name exists in both directory servers (original and new), then the original user GUID might conflict with the user GUID containedin new directory server, resulting in authentication errors.

    To Refresh the User GUIDs:

    This task requires that you manually edit the configuration files to instruct the Oracle BI Server and Oracle BI Presentation Server to refresh the GUIDs on restart. Once completed, you will edit these files again to remove the modification. For information about where to locate Oracle Business Intelligence configuration files, see "Where Configuration Files are Located" in Oracle Fusion Middleware System Administrator's Guide for Oracle Business Intelligence Enterprise Edition.

    1. Update the FMW_UPDATE_ROLE_AND_USER_REF_GUIDS parameter in the file NQSConfig.ini:

    1. Open the file NQSConfig.ini located at:

    ORACLE_INSTANCE/config/OracleBIServerComponent/coreapplication_obisn

    2. Locate the FMW_UPDATE_ROLE_AND_USER_REF_GUIDS parameter and setit to YES, as shown below.

    http://download.oracle.com/docs/cd/E14571_01/bi.1111/e10543/privileges.htm#BIESC721http://download.oracle.com/docs/cd/E14571_01/bi.1111/e10543/privileges.htm#BIESC721

  • 2-6    Oracle Value Chain Planning Installation Guide

    FMW_UPDATE_ROLE_AND_USER_REF_GUIDS = YES;

    3. Save and close the file.

    2. Update the Catalog element in the file instanceconfig.xml.

    1. Open the file instanceconfig.xml located at ORACLE_INSTANCE/config/OracleBIPresentationServicesComponent/coreapplication_obipsn

    2. Locate the Catalog element and add UpdateAccountGUIDs line as shown below:

    false UpdateAndExit

    3. Save and close the file.

    3. In the Enterprise Manager Overview tab, click Start to start all services.

    4. Set the FMW_UPDATE_ROLE_AND_USER_REF_GUIDS in the file NQSConfig.ini back to NO.

    Important: You must perform this step to ensure that your system is secure.

    5. Update the Catalog element in instanceconfig.xml to remove the entry.

    6. In the Enterprise Manager Overview tab, click Restart to restart all services.

    9. Unzip the language file, such as apcc-obiee-ja.zip, to temp directory. This generates the apcc directory.

    10. Make sure your environment setting is correct to use the TransX utility.

    The following link provides more information about Java technologies, tips for developing in the Java programming language, and various ways you can leverage the Java platform.

    http://www.oracle.com/technetwork/topics/newtojava/documentation/index.html

    You can perform the following option from your database machine with XDK installed or Windows client.

    Option #1 (from database):

    1. Set ORACLE_HOME to the database ORACLE_HOME.

    http://www.oracle.com/technetwork/topics/newtojava/documentation/index.html

  • Advanced Planning Command Center    2-7

    2. Set CLASSPATH and export as mentioned below:CLASSPATH=$ORACLE_HOME/lib/xmlparserv2.jar: $ORACLE_HOME/lib/xschema.jar: $ORACLE_HOME/lib/xsu12.jar: $ORACLE_HOME/lib/oraclexsql.jar: $ORACLE_HOME/lib/classgen.jar: $ORACLE_HOME/lib/transx.zip: $ORACLE_HOME/jdbc/lib/ojdbc6dms.jar: $ORACLE_HOME/jdbc/lib/ojdbc6.jar: $ORACLE_HOME/rdbms/jlib/servlet.jar: $ORACLE_HOME/rdbms/jlib/xdb.jar: $ORACLE_HOME/oc4j/lib/dms.jar export CLASSPATH

    3. Set CLASSPATHJ and export as mentioned below:CLASSPATHJ=$ORACLE_HOME/jdbc/lib/ojdbc6_g.jar export CLASSPATHJ

    4. Set JAVA_HOME and export as mentioned below:JAVA_HOME=$ORACLE_HOME/jdk export JAVA_HOME

    Option #2 (from Windows client):

    1. On Windows and Windows XP clients, right-click My Computer and select Properties. On Windows 7 clients, right-click Computer and select Properties.

    2. On Windows and Windows XP clients, select the Advanced tab in System Properties. On Windows 7 clients, select Advanced System Settings.

    3. Click Environment Variables to set CLASSPATH, CLASSPATHJ, JAVA_HOME, ORACLE_HOME, and other variables.

    4. Set ORACLE_HOME.set ORACLE_HOME=D:\Oracle\Database\Client\product\11.2.0\client_2

    5. Set CLASSPATH.set CLASSPATH=%ORACLE_HOME%\LIB\xmlparserv2.jar; %ORACLE_HOME%\LIB\xsu12.jar; %ORACLE_HOME%\LIB\oraclexsql.jar; %ORACLE_HOME%\LIB\transx.zip; %ORACLE_HOME%\jdbc\lib\classes12dms.jar; %ORACLE_HOME%\jdbc\lib\ojdbc5.jar; %ORACLE_HOME%\LIB\servlet.jar; %ORACLE_HOME%\RDBMS\jlib\xdb.jar; %CLASSPATH%

    6. Set CLASSPATHJ.setCLASSPATHJ=C:\Apps\db\oracle102\jdbc\lib\classes12.zip;C:\Apps\db\oracle102\jdbc\lib\nls_charset12.jar

  • 2-8    Oracle Value Chain Planning Installation Guide

    7. Set JAVA_HOME.set JAVA_HOME=D:\jdk1.5.0_09

    Note: The path value setting will be different due to different installation path.

    Make sure that all jar files mentioned are located in appropriate directories, otherwise you will receive errors while running the TransX utility.

    Make sure that the path values are on one line so that all the directories referenced will be added to environment variable properly.

    11. Use TransX to upload the dlf file such as apcc_ja.dlf in apcc\OracleBI\repository directory by providing username/password and DB connection SID.

    transx "hostname:port:sid" username password filename

    Example:transx "rws60147rems:1524:mz1dv220" apps apps d:\apcc\OracleBI\repository\apcc_ja.dlf

    12. Verify the seeding data is uploaded correctly in MSC_TRANSLATED_MESSAGE using the following query:select lang_id, count(*)from msc_translated_messagegroup by lang_id;

    13. SKIP THIS STEP FOR ENGLISH. Copy the files sopcaptions.xml, sppcaptions.xml, scacaptions.xml and scrmcaptions.xml from your temp directory into ORACLE_HOME\instances\instance1\bifoundation\OracleBIPresentationServicesComponent\coreapplication_obips1\msgdb\l_ja\captions on OBIEE machine if the directory has been created; if directory has not been created, create first subdirectory l_ja\captions under coreapplication_obips1\msgdb directory.

    Note: Make sure the captions folder uses a lower case "c".

    Also, inside the XML files, make sure the text tag is all upper case . If it is not (for example, it appears as ), then replace all occurrences to upper case .

    14. Restart OBIEE services.

    1. Open Fusion Middleware control using following URL:

    http://hostname.domain:port/em

  • Advanced Planning Command Center    2-9

    2. Log in with WebLogic user and password.

    3. In left tree structure, select Business Intelligence > coreapplication > Overviewtab.

    4. Click Restart to restart all services.

    Configuring Single Sign-onPerform the subsequent procedures to configure Single Sign-On (SSO) for your APCC installation.

    Note: Make sure your EBS and OBIEE servers are in the same domain and use the same security protocol.

    Setting Up the OBIEE ProfileSet the URL for "FND: Oracle Business Intelligence Suite EE base URL" profile. The URLuses the following format:

    http://machine:port

    Add Session Cookie for Single Sign-OnPerform the following procedure to add a session cookie for Single Sign-On deployments.

    1. Stop all OBIEE services using Fusion Middleware control.

    1. Open Fusion Middleware control using following URL format:

    http://hostname.domain:port/em

    2. Log in with WebLogic user and password.

    3. In left tree structure select Business Intelligence > coreapplication > Overview tab.

    4. Click Stop.

    2. Run the SQL statement below to get cookie_name. This will be the cookie_name for nameInSource param.select app_session.GET_ICX_COOKIE_NAME from dual

    3. Add the following to the file authenticationschemas.xml in the ORACLE_INSTANCE/bifoundation/web/display directory:

  • 2-10    Oracle Value Chain Planning Installation Guide

    For more information, refer to "Integrating with Oracle E-Business Suite Security" from the Oracle Fusion Middleware Integrator's Guide for Oracle Business Intelligence Enterprise Edition 11g Release 1 (11.1.1) in the link below:

    http://fmwdocs.us.oracle.com/doclibs/fmw/E15295_01/bi.1111/e16364/ebs_actions.htm

    Example:

    1. Find the following element:

  • Advanced Planning Command Center    2-11

    2. Include EBS-ICX in the list of enabled schemas as shown below:

    UidPwd,Impersonate,UidPwd-soap,Impersonate-soap,EBS-ICX

    Note: Ignore the comment in instanceconfig.xml that says this setting is centrally managed. EBS-ICX must be manually addedto the EnabledSchemas element.

    3. Save and close file.

    For more information, refer to "Updating instanceconfig.xml [http://fmwdocs.us.oracle.com/doclibs/fmw/E15295_01/bi.1111/e16364/ebs_actions.htm#CIHGHEFE]" from the Oracle Fusion Middleware Integrator's Guide for Oracle Business Intelligence Enterprise Edition 11g Release 1 (11.1.1).

    5. Start all OBIEE services.

    1. Open Fusion Middleware control using following URL:

    http://hostname.domain:port/em

    2. Log in with WebLogic user and password.

    3. In left tree structure, select Business Intelligence > coreapplication > Overviewtab.

    4. Click Start to start all services.

    TroubleshootingIf TransX does not run due to missing classes, it is most likely that classpath is not set properly. Following sample shows setting CLASSPATH variable for Windows 11g client with XDK option:

    Exampleset ORACLE_HOME=D:\Oracle\Database\Client\product\11.2.0\client_2

    set CLASSPATH=%ORACLE_HOME%\LIB\xmlparserv2.jar; %ORACLE_HOME%\LIB\xsu12.jar; %ORACLE_HOME%\LIB\oraclexsql.jar; %ORACLE_HOME%\LIB\transx.zip; %ORACLE_HOME%\jdbc\lib\classes12dms.jar; %ORACLE_HOME%\jdbc\lib\ojdbc5.jar; %ORACLE_HOME%\LIB\servlet.jar; %ORACLE_HOME%\RDBMS\jlib\xdb.jar; %CLASSPATH%

    For more XDK information, refer to Oracle XDK documentation.

    http://fmwdocs.us.oracle.com/doclibs/fmw/E15295_01/bi.1111/e16364/ebs_actions.htm#CIHGHEFE

  • 2-12    Oracle Value Chain Planning Installation Guide

    Using WebCenter for APCCThis topic provides information about using WebCenter with APCC.

    PrerequisitesVerify the information below.

    1. Verify that WebLogic/WebCenter/SOA components are installed properly. Refer to My Oracle Support note 1074345.1.

    2. Verify UCM is installed and configured properly [optional].

    Configuring WebCenterTo configure WebCenter for Oracle Advanced Planning Command Center perform the following:

    1. Deploy and configure the spaces servlet, page 2-12.

    2. Deploy and configure the BPM Tasklist, page 2-14.

    3. Deploy and configure the group space Template, page 2-17.

    4. Deploy and configure the application links [Optional], page 2-19.

    5. Deploy and configure the SOA BPEL flows, page 2-23.

    6. Set up profile options, page 2-23.

    7. Compile MscWCRedirect.jsp, page 2-25.

    8. Run the Planning Process Activities concurrent process, page 2-26.

    9. Change the WebCenter application name, page 2-26.

    Deploy and Configure the Spaces ServletPerform the procedures below to deploy and configure the spaces servlet.

    1. Obtain file mscspacesservlet.ear from $MSC_TOP/patch/115/ear/mscspacesservlet.ear.

    2. Copy it to your local directory in Linux Session.

    3. Open the WebCenter Console for the WebCenter domain.

  • Advanced Planning Command Center    2-13

    4. Log in to the WebCenter Console.

    5. Click Lock & Edit.

    6. From the Domain Structure region, click Deployments.

    7. Click Install.

    8. Click link upload your file(s).

    9. Search for your EAR file in the deployment archive and select the EAR file to deploy.

    10. Click Next, select Managed Server WLS_Spaces, deploy .ear file, and click Finish.

    11. When deployment to the managed server is complete, click the Release Configuration.

    12. If the state of deployment of mscspacesservlet is "Prepared", click Lock & Edit >Deployments, select deployment mscspacesservlet, click Start, click Servicing all requests, and then click Release Configuration. Verify that the deployment status of mscspacesservlet changes to Active.

    13. To generate Java keystore in the WebCenter instance, go to JDK_HOME/jdk/bin andopen a command prompt.

    14. Execute the following keytool run commands to generate keystore producer.jks: keytool -genkeypair -keyalg RSA -dname "cn=producer,dc=example,dc=com" -alias producer -keypass welcome1 -keystore /scratch/dumakant/keystore/samedomain/producer.jks -storepass welcome1 -validity 365 keytool -exportcert -v -alias producer -keystore /scratch/dumakant/keystore/samedomain/producer.jks -storepass welcome1 -rfc -file producer.cert keytool -importcert -alias webcenter_spaces_ws -file producer.cert -keystore /scratch/dumakant/keystore/samedomain/producer.jks -storepass welcome1

    /scratch/dumakant/keystore/samedomain/ can be your local Linux home path.

    Set the value of recipient key alias in profile option "MSC: APCC Webcenter Spaces Recipient Key Alias".

    15. Connect to the WebCenter server using telnet.

    16. Execute the following command:cd /slot/ems2995/appmgr/Oracle/Middleware/user_projects/domains/wc_domain/config/fmwconfig/

    17. Copy producer.jks to this location.

  • 2-14    Oracle Value Chain Planning Installation Guide

    18. Open jps-config.xml.

    19. Change serviceInstance as follows:serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks" to location="./producer.jks"

    20. Run command wlst.

    21. Connect to the WebCenter using the following command line:connect('weblogic','welcome1', 'Webcenter host:port')

    For example, for WebCenter host:port, use dadvmi0029.us.oracle.com:7060.

    22. Back up cwallet.sso.

    23. Execute the following:createCred(map="oracle.wsm.security",key="enc-csf-key",user="producer",password="welcome1",desc="Enc Password") createCred(map="oracle.wsm.security",key="sign-csf-key",user="producer",password="welcome1",desc="Enc Password") createCred(map="oracle.wsm.security",key="keystore-csf-key",user="keystore-csf-key",password="welcome1",desc="Keystore password")

    24. Restart the WebCenter servers.

    Deploy and Configure the BPM TasklistPerform the following procedures to deploy and configure the BPM Tasklist.

    Create a Directory and Set a Path1. Create directory /tmp/tasklist and set path as follows:

    /Oracle/Middleware/jdk160_11/bin/:$PATH

    Update and Copy the WAR File to the WebCenter Home1. Get file msc_custom_spaces.zip from ARU and unzip it to obtain

    custom.webcenter.spaces.war. Then, unjar it. Execute the following:cd /tmp/tasklist; unzip msc_custom_spaces.zip cd /tmp/tasklist; jar xvf custom.webcenter.spaces.war;

    2. Go to WEB-INF/lib/ and unjar wf_client_custom.jar. Execute the following:cd /tmp/tasklist/WEB-INF/lib;mkdir temp;cp wf_client_custom.jar temp/cd temp;jar xvf wf_client_custom.jar

  • Advanced Planning Command Center    2-15

    3. Open wf_client_config.xml and provide your soa server URL for tagsserverURL and rootEndPointURL.

    4. Update wf_client_custom.jar with the updated wf_client_config.xml. Execute the following:cd /tmp/tasklist/WEB-INF/lib/temp;jar uvf wf_client_custom.jar wf_client_config.xml

    5. Copy file wf_client_custom.jar to WEB-INF/lib/. Execute the following:cp /tmp/tasklist/WEB-INF/lib/temp/wf_client_custom.jar ../cd /tmp/tasklist/WEB-INF/lib/;rm -rf temp;

    6. Update custom.webcenter.spaces.war with updated file WEB-INF/lib/wf_client_custom.jar and all other files that were part of custom.webcenter.spaces.war. After executing these commands, there is updated custom.webcenter.spaces.war at /tmp/:cd /tmp/tasklist;jar uvf custom.webcenter.spaces.war WEB-INF/lib/wf_client_custom.jar

    7. To back up, execute the following: /slot/ems4372/appmgr/oracle/middleware/Oracle_WC1/webcenter/modules/oracle.webcenter.spaces_11.1.1/custom.webcenter.spaces.warcd /slot/ems4372/appmgr/oracle/middleware/Oracle_WC1/webcenter/modules/oracle.webcenter.spaces_11.1.1/cp custom.webcenter.spaces.war custom.webcenter.spaces.war.orig

    8. Copy custom.webcenter.spaces.war. Execute the following: /slot/ems4372/appmgr/oracle/middleware/Oracle_WC1/webcenter/modules/oracle.webcenter.spaces_11.1.1/cd /slot/ems4372/appmgr/oracle/middleware/Oracle_WC1/webcenter/modules/oracle.webcenter.spaces_11.1.1/cp /tmp/custom.webcenter.spaces.war

    Update Deployments1. Navigate to http://rws60212rems:7004/console/using weblogic/welcome1 and click

    Lock & Edit.

    2. Click Deployments, select webcenter, click Stop, select option Force Stop Now, and answer Yes to the confirmation question.

    3. Reselect webcenter, click Delete, and answer Yes to the confirmation question.

    4. Select custom.webcenter.spaces, click Update, click Next, click Next, and click Finish.

    5. Click Install. Select path as follows:

    /slot/ems4372/appmgr/oracle/middleware/Oracle_WC1/archives/applications, and

  • 2-16    Oracle Value Chain Planning Installation Guide

    file as webcenter.ear

    Deploy it on managed server WLS_Spaces.

    6. Click Deployments, select webcenter, click Start, select option Start servicing all requests, and answer Yes to the confirmation question.

    Set extendApp to true in setDomain.sh.1. Open

    /slot/ems4372/appmgr/oracle/middleware/user_projects/domains/wc_domain/bin/setDomainEnv.sh and add the following:EXTRA_JAVA_PROPERTIES="-Doracle.webcenter.spaces.extendApp=true ${EXTRA_JAVA_PROPERTIES}"export EXTRA_JAVA_PROPERTIES

    2. Restart Managed Server WLS_Spaces.

    Create a New View in Oracle BPM Worklist1. Navigate to the BPM worklist [http://rws60212rems:8880/integration/worklistapp]

    and log in using admin credentials.

    2. Click Add [+] icon from section Worklist Views.

    3. Select Create View, select name APCC Shared View, select Add to Standard Views. Navigate to Add Condition drilldown and select State. Click Add [+] icon, and select Assignees who can share this view.

    4. Select Display tab, then select these columns in the left side of the window:

    • Title: BPEL process name that you created in the Scenario Manager

    • Due Date

    • Application Context: BPEL Activity Name

    • Identifier: Plan name

    • State: Worklist task state--Assigned, Deleted, Suspended

    • Category: BPEL Activity Status - In progress, Not Started, Error or Completed

    • Created: Date

    • Creator: User

    5. Click OK.

    Test the Tasklist1. Navigate to WebCenter (for example, http://rws60212rems:8877/webcenter/) and

  • Advanced Planning Command Center    2-17

    log in.

    2. Create a blank group space, edit page, and click add content. The Catalog opens.

    3. Click open on APCC Custom Folder, move to Task List, and click Add.

    4. Verify that it is added to the Tasklist.

    Deploy and Configure the Group Space Template1. Get file msc_apcc_gs_template.ear from ARU.

    2. Copy it to your local directory.

    3. Open the WebCenter Spaces URL.

    Examplehttp://rws60212rems.us.oracle.com:8877/webcenter

    4. Log in to the WebCenter Spaces URL.

    5. Navigate to the WebCenter Administrator.

    6. Click the Manage Group Spaces and Group Space Templates. Manage Group Spaces opens.

    7. Click the Templates subtab. The Manage Group Space Templates window opens.

    8. Click the Import option. The Import Archive Name window opens.

    9. Select Option Archive Located on Local File System, specify local directory as the EAR file location, and click Import. This completes the group space template import.

    10. Log in to the WebCenter Spaces URL.

    11. Click Group Spaces.

    12. Click Create Group Space.

    13. Enter Group Space Name, enter Description, and select group space template name.

    14. Click Create. This creates a group space with group space name given.

    15. Click Group Space Name tab.

    16. Navigate to Setting > Custom Attributes.

  • 2-18    Oracle Value Chain Planning Installation Guide

    17. Select custom attribute FND_OBIEE_URL.

    18. Navigate to Actions, and select Edit Attribute.

    19. Enter your OBIEE URL.

    Example:http://adc60069fems.us.oracle.com:9799/

    20. Click OK.

    21. Select custom attribute APPS_SERVLET_AGENT.

    22. Navigate to Actions, and select Edit Attribute.

    23. Enter Apps Servlet URL.

    Example: http://rws60147rems.us.oracle.com:8034/OA_HTML

    24. Click OK.

    25. Select custom attribute MSC_SCN_SERVICE_ENDPOINT.

    26. Navigate to Actions, and select Edit Attribute.

    27. Enter the BPM Worklist URL.

    Example: http://rws60018rems.us.oracle.com:8880

    28. Click OK.

    29. Navigate to the home page, click Edit Page, delete the worklist component from topof the page, and place APCC Custom Folder > Tasklist at the same location. This replaces a worklist component with a tasklist component.

    30. Navigate to the Setting tab, and then navigate to the General tab.

    31. Click Save as Group Space Template. The Save as Group Space Template window opens.

    32. Enter Template Name, enter Description, and check Publish.

    33. Click Save. This creates the template.

    34. Enter the template name in MSC: APCC Webcenter Group Space Template Profile.

  • Advanced Planning Command Center    2-19

    Deploy and Configure Application Links [Optional]This configures E-Business Suite functions as external applications in the WebCenter Personal Sidebar; the user can navigate to E-Business Suite from WebCenter.

    Group space also contains application links with context-like group space names, but application Links defined in WebCenter Personal Sidebar do not pass context information to E-Business Suite applications.

    1. Open enterprise manager [http://host:port/em] and log in as administrator [weblogic/welcome1].

    2. Expand Webcenter, expand Webcenter spaces, select webcenter (WLS Spaces), right-click Settings, and click Service Configuration.

    3. Select External Applications.

    4. Click the Add icon, input values for these entities, and click OK.

    Some of these are sample values:

    • Application Name: Scenarios

    • Display Name: Scenarios

    • Enable Automatic Login: Selected

    • Login URL: http://host:port/OA_HTML/MscObieeSrvlt?ParamType=Name&FROM_NODE=WC&TO_NODE=SCN

    • Find the values for the host and port from the value of profile option Apps Servlet Agent.

    • HTML User ID Field Name: usernameField

    • HTML User Password Field Name: passwordField

    • Authentication Method: Post

    • Enable Shared Credentials: Selected

    • User Name: TEST

    • Password: TEST

    5. Click the Add icon, input values for these entities, and click OK.

    Some of these are sample values:

  • 2-20    Oracle Value Chain Planning Installation Guide

    • Application Name: Supply Chain Analyst Dashboard

    • Display Name: Supply Chain Analyst Dashboard

    • Enable Automatic Login: Selected

    • Login URL:http://host:port/OA_HTML/MscObieeSrvlt?ParamType=Name&FROM_NODE=WC&TO_NODE=SCA

    Find the values for the host and port from the value of profile option Apps Servlet Agent.

    • HTML User ID Field Name: usernameField

    • HTML User Password Field Name: passwordField

    • Authentication Method: Post

    • Enable Shared Credentials: Selected

    • User Name: TEST

    • Password: TEST

    6. Click the Add icon, input values for these entities, and click OK.

    Some of these are sample values:

    • Application Name: Sales and Operations Planning Analyst Dashboard

    • Display Name: Sales and Operations Planning Analyst Dashboard

    • Enable Automatic Login: Selected

    • Login URL:http://host:port/OA_HTML/MscObieeSrvlt?ParamType=Name&FROM_NODE=WC&TO_NODE=SOP

    Find the values for the host and port from the value of profile option Apps Servlet Agent.

    • HTML User ID Field Name: usernameField

    • HTML User Password Field Name: passwordField

    • Authentication Method: Post

    • Enable Shared Credentials: Selected

  • Advanced Planning Command Center    2-21

    • User Name: TEST

    • Password: TEST

    7. Click the Add icon, input values for these entities, and click OK.

    Some of these are sample values:

    • Application Name: Simulation Planner Workbench

    • Display Name: Simulation Planner Workbench

    • Enable Automatic Login: Selected

    • Login URL:http://host:port/OA_HTML/MscObieeSrvlt?ParamType=Name&FROM_NODE=WC&TO_NODE=rp

    Find the values for the host and port from the value of profile option Apps Servlet Agent.

    • HTML User ID Field Name: usernameField

    • HTML User Password Field Name: passwordField

    • Authentication Method: Post

    • Enable Shared Credentials: Selected

    • User Name: TEST

    • Password: TEST

    8. Click the Add icon, input values for these entities, and click OK.

    Some of these are sample values:

    • Application Name: Demand Management Workbench

    • Display Name: Demand Management Workbench

    • Enable Automatic Login: Selected

    • Login URL: http://host:port/OA_HTML/MscObieeSrvlt?ParamType=Name&FROM_NODE=WC&TO_NODE=DEMANTRA

    Find the values for the host and port from the value of profile option Apps Servlet Agent.

  • 2-22    Oracle Value Chain Planning Installation Guide

    • HTML User ID Field Name: usernameField

    • HTML User Password Field Name: passwordField

    • Authentication Method: Post

    • Enable Shared Credentials: Selected

    • User Name: TEST

    • Password: TEST

    9. Click the Add icon, input values for these entities, and click OK.

    Some of these are sample values:

    • Application Name: BPM Worklist

    • Display Name: BPM Worklist

    • Enable Automatic Login: Selected

    • Login URL:http://host:port/integration/worklistapp

    Find the values for the host and port from the value of profile option MSC: Scn Service End Point.

    • HTML User ID Field Name: usernameField

    • HTML User Password Field Name: passwordField

    • Authentication Method: Post

    • Enable Shared Credentials: Selected

    • User Name: TEST

    • Password: TEST

    10. Open WebCenter spaces [http://host:port/webcenter] and log in as administrator [weblogic/welcome1].

    11. Navigate to the top menu, select the Administration, and click Integrate Existing Applications.

    12. Expand Applications Node, select Scenarios, and click Edit. For each application, change Open Behavior to the Webcenter tab, and click OK.

  • Advanced Planning Command Center    2-23

    Deploy and Configure SOA BPEL FlowsTo deploy and configure SOA BPEL flows, refer to My Oracle Support Document 1584883.1.

    Set Up Profile OptionsPerform the procedure below to set up your profile options.

    1. Navigate to your E-Business Suite environment.

    2. Select responsibility System Administrator.

    3. Navigate to Profiles > System.

    4. Verify or set values for the profile options as displayed in the table below.

    Profile Options

    Number / Owner

    System Profile Name

    User Profile Name

    Valid Values / Set To

    Comments

    1 MSC_WC_ENABLED

    MSC: APCC Webcenter Enabled

    Yes/No -

    2 MSC_WC_SPACES_MEMBERROLE

    MSC: APCC Webcenter Spaces Member Role

    Viewer Or Participant

    Members addedto the webcenter group space canbe either viewers or participants.

    3 MSC_WC_SPACES_TEMPLATE

    MSC: APCC Webcenter Group Space Template

    Webcenter Group Space Template Name

    Example

    Basic

    4 MSC_WC_SPACES_RECIPIENTKEYALIAS

    MSC: APCC Webcenter Spaces Recipient Key Alias

    Recipient Key Alias

    Example

    Producer

  • 2-24    Oracle Value Chain Planning Installation Guide

    Number / Owner

    System Profile Name

    User Profile Name

    Valid Values / Set To

    Comments

    5 MSC_WC_SPACES_SAMLISSUERNAME

    MSC: APCC Webcenter Spaces Saml Issuer Name

    Saml issuer name of Webcenter

    Example

    www.oracle.com

    6 MSC_WC_SPACES_PORT

    MSC: APCC Webcenter Spaces Port

    Webcenter Spaces managed serverPort

    Example

    8877

    7 MSC_WC_URL MSC: APCC Webcenter URL

    Webcenter URL Examplehttp://rws60018rems.us.oracle.com/webcenter/wcAuthentication/?login=true&success_url=/spaces

    Replace your host and keep the other things same. Then, youskip the Webcenter welcome/login screen when navigating frome-Business Suiteto Webcenter.

    8 MSC_SCN_SERVICE_ENDPOINT

    MSC: BPEL EndPoint URI

    WebLogic Soa server url

    Examplehttp://rws60212resm.us.oracle.com:8880

    8880 is the soa_server1 port number.

    9 MSC_SCN_BPEL_DOMAIN

    MSC: BPEL Domain Name

    soa-infra For example, soa-infra.

  • Advanced Planning Command Center    2-25

    Number / Owner

    System Profile Name

    User Profile Name

    Valid Values / Set To

    Comments

    10 MSC_WS_WEBLOGIC_USERNAME

    MSC: APCC WebLogic Username

    Oracle BPM worklist admin user

    Example

    weblogic_admin

    This user should be admin for OID and Webcenter.

    11 MSC_WS_WEBLOGIC_PASSWORD

    MSC: APCC WebLogic Password

    Oracle BPM worklist admin password.

    Example

    welcome1

    12 MSC_WC_WEBLOGIC_USERNAME

    MSC: APCC WebLogic Console Username

    WebLogic admin user

    Example

    weblogic

    This user should be the admin user for Weblogic.

    13 MSC_WC_WEBLOGIC_PASSWORD

    MSC: APCC WebLogic Console Password

    Set it to WebLogic admin password.

    Example

    welcome1

    Compile MscWCRedirect.jspPerform the procedure below to compile the MscWCRedirect.jsp file.

    1. Log in to the middle tier where $APPL_TOP resides as an appmgr user

    2. Execute the following command: cd $FND_TOP/patch/115/bin;

    3. Compile and flush as follows:perl ojspCompile.pl --compile -s 'MscWCRedirect.jsp' –flush

    4. Restart the middle tier as follows:

  • 2-26    Oracle Value Chain Planning Installation Guide

    cd $ADMIN_SCRIPTS_HOME;adoacorectl.sh stop;adoacorectl.sh start;adoacorectl.sh status;

    Run the Planning Process Activities Concurrent ProcessPerform the procedure below to run the Planning Process Activities concurrent process.

    1. Click Deployed Composite. Verify that there is a green dot before each flow name and that there is a green up arrow in each status. If there is not, undeploy the flow, restart the server, deploy the flow, and check it again.

    2. Select responsibility Advanced Planning Scenario Manager.

    3. Run concurrent process Planning Process Activities concurrent process. This populates the Oracle 11g BPEL flows into the MSC tables.

    Change the WebCenter Application NamePerform the procedure below to change the WebCenter application name.

    1. Log in to WebCenter using administrator.

    2. Click the Administration link at the top of the page.

    3. Select the General tab.

    4. Change Application Name to 'Value Chain Planning".

    5. Click Apply.

  • Advanced Supply Chain Planning    3-1

    3Advanced Supply Chain Planning

    This chapter covers the following topics:

    • Performing Pre-Configuration Setup

    • Performing Configuration

    • Upgrading ASCP

    • Troubleshooting

    Performing Pre-Configuration SetupThis section describes pre-configuration requirements for Oracle ASCP Usability enhancements. The tasks mentioned below need to be completed after applying the patch and before starting the installation.

    1. Ensure that WebLogic 11gR1 (WebLogic Server 10.3.6 with ADF 11.1.1.6.0 libraries) is installed.

    2. Following profiles should be set up in EBS at site level (the EBS instance which the data source points to):

    User Profile Name: MSC: ASCP Planning URL

    : MSC_ASCP_WEBLOGIC_URL

    Example:

    http://domain_name:port_number

    Note: The port number provided in the profile value should be same as the port number for the ASCP domain, managed server that is defined in Creating the ASCP Managed Server, page 3-11.

    Example:

    http://rws60144rems.us.oracle.com:6087

  • 3-2    Oracle Value Chain Planning Installation Guide

    3. After applying the patch, copy $MSC_TOP/patch/115/ear/PlanningUIEar.zip file from the EBS server to a directory on the WebLogic server.

    4. Create a folder named "applications" on the host machine where WebLogic is installed. This folder is referenced only as "applications" in this document.

    Example:

    /slot/ems1392/oracle/mwhome/user_projects/domain/fmw_domain/applications

    5. Copy the ZIP file to the folder applications.

    6. Extract the ZIP file in the same folder. The unzipped file contains PlanningUI.ear file.

    The .ear files will be selected from this location during deployment.

    For information on configuration and deployment, refer to the following:

    • Creating the JDBC Data Source, page 3-15

    • Deploying and Starting the Planning Application, page 3-23

    Performing Configuration This section includes information about the following ASCP configuration tasks:

    1. Creating the ASCP Domain and Admin Server, page 3-2

    2. Creating the ASCP Managed Server, page 3-11

    3. Creating the JDBC Data Source, page 3-15

    4. Setting Up MDS Repository, page 3-21

    5. Starting the Admin Server and Managed Server, page 3-23

    6. Deploying and Starting the Planning Application, page 3-23

    Creating the ASCP Domain and Admin ServerNote: If you currently have a working WebLogic Server (WLS) and domain, this step is optional. You can proceed to Creating the ASCP Managed Server, page 3-11.

    Install WebLogic Server (WLS) 10.3.6, and configure the domain with the Oracle JRF option.

  • Advanced Supply Chain Planning    3-3

    On the installed WLS, create a new WLS domain (for example, ascpdomain), and a new admin server (for example, AdminServer) in this domain.

    Perform the following procedure to create the ASCP domain.

    1. Go to /common/bin folder.

    Example:

    cd /wlserver_10.3/common/bin

    2. Run config.sh script.

    Example:

    ./config.sh

    The Welcome screen for the Oracle WebLogic Configuration Wizard appears. This wizard guides you through the steps to generate a new domain or extend an existing domain.

    3. Select Create a new WebLogic domain and click Next. The Select Domain Source screen appears.

  • 3-4    Oracle Value Chain Planning Installation Guide

    4. Perform the following:

    1. Select Generate a domain configured automatically to support the following products.

    Keep the default settings.

    2. Click Next.

    The Specify Domain Name and Location screen appears.

  • Advanced Supply Chain Planning    3-5

    5. Provide the Domain name and Domain location, and then click Next.

    The domain location is /user_projects/domains where is the installation path for your WebLogic server.

    The Configure Administrator User name and Password screen appears.

  • 3-6    Oracle Value Chain Planning Installation Guide

    6. Enter the User name, User password and Confirm user password of your choice, and then click Next.

    The Configure Server Start Mode and JDK screen appears.

  • Advanced Supply Chain Planning    3-7

    7. Perform the following:

    1. Select Production Mode.

    2. In JDK Selection region, select Available JDKs and select JRockit SDK 1.6.0_05.

    3. Click Next.

    The Select Optional Configuration screen appears.

  • 3-8    Oracle Value Chain Planning Installation Guide

    8. Select the Administrative Server option only and click Next.

    The Configure the Administration Server screen appears.

  • Advanced Supply Chain Planning    3-9

    9. Perform the following:

    1. Input the fields in the following table.

    Field Description

    Name Enter the name of the admin server.

    Listen address The admin server listen port address. Leave default option of All Local Addresses.

    Listen port Enter the server listen port number. Check the availability of the number before entering a value.

    SSL listen port Enter the SSL listen port number. Check the availability of the number before entering a value.

    2. Select the SSL enabled option.

    3. Click Next.

  • 3-10    Oracle Value Chain Planning Installation Guide

    The Configuration Summary screen appears.

    10. Review the details. If you want to modify any settings, use the Previous button to return to the appropriate screen. If no changes are required, click Create.

    The Creating Domain screen appears and displays the system progress.

  • Advanced Supply Chain Planning    3-11

    11. When the domain is complete, click Done.

    The wizard closes.

    12. Go to the ASCP domain directory.

    Example:

    $ cd /slot/ems3424/appmgr/WLS/user_projects/domains/ascpdomain/

    13. In the ASCP domain directory (for example, ascpdomain), create the output/ and log/ directories as follows:

    $ mkdir - m 777 output/

    $ mkdir -m 777 log/

    Creating the ASCP Managed Server This section provides procedures for creating the managed server and applying JRF.

    1. Open a Web browser and type in the URL/address in the following format:

    http://:/console

    represents the host name of the machine on which the WebLogicserver is running (for example, rws3220163.us.oracle.com) and is the Admin server Listen port number specified when the ASCP domain was created.

  • 3-12    Oracle Value Chain Planning Installation Guide

    Example:

    http://rws3220163.us.oracle.com:7901/console

    The Oracle WebLogic Administration Console appears.

    2. Navigate to Servers in the Domain Structure region.

    Example Navigation Path:

    base_domain > Environment > Servers

    3. Click New to create a new server.

    4. Perform the following:

    1. Input the fields in the following table.

    Field Description

    Server Name Enter the name of the ASCP managed server (for example, ASCPManagedServer).

  • Advanced Supply Chain Planning    3-13

    Field Description

    Server Listen address Enter the listen address for manager server.

    Server Listen port Enter the server listen port number.

    2. Define the server cluster options as needed.

    3. Click Next.

    4. Select the SSL Enabled option to enter the SSL port number.

    5. Enter the Secured Socket Listen port in the SSL Port field.

    6. Click Finish.

    The Configuration tab displays the new managed server.

    5. Apply JRF on Managed Server using Enterprise Manger (EM).

    1. Open a Web browser and type in the URL/address in the following format:

    http://:/em

    represents the host name of the machine on which the WebLogic server is running (for example, rws3220163.us.oracle.com) and is the Admin server Listen port number specified when the ASCP domain was created.

    Example:

  • 3-14    Oracle Value Chain Planning Installation Guide

    http:// rws3220163.us.oracle.com:7901/em

    2. Navigate to WebLogic domain, your domain name, and select the Managed Server.

    The managed server information appears on the right side of the page.

    3. Click Apply JRF Template.

    When successfully applied, a confirmation message appears at the top of the page.

    The JRF Template can also be applied from the command line using the following procedure:

    Note: Skip the command line procedures if JRF was already applied using Enterprise Manger (EM).

    1. Run wlst.sh from Middleware bin directory.

    cd $MIDDLEWARE_HOME\oracle_common\common\bin

    ./wlst.sh

    2. Authenticate the connection.

  • Advanced Supply Chain Planning    3-15

    Example:

    connect('weblogic','welcome1', 'rws3220040.us.oracle.com:7004')

    Substitute your WLS username and password in the example above. Provide the host and port where the WLS Admin Server is running for the ASCP domain.

    3. Apply JRF.

    Example:

    applyJRF('ASCPManagedServer', '/slot/ems6479/appmgr/Oracle111160/Middleware/user_projects/domains/base_domain', true)

    Use your Managed Server name and the path for the ASCP domain directory example above.

    Creating the JDBC Data SourcePerform the procedure below to create the JDBC data source (for example, ApplicationDB).

    1. Log in to the WebLogic administration console, as described in Creating the ASCP Managed Servers, page 3-11.

    2. Click Lock & Edit from the Change Center region, located on the top left of the page, if applicable.

    3. Navigate to Data Sources under the Domain Structure region.

    Example Navigation:

    base_domain > Services > JDBC > Data Sources

    4. Click New.

    The Create a New JDBC Data Source page appears.

  • 3-16    Oracle Value Chain Planning Installation Guide

    5. Perform the following:

    1. Input the fields in the following table.

    Field Description

    Name Enter the name of the JDBC data source (for example, ApplicationDB).

    JNDI Name Enter the name you want to assign to your new JDBC Data Source (for example,jdbc/ApplicationDBDS).

    2. Select Oracle from the Database Type list.

    3. Click Next.

    The JDBC Data Source Properties page appears.

  • Advanced Supply Chain Planning    3-17

    4. Select the Oracle's Driver (Thin) for instance connections, Version 9.0.1 and later from the Database Driver list.

    5. Click Next.

    The Transaction Options page appears.

    6. Click Next to accept the default settings displayed.

    The Connection Properties page appears.

  • 3-18    Oracle Value Chain Planning Installation Guide

    7. Input the database connection detail fields in the following table.

    Field Description

    Database Name Enter the database name (for example, ma1yd213).

    Host Name Enter the host name or IP address of the database server (for example, rws60052rems.us.oracle.com).

    Port Enter the port on the database server usedto connect to the database (for example, 1572).

    Database User Name Enter the database account user name you want to use to create database connections (for example, apps).

    Password Enter the database account password you want to use to create the database connections.

  • Advanced Supply Chain Planning    3-19

    Field Description

    Confirm Password Retype your password.

    8. Click Next.

    The Tests Database Connection page appears.

    9. Click Test Configuration.

    If the JDBC is set up correctly, then the following message appears at the top of the page:

    Connection test succeeded.

    10. Click Next.

    The Select Targets page appears.

  • 3-20    Oracle Value Chain Planning Installation Guide

    11. Select the ASCP managed server you created (for example, ASCPManagedServer), and click Finish.

    12. Select the new JDBC data source (for example, ApplicationDB), and click the Configuration tab.

    13. Select Connection Pool subtab and set Maximum Capacity field to 150. The default value for the field is 15.

  • Advanced Supply Chain Planning    3-21

    14. Scroll down the page, and click the Advanced link. The Advanced options appear.

    15. Select Test Connections on Reserve and click Save.

    16. Click Activate Changes from the Change Center region, located on the top left of the page. This screen only appears if you were in Lock & Edit mode, which you selected at the beginning of this procedure.

    At this point, you have successfully set up the JDBC Resource.

    Setting Up MDS RepositoryPerforming the following procedure to set up the MDS repository.

  • 3-22    Oracle Value Chain Planning Installation Guide

    1. Return to the UNIX console and go to the ASCP domain home (the path where ASCP domain is installed).

    2. Create a new directory "mds": (/servers//mds).

    Example:

    /user_projects/domains/uitestdomain/servers/AdminServer/mds

    Creating a File Persistence Store

    To create a file persistence store in WebLogic Server Administration Console, perform the following procedure:

    1. Click Lock & Edit button from the Change Center region to change the domain configuration, if applicable.

    2. Click Persistent Stores from the Domain Structure region (or you can navigate to Services >Persistent Stores from the Domain Structure region).

    The Summary of Persistent Store page appears.

    3. Click New, and select Create File Store.

    4. Perform the following:

    1. Enter mds-ascp-repos in the Name field.

    2. Select ASCPManagedServer from the Target list.

    3. Enter /servers//mds in the Directory path field.

    4. Click OK.

    5. Click Activate Changes from the Change Center region, located in top left of the page.

  • Advanced Supply Chain Planning    3-23

    Starting the Admin Server and Managed ServerPerform the command line procedure below to start the ASCP Admin Server and ASCPManaged Server.

    1. Change directories to the /bin location.

    Syntax:

    cd $/bin

    Example:

    /slot/ems6479/appmgr/Oracle111160/Middleware/user_projects/domains/base_domain/bin

    2. Start the AdminServer.

    Example Syntax:

    nohup ./startWebLogic.sh -Dweblogic.management.username=weblogic -Dweblogic.management.password=welcome1> weblogic.out &

    Substitute your Hostname, Managed server post, Username and Password in the example command above.

    3. Start the ASCPManagedServer.

    Example Syntax:

    nohup ./startManagedWebLogic.sh "ASCPManagedServer" "http://rws3220163.us.oracle.com:7001" -Dweblogic.management.username=weblogic -Dweblogic.management.password=welcome1 >ASCPManagedServer.out &

    Substitute your Hostname, Managed server post, Username and Password in the example command above.

    Deploying and Starting the Planning ApplicationThis procedure consists of the following tasks:

    1. Copying and extracting the ZIP files.

    2. Deploying the Planning Application.

    Copying and Extracting the ZIP Files

    Perform the following procedure to copy and extract the ZIP files.

    After applying the VCP patch, the PlanningUIEar zip file has to be copied from EBS APPL_TOP to a directory where WebLogic is installed. The new application will have to be deployed to the ASCPManaged server.

  • 3-24    Oracle Value Chain Planning Installation Guide

    1. Create a folder with name "applications" in a directory on the host machine where WebLogic is installed. This folder is referred to as "applications".

    Example:

    /slot/ems1392/oracle/mwhome/user_projects/domain/fmw_domain/applications

    2. Copy the following ZIP files to the folder "applications".

    Example:

    cp $MSC_TOP/patch/115/ear/PlanningUIEar.zip

    3. Extract the ZIP files to the same folder.

    The PlanningUI.ear file is selected from this location for deployment.

    Deploying the Planning Application

    Perform the following procedure to deploy the Planning Application:

    1. In order to deploy the Planning Application, open the WebLogic UI for ASCP Domain according to the procedure mentioned in Starting the Admin Server and Managed Server, page 3-23.

    2. Select Deploym