Oracle BPASuite Installation Guide

March 16, 2018 | Author: Yannis Despotopoulos | Category: Oracle Database, Installation (Computer Programs), Java Virtual Machine, Transport Layer Security, Web Server
Share
Report this link


Comments



Description

Oracle BPA Suite 11gOracle BPA Suite Installation and Administration Guide May 2009 Copyright © 2008, 2009 Oracle and/or IDS Scheer AG. All rights reserved. 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 software or related documentation 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 RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065. This software 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 which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. This software 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. Portions of this software copyright © 2009, IDS Scheer AG. Oracle BPA Suite Installation and Administration Guide Contents 1 2 Manual conventions ..............................................................................................1 Installation..........................................................................................................2 2.1 2.2 2.3 2.4 Installation options .....................................................................................3 Client installation - Windows operating system................................................5 Client install and uninstall - Linux operating system .........................................7 Oracle Business Process Repository installations (Windows operating system) .....8 2.4.1.1 2.4.1.2 2.4.1.3 2.4.2.1 2.4.2.2 2.4.2.3 Initial installation ........................................................................ 12 Subsequent installation ................................................................ 14 Update installation....................................................................... 15 Oracle Business Process Repository................................................ 18 Oracle BPA Suite Site Administrator ............................................... 20 Oracle Business Process Repository Site Manager............................. 21 Step-by-step instructions - Use existing Oracle database (prepared for Oracle BPA Suite) ................................................ 21 Step-by-step - Configure and connect existing Oracle database instance ................................................................................ 23 Step-by-step - Create new Oracle database instance.................... 25 Step-by-step - Microsoft SQL Server .......................................... 27 Step-by-step - IBM DB2 ........................................................... 28 2.4.1 Default (recommended for up to 50 users) ............................................... 12 2.4.2 User-defined (advanced installation)........................................................ 17 2.4.2.3.1 2.4.2.3.2 2.4.2.3.3 2.4.2.3.4 2.4.2.3.5 2.4.2.4 2.5 Oracle BPA Suite Web Client Components ....................................... 30 Oracle Business Process Repository installations (Unix operating system) ......... 34 2.5.1 Oracle Business Process Repository ......................................................... 37 2.5.2 Oracle Business Process Repository Site Manager ...................................... 38 2.5.3 Oracle Business Process Repository and Oracle Business Process Repository Site Manager ........................................................................ 39 2.5.4 Oracle BPA Suite Web Client Components................................................. 41 2.5.5 Uninstall .............................................................................................. 43 2.6 Oracle Business Process Publisher Server installations.................................... 44 2.6.1.1 2.6.1.2 2.6.1.3 2.6.1.4 2.6.1.5 2.6.2.1 2.6.2.2 2.6.3.1 2.6.3.2 2.6.4.1 2.6.4.2 2.6.4.3 Step-by-step Step-by-step Step-by-step Step-by-step Step-by-step instructions instructions instructions instructions instructions (standard database) ................................ 45 (Oracle database) .................................... 47 (existing Oracle database)_tomcat ............. 51 (new Oracle database)_tomcat .................. 56 (MS SQL Server 2005 database) ................ 61 2.6.1 Apache Tomcat Web Application Server under Windows.............................. 44 2.6.2 Apache Tomcat Web Application Server under Solaris/Linux ........................ 66 Step-by-step instructions (Oracle database) .................................... 69 Step-by-step instructions (MS SQL Server 2005 database) ................ 72 Step-by-step instructions (Oracle database) .................................... 75 Step-by-step instructions (MS SQL Server 2005 database) ................ 97 Step-by-step instructions (Oracle database) .................................. 122 Step-by-step instructions (MS SQL Server 2005 database) .............. 143 Deployment of a new WAR file .................................................... 166 2.6.3 IBM WebSphere Application Server (WAS 6.1.0.15) under Windows ............. 74 2.6.4 IBM WebSphere Application Server (WAS 6.1.0.15) under RHELx64 ........... 121 I Oracle BPA Suite Installation and Administration Guide 2.6.5 Oracle WebLogic Server, version 11g under Windows............................... 170 2.6.5.1 2.6.5.2 Step-by-step instructions (Oracle database)_WebLogic11g .............. 171 Step-by-step instructions (MS SQL Server 2005 database)_WebLogic.................................................................. 183 Apache Tomcat Web Application Server under Windows .................. 195 Step-by-step Step-by-step Step-by-step Step-by-step Step-by-step instructions instructions instructions instructions instructions (standard database) .......................... 195 (Oracle database configured)_tomcat ... 197 (existing Oracle database)_tomcat....... 201 (new Oracle database)_tomcat............ 206 (MS SQL Server 2005 database).......... 211 2.6.6 Oracle Business Process Publisher Report Server installations.................... 194 2.6.6.1 2.6.6.1.1 2.6.6.1.2 2.6.6.1.3 2.6.6.1.4 2.6.6.1.5 2.7 2.8 2.9 2.10 Acrobat Reader ...................................................................................... 214 Java Runtime Environment....................................................................... 215 System add-ons ..................................................................................... 216 Additional installation information and principles ......................................... 217 Oracle BPA Suite - System architecture ................................................ 217 Oracle Business Process Architect installations....................................... 217 Oracle Business Process Repository - Exit a service ................................ 217 Automatic backup ............................................................................. 218 Particular issues - Oracle BPA Suite client and Oracle Business Process Repository on the same computer ...................................................... 219 Installation ............................................................................... 219 Uninstall .................................................................................. 220 2.9.1 Oracle BPA Suite Process Generator....................................................... 216 2.10.1 2.10.2 2.10.3 2.10.4 2.10.5 2.10.5.1 2.10.5.2 3 Administration ................................................................................................. 221 3.1 Database management systems................................................................ 221 3.1.1.1 Oracle database management system for Oracle Business Process Repository................................................................................ 221 Set up the database .............................................................. 221 Install Oracle BPA Suite database objects.......................... 222 Use SQL*Plus scripts ...................................................... 222 Available SQL*Plus scripts....................................... 223 Run batch files install.bat/install.sh .......................... 224 Connection data..................................................... 224 Change tablespace names ....................................... 224 Change the password for Oracle user ARIS71............. 225 Change the password for Oracle user arisadm71 ........ 226 Change user names................................................ 226 3.1.1 Oracle Business Process Repository ....................................................... 221 3.1.1.1.1 3.1.1.1.1.1 3.1.1.1.1.2 3.1.1.1.1.2.1 3.1.1.1.1.2.2 3.1.1.1.1.3 3.1.1.1.1.3.1 3.1.1.1.1.3.2 3.1.1.1.1.3.3 3.1.1.1.1.3.4 3.1.1.1.1.3.5 3.1.1.1.2 3.1.1.2 Configure the installation scripts ...................................... 224 Configure Oracle Business Process Repository URL..................... 226 MS SQL database management system for Oracle Business Process Repository................................................................................ 227 Required programs, drivers, and scripts ................................... 227 Notes on installing SQL Server ................................................ 228 Set up the database .............................................................. 228 Configure the installation scripts ...................................... 229 3.1.1.2.1 3.1.1.2.2 3.1.1.2.3 3.1.1.2.3.1 II Oracle BPA Suite Installation and Administration Guide 3.1.1.2.3.1.1 3.1.1.2.3.1.2 3.1.1.2.3.1.3 3.1.1.2.3.2 3.1.1.3 Change the name of the database ............................ 229 Change the password for the login user ARIS71 ......... 229 Change the user name ARIS71 ................................ 230 Configure Oracle Business Process Repository URL ............. 231 IBM DB2 database management system for Oracle Business Process Repository .................................................................... 231 Manage a system with an MS SQL database .................................. 234 Sample script create_db.sql.................................................... 237 Manage a system with an Oracle database .................................... 239 3.1.2 Oracle Business Process Publisher Server ............................................... 233 3.1.2.1 3.1.2.2 3.2 3.1.2.1.1 Oracle Business Process Repository ........................................................... 242 3.2.1 Oracle Business Process Repository - Operating system and database system platforms ................................................................................ 246 3.2.2 Recommended user-related server dimensioning ..................................... 248 3.2.3 Protocols used .................................................................................... 249 3.2.3.1 3.2.3.2 3.2.4.1 3.2.4.2 3.2.4.3 3.2.4.4 3.2.4.5 3.2.4.6 3.2.4.7 3.2.4.8 3.2.4.9 3.2.4.10 3.2.4.11 3.2.4.12 3.2.4.13 3.2.5 3.2.6 3.2.7 3.2.8 3.3 3.3.1 3.3.2 3.3.3 3.3.4 3.4 Oracle BPA Suite on the Internet/SSL........................................... 249 Oracle BPA Suite on the intranet/VPN ........................................... 249 Log logins ................................................................................ 251 Log messages ........................................................................... 251 SSL encryption of data transmission via Secure Socket Layer .......... 251 Update SSL certificates .............................................................. 252 Configure Oracle Business Process Repository/Oracle Business Process Repository Site Manager connection.................................. 253 Configure client/Oracle Business Process Repository connection ....... 254 Deactivate Report Server............................................................ 254 Deactivate simulation server ....................................................... 255 HTML Generator - Current database lists....................................... 255 Activate Oracle BPA Suite Notify Service ....................................... 256 Restrict number of index_backup files .......................................... 258 Provide additional memory ......................................................... 259 New database - Additional languages ........................................... 259 3.2.4 Configure Oracle Business Process Repository ......................................... 249 Oracle BPA Suite Converter .................................................................. 260 When are placed symbols displayed (server)? ......................................... 261 Add custom icons for macros ................................................................ 262 Server log directory ............................................................................ 262 What are Oracle BPA Suite agents for?................................................... 263 What tasks does an Oracle BPA Suite agent handle? ................................ 263 How to exit Oracle BPA Suite agents ...................................................... 263 Activate Oracle BPA Suite Notify Service ................................................ 264 Oracle BPA Suite agent............................................................................ 263 Java clients (application) ......................................................................... 265 3.4.1 Oracle Business Process Simulator ........................................................ 269 3.4.2 Client log directory.............................................................................. 270 3.5 Oracle Business Process Publisher ............................................................. 271 3.5.1.1 Approved platforms, servers, applications, and databases ............... 275 3.5.1 Oracle Business Process Publisher Server ............................................... 273 3.5.2 Context path ...................................................................................... 279 3.5.3 Modify configuration files ..................................................................... 279 III Oracle BPA Suite Installation and Administration Guide 3.5.3.1 3.5.3.2 3.5.3.3 3.5.3.4 3.5.3.5 3.5.3.6 3.5.3.7 3.5.3.8 3.5.3.9 3.5.3.10 3.5.3.11 3.5.3.12 3.5.3.13 3.6 Show all groups in the Explorer tree (Publisher Server)................... 279 Change the DAO of an Oracle database (Tomcat)........................... 280 E-mail settings.......................................................................... 281 Free port to Web server ............................................................. 281 Change IP address .................................................................... 282 LDAP user management ............................................................. 282 Use Microsoft SQL database ........................................................ 283 Encrypt LDAP password.............................................................. 286 Configure navigation carousel ..................................................... 286 Display news ............................................................................ 287 Configure OIS user management (Oracle Business Process Publisher Server) ...................................................................... 288 Use an Oracle database (Tomcat) ................................................ 288 Oracle restart ........................................................................... 291 3.5.4 Manage reports .................................................................................. 292 Java clients (browser mode)..................................................................... 293 3.6.1.1 3.6.1.2 3.6.1.3 3.6.1.4 3.6.1.5 Installed files of Oracle BPA Suite ................................................ 295 Language update and character sets ............................................ 298 Execution as application or applet ................................................ 298 Provide additional memory ......................................................... 299 Installation by software distribution ............................................. 299 Possible settings for user.cfg .................................................. 300 Preconfigured user.cfg ........................................................... 300 Configure user.cfg................................................................. 300 3.6.1 Set up Java clients for browser use........................................................ 295 3.6.1.5.1 3.6.1.5.2 3.6.1.5.3 3.6.2 Start a second Java-based product in the browser ................................... 300 3.6.3 Automatically update installed Web clients.............................................. 301 3.6.3.1 3.6.3.2 3.7 Preparations for the automatic update .......................................... 301 Set up web clients for automatic update ....................................... 301 Central user login using LDAP ................................................................... 302 3.7.1 Configure LDAP server operation ........................................................... 303 3.7.2 Set Oracle Business Process Repository for LDAP server operation with SSL .............................................................................................. 304 3.8 Data backup .......................................................................................... 305 3.8.1.1 Configuration............................................................................ 309 Transfer item groups of the configuration ................................. 309 Transfer exported filters, font formats, languages, and templates ............................................................................ 310 3.8.1 Transfer data from earlier Oracle BPA Suite versions ................................ 307 3.8.1.1.1 3.8.1.1.2 3.8.1.2 Transfer custom or modified scripts of previous Oracle BPA Suite versions ................................................................................... 310 3.8.2 Back up users and configuration ........................................................... 311 3.8.3 Automatic backup of current configuration files ....................................... 312 3.8.4 Save method changes ......................................................................... 312 3.9 Data management with Oracle BPA Suite Admintool .................................... 312 3.9.1 Start Oracle BPA Suite Admintool .......................................................... 313 3.9.2 Oracle BPA Suite Admintool commands .................................................. 313 IV Oracle BPA Suite Installation and Administration Guide 3.9.2.1 Backup .................................................................................... 316 Example .............................................................................. 317 Data backup using a batch program (batch file) ........................ 318 3.9.2.1.1 3.9.2.1.2 3.9.2.2 3.9.2.3 3.9.2.4 3.9.2.5 3.9.2.6 3.9.2.7 3.9.2.8 3.9.2.9 3.9.2.10 3.9.2.11 3.9.2.12 3.9.2.13 3.9.2.14 3.9.2.15 3.9.2.16 3.9.2.17 3.9.2.18 3.9.2.19 3.9.2.20 3.9.2.21 3.9.2.22 3.9.2.23 3.9.2.24 3.9.2.25 3.9.2.26 3.9.2.27 3.9.2.28 3.9.2.29 3.10 3.10.1 3.10.2 3.10.3 3.10.4 3.10.5 3.10.6 3.10.7 3.11 Backupasn ............................................................................... 318 Backupconfig ............................................................................ 319 Configadminpassword ................................................................ 320 Copy ....................................................................................... 320 Createdb.................................................................................. 321 Dbmspassword ......................................................................... 321 Download................................................................................. 321 Delete ..................................................................................... 322 Exit ......................................................................................... 322 Help ........................................................................................ 322 Interactive ............................................................................... 323 Kill .......................................................................................... 323 List ......................................................................................... 324 Maintain................................................................................... 324 Monitor .................................................................................... 324 Password ................................................................................. 325 Rename ................................................................................... 325 Reorg ...................................................................................... 325 Restore.................................................................................... 326 Restoreversioned ...................................................................... 327 Restoreasn ............................................................................... 327 Restoreconfig............................................................................ 328 Server ..................................................................................... 328 Sessions .................................................................................. 329 Siteadminpassword ................................................................... 330 Statistic ................................................................................... 330 Status ..................................................................................... 331 Version .................................................................................... 331 Evaluation (scripting) .............................................................................. 331 Optimize memory requirements .......................................................... 332 Report formats and report files............................................................ 333 Windows API functions ....................................................................... 334 Dialog variables ................................................................................ 335 Nested dialogs .................................................................................. 335 Icons for placed attributes .................................................................. 336 Add custom icons for macros .............................................................. 336 Known restrictions .................................................................................. 337 3.11.1 When do links work?.......................................................................... 339 3.11.2 Calendar .......................................................................................... 342 3.12 3.13 Glossary ................................................................................................ 342 Appendix ............................................................................................... 346 3.13.1 System language and locale IDs .......................................................... 346 3.13.2 Port numbers.................................................................................... 350 V keyboard entries. In the Installation and Administration Guide. Note This manual describes the settings and features as they were at the time of print. Example Click on OK. Notation/Formatting Menu items.Oracle BPA Suite Installation and Administration Guide 1 Manual conventions This chapter describes the manual conventions. Click on Help/Help topics. setting up. Enter the path <directory>\server. and using the product. Sequences of menus and menu items are separated by forward slashes. are written in bold. Information about discrepancies is provided in the Readme file that accompanies the product. the description of settings and features may differ from actual settings and features. When you combine various technologies. Always follow the instructions provided in the installation manuals of the relevant manufacturer. 1 . Since manual and software are subject to different production cycles. etc. particularly announcements concerning releases on their Internet pages. the following notational and formatting conventions are used for menu items. shortcut keys. Please read this file and take the information into account when installing. Enter the path in the sample. please observe the manufacturers' instructions. file names. We cannot guarantee proper functioning of supported third-party systems. User-defined entries are highlighted in bold and enclosed in angle brackets. or contact Oracle Corporation support.txt file. file names. dialog boxes. etc. all configuration changes are applied. add a language (Modify Program option).exe. for example.exe startup file.Oracle BPA Suite Installation and Administration Guide 2 Installation This chapter describes the requirements for individual installations. If you run an update installation for Oracle Business Process Repository. you are prompted to reboot your computer after installation. Note When you perform an update. the system checks if a CFG file was changed manually. The settings from the previous installation are retained. if you have modified the arisclient. Repair program This option repeats an installation with the current settings. Any subsequently installed hotfixes will be deleted! Remove This option uninstalls the component for which the installation program was launched. and the languages you installed. 2 . It is assumed that you perform the installations for the first time using the OracleBPA. If so. For example. the program group. If you re-run an installation for installed programs. If system files are changed during installation. or repeat an installation (Repair Program option). for example the installation path. the following options are provided: Modify Program Use this option to add more components and/or languages. You can also start individual installation programs via the corresponding Setup. it is backed up (Page 218) in the <Oracle BPA Suite installation directory>\javaclient\backup\config directory. This is useful if a program file was deleted by accident. Each installation is explained step-by-step.cfg file manually. a backup copy of that file is generated before the new CFG file is installed. Please refer to the chapter Administration (Page 221) to obtain information on additional settings required for using Oracle BPA Suite products. except in an exclusively German installation) when you install Oracle BPA Suite products. click on the name of your drive in Windows Explorer and run the program OracleBPA. You can access these documents via Start/Programs/Oracle BPA Suite/Documents. 2. Important documents are automatically created in English (always. 3 . This ensures that your changes are preserved in future update installations.1 Installation options If you insert an Oracle BPA Suite installation media in your drive. the start page opens automatically. If it is not displayed automatically.Oracle BPA Suite Installation and Administration Guide Warning Please only use the file userServerSettings.cfg to change the configuration. The other Oracle Business Process Repository configuration files are overwritten for each installation.exe. Oracle BPA Suite Installation and Administration Guide Installation media Installation program Install Oracle BPA Suite Additional installations Provides access to the server installation programs and to the installation of JRE and Adobe Acrobat Reader. workshops. Java Runtime Environment (JRE) To use Java-based Oracle BPA Suite products and start them via a Web browser. install SUN Java Runtime Environment (JRE) if you have not yet done so. Additional installations Installation program Install Oracle Business Process Repository Install Oracle Business Process Publisher Server Adobe Acrobat Reader Install the viewer for displaying PDF documents. such as the Oracle BPA Suite Methods Manual. Opens the description of differences between earlier Oracle BPA Suite versions and the current Oracle BPA Suite version. 4 . Opens the IDS Scheer Academy catalog with the latest information on training. Installation and Administration Guide Quick Start Guide Delta paper Opens the Installation and Administration Guide in PDF format. Oracle BPA Suite news IDS Scheer Academy Opens the Oracle BPA Suite news page on the IDS Scheer home page in your Web browser. Content/Components installed Install Oracle Business Process Repository. Install Oracle Business Process Publisher Server. This requires Adobe Acrobat Reader. Content/Components installed Install products of the Oracle BPA Suite. Opens the Quick Start Guide. and consulting services. This means that you can only create databases and work with them if you connect to Oracle Business Process Repository. Click on Next. 3. 2. The Select target path page opens. 5 . Important documents are automatically created in English (always. The installation program's Welcome page opens. 5.Windows operating system This chapter describes the installation of Oracle BPA Suite clients on Windows operating systems. 4. click on Yes. Ensure that the system requirements for all products and functionalities are met. You can access these documents via Start/Programs/Oracle BPA Suite/Documents.exe program. The installation Oracle BPA Suite WITHOUT LOCAL STANDARD DATABASE SYSTEM does not provide the standard database system. You can also connect to an Oracle Business Process Repository to create databases there and work with them. This allows you to create databases on your computer and work with them without other users being able to access them. except in an exclusively German installation) when you install Oracle BPA Suite products. click on the name of your drive in Windows Explorer and run the OracleBPA.Oracle BPA Suite Installation and Administration Guide 2. If additional languages are installed. this step is skipped and the directory in which the other products are installed is used.2 Client installation . Once you have read the license agreements and accept them. Insert the Oracle BPA Suite installation media into your drive. select Oracle BPA Suite WITH LOCAL STANDARD DATABASE SYSTEM. The installation Oracle BPA Suite WITH LOCAL STANDARD DATABASE SYSTEM also installs the standard database system. Click on Install Oracle BPA Suite. If other Oracle BPA Suite products are already installed on the computer. The Select program folder page opens. To be able to work locally. If the start page is not displayed automatically. the documents and help files of those languages (Windows operating system) are automatically installed. Procedure 1. The Start Copy Operation page opens. click on Next. To install the products in a directory different from the one suggested. The program directory for Oracle BPA Suite is created. The products will now be installed. and then click on OK. To use the installation directory suggested in the Target folder box. Click on OK and select Next. The Select language dialog box opens. If you use the Oracle BPA Suite products exclusively in a server/client environment and do not require a separate database system on your computer: Activate the option field Oracle BPA Suite WITHOUT LOCAL STANDARD DATABASE SYSTEM. enter a name in the Program folder box or select the program folder in the Existing folders box. click on Next. click on Change. and the installation program closes. If other Oracle BPA Suite products are already installed on the computer. To use a different name. Click on Finish. Click on Next. You have the following options: If you want to use Oracle BPA Suite with a local standard database system on your computer. Click on Next. and click on Next. 7. If you do not want to create a desktop shortcut to launch Oracle BPA Suite products. Select the program directory in which to place the program shortcut. Select the installation directory. and then click on Next. 6 . Check the settings in the Start Copy Operation dialog box. The installation is complete. Continue with the following step. Click on Next. If these are correct. 11. The system notifies you when the installation is complete. The corresponding option button Oracle BPA Suite WITH LOCAL STANDARD DATABASE SYSTEM is already enabled by default. this step is skipped and the directory in which the other products are installed is used. 13. Enable the check boxes for the desired interface and method languages. If you have previously selected Oracle BPA Suite products that cannot access local databases. 10. 9. 12.Oracle BPA Suite Installation and Administration Guide 6. click on Next. the system notifies you accordingly. The Local Standard Database System dialog box opens. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. disable the Create Desktop Shortcut check box. 8. 3 Client install and uninstall . The path of the Java Runtime Environment is stored in the YYYMMDDHHMMDD. You can reconfigure the software at any time after installation with the configure.Linux operating system This chapter describes the installation of Oracle Business Process Architect on a Linux operating system.xxxxxx/setup/backup. Ensure that the system requirements for all products and functionalities are met.xxxxxx. Copy the file install_bpa11gR1. you must run setup again.Oracle BPA Suite Installation and Administration Guide Tip You can use Oracle BPA Suite Converter to transfer databases that were created with previous Oracle BPA Suite versions (for further information./JavaClient.sh script in the directory JavaClient.xxxxxx/setup/. 2. 2./install_bpa11gR1. Procedure 1.sh file from any directory of your choice. you need to enter the full path in front of the file name. 7 .sh to install an Oracle BPA Suite product.xxxxxx. 3.sh to the directory in which you would like to install an Oracle BPA Suite product. Use the appropriate Launcher.xxxxxx. enter .conf file in the directory . A subsequent installation or update installation is similar to the server installation. To install an additional language later. Configuration is performed automatically with the installation.data.exe file in the directory JavaClient. please refer to the chapter entitled Transfer data from earlier versions of Oracle BPA Suite in the Administration Guide). You can start the install_bpa11gR1.xxxxxx/ to start an Oracle BPA Suite product. When you are in the directory to which you copied the file. The software is ready to run immediately. To do so. if more RAM is available than listed below. a faster processor. additional memory.g. or system extension may be required. you first have to exit the application and then delete the installation folder. Delete the folder <installation directory>/JavaClientxxxxxx: rm –r <installation directory>/JavaClient. In general. To ensure optimum load distribution and better protection against failure. system configuration. Meeting the recommended system requirements will assure good performance even with large data volumes. memory. Merge or Simulation). On the other hand. it is advisable to use up-to-date hardware taking into account the number of users who will be accessing the same Oracle Business Process Repository. For simultaneous use of other applications. The minimum system requirements must be met in order for the Oracle BPA Suite products to work properly.xxxxxx 2. The default server includes: Oracle Business Process Repository Oracle Business Process Repository Site Manager Oracle BPA Suite Converter This section describes processor. Close the application. All Oracle BPA Suite clients use Oracle Business Process Repository to access the database server and thus work with a common data basis. runtime behavior might improve. Procedure 1. 2. and software requirements of the various server and client computers for Oracle BPA Suite. In some cases. Depending on the application scenario (e. large databases can involve extended runtimes. Use of report. more than one Oracle Business Process Repository can be used. minimum and recommended system requirements are specified.Oracle BPA Suite Installation and Administration Guide Uninstall To uninstall a client.4 Oracle Business Process Repository installations (Windows operating system) This chapter describes installations related to Oracle Business Process Repository that can be performed under a Windows operating system. 8 . backup and restore functions may require more RAM. the maximum size of a Virtual Machine (VM) is 1 GB.Oracle BPA Suite Installation and Administration Guide Note This manual describes the settings and features as they were at the time of print. We strongly recommend protection at the operating system level to minimize the risk of data misuse. 9 . If you create a Publisher export and use links to large files (>15 MB).4 GHz RAM 64-bit system 2 GB RAM 32-bit system 1 GB RAM In 32-bit systems. setting up. 512 MB The system requirements depend on the number of users (1 GB main memory for 50 users) and use of certain features.4 GHz Minimum Intel Pentium IV 2. Please also note the information on script development (Page 331). If you want to run report scripts that process large quantities of database items. Oracle Business Process Repository saves configuration data at the operating system level. The RAM required for JavaScript reports varies greatly. Please read this file and take the information into account when installing. the export process is canceled. Information about discrepancies is provided in the Readme file that accompanies the product. If the memory is insufficient. Hardware Processor Recommended Intel Pentium IV 3. you may need more memory for your Oracle Business Process Repository.2 GB main memory for Oracle Business Process Repository. and using the product. we recommend a 64-bit Windows installation or a Unix installation due to the upper memory limit of 1. the description of settings and features may differ from actual settings and features. Since manual and software are subject to different production cycles. 0. C:\Program Files\Java\jre1. You do not need to install JRE separately.g. Approvals are also valid for subsequent updates. Please 10 . Therefore. If JRE 1. Note SUN renamed the JRE versions.6.0_04 is now called JRE 6. If you have already installed JRE. For example.0_05 and for any subsequent patch from the public domain Java SE of the SUN home page (except for Java SE for Business). Arabic. you must create it.6. The following are approved: Java Runtime Environment (JRE) 1. your installation is not used by Oracle BPA Suite. Cyrillic.Oracle BPA Suite Installation and Administration Guide Software Operating systems Network Details Depends on the database systems used. If you are using JRE 1.properties. copy the file jaxbapi.0_04 and subsequent patches that are in the public domain (Java SE on the SUN home page except Java SE for Business) and generally released by SUN. if you wish to display Japanese characters. the Oracle BPA Suite approvals for JREs are valid for all patch levels of a version. Your JRE installation is only used if you start Oracle BPA Suite products from your browser.0_01\lib\endorsed. the approval is valid for both JRE 1.). you must rename the font.6. JRE Windows If you have Oracle Business Process Repository installed and start Oracle BPA Suite products as programs. e. SUN Microsystems guarantees compatibility between the JRE patch levels.0_04 and JRE 1. the corresponding file in directory <JRE installation directory>\<version>\lib must be named font. If the directory endorsed does not exist.6.ja file to font. Update 4.6 update 3 or an older version. JRE 1.jar from the directory <Web Client Components>\lib to the directory <Java JRE installation directory>/endorsed.properties. Oracle BPA Suite products are tested using the JRE that is current at the time of release.6. an internal JRE version is automatically used. High-speed network (>=100 Mbit) between database server and Oracle Business Process Repository.0_04 and subsequent patches are approved for an Oracle BPA Suite product.6. To display different character sets (Japanese.properties. etc. Depending on your graphics card and driver configuration. it may not always be possible to open report output in PDF format from a Publisher export. no firewall is required.Oracle BPA Suite Installation and Administration Guide Software Details note that you must repeat this procedure for every update of version 3 or older. Additional information is available from our support. for example. We therefore recommend installation of version 4 or higher. installation of Java 6 update 10 may cause delays in the Designer and Matrices modules. 2002. In addition. Communication between clients and Oracle Business Process Repository takes place via the CORBA protocol IIOP (Internet Inter Object Request Broker Protocol). However.d3d=false Protocols (Page 249) Data exchange between browser-capable Oracle BPA Suite clients and Oracle Business Process Repository can be encrypted with SSL (1024-bit RSA). Output If. please ensure that the tables have been saved in XLS format. use the following command line entry to start the program: -Dsun. 11 . If you use reports to import data from Excel tables. Oracle Corporation offers customized solutions. In this case. SSL capability is already integrated into Oracle BPA Suite and only needs to be activated when needed. problems may occur despite better performance. 2003. If pop-up blockers are activated for the domain. you must have Adobe Reader and Microsoft Office version 2000. or 2007 installed. you want to output documents in PDF format using Microsoft Word or Microsoft Excel. If Oracle BPA Suite clients within the intranet or in a VPN environment (Virtual Private Network) access Oracle Business Process Repository.java2d. Note Oracle Business Process Repository does not support NAT (Network Address Translation) by default. all applications that are linked in your models should be installed. If you have Java 6 update 10 installed. please ensure that a Web server is installed on the computer and that the Web server default path points to <Oracle BPA Suite installation directory>\Server\HTML. 3.1. 3. If the start page is not displayed automatically. 2. If you want to use Java-based Oracle BPA Suite products via a browser. 4. Ensure that the system requirements for all products and functionalities are met.exe program.4.1 Default (recommended for up to 50 users) Use the following procedures to install: Oracle BPA Suite Site Administrator Oracle Business Process Repository Site Manager Oracle Business Process Repository Standard database system Oracle BPA Suite Web Client Components Procedure 1.4.1 Initial installation The detailed description below explains the steps that the installation program performs when you run the standard installation of Oracle Business Process Repository on your system for the first time. The installation program's Welcome page opens. click on the name of your drive in Windows Explorer and run the OracleBPA. Insert the Oracle BPA Suite installation media into your drive. 2. 2. Perform the default server installation (Page 12). Ensure that the system requirements (Page 242) for all components are met. The standard database system is installed automatically at the same time. 5. Click on Additional Installations. 12 . Install the relevant clients on the workstations. Click on Next.Oracle BPA Suite Installation and Administration Guide 2. Click on Install Oracle Business Process Repository. Procedure 1. enter a name in the Program folder box or select the program folder in the Existing folders box. click on Next. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. or navigate to the desired directory in the Directories box. Click on OK. If other Oracle BPA Suite products are already installed on the computer. Enter the desired path in the Path box. 9. on your active Web server. Enable the check boxes for the languages in which you want to install the program.g.Oracle BPA Suite Installation and Administration Guide 6. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. To use the installation directory suggested in the Target folder box. To install the products in a directory different from the one suggested. click on Yes. Ensure that all languages you want to provide to the Oracle BPA Suite clients are installed. Note that the name of the installation directory must not contain any country-specific special characters. The Select target path page opens. To install the program in a directory different from the one suggested. this step is skipped and the directory in which the other products are installed is used. To use the suggested installation directory. 12. Click on Next. If other Oracle BPA Suite products are already installed on the computer. To accept the license agreement. Click on Default (recommended for up to 50 users). The program directory for Oracle BPA Suite is created. 11. Click on Next. 13 . Select the installation directory. 7. and then click on OK. To use a different name. click on Browse. Please read it carefully. and then click on Next. click on Change. click on Next and continue with the next step. The Select target path page opens. this step is skipped and the directory in which the other products are installed is used. 10. Select the program directory in which to place the program shortcut. e. Click on Next. 8. Select the installation directory for your Oracle BPA Suite Web Client Components files. The license agreement is displayed. If these are correct. we recommend that you create backup copies and add them with modified names once the installation is complete. you need to click on the program icon to run the program. If you changed existing reports but did not rename them. 3. the old files are saved in a backup directory.1. 2. once the driver is installed. 14 .4. The products will now be installed.Oracle BPA Suite Installation and Administration Guide 13. 4. Procedure 1. and the installation program closes. Report scripts supplied by default are reinstalled. If files have to be reinstalled during setup. Check the settings in the Installation Overview dialog box. The configuration changes that you made in the file userServerSettings. 15. click on the name of your drive in Windows Explorer and run the OracleBPA. Click on Finish. If the start page is not displayed automatically. The installation is complete. Otherwise. click on Next. they are still available after installation. 2.2 Subsequent installation The detailed description below explains the steps that the installation program performs when you have Oracle Business Process Repository installed and call the same Oracle Business Process Repository installation program again.cfg are applied.exe program. Therefore. Click on Install Oracle Business Process Repository. If you want to use the supplied demo database rather than the current one. Confirm the Welcome dialog and. Click on Next. Decide whether or not the program is to be installed as a Windows service by enabling the relevant check box. The contents of the HTML directories are examples of such files. Ensure that the system requirements are met for all components. If you install it as a Windows service. it will be launched automatically with the operating system. completion of the installation. Click on Additional Installations. Insert the Oracle BPA Suite installation media into your drive. you can copy it to your server using the Restore function. 14. Previously used databases and filters are not affected by the subsequent installation. If files have to be reinstalled during setup. 15 .3 Update installation The detailed description below explains the steps that the installation program performs when you have Oracle Business Process Repository installed and call the Oracle Business Process Repository installation program with an Oracle BPA Suite installation media of a higher version. If you changed existing reports but did not rename them. The Modify Program option button is already enabled. it will be launched automatically with the operating system. you can copy it to your server using the Restore function. they are still available after installation. 8. 10. Please ensure that all languages you selected for the installed Oracle BPA Suite products are installed. The Note dialog box asks you to terminate any running Oracle Business Process Repository or the corresponding Windows service (Page 217) before you continue with the installation. If you install it as a Windows service. Report scripts supplied by default are reinstalled. If your settings are correct. Click on Next. Enable the check boxes for the languages you want to add.Oracle BPA Suite Installation and Administration Guide 5. you need to click on the program icon to run the program. 6. click on Next. Therefore. Click on Next. The components will now be installed. Click on Finish. The contents of the HTML directories are examples of such files. Otherwise. 7. The installation program's Welcome page opens. 9.1. If you want to use the supplied demo database rather than the current one. Previously used databases and filters are not affected by the installation. you must run setup again.4. 2. the old files are saved in a backup directory. we recommend that you create backup copies and add them with modified names once the installation is complete. Decide whether or not the program is to be installed as a Windows service by enabling the relevant check box. The installation is complete and the installation program closes. Tip To install an additional language later. Click on OK after having done so or if no Oracle Business Process Repository is running. Check your settings in the summary. All configuration changes are entered in the file userServerSettings. In older program versions. 5. If you run an update installation of the current version. 6. If the start page is not displayed automatically.cfg. the configuration files are converted when Oracle Business Process Repository is started. The installation is complete and the installation program closes. 16 . Click on Finish. 2. The Note dialog box asks you to terminate any running Oracle Business Process Repository or the corresponding Windows service before you continue with the installation. Click on OK to confirm the message. Insert the Oracle BPA Suite installation media into your drive. Procedure 1.exe program. The configuration files are deleted. you must run setup again. click on Next. They are backed up in the backup directory. Check your settings in the summary.Oracle BPA Suite Installation and Administration Guide The configuration changes that you made in the file userServerSettings. If your settings are correct. configuration changes were entered in different files. click on the name of your drive in Windows Explorer and run the OracleBPA.cfg are applied. Click on Install Oracle Business Process Repository. A message informs you that the currently installed Oracle Business Process Repository version is older than the version of the Oracle BPA Suite installation media and that an update will be performed. Click on OK after having done so or if no Oracle Business Process Repository is running. 8. Tip To install an additional language later. The components will now be installed. 3. Click on Additional Installations. 4. Ensure that the system requirements are met for all components. 7. we recommend that you install Oracle Business Process Repository and the database system on different computers. 4. Start Oracle BPA Suite Site Administrator. Oracle Business Process Repository. Thus. install Oracle BPA Suite Web Client Components and set up your Web server for use with Oracle BPA Suite Web Client Components (see chapter Oracle BPA Suite Web Client Components) or 5. If you want to use Java-based Oracle BPA Suite products via a browser. a scenario can be set up in which Oracle Business Process Repository and the database system (Oracle Business Process Repository Site Manager) are installed on different computers. Procedure 1. 3. Install Oracle Business Process Repository Site Manager with the appropriate option (see chapter Step-by-step instructions (Page 21)) on the server computer on which you installed your database. Install a database system. or set up an existing database for work with Oracle BPA Suite. 2. Continue with step 5. 17 . Install Oracle Business Process Repository on every computer you want to use as Oracle Business Process Repository. Right-click on the name of the server. It is advisable that only Oracle Corporation employees perform this type of installation (see chapter Support in the Administration Guide).4.Oracle BPA Suite Installation and Administration Guide 2. For scenarios in which 200 or more users work simultaneously with Oracle BPA Suite. You can import the demo database into your database system. and select Restore. a. and Oracle BPA Suite Web Client Components separately or together. Ensure that the system requirements are met for all components (see chapter Hardware and software requirements in the Administration Guide).2 User-defined (advanced installation) This installation option allows you to install Oracle Business Process Repository Site Manager. b. Select the ADB file of the demo database in the directory Databases and Filters\Databases on the installation media. Unlike the installations described above. Insert the Oracle BPA Suite installation media into your drive. 2. Tip To install an Oracle BPA Suite Site. Once the database is registered with Oracle BPA Suite. perform the installation on every computer you intend to use as an Oracle Business Process Repository in the Oracle BPA Suite Site. the installation sequences are combined according to your selection. If the start page is not displayed automatically. it is assumed that there are no previous installations on the computer. 4. and click on Open. 3. and Oracle BPA Suite Web Client Components. click on the name of your drive in Windows Explorer and run the OracleBPA. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)).2. 2. perform the installation on every computer you intend to use as an Oracle Business Process Repository in the Oracle BPA Suite Site. Oracle BPA Suite Site Administrator. Oracle Business Process Repository Site Manager. Click on Install Oracle Business Process Repository. For the following procedures.exe program. 18 . Click on Additional Installations.Oracle BPA Suite Installation and Administration Guide c. Procedure 1. you receive a corresponding message. user-defined options allow you to install any combination of components from Oracle Business Process Repository. If you select more than one component.1 Oracle Business Process Repository This section describes in detail the steps that the installation program performs when you install an Oracle Business Process Repository.4. Tip To install an Oracle BPA Suite Site. The instructions describe the installation sequence if you select one of the components provided. Ensure that all languages you want to provide are installed. If other Oracle BPA Suite products are already installed on the computer. 12. Disable all check boxes except the Oracle Business Process Repository check box. 13. If other Oracle BPA Suite products are already installed on the computer. Click on Next. 8. Enable the check boxes for the languages in which you want to install the program. The installation is complete and the installation program closes. If you install it as a Windows service. 9. Click on Finish. The components will now be installed. enter a name in the Program folder box or select the program folder in the Existing folders box. click on Yes. this step is skipped and the directory in which the other products are installed is used. The Select target path page opens. The program directory for Oracle BPA Suite is created. it will be launched automatically with the operating system. you need to click on the program icon to run the program. Either enter your license key or enable the Dongle Version (Hardware Key) check box if you use a hardware key instead of a license key. click on Next. Enter the name of the computer on which Oracle Business Process Repository Site Manager has been installed.Oracle BPA Suite Installation and Administration Guide 5. and then click on Next. 7. this step is skipped and the directory in which the other products are installed is used. 10. Click on Next. Check your settings in the summary. The Select target path page opens. Click on USER-DEFINED (ADVANCED INSTALLATION). Decide whether or not the program is to be installed as a Windows service by enabling the relevant check box. 11. Once you have read the license agreements and accept them. Otherwise. The installation program's Welcome page opens. To use a different name. Click on Next. 19 . If your settings are correct. The Select program folder page opens. Click on Next. 6. Select the program directory in which to place the program shortcut. Enable the check boxes for the languages in which you want to install the program. 2. Insert the Oracle BPA Suite installation media into your drive. Click on Additional Installations.2. If the start page is not displayed automatically. enter a name in the Program folder box or select the program folder in the Existing folders box.2 Oracle BPA Suite Site Administrator The detailed description below explains the steps that the installation program performs when you install Oracle BPA Suite Site Administrator. Click on Next. 5. To use a different name. 11. If other Oracle BPA Suite products are already installed on the computer. click on the name of your drive in Windows Explorer and run the OracleBPA. and then click on Next. 7. Click on Next. Click on USER-DEFINED (ADVANCED INSTALLATION). 6.Oracle BPA Suite Installation and Administration Guide 2. this step is skipped and the directory in which the other products are installed is used. this step is skipped and the directory in which the other products are installed is used. Disable all check boxes except for the Oracle BPA Suite Site Administrator check box. 10. The Select target path page opens. If other Oracle BPA Suite products are already installed on the computer. Click on Next.exe program. Click on Install Oracle Business Process Repository. The Select program folder page opens. Once you have read the license agreements and accept them. Select the program directory in which to place the program shortcut. Either enter your license key or enable the Dongle Version (Hardware Key) check box if you use a hardware key instead of a license key. Ensure that all languages you want to provide are installed. The installation program's Welcome page opens. 3. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). click on Yes. 4. 9. recommended for 50 or more users. Click on Next. 8. Ensure that the Install ARIS Governance Engine check box is cleared. 20 . Procedure 1. The program directory for Oracle BPA Suite is created.4. If other Oracle BPA Suite products are already installed on the computer. The installation program's Welcome page opens.3. 13. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). Click on Finish. 4. 2. 3. click on Next.Oracle BPA Suite Installation and Administration Guide 12. 21 .1 Step-by-step instructions . Please read it carefully. this step is skipped and the directory in which the other products are installed is used.2. 14. Procedure 1. If the installation media start page is not displayed automatically. Insert the Oracle BPA Suite installation media into your drive. Click on Additional Installations. The products will now be installed. Click on Next. 2. 2. If these are correct.3 Oracle Business Process Repository Site Manager This section describes in detail the steps that the installation program performs when you install Oracle Business Process Repository Site Manager. Click on Next. Warning You may install Oracle Business Process Repository Site Manager only once for each Oracle BPA Suite Site.4. Check the settings in the Start Copy Operation dialog box. To accept the license agreement. using the SQL*PLUS scripts). The license agreement is displayed.4.Use existing Oracle database (prepared for Oracle BPA Suite) The database objects required for operating Oracle BPA Suite have already been created (Page 221) (for example.2.exe file. 5. Click on Install Oracle Business Process Repository. click on Yes. doubleclick on the OracleBPA. The installation is complete and the installation program closes. The Select target path page opens. Otherwise. 8. Ensure that all languages you want to provide are installed. The Select Language page opens. The Connect to already configured Oracle database instance page opens. The program directory for Oracle BPA Suite is created. 13. To use the installation directory suggested in the Target folder box. 14. Disable all check boxes except the Oracle Business Process Repository Site Manager check box. Click on Next. Click on Next. enter a name in the Program folder box or select the program folder in the Existing folders box. click on Change. 9. Activate Oracle. you need to click on the program icon to run the program. The database may be installed locally or on a different computer. Select the installation directory. 22 . Click on Connect to already configured Oracle database instance. 11. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. 12. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. and then click on Next. The default name of the database is BPA. and service name for the database. The Select Components page opens. Decide whether or not the program is to be installed as a Windows service by enabling the relevant option button. If you install it as a Windows service. 10. Click on Next. 7. Enter the server.Oracle BPA Suite Installation and Administration Guide 6. port. Click on Next. Click on Next. To use a different name. To install the products in a directory different from the one suggested. this step is skipped and the directory in which the other products are installed is used. click on Next. and then click on OK. it will be launched automatically with the operating system. Click on Next. Enable the check boxes for the languages in which you want to install the program. Select the program directory in which to place the program shortcut. If other Oracle BPA Suite products are already installed on the computer. Click on Next. 2. Click on Next.g. click on Yes. The installation is complete. If the installation media start page is not displayed automatically. Otherwise. and the installation program closes. and you achieve better performance and higher availability. Insert the Oracle BPA Suite installation media into your drive. If other Oracle BPA Suite products are already installed on the computer. 6.2. If your settings are correct. you run the risk of completely exhausting the memory in the tablespaces. but the database objects required for operating Oracle BPA Suite have not been created (Page 221) there yet. this step is skipped and the directory in which the other products are installed is used. You should set the tablespaces for automatic. The installation program's Welcome page opens. The components will now be installed. regular monitoring (e. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). Click on Finish. The license agreement is displayed. Please read it carefully.exe file. doubleclick on the OracleBPA. we recommend that you work with two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. Click on Additional Installations.Oracle BPA Suite Installation and Administration Guide 15. If the option for automatic growth is not set. This keeps the two systems from competing for resources. Procedure 1.4. 2. To accept the license agreement.2 Step-by-step . unlimited growth. Ensure that Oracle SQLPlus is installed.Configure and connect existing Oracle database instance You already have an Oracle database. 4. 3. 23 .3. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. Check your settings in the summary. 5. Click on Install Oracle Business Process Repository. 16. The Select target path page opens. If you use Oracle Business Process Publisher. click on Next. Click on Next. The Select Language page opens. 9. Click on Next. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. Disable all check boxes except the Oracle Business Process Repository Site Manager check box. and then click on Next. If the check is successful. the dialog box Configure and Connect Existing Oracle Database Instance opens. 12. To install the products in a directory different from the one suggested. 14.Oracle BPA Suite Installation and Administration Guide 7. this step is skipped and the directory in which the other products are installed is used. Click on Next. To use a different name. Click on Configure and Connect Existing Oracle Database Instance. Enable the check boxes for the languages in which you want to install the program. enter a name in the Program folder box or select the program folder in the Existing folders box. an error message is output. If other Oracle BPA Suite products are already installed on the computer. port number. click on Next. 15. 13. Ensure that all languages you want to provide are installed. Click on Next. Activate Oracle. Select the installation directory. and then click on OK. service name for the database. To use the installation directory suggested in the Target folder box. The Select Components page opens. 10. verify and correct the server name. 16. The database may be installed locally or on a different computer. The program directory for Oracle BPA Suite is created. If the check is not successful. Select the program directory in which to place the program shortcut. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. The installation program checks whether an sqlplus command is installed and whether a link can be established to it. Click on User-defined (recommended for 50 or more users). Click on Next. 24 . If this happens. 11. and the password of the SYSTEM user. Click on Next. 8. click on Change. The installation is complete. Procedure 1. Select the data tablespace and the index tablespace in the dialog box.4. Click on Next. Click on Install Oracle Business Process Repository. 6. Check your settings in the summary.Create new Oracle database instance You set up (Page 221) a new Oracle database instance and prepare it for use with Oracle Business Process Analysis Suite.exe file. it will be launched automatically with the operating system. To install the products in a directory different from the one suggested. Click on Next. 18. Click on Finish. To accept the license agreement.3 Step-by-step . 20. The components will now be installed. 25 .2. click on Yes. 3.Oracle BPA Suite Installation and Administration Guide 17. 5. Please read it carefully. The installation program's Welcome page opens. Select the installation directory. Click on Next. 2. Click on Next. The license agreement is displayed. click on Change. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. and the installation program closes. 2. click on Next. Ensure that Oracle SQLPlus is installed. To use the installation directory suggested in the Target folder box. you need to click on the program icon to run the program. If your settings are correct. Insert the Oracle BPA Suite installation media into your drive. 19. If you install it as a Windows service. Decide whether or not the program is to be installed as a Windows service by enabling the relevant option button. If the installation media start page is not displayed automatically. Otherwise. doubleclick on the OracleBPA. click on Next. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)).3. The Select target path page opens. Click on Additional Installations. 4. and then click on OK. 7. 14. Ensure that all languages you want to provide are installed. To use a different name. The program directory for Oracle BPA Suite is created. 26 . d. 12. and confirm your entry. This is checked in the next step. Click on Next. To install the database in a different directory than the one suggested. The Create New Oracle Database dialog box opens. etc. 10. and then click on OK. Select the Oracle database installation to be used. and then click on Next. this step is skipped and the directory in which the other products are installed is used. SYSTEM. Select the program directory in which to place the program shortcut. e. box. 13. enter a name in the Program folder box or select the program folder in the Existing folders box. Click on User-defined (recommended for 50 or more users). Activate Oracle. Note that the name of the directory must not contain any country-specific special characters. It must be a port that is not used. a. Click on Next. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. Click on Next. Click on Create New Oracle Database Instance. Disable all check boxes except the Oracle Business Process Repository Site Manager check box. 8. If other Oracle BPA Suite products are already installed on the computer. Select the directory for the database files of the database being created. Port 1521 is the default. The Select Language page opens. Click on Next. Enable the check boxes for the languages in which you want to install the program. Click on Next. 11. The Select Components page opens. click on the Browse button. Enter the port number of the new Oracle Listener. 9.Oracle BPA Suite Installation and Administration Guide Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. f. b. The database may be installed locally or on a different computer. c. The name of the new database is BPA. Enter the password for the system users in the Password for SYS. Select the installation directory. click on Next. To use the installation directory suggested in the Target folder box. Click on Install Oracle Business Process Repository. If your settings are correct.3. Click on Finish. To accept the license agreement.2.4. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). The installation program's Welcome page opens. 2. 6. click on Yes. The license agreement is displayed. doubleclick on the OracleBPA. 5. If other Oracle BPA Suite products are already installed on the computer. 17. The components will now be installed. and the installation program closes.4 Step-by-step . Click on Additional Installations. If the installation media start page is not displayed automatically. click on Next. Please read it carefully. The installation is complete. you need to click on the program icon to run the program. and then click on OK. 16. 3. Check your settings in the summary. Click on Next. 7.Oracle BPA Suite Installation and Administration Guide 15. Click on Next. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. Decide whether or not the program is to be installed as a Windows service by enabling the relevant check box.exe file. 2. 27 . The Select target path page opens.Microsoft SQL Server You set up (Page 227) a new Microsoft SQL Server and prepare it for use with Oracle Business Process Analysis Suite. Insert the Oracle BPA Suite installation media into your drive. click on Change. Otherwise. Procedure 1. 4. this step is skipped and the directory in which the other products are installed is used. If you install it as a Windows service. To install the products in a directory different from the one suggested. it will be launched automatically with the operating system. The Select Language page opens. The components will now be installed.2. Click on Next. 28 . Click on Next. If you install it as a Windows service. and then click on Next.3. Check your settings in the summary. 8. 10. The program directory for Oracle BPA Suite is created. Otherwise. 12. Select the program directory in which to place the program shortcut. Enable the check boxes for the languages in which you want to install the program. Click on User-defined (recommended for 50 or more users). Decide whether or not the program is to be installed as a Windows service by enabling the relevant option button. you need to click on the program icon to run the program. To use a different name. and click on Next. Click on Finish. Click on Next. it will be launched automatically with the operating system. The installation is complete.5 Step-by-step . The Select Components page opens.IBM DB2 You set up (Page 231) a new DB2 server and prepare it for use with Oracle Business Process Analysis Suite. 15. If other Oracle BPA Suite products are already installed on the computer. Ensure that all languages you want to provide are installed. 14. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). If your settings are correct. enter a name in the Program folder box or select the program folder in the Existing folders box. 13. and the installation program closes. Enable the Microsoft SQL Server option. 9. 11. Disable all check boxes except the Oracle Business Process Repository Site Manager check box. click on Next. this step is skipped and the directory in which the other products are installed is used.4. 2.Oracle BPA Suite Installation and Administration Guide Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. Procedure 1. The Select Language page opens. 10. Disable all check boxes except the Oracle Business Process Repository Site Manager check box. Click on Additional Installations. and then click on OK. To accept the license agreement. this step is skipped and the directory in which the other products are installed is used. To use the installation directory suggested in the Target folder box. and click on Next. Insert the Oracle BPA Suite installation media into your drive. 9. To install the products in a directory different from the one suggested. Click on Next. enter a name in the Program folder box or select the program folder in the Existing folders box. Click on Next.exe file. this step is skipped and the directory in which the other products are installed is used. The Select target path page opens. To use a different name. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. 11. 8. The installation program's Welcome page opens. Select the installation directory. 4. The license agreement is displayed. 6. Click on Next. 29 .Oracle BPA Suite Installation and Administration Guide 2. Please read it carefully. 3. 12. If the installation media start page is not displayed automatically. Click on Next. 5. Ensure that all languages you want to provide are installed. doubleclick on the OracleBPA. Click on Install Oracle Business Process Repository. Enable the check boxes for the languages in which you want to install the program. click on Next. Enable IBM DB2. Click on User-defined (recommended for 50 or more users). The program directory for Oracle BPA Suite is created. Select the program directory in which to place the program shortcut. If other Oracle BPA Suite products are already installed on the computer. The Select Components page opens. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. click on Change. and then click on Next. If other Oracle BPA Suite products are already installed on the computer. click on Yes. 7. The components will now be installed. Run Oracle Business Process Repository setup on the computer where your Web server is installed. Oracle BPA Suite Web Client Components consist of passive Web server components (e.g. Otherwise. you need to click on the program icon to run the program. and the installation program closes. <C:\inetpub\tomcat\>. If you install it as a Windows service.Oracle BPA Suite Installation and Administration Guide 13. Oracle BPA Suite Web Client Components and HTML Generator The index. It is launched every time a database is created.html and aris_database. Click on Next. The installation is complete. e. or renamed. please refer to the chapter on HTML Generator . If your settings are correct. you need to specify one of the following settings: Map a drive to the WWW root of the Web server. 2. Check your settings in the summary.4 Oracle BPA Suite Web Client Components If you want to use Oracle BPA Suite via a browser.cfg of Oracle Business Process Repository.html files are updated by the HTML Generator during system operation (for further information. Decide whether or not the program is to be installed as a Windows service by enabling the relevant option button. you need to install Oracle BPA Suite Web Client Components.2. 14. The HTML Generator is configured using the files defaultServerSettings. HTML files) only. Click on Finish. Enter the path to the WWW root. click on Next.4. and it uses the templates located in the directory Oracle Business Process Repository/templates/htmlgen.Current database lists in the Administration Guide). Oracle BPA Suite Web Client Components and Web server Before your Web server can use Oracle BPA Suite Web Client Components.g. The following directories are created: /lan 30 . it will be launched automatically with the operating system. deleted. 15.cfg and userServerSettings. cfg file.cfg and add the following entry: <profiles> <public ssl="443" /> </profiles> Please note that the output and backup paths must be modified accordingly in the userServerSettings. /ssl If you select this directory for launching Java-based Oracle BPA Suite products. open the file userServerSettings.Oracle BPA Suite Installation and Administration Guide This is the start directory commonly used. Note To enable SSL encryption. please refer to the chapter on SSL encryption of data transmission via Secure Socket Layer in the Administration Guide). you need to adjust the paths on the computer on which Oracle Business Process Repository Site Manager is installed. If your work is not limited to the use of only one Oracle Business Process Repository. they are run as an application. It runs the Java-based Oracle BPA Suite products as an applet and enables direct access to the Oracle Business Process Repository. the data exchange is encrypted (for further information. /app If you select this directory for launching Java-based Oracle BPA Suite products. Insert the following entry: <htmlgen> path="e:/inetpub/wwwroot/bpa11"/><backuppath path="e:/inetpub/wwwroot/bpa11/backup"/> </htmlgen> 31 . please refer to the chapter on Execution as application or applet in the Administration Guide). not as an applet (for further information. g. click on Next. The installation program's Welcome page opens. Insert the Oracle BPA Suite installation media into your drive. Enter the desired path in the Path box. click on the name of your drive in Windows Explorer and run the OracleBPA. Click on Next. Click on USER-DEFINED (ADVANCED INSTALLATION). Click on OK. click on Yes. Select the installation directory. This ensures that your changes are preserved in future update installations.exe program. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). 8. 3. The other Oracle Business Process Repository configuration files are overwritten for each installation. 4. Procedure 1. 2. click on Browse.html" database_template="aris_database_ssl. e. 5. Click on Next.Oracle BPA Suite Installation and Administration Guide You make other changes in the same way: <htmlgen> <appserver name=“myspecialhost" /> <genlist> <genfile target_dir="ssl" target_name="dblist.html"/> </genlist> </htmlgen> Warning Please only use the file userServerSettings. 7. on your active Web server. Click on Next. 9. To install the program in a directory different from the one suggested. If the start page is not displayed automatically. Click on Install Oracle Business Process Repository. Click on Additional Installations. 6. To use the installation directory suggested in the Target folder box. Once you have read the license agreements and accept them.cfg to change the configuration. Disable all check boxes except Oracle BPA Suite Web client components. or navigate to the desired directory in the Directories box. recommended for 50 or more users. 32 . The Select target path page opens. To install the program in a directory different from the one suggested. These pages contain the database lists that are generated by the HTML Generator whenever Oracle BPA Suite deletes or adds databases or changes their names. Select the installation directory for your Oracle BPA Suite Web Client Components files.html are located in the directory \html. Click on Next. Warning Please only use the file userServerSettings. on your active Web server.html. e.Oracle BPA Suite Installation and Administration Guide 10. click on Next. Check your settings in the summary.cfg to change the configuration. Note If you install Oracle Business Process Repository Site Manager and Oracle BPA Suite Web Client Components in one step. To use the suggested installation directory. they reside in the directory \html\<languageid>. For multilingual pages. or navigate to the desired directory in the Directories box. For monolingual pages. the start pages index_app. The components will now be installed. 11. the installation program enters the path to the HTML Generator in the file setupServerSettings.html. If your settings are correct. 12. The installation is complete and the installation program closes. A path is relative within the directory so that you can change the name of the path specified during installation without any negative impact. and index_ssl. index_lan. Click on Finish. The installation process generates the \html directory in the specified path. Enter the desired path in the Path box. The other Oracle Business Process Repository configuration files are overwritten for each installation. 33 .cfg of the Oracle Business Process Repository Site Manager computer. Note that the name of the installation directory must not contain any country-specific special characters.g. click on Next and continue with the next step. This ensures that your changes are preserved in future update installations. click on Browse. Click on OK. All Oracle BPA Suite clients use Oracle Business Process Repository to access the database server and thus work with a common data basis. runtime behavior might improve. The minimum system requirements must be met in order for the Oracle BPA Suite products to work properly. additional memory. Meeting the recommended system requirements will assure good performance even with large data volumes. large databases can involve extended runtimes. backup and restore functions may require more RAM. a faster processor. system configuration. For simultaneous use of other applications.5 Oracle Business Process Repository installations (Unix operating system) This chapter describes installations related to Oracle Business Process Repository that can be performed under a Unix operating system. the description of settings and features may differ from actual settings and features. minimum and recommended system requirements are specified. setting up. In general.Oracle BPA Suite Installation and Administration Guide 2. To ensure optimum load distribution and better protection against failure. and software requirements of the various server and client computers for Oracle BPA Suite. and using the product. more than one Oracle Business Process Repository can be used. Please read this file and take the information into account when installing. Use of report. if more RAM is available than listed below. The default server includes: Oracle Business Process Repository Oracle Business Process Repository Site Manager Oracle BPA Suite Converter This section describes processor. In some cases. or system extension may be required. memory. it is advisable to use up-to-date hardware taking into account the number of users who will be accessing the same Oracle Business Process Repository. Information about discrepancies is provided in the Readme file that accompanies the product. Depending on the application scenario (e. On the other hand. Since manual and software are subject to different production cycles.g. Merge or Simulation). 34 . Note This manual describes the settings and features as they were at the time of print. 512 MB 35 . If the memory is insufficient. the export process is canceled.4 GHz Minimum Intel Pentium IV 2. the maximum size of a Virtual Machine (VM) is 1 GB.Oracle BPA Suite Installation and Administration Guide Oracle Business Process Repository saves configuration data at the operating system level. We strongly recommend protection at the operating system level to minimize the risk of data misuse.4 GHz RAM 64-bit system 2 GB RAM 32-bit system 1 GB RAM In 32-bit systems.2 GB main memory for Oracle Business Process Repository. Please also note the information on script development (Page 331). The system requirements depend on the number of users (1 GB main memory for 50 users) and use of certain features. we recommend a 64-bit Windows installation or a Unix installation due to the upper memory limit of 1. The RAM required for JavaScript reports varies greatly. If you create a Publisher export and use links to large files (>15 MB). If you want to run report scripts that process large quantities of database items. you may need more memory for your Oracle Business Process Repository. Hardware Processor Recommended Intel Pentium IV 3. Communication between clients and Oracle Business Process Repository takes place via the CORBA protocol IIOP (Internet Inter Object Request Broker Protocol). SSL capability is already integrated into Oracle BPA Suite and only needs to be activated when needed.Oracle BPA Suite Installation and Administration Guide Software Operating systems Network Details Depends on the database systems used.6 for your operating system. all applications that are linked in your models should be installed. you must have Adobe Reader and Microsoft Office version 2000. If you use reports to import data from Excel tables. 2003. no firewall is required. Output If. However. Please first install the appropriate JRE 1. or 2007 installed. 2002. In addition. you want to output documents in PDF format using Microsoft Word or Microsoft Excel. High-speed network (>=100 Mbit) between database server and Oracle Business Process Repository. Oracle Corporation offers customized solutions. Note Oracle Business Process Repository does not support NAT (Network Address Translation) by default. If Oracle BPA Suite clients within the intranet or in a VPN environment (Virtual Private Network) access Oracle Business Process Repository. please ensure that the tables have been saved in XLS format. for example. If pop-up blockers are activated for the domain. JRE Oracle Business Process Repository requires JRE 1. Protocols (Page 249) Data exchange between browser-capable Oracle BPA Suite clients and Oracle Business Process Repository can be encrypted with SSL (1024-bit RSA).6. it may not always be possible to open report output in PDF format from a Publisher export. Additional information is available from our support. The following installation options exist: Oracle Business Process Repository and Oracle Business Process Repository Site Manager Only Oracle Business Process Repository Only Oracle Business Process Repository Site Manager 36 . Procedure 1. 2.xxxxxx. To change the installation path. for example computerxyz. Insert the installation media. You must enter a fully qualified name for the computer on which Oracle Business Process Repository Site Manager is installed. Specify the following options for the installation of Oracle Business Process Repository: -bpr_type BS -jvm <Path of the Java Runtime Environment> -sitemanager <Host Name of Oracle Business Process Repository Site Manager> 4. Copy the file install_bpr11gR1. 37 . perform the installation on every computer you intend to use as an Oracle Business Process Repository in the Oracle BPA Suite Site. and enter . You can start the file install_bpr11gR1. specify the additional option installdir <absolute path of the desired installation directory>./install_bpr11gR1. 3. To do so. and navigate to the directory Setups/Unix Linux/Oracle Business Process Repository.sh from any directory.sh to your hard drive. Ensure that the system requirements are met for all products and features (please refer to chapter Administration.com. you need to enter the full path in front of the file name. Tip To install an Oracle BPA Suite Site.1 Oracle Business Process Repository This section describes in detail the steps that must be performed when you install Oracle Business Process Repository.Oracle BPA Suite Installation and Administration Guide 2.domainxyz. Hardware and software requirements).5. Switch to the directory in which the Oracle Business Process Repository installation script is located.sh [business_server_options] to install Oracle Business Process Repository.xxxxxx.xxxxxx. Step-by-step instructions Prerequisite A database instance for Oracle BPA Suite must have been created on the database server. 2.sh/setup/backup.sh [site_manager_options] to install Oracle Business Process Repository Site Manager.sh script in the install_bpa11.sh/setup folder. Insert the installation media. Step-by-step instructions Procedure 1.xxxxxx.xxxxxx.data. and enter sh install_bpr11gR1. The software is ready to run immediately. The script extracts itself and stores the files in the /install_bpa11. Copy the file install_bpr11gR1.sh subdirectory.sh in the directory install_bpa11.xxxxxx./install_bpa11. use the launcher y-serverlauncher.5.sh to your hard drive.2 Oracle Business Process Repository Site Manager This section describes in detail the steps that must be performed when you install Oracle Business Process Repository Site Manager. You can reconfigure the software at any time after installation with the configure. To start Oracle Business Process Repository.sh.xxxxxx. Note The Oracle BPA Suite Web Client Components (Page 41) are installed automatically at the same time.conf in the directory .Oracle BPA Suite Installation and Administration Guide The parameters are stored in the file YYYMMDD-HHMMDD. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221)). Warning You may install Oracle Business Process Repository Site Manager only once for each Oracle BPA Suite Site. Configuration is performed automatically with the installation. and navigate to the directory Setups/Unix Linux/Oracle Business Process Repository. Switch to the directory in which the Oracle Business Process Repository installation script is located. Specify the following options for the installation of Oracle Business Process Repository Site Manager: -bpr_type SM -jvm <Path of the Java Runtime Environment> -dbserver <Host name of the database server> 38 .xxxxxx.xxxxxx. 2. sh.sh in the directory install_bpa11.sh/setup/backup. specify the additional option installdir <absolute path of the desired installation directory>.sh in the directory install_bpa11. To start Oracle Business Process Repository. use the launcher y-serverlauncher.sh/setup.5. Tip To install an Oracle BPA Suite Site.com.xxxxxx.xxxxxx. 2. Step-by-step instructions Prerequisite A database instance for Oracle BPA Suite must have been created on the database server.conf in the directory .xxxxxx.Oracle BPA Suite Installation and Administration Guide -dbport <Port of the database server> -dbinstance <Name of the database instance> You must enter a fully qualified name for the database server.xxxxxx. 39 .xxxxxx. You can start the file install_bpr11gR1. Configuration is performed automatically with the installation. The software is ready to run immediately. The script extracts itself and stores the files in the /install_bpa11./install_bpa11.domainxyz. You can reconfigure the software at any time after installation with the script configure. To do so.3 Oracle Business Process Repository and Oracle Business Process Repository Site Manager This section describes in detail the steps that must be performed when you install Oracle Business Process Repository and Oracle Business Process Repository Site Manager simultaneously. for example. computerxyz. that is. perform the installation on every computer you intend to use as an Oracle Business Process Repository in the Oracle BPA Suite Site.sh subdirectory.sh from any directory. you need to enter the full path in front of the file name. The parameters are stored in the file YYYMMDD-HHMMDD. To change the installation path.data. xxxxxx. use the launcher y-serverlauncher. specify the additional option installdir <absolute path of the desired installation directory>.sh.xxxxxx.xxxxxx. Switch to the directory in which the Oracle Business Process Repository installation script is located. 2.domainxyz. Insert the installation media. The script extracts itself and stores the files in the /install_bpa11. and navigate to the directory Setups/Unix Linux/Oracle Business Process Repository. you need to enter the full path in front of the file name.sh in the directory install_bpa11.xxxxxx.xxxxxx. If To change the installation path. that is.xxxxxx.sh subdirectory. To do so.data.sh to your hard drive. 40 . and enter sh install_bpr11gR1.xxxxxx.sh/setup/backup.sh in the directory install_bpa11.sh [site_manager_options] to install Oracle Business Process Repository and Oracle Business Process Repository Site Manager. Copy the file install_bpr11gR1. Specify the following options for the installation of Oracle Business Process Repository and Oracle Business Process Repository Site Manager: -bpr_type BS_SM -jvm <Path of the Java Runtime Environment> -dbserver <Host name of the database server> -dbport <Port of the database server> -dbinstance <Name of the database instance> You must enter a fully qualified name for the database server.conf in the directory .sh from any directory. Configuration is performed automatically with the installation. To start Oracle Business Process Repository. You can reconfigure the software at any time after installation with the script configure. The parameters are stored in the file YYYMMDD-HHMMDD. You can start the file install_bpr11gR1. The software is ready to run immediately. computerxyz. for example.com.Oracle BPA Suite Installation and Administration Guide Procedure 1. Ensure that the system requirements for all products and functionalities are met (see chapter Administration (Page 221))./install_bpa11.sh/setup. e. Run Oracle Business Process Repository setup on the computer where your Web server is installed. please refer to the chapter on HTML Generator .html.4 Oracle BPA Suite Web Client Components When you install Oracle Business Process Repository on a computer with a Unix operating system. deleted.Current database lists in the Administration Guide).cfg and userServerSettings.html are located in the directory \html.g. the start pages index_app.html files are updated by the HTML Generator during system operation (for further information. Oracle BPA Suite Web Client Components consist of passive Web server components (e. These pages contain the database lists that are generated by the HTML Generator whenever Oracle BPA Suite deletes or adds databases or changes their names. Enter the path to the WWW root. and index_ssl. the Oracle BPA Suite Web Client Components are installed automatically at the same time.5. you need to specify one of the following settings: Map a drive to the WWW root of the Web server.html.html and aris_database.Oracle BPA Suite Installation and Administration Guide Note The Oracle BPA Suite Web Client Components (Page 41) are installed automatically at the same time. index_lan. HTML files) only.g. 2. It is launched every time a database is created. The respective language page is located in the directory \html\<languageid>. Oracle BPA Suite Web Client Components and HTML Generator The index. The HTML Generator is configured using the files defaultServerSettings. For multilingual pages.cfg of Oracle Business Process Repository. The following directories are created: /lan 41 . <C:\inetpub\tomcat\>. and it uses the templates located in the directory Oracle Business Process Repository/templates/htmlgen. or renamed. Oracle BPA Suite Web Client Components and Web server Before your Web server can use Oracle BPA Suite Web Client Components. they are run as an application. Insert the following entry: <htmlgen> path="e:/inetpub/wwwroot/bpa11"/><backuppath path="e:/inetpub/wwwroot/bpa11/backup"/> </htmlgen> 42 . the data exchange is encrypted (for further information. open the file userServerSettings.cfg and add the following entry: <profiles> <public ssl="443" /> </profiles> Please note that the output and backup paths must be modified accordingly in the userServerSettings. /app If you select this directory for launching Java-based Oracle BPA Suite products.cfg file. please refer to the chapter on Execution as application or applet in the Administration Guide). /ssl If you select this directory for launching Java-based Oracle BPA Suite products. not as an applet (for further information. Note To enable SSL encryption. It runs the Java-based Oracle BPA Suite products as an applet and enables direct access to the Oracle Business Process Repository. you need to adjust the paths on the computer on which Oracle Business Process Repository Site Manager is installed. please refer to the chapter on SSL encryption of data transmission via Secure Socket Layer in the Administration Guide). If your work is not limited to the use of only one Oracle Business Process Repository.Oracle BPA Suite Installation and Administration Guide This is the start directory commonly used. 2. Use the script y-serverstopper.html" database_template="aris_database_ssl.5 Uninstall To uninstall one or more of the following components. you first have to exit Oracle Business Process Repository and then delete the component. The other Oracle Business Process Repository configuration files are overwritten for each installation. Delete the folder <installation directory>/server.sh in the folder <installation directory>/server. 2.xxxxxx 43 .cfg to change the configuration.html"/> </genlist> </htmlgen> Warning Please only use the file userServerSettings. This ensures that your changes are preserved in future update installations.xxxxxx to exit Oracle Business Process Repository.xxxxxx: rm –r <installation directory>/server. Procedure 1.5.Oracle BPA Suite Installation and Administration Guide You make other changes in the same way: <htmlgen> <appserver name=“myspecialhost" /> <genlist> <genfile target_dir="ssl" target_name="dblist. 2. require a Web application server (for example Apache Tomcat) as runtime environment. The browser caches should be cleared after an update installation. Swimlane models cannot be exported optimally using a Derby database. reports are run by Oracle Business Process Publisher Server. You can additionally install a Report Server (Page 194) to optimize system performance when running reports Note Due to methodological and functional changes. up to 10 users can access a Publisher export simultaneously. you require an external database system. After the standard installation. you must perform exports again. please observe the manufacturers' instructions. these systems enable all users to simultaneously work on a Publisher export. you may no longer be able to open an existing Publisher export. If this happens.6 Oracle Business Process Publisher Server installations This chapter describes the Oracle Business Process Publisher Server installations for the approved Web Application Servers. Oracle Business Process Publisher Servers manage every Publisher export. Java Servlets and Java Server Pages (JSP) are used. A Publisher export is a Web application based on J2EE. For a larger number of users.Oracle BPA Suite Installation and Administration Guide 2.6. in addition to a Java environment (JDK). which.1 Apache Tomcat Web Application Server under Windows This chapter describes the installation of Apache Tomcat Web Application Server under Microsoft Windows. Note When you combine various technologies. The data is held in a relational database system and is exchanged with the program via a JDBC interface. Depending on the Oracle Business Process Publisher Server license purchased. We cannot guarantee proper 44 . With this database system. The standard database system and Apache Tomcat Web Application Server are automatically installed if you select the standard installation for Oracle Business Process Publisher Server. particularly announcements concerning releases on their Internet pages. Click on Install Oracle Business Process Publisher Server. Select the installation directory. Depending on the Oracle Business Process Publisher Server license purchased. Once you have read the license agreements and accept them. 6. click on Yes. 45 . Ensure that the system requirements for all products and functionalities are met. Insert the Oracle BPA Suite installation media into the appropriate drive.1. The installation program's Welcome page opens. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. Click on Additional Installations.exe program. these systems enable all users to simultaneously work on exports. click on the name of your drive in Windows Explorer and run the OracleBPA. The Select target path page opens. or contact Oracle Corporation support. 2. and then click on OK. click on Next. Procedure 1. To install the products in a directory different from the one suggested. 4. this step is skipped and the directory in which the other products are installed is used.Oracle BPA Suite Installation and Administration Guide functioning of supported third-party systems. With this database system. click on Change.1 Step-by-step instructions (standard database) This procedure describes the standard installation of Apache Tomcat Web Application Server. Always follow the instructions provided in the installation manuals of the relevant manufacturer. To use the installation directory suggested in the Target folder box. 5. 3. 7. If other Oracle BPA Suite products are already installed on the computer. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. up to 10 users can access exports simultaneously. Click on Next. you need the Oracle (Page 288) database system or MS SQL Server 2005. For a larger number of users.6. Click on Next. If the start page is not displayed automatically. 2. The Select program folder page opens. After the standard installation of Oracle Business Process Publisher Server. this step is skipped and the directory in which the other products are installed is used.g. Communicate the URL (<root directory of Oracle Business Process Publisher Server>/<context>) that allows users to access every Publisher export and administrators to manage exports. If you have installed Oracle Business Process Publisher Server on an external computer. The port number you entered must not be used by another application (e. If your settings are correct. change the IP address in the configuration file. enter a name in the Program folder box or select the program folder in the Existing folders box. Click on Next. 10. To use a different name. and then click on Next. the URL is http://<server name>:9090/businesspublisher if you did not change the default settings during installation. Select the Oracle Business Process Publisher Server option. you must start Oracle Business Process Publisher Server and communicate the URL. ensure that the appropriate database is installed and adjust the database management system for use with Oracle Business Process Publisher Server (Page 233). click on Next. To create a Publisher export and enable users to work with it. The components will now be installed. The installation is complete and the installation program closes. After the standard installation of Oracle Business Process Publisher Server. 13. Web server). The Enter port number page opens. If other Oracle BPA Suite products are already installed on the computer. Click on Next. 9. Click on Finish. Check your settings in the summary. 11. 12. the URL is http://<server name>:9090/businesspublisher if you did not change the default settings during installation. Enable the Standard Database System check box if you want to use the standard database. 16. The program directory for Oracle BPA Suite is created. 15.Oracle BPA Suite Installation and Administration Guide 8. 14. Select the program directory in which to place the program shortcut. Enter the port number for accessing Oracle Business Process Publisher Server via a browser. 46 . If you want to use another database instead of the Derby database. If you prefer another name. Prerequisite You have created an Oracle database and configured it as follows. all enabled users can work simultaneously with a Publisher export.2 Step-by-step instructions (Oracle database) Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. This description assumes you are using Apache Tomcat. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP. regular monitoring (e.g. GRANT ALTER SESSION TO ARISBP. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. This keeps the two systems from competing for resources. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). If you use this database. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. If the option for automatic growth is not set. We recommend that you set the tablespaces for automatic. If you install a database yourself. you must customize the configuration file webappserver. Otherwise. Use of the database character set AL32UTF8 is mandatory. To use other names or existing tablespaces. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. you run the risk of completely exhausting the memory in the tablespaces. always follow the instructions provided in the Oracle Installation Guide.cfg (see below).Oracle BPA Suite Installation and Administration Guide 2.xml (see below). We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher.1. and you achieve better performance and higher availability. 47 . weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time.6. The name of the Oracle user is assumed to be ARISBP. You can select any password. unlimited growth. Enter it in the configuration file businesspublisher. We recommend a block size of 8K. .Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle.jdbc.apache.apache.xml in the Oracle Business Process Publisher Server installation directory .DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" <!-. Open the file businesspublisher.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname. For an explanation of these values.\BPServer\tomcat\conf\catalina\localhost\ with a text editor. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. go to: http://jakarta. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. port.org/commons/dbcp/configuration. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3. Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax..org/commons/dbcp/configuration. GRANT QUERY REWRITE TO ARISBP. 48 .Oracle BPA Suite Installation and Administration Guide GRANT CREATE TABLE TO ARISBP. GRANT CREATE VIEW TO ARISBP.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.cfg in the Oracle Business Process Publisher Server installation directory . Procedure 1. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. 2.sql. Open the file webappserver.html (http://jakarta.html)--> username="ARISBP" password="ARISBP" <!-.Configure the DBCP (database connection pool) with these values.driver. idsscheer.String</env-entry-type> <env-entry-value> com. Ensure that the system requirements for all products and functionalities are met.\BPServer\tomcat\common\lib.. Note When you combine various technologies.3. click on the name of your drive in Windows Explorer and run the OracleBPA. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites). b. We cannot guarantee proper functioning of supported third-party systems.Oracle BPA Suite Installation and Administration Guide a.lang. You find the file on the installation media.jar exists in the Oracle Business Process Publisher Server installation directory . Insert the Oracle BPA Suite installation media into the appropriate drive. Ensure that the JDBC driver ojdbc5. Install Oracle Business Process Publisher Server Procedure 1.aris.2.0. Always follow the instructions provided in the installation manuals of the relevant manufacturer.application. 2.businesspublisher. or contact Oracle Corporation support.database. We assume that you are using version 10. particularly announcements concerning releases on their Internet pages. 49 . Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.exe program.A OracleDAO</env-entryvalue> </env-entry> 4.dao. please maintain them here. If the start page is not displayed automatically. please observe the manufacturers' instructions. enter a name in the Program folder box or select the program folder in the Existing folders box. 12. and then click on OK. To use an Oracle database. this step is skipped and the directory in which the other products are installed is used. 10. Select the program directory in which to place the program shortcut. The port number you entered must not be used by another application (e. To install the products in a directory different from the one suggested. Select the Oracle Business Process Publisher Server option. 6. 9. Select the installation directory.g. 7. The Select program folder page opens. Click on Next. To use a different name. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. The database may be installed locally or on a different computer. Click on Connect to already configured Oracle database instance. Click on Next. To use the installation directory suggested in the Target folder box. click on Yes. Click on Additional Installations. The program directory for Oracle BPA Suite is created. 5. click on Next. and then click on Next. 11. Click on Install Oracle Business Process Publisher Server.Oracle BPA Suite Installation and Administration Guide 3. 8. The Select target path page opens. The installation program's Welcome page opens. click on Change. Click on Next. Click on Next. If other Oracle BPA Suite products are already installed on the computer. If other Oracle BPA Suite products are already installed on the computer. Enter the port number for accessing Oracle Business Process Publisher Server via a browser. enable the Oracle Database check box. The Connect to already configured Oracle database instance page opens. 13. this step is skipped and the directory in which the other products are installed is used. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. Web server). 50 . The Enter port number page opens. 4. Once you have read the license agreements and accept them. Prerequisite You have created an Oracle database and configured it as follows. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. Use of the database character set AL32UTF8 is mandatory. and you achieve better performance and higher availability. regular monitoring (e. unlimited growth. To use other names or existing tablespaces. Check your settings in the summary. you run the risk of completely exhausting the memory in the tablespaces.g. If the option for automatic growth is not set. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data).cfg (see below). 2. This keeps the two systems from competing for resources. and database user (ARISBP is set as default). Click on Next. This description assumes you are using Apache Tomcat. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. service name of your database (BUPU1020 is set as default). click on Next. all enabled users can work simultaneously with a Publisher export. 16. you must customize the configuration file webappserver. The components will now be installed. We recommend that you set the tablespaces for automatic. The installation is complete and the installation program closes. If your settings are correct.1. Click on Finish.6.Oracle BPA Suite Installation and Administration Guide 14. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. 51 .3 Step-by-step instructions (existing Oracle database)_tomcat Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. We recommend a block size of 8K. If you install a database yourself. Enter the port number (1521 is set as default). If you use this database. 15. always follow the instructions provided in the Oracle Installation Guide. Otherwise. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP. 2.xml (see below). GRANT QUERY REWRITE TO ARISBP.\BPServer\tomcat\conf\catalina\localhost\ with a text editor. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax. Open the file businesspublisher. Procedure 1.xml in the Oracle Business Process Publisher Server installation directory .DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" 52 . GRANT ALTER SESSION TO ARISBP. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. The name of the Oracle user is assumed to be ARISBP.Oracle BPA Suite Installation and Administration Guide weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time..sql. If you prefer another name. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. GRANT CREATE VIEW TO ARISBP. Enter it in the configuration file businesspublisher. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. You can select any password. GRANT CREATE TABLE TO ARISBP. For an explanation of these values. b. port.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.cfg in the Oracle Business Process Publisher Server installation directory .database.jdbc. Open the file webappserver.lang. please maintain them here.aris.apache.html)--> username="ARISBP" password="ARISBP" <!-. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3.dao.businesspublisher.org/commons/dbcp/configuration. a.Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle.org/commons/dbcp/configuration.driver.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname.A OracleDAO</env-entryvalue> </env-entry> 53 .Configure the DBCP (database connection pool) with these values.application. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.String</env-entry-type> <env-entry-value> com. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites).Oracle BPA Suite Installation and Administration Guide <!-.html (http://jakarta. go to: http://jakarta..idsscheer.apache. this step is skipped and the directory in which the other products are installed is used. Click on Next.3. Click on Additional Installations. We assume that you are using version 10. particularly announcements concerning releases on their Internet pages. and then click on OK. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. To use the installation directory suggested in the Target folder box. please observe the manufacturers' instructions. The installation program's Welcome page opens. Click on Install Oracle Business Process Publisher Server. 3. Note When you combine various technologies. 4. The Select target path page opens.. Ensure that the JDBC driver ojdbc5. Always follow the instructions provided in the installation manuals of the relevant manufacturer. We cannot guarantee proper functioning of supported third-party systems.Oracle BPA Suite Installation and Administration Guide 4.\BPServer\tomcat\common\lib. If other Oracle BPA Suite products are already installed on the computer.exe program. Install Oracle Business Process Publisher Server Procedure 1. 54 .jar exists in the Oracle Business Process Publisher Server installation directory . click on Next. To install the products in a directory different from the one suggested. 7. Select the installation directory.0. 6. If the start page is not displayed automatically.2. or contact Oracle Corporation support. You find the file on the installation media. click on Change. Once you have read the license agreements and accept them. click on Yes. 5. Click on Next. 2. click on the name of your drive in Windows Explorer and run the OracleBPA. Insert the Oracle BPA Suite installation media into the appropriate drive. Ensure that the system requirements for all products and functionalities are met. If the check is successful. The installation program checks whether an sqlplus command is installed and whether a link can be established to it. Click on Finish. 8. an error message is output. 14. and then click on Next. 9. Click on Next. verify and correct the server name. and the password of the SYSTEM user.Oracle BPA Suite Installation and Administration Guide Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. 13. service name for the database. The program directory for Oracle BPA Suite is created. To use a different name. port number. enter a name in the Program folder box or select the program folder in the Existing folders box. Select the Oracle Business Process Publisher Server option. Click on Configure and Connect Existing Oracle Database Instance. If your settings are correct. 11. Select the data tablespace and the index tablespace in the dialog box. Click on Next. this step is skipped and the directory in which the other products are installed is used. 16. The components will now be installed. Enter the port number for accessing Oracle Business Process Publisher Server via a browser. If the check is not successful. Check your settings in the summary. 10. The installation is complete and the installation program closes. If other Oracle BPA Suite products are already installed on the computer. Click on Next. 12. The port number you entered must not be used by another application (e. 15. The Enter port number page opens. The Select program folder page opens. Click on Next. 55 . the dialog box Configure and Connect Existing Oracle Database Instance opens. If this happens.g. The database may be installed locally or on a different computer. Web server). click on Next. Select the program directory in which to place the program shortcut. cfg (see below). The name of the Oracle user is assumed to be ARISBP. If you install a database yourself. This description assumes you are using Apache Tomcat. regular monitoring (e. Enter it in the configuration file businesspublisher. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP.xml (see below). Use of the database character set AL32UTF8 is mandatory.4 Step-by-step instructions (new Oracle database)_tomcat Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. always follow the instructions provided in the Oracle Installation Guide. unlimited growth. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. To use other names or existing tablespaces. If the option for automatic growth is not set.Oracle BPA Suite Installation and Administration Guide 2. all enabled users can work simultaneously with a Publisher export. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). We recommend that you set the tablespaces for automatic. This keeps the two systems from competing for resources. 56 . The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. You can select any password. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. and you achieve better performance and higher availability. Prerequisite You have created an Oracle database and configured it as follows. Otherwise.g. If you prefer another name.1. you run the risk of completely exhausting the memory in the tablespaces.6. If you use this database. you must customize the configuration file webappserver. We recommend a block size of 8K. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. port.jdbc.Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle. Open the file businesspublisher. GRANT QUERY REWRITE TO ARISBP.\BPServer\tomcat\conf\catalina\localhost\ with a text editor. GRANT CREATE TABLE TO ARISBP.driver.Oracle BPA Suite Installation and Administration Guide GRANT ALTER SESSION TO ARISBP.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" <!-. Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax.html)--> username="ARISBP" password="ARISBP" <!-.sql. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA.org/commons/dbcp/configuration.apache..Configure the DBCP (database connection pool) with these values.xml in the Oracle Business Process Publisher Server installation directory .org/commons/dbcp/configuration. Procedure 1. 2.html (http://jakarta. go to: http://jakarta. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted.apache. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 57 . GRANT CREATE VIEW TO ARISBP. For an explanation of these values. cfg in the Oracle Business Process Publisher Server installation directory .Oracle BPA Suite Installation and Administration Guide 3. We assume that you are using version 10. a. please maintain them here. please observe the manufacturers' instructions.lang.dao.businesspublisher..jar exists in the Oracle Business Process Publisher Server installation directory .0. particularly announcements concerning releases on their Internet pages. You find the file on the installation media.database.aris. Open the file webappserver.A OracleDAO</env-entryvalue> </env-entry> 4. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java. Ensure that the JDBC driver ojdbc5. Always follow the instructions provided in the installation manuals of the relevant manufacturer.. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites). 58 .3. Note When you combine various technologies.idsscheer.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.\BPServer\tomcat\common\lib.2.String</env-entry-type> <env-entry-value> com. or contact Oracle Corporation support. b. We cannot guarantee proper functioning of supported third-party systems.application. this step is skipped and the directory in which the other products are installed is used. 59 . To use a different name. The program directory for Oracle BPA Suite is created. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. The Select program folder page opens. If other Oracle BPA Suite products are already installed on the computer. The installation program's Welcome page opens. Select the program directory in which to place the program shortcut. click on the name of your drive in Windows Explorer and run the OracleBPA. If other Oracle BPA Suite products are already installed on the computer. To install the products in a directory different from the one suggested. Click on Additional Installations. this step is skipped and the directory in which the other products are installed is used. Ensure that the system requirements for all products and functionalities are met. Click on Next. 7. The Enter port number page opens. Once you have read the license agreements and accept them. To use the installation directory suggested in the Target folder box.exe program. and then click on OK. The Select target path page opens. Select the installation directory. click on Yes. If the start page is not displayed automatically. click on Change. Select the Oracle Business Process Publisher Server option. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. 9. 5. Click on Install Oracle Business Process Publisher Server. 6. Insert the Oracle BPA Suite installation media into the appropriate drive. 3. 4. 2. and then click on Next. enter a name in the Program folder box or select the program folder in the Existing folders box.Oracle BPA Suite Installation and Administration Guide Install Oracle Business Process Publisher Server Procedure 1. 8. Click on Next. click on Next. Oracle BPA Suite Installation and Administration Guide 10. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. The components will now be installed. c. Enter the password for the system users in the Password for SYS. 11. 14. Click on Next. enable the Oracle Database check box. b. The Create New Oracle Database Instance dialog box opens. Click on Create New Oracle Database Instance. Click on Next. The port number you entered must not be used by another application (e. The installation is complete and the installation program closes. d. click on the Browse button. f. The database may be installed locally or on a different computer. 60 . click on Next. Check your settings in the summary. SYSTEM. Select the Oracle database installation to be used. It must be a port that is not used. 16. The name of the new database is BPA. Enter the port number of the new Oracle Listener. box. service name of your database (BUPU1020 is set as default). a. Enter the port number for accessing Oracle Business Process Publisher Server via a browser. Click on Next. To install the database in a different directory than the one suggested. and database user (ARISBP is set as default). This is checked in the next step. 13. If your settings are correct. Web server). Note that the name of the directory must not contain any country-specific special characters.g. 12. Click on Next. To use an Oracle database. and then click on OK. Click on Finish. e. Enter the port number (1521 is set as default). Select the directory for the database files of the database being created. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. and confirm your entry. Port 1521 is the default. 15. etc. Oracle BPA Suite Installation and Administration Guide 2.6.1.5 Step-by-step instructions (MS SQL Server 2005 database) Please adjust the system as required to manage Oracle Business Process Publisher in combination with an MS SQL Server 2005 database. If you use the MS SQL Server 2005 database, all users covered by the license can simultaneously work with a Publisher export, which is not possible with the standard database. Prerequisite Copy the file create_db.sql (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a directory of your choice. You have installed Microsoft SQL Server 2005 under MS Windows. Microsoft SQL Server 2005 is not included in the package. Procedure 1. Open the Server properties dialog box. 2. On the Security tab, select the SQL Server and Windows authentication mode option. 3. Create a database using the script create_db.sql. a. Open the script for editing. b. Adjust the path to the database file. Ensure that the path has been created before you run the script. If you specify the ARISBP11 database name, user name, and password according to your choice, you must also change them in the configuration files businesspublisher.xml and webappserver.cfg. c. Ensure that Latin1_General_CI_AI sorting is selected for the COLLATE statement. The script creates the specified data groups. If you have changed the names in the script, you must also change them in the configuration file businesspublisher.xml. ARISBPDATA: contains all database objects ARISBPINDEX: contains all index data d. Copy the JDBC driver jTDS.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the Tomcat installation directory under common/lib. 61 Oracle BPA Suite Installation and Administration Guide 4. Customize the configuration file ..\BPServer\tomcat\conf\catalina\localhost\businesspublisher.xml: a. Ensure that the driverClassName property is set to net.sourceforge.jtds.jdbc.Driver. b. Ensure that the URL has been adjusted correctly, for example as follows: jdbc:jtds:sqlserver://hostname:<Port>/ARISBP11 If you have specified a database name of your choice, use it instead of ARISBP11. If you are using named instances, complete the URL with the following entry: ;instance=<name of instance>, for example, jdbc:jtds:sqlserver://hostname:1433/ARISBP11;instance =MSSQLSRV. c. Change the user name and password. 5. Customize the configuration file ..\BPServer\tomcat\webapps\businesspublisher\config\webappserv er.cfg. a. Ensure that the entries in the following line are correct: <bp-mssql schema="ARISBPDATA" filegroupdata="ARISBPDATA" filegroup-index="ARISBPINDEX" /> If you have changed the names in the script, you must adjust them here. 6. Ensure that the database connection is set for MSSQL. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entryvalue>com.idsscheer.aris.businesspublisher.application.dao.database .AMSSQLDAO</env-entry-value> </env-entry> Tip For additional information about Microsoft SQL Server 2005, visit http://support.microsoft.com/kb/914277/en-us (http://support.microsoft.com/kb/914277/en-us). 62 Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies, please observe the manufacturers' instructions, particularly announcements concerning releases on their Internet pages. We cannot guarantee proper functioning of supported third-party systems. Always follow the instructions provided in the installation manuals of the relevant manufacturer, or contact Oracle Corporation support. Install Oracle Business Process Publisher Server Procedure 1. Ensure that the system requirements for all products and functionalities are met. 2. Insert the Oracle BPA Suite installation media into the appropriate drive. If the start page is not displayed automatically, click on the name of your drive in Windows Explorer and run the OracleBPA.exe program. 3. Click on Additional Installations. 4. Click on Install Oracle Business Process Publisher Server. 5. The installation program's Welcome page opens. Click on Next. 6. Once you have read the license agreements and accept them, click on Yes. The Select target path page opens. If other Oracle BPA Suite products are already installed on the computer, this step is skipped and the directory in which the other products are installed is used. 7. Select the installation directory. To use the installation directory suggested in the Target folder box, click on Next. To install the products in a directory different from the one suggested, click on Change. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box, and then click on OK. Click on Next. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. The Select program folder page opens. 8. Select the program directory in which to place the program shortcut. If other Oracle BPA Suite products are already installed on the computer, this step is skipped and the directory in which the other products are installed is used. The program directory for Oracle BPA 63 Oracle BPA Suite Installation and Administration Guide Suite is created. To use a different name, enter a name in the Program folder box or select the program folder in the Existing folders box, and then click on Next. 9. Select the Oracle Business Process Publisher Server option. The Enter port number page opens. 10. Enter the port number for accessing Oracle Business Process Publisher Server via a browser. The port number you entered must not be used by another application (e.g. Web server). Click on Next. 11. To use an MS SQL Server, enable the MS SQL Server check box. 12. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. Enter the port number (1521 is set as default), service name of your database (BUPU1020 is set as default), and database user (ARISBP is set as default). Click on Next. 13. Check your settings in the summary. If your settings are correct, click on Next. The components will now be installed. 14. Click on Finish. The installation is complete and the installation program closes. Sample script create_db.sql USE master GO CREATE DATABASE [ARISBP11] ON PRIMARY (NAME = N'ARISBPPRIM', FILENAME = N'C:\mssqldata\ARISBP11\ARISBPPRIM.mdf' , SIZE = 10MB , FILEGROWTH = 10MB), FILEGROUP [ARISBPDATA] (NAME = N'ARISBPDATA', FILENAME = N'C:\mssqldata\ARISBP11\ARISBPDATA.ndf' , SIZE = 100MB , FILEGROWTH = 100MB), FILEGROUP [ARISBPINDEX] (NAME = N'ARISBPINDEX', FILENAME = N'C:\mssqldata\ARISBP11\ARISBPINDEX.ndf' , SIZE = 100MB , FILEGROWTH = 100MB) LOG ON (NAME = N'ARISBPLOG', FILENAME = N'C:\mssqldata\ARISBP11\ARISBPLOG.ldf' , SIZE = 10MB , FILEGROWTH = 10MB) COLLATE Latin1_General_CI_AI GO EXEC dbo.sp_dbcmptlevel @dbname=N'ARISBP11', @new_cmptlevel=90 GO BEGIN TRY EXEC [ARISBP11].[dbo].[sp_fulltext_database] @action = 'disable' END TRY BEGIN CATCH END CATCH 64 Oracle BPA Suite Installation and Administration Guide GO ALTER DATABASE [ARISBP11] SET ANSI_NULL_DEFAULT OFF GO ALTER DATABASE [ARISBP11] SET ANSI_NULLS OFF GO ALTER DATABASE [ARISBP11] SET ANSI_PADDING OFF GO ALTER DATABASE [ARISBP11] SET ANSI_WARNINGS OFF GO ALTER DATABASE [ARISBP11] SET ARITHABORT OFF GO ALTER DATABASE [ARISBP11] SET AUTO_CLOSE OFF GO ALTER DATABASE [ARISBP11] SET AUTO_CREATE_STATISTICS ON GO ALTER DATABASE [ARISBP11] SET AUTO_SHRINK OFF GO ALTER DATABASE [ARISBP11] SET AUTO_UPDATE_STATISTICS ON GO ALTER DATABASE [ARISBP11] SET CURSOR_CLOSE_ON_COMMIT OFF GO ALTER DATABASE [ARISBP11] SET CURSOR_DEFAULT GLOBAL GO ALTER DATABASE [ARISBP11] SET CONCAT_NULL_YIELDS_NULL OFF GO ALTER DATABASE [ARISBP11] SET NUMERIC_ROUNDABORT OFF GO ALTER DATABASE [ARISBP11] SET QUOTED_IDENTIFIER OFF GO ALTER DATABASE [ARISBP11] SET RECURSIVE_TRIGGERS ON GO ALTER DATABASE [ARISBP11] SET RECOVERY FULL GO ALTER DATABASE [ARISBP11] SET MULTI_USER GO ALTER DATABASE [ARISBP11] SET PAGE_VERIFY CHECKSUM GO CREATE LOGIN ARISBP11 WITH PASSWORD=N'ARISBP', DEFAULT_DATABASE=[ARISBP11] GO USE [ARISBP11] GO CREATE USER [ARISBP11] FOR LOGIN [ARISBP11] GO CREATE SCHEMA [ARISBPDATA] GO ALTER USER ARISBP11 WITH DEFAULT_SCHEMA = ARISBPDATA; GO GRANT CONTROL ON SCHEMA :: [ARISBPDATA] TO [ARISBP11] GO GRANT CREATE TABLE TO [ARISBP11] GO GRANT CREATE VIEW TO [ARISBP11] GO GRANT CREATE FUNCTION TO [ARISBP11] GO 65 Oracle BPA Suite Installation and Administration Guide 2.6.2 Apache Tomcat Web Application Server under Solaris/Linux This chapter describes the installation of Apache Tomcat Web Application Server on Solaris or Linux systems. Note When you combine various technologies, please observe the manufacturers' instructions, particularly announcements concerning releases on their Internet pages. We cannot guarantee proper functioning of supported third-party systems. Always follow the instructions provided in the installation manuals of the relevant manufacturer, or contact Oracle Corporation support. Step-by-step instructions (MS SQL Server 2005 database) This procedure describes the adjustments to an Apache Tomcat Web Application Server 5.5.25 under Solaris 5.20 en if you are using an MS SQL Server 2005 database. Prerequisite Copy the file jtds.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server/MSSQL) to a directory of your choice. You need the file businesspublisher.war for WAR deployment. You find this file on the installation media, or you can download it from www.oracle.com. You have created and configured an MS SQL Server 2005 database (Page 234). If you install a database yourself, always follow the instructions provided in the MS SQL Installation Guide. Procedure 1. Download (http://tomcat.apache.org) the file apache-tomcat5.5.25.tar.gz, and unzip the contents to a directory, such as tmp, for which you have all privileges. This provides you with the standard configuration, which you now adjust. 2. Open the subdirectory ..tomcat/bin, and create the file setenv.sh there. 3. Adjust the following variables as shown in the example: CATALINA_HOME="/tmp/apache-tomcat-5.5.25" JAVA_HOME="/usr/jre/jre1.5.0_10" 66 Oracle BPA Suite Installation and Administration Guide CATALINA_OPTS="$CATALINA_OPTS Daris.businesspublisher.home=$CATALINA_HOME/webapps/ businesspublisher Djava.security.auth.login.config="$CATALINA_HOME/webapp s/businesspublisher\config\BPLogin.cfg" Xbootclasspath/p:/tmp/orbacus.4.3.2.jar -Xms128m Xmx1024m-XX:MaxPermSize=128m" 4. Copy the file businesspublisher.war to the installation directory .../apache-tomcat-5.5.25/webapps. You find the file on the installation media or on our ftp server (ftp://ftp.idsscheer.de/pub/ARIS/HELPDESK/). 5. Test the configuration by starting Tomcat. To do this, run the file startup.sh in the installation directory apache-tomcat-5.5.25/bin. The businesspublisher.war file is automatically extracted and integrated in the system (deployment). 67 Oracle BPA Suite Installation and Administration Guide 6. Stop Tomcat by running the file shutdown.sh in the installation directory .../apache-tomcat-5.5.25/bin. 7. Open the file webappserver.cfg in the installation directory .../apache-tomcat5.5.25/tomcat/webapps/businesspublisher/config/. 8. Enter the new license key in the License key line, e.g. <license key="C99999-XXX_Business_PublisherV71LdeLenPdU250-XXXX..."/> 9. In the bpservicehost value line, change the value for the IP address of the computer on which Tomcat is installed, e.g. <bpservicehost value="172.30.111.123"/> 10. Ensure that the database connection is set for MSSQL. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entryvalue>com.idsscheer.aris.businesspublisher.application.dao.database .AMSSQLDAO</env-entry-value> </env-entry> 11. Save the change and close the file. 68 Oracle BPA Suite Installation and Administration Guide 12. Create the file businesspublisher.xml in the installation directory .../apache-tomcat-5.5.25/conf/catalina/localhost. 13. Insert the following lines at the end of this file: <!--IDS CONTEXT --> <Context path="/businesspublisher" docBase="/tmp/apache-tomcat5.5.20/webapps/businesspublisher/" debug="1" reloadable="true" crossContxt="true"> Rescource name="jdbc/businesspublisherdb" auth="Container" type="javax.sql.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" username="<enter the user name>" password="<enter the password of the user>" driverClassName="net.sourceforge.jtds.jdbc.Driver" url="jdbc:jtds:sqlserver://<Hostname>:<Port>/ARISBP71" </Context> </Host> </Engine> </Server> 14. Save the change and close the file. 15. Customize the configuration file batchserver.cfg. You find more information about this in the file. Ensure that the value of the key name value is maintained with the name of the batch server and the key host value with the IP address or the fully qualified name. 16. Copy the file jtds.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the installation directory .../apache-tomcat-5.5.25/common/lib. 17. Start Tomcat. The system is configured. 2.6.2.1 Step-by-step instructions (Oracle database) This procedure describes the adjustments to an Apache Tomcat Web Application Server 5.5.25 under Solaris/Linux. 1. Download (http://tomcat.apache.org) the file apache-tomcat5.5.25.tar.gz, and unzip the contents to a directory for which you have all privileges. 69 Oracle BPA Suite Installation and Administration Guide The following folder structure is created. This provides you with the standard configuration, which you now adjust. 2. Copy the file orbacus<version number>.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a local directory. The version number may have changed since completion of this document. In this example, the file name is orbacus.4.3.2.jar. 3. Open the bin subdirectory, and create the file setenv.sh with the following content: CATALINA_HOME="/<directory>/apache-tomcat-5.5.25" JAVA_HOME="/usr/jre/jre1.6.0_4 CATALINA_OPTS="$CATALINA_OPTS Daris.businesspublisher.home=$CATALINA_HOME/webapps/ businesspublisher Djava.security.auth.login.config=$CATALINA_HOME/webapps /businesspublisher/config/bplogin.cfg Xbootclasspath/p:/<path>/orbacus.4.3.2.jar -Xms128m Xmx1024m" Adapt the paths and file names to the relevant system. 4. Copy the file businesspublisher.war (installation media/Setups/All OS/Oracle Business Process Publisher Server or IDS ftp server (ftp://ftp.ids-scheer.de/pub/ARIS/HELPDESK/)) to the installation directory .../apache-tomcat-5.5.25/webapps. 5. Test the configuration by starting Tomcat. To do this, run the file startup.sh in the installation directory apache-tomcat-5.5.25/bin. The file businesspublisher.war is automatically extracted and the structure .../apache-tomcat5.5.25/tomcat/webapps/businesspublisher/config is created. 6. Stop Tomcat by running the file shutdown.sh in the installation directory .../apache-tomcat-5.5.25/bin. 70 Oracle BPA Suite Installation and Administration Guide 7. Open the file .../apache-tomcat5.5.25/tomcat/webapps/businesspublisher/config/webappserver.cf g. a. In the bpservicehost value line, change the value for the IP address of the computer on which Tomcat is installed, e.g. <bpservicehost value="172.30.111.123"/> 8. Ensure that the database connection is set for Oracle here: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value> com.idsscheer.aris.businesspublisher.application.dao.database.AOra cleDAO</env-entryvalue> </env-entry> 9. Save the change and close the file. 10. Create the file businesspublisher.xml in the installation directory .../apache-tomcat-5.5.25/tomcat/conf/catalina/localhost with the following content: <Context path="/businesspublisher" docBase="/opt/apachetomcat-5.5.25/webapps/businesspublisher" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax.sql.DataSource" maxActive="30" maxIdle="20" maxWait="1000" username="ARISBP" password="ARISBP" driverClassName="oracle.jdbc.driver.OracleDriver" url="jdbc:oracle:thin:@DBSERVER:PORT:INSTANCE" connectionProperties="SetBigStringTryClob=true"/> </Context> 11. Save the change and close the file. 12. Customize the configuration file batchserver.cfg, and save your changes. You find more information about this in the file. 71 Oracle BPA Suite Installation and Administration Guide 13. Copy the file ojdbc5.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the installation directory .../apache-tomcat-5.5.25/common/lib. 14. Start Tomcat. Users can now create Web exports. Note 1. When you combine various technologies, please observe the manufacturers' instructions, particularly announcements concerning releases on their Internet pages. We cannot guarantee proper functioning of supported third-party systems. Always follow the instructions provided in the installation manuals of the relevant manufacturer, or contact Oracle Corporation support. 2.6.2.2 Step-by-step instructions (MS SQL Server 2005 database) This procedure describes the adjustments to an Apache Tomcat Web Application Server 5.5.25 under Solaris/Linux. 1. Download (http://tomcat.apache.org) the file apache-tomcat5.5.25.tar.gz, and unzip the contents to a directory for which you have all privileges. The following folder structure is created. This provides you with the standard configuration, which you now adjust. 2. Copy the file orbacus<version number>.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a local directory. The version number may have changed since completion of this document. In this example, the file name is orbacus.4.3.2.jar. 3. Open the bin subdirectory, and create the file setenv.sh with the following content: 72 Oracle BPA Suite Installation and Administration Guide CATALINA_HOME="/<directory>/apache-tomcat-5.5.25" JAVA_HOME="/usr/jre/jre1.6.0_4 CATALINA_OPTS="$CATALINA_OPTS Daris.businesspublisher.home=$CATALINA_HOME/webapps/ businesspublisher Djava.security.auth.login.config=$CATALINA_HOME/webapps /businesspublisher/config/bplogin.cfg Xbootclasspath/p:/<path>/orbacus.4.3.2.jar -Xms128m Xmx1024m" Adapt the paths and file names to the relevant system. 4. Copy the file businesspublisher.war (installation media/Setups/All OS/Oracle Business Process Publisher Server or IDS ftp server (ftp://ftp.ids-scheer.de/pub/ARIS/HELPDESK/)) to the installation directory .../apache-tomcat-5.5.25/webapps. 5. Test the configuration by starting Tomcat. To do this, run the file startup.sh in the installation directory apache-tomcat-5.5.25/bin. The file businesspublisher.war is automatically extracted and the structure .../apache-tomcat5.5.25/tomcat/webapps/businesspublisher/config is created. 6. Stop Tomcat by running the file shutdown.sh in the installation directory .../apache-tomcat-5.5.25/bin. 7. Open the file .../apache-tomcat5.5.25/tomcat/webapps/businesspublisher/config/webappserver.cf g. a. In the bpservicehost value line, change the value for the IP address of the computer on which Tomcat is installed, e.g. <bpservicehost value="172.30.111.123"/> 8. Ensure that the database connection is set for MSSQL. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entryvalue>com.idsscheer.aris.businesspublisher.application.dao.database .AMSSQLDAO</env-entry-value> </env-entry> 9. Save the change and close the file. 73 jdbc. you must make some settings in the administration console of IBM WebSphere.xml in the installation directory .DataSource" maxActive="30" maxIdle="20" maxWait="1000" username="ARISBP" password="ARISBP" driverClassName="oracle./apache-tomcat-5. Create the file businesspublisher. 74 .15) and approved databases. Customize the configuration file batchserver. particularly announcements concerning releases on their Internet pages. If you select this procedure..5. Start Tomcat.5. please observe the manufacturers' instructions.1.cfg. We cannot guarantee proper functioning of supported third-party systems. 2.driver.25/webapps/businesspublisher" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax. 12.15) under Windows This chapter describes the installation of Oracle Business Process Publisher Server in combination with IBM WebSphere Application Server (WAS 6.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the installation directory .6.5./apache-tomcat-5. Copy the file jtds. Note When you combine various technologies..3 IBM WebSphere Application Server (WAS 6. 14.. You find more information about this in the file.. 13. Users can now create Web exports.25/common/lib.Oracle BPA Suite Installation and Administration Guide 10. Save the change and close the file.0.sql. or contact Oracle Corporation support. and save your changes.1. Always follow the instructions provided in the installation manuals of the relevant manufacturer.OracleDriver" url="jdbc:oracle:thin:@DBSERVER:PORT:INSTANCE" connectionProperties="SetBigStringTryClob=true"/> </Context> 11.25/tomcat/conf/catalina/localhost with the following content: <Context path="/businesspublisher" docBase="/opt/apache-tomcat5.0. or you can download it from www.6. regular monitoring (e.0. unlimited growth. If the option for automatic growth is not set. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. Use of the database character set AL32UTF8 is mandatory. Otherwise.Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies.g. You have created an Oracle database and configured it as follows. or contact Oracle Corporation support. Always follow the instructions provided in the installation manuals of the relevant manufacturer. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher.15 (en) if you are using an Oracle database 10g.3. If you install a database yourself. You find this file on the installation media. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). You need the file businesspublisher. particularly announcements concerning releases on their Internet pages. please observe the manufacturers' instructions. you run the risk of completely exhausting the memory in the tablespaces. Prerequisite Copy the file from the directory installation media/Setups/All OS/Oracle Business Process Publisher Server/Oracle/IBM Websphere to a directory of your choice. We recommend that you set the tablespaces for automatic. and you achieve better performance and higher availability. This keeps the two systems from competing for resources. To use other names or existing tablespaces. 75 .cfg (see below). always follow the instructions provided in the Oracle Installation Guide.war for WAR deployment.com. We cannot guarantee proper functioning of supported third-party systems. you must customize the configuration file webappserver. We recommend a block size of 8K.1 Step-by-step instructions (Oracle database) This procedure describes the adjustments to an IBM WAS 6.oracle.1. 2. GRANT CREATE TABLE TO ARISBP. Click on Resources/JDBC/JDBC Provider in the views. Enter it in the configuration file businesspublisher. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. click on Start/Programs/IBM Websphere/Application Server V6. Procedure 1. You can select any password. Open the administration console of your IBM WebSphere Application Server in the browser (http://localhost:9060/ibm/console). and create a JDBC provider.1/Profile/<Appsrv01>/Start Server. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP.xml (see below). 76 .Oracle BPA Suite Installation and Administration Guide weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. GRANT ALTER SESSION TO ARISBP. GRANT QUERY REWRITE TO ARISBP. After the installation. If you prefer another name. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. 2. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. The name of the Oracle user is assumed to be ARISBP. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. 3. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. GRANT CREATE VIEW TO ARISBP. 8. select the Cell entry and click on New.Oracle BPA Suite Installation and Administration Guide 4. 77 . In the Implementation type box. In the Scope box. select the Connection pool data source entry. 5. 6. Select the Oracle JDBC Driver entry in the Provider type box. Select the Oracle entry in the Database type box. Enter the name in the Name box and a description in the Description box. Then click on Next. 7. 10. 78 . and check your settings in the summary. Click on Next. The new JDBC provider is created. and enter the path to the ojdbc file in the Class path box (see Prerequisites). Click on Finish.Oracle BPA Suite Installation and Administration Guide 9. and save the configuration. If the value has not been correctly transferred. 11. correct the path on the page JDBC providers/Oracle JDBC Driver. Click on Next. 13. Click on Resources/JDBC/Data source in the views. and click on New. In the Data source name and JNDI name box. enter the entries shown in the graphic.Oracle BPA Suite Installation and Administration Guide 12. and click on Next. 79 . select the entry Cell in the Scope box. 15. 17. 16. Enter the URL for the Oracle database server using the following syntax: jdbc:oracle:thin:@<Servername>:<Port>:<Instance>. Select the option Select an existing JDBC provider. and select the settings shown.Oracle BPA Suite Installation and Administration Guide 14. and check the settings in the summary. Click on Next. select Oracle JDBC Driver. and click on Next. Click on Finish. 80 . You must save the master configuration. 81 . and on New to create a user with access privileges.Oracle BPA Suite Installation and Administration Guide 18. on Custom Properties. Click on the link Oracle JDBC Driver DataSource. Configure database access on the page Data sources/Oracle JDBC Driver DataSource/Custom properties. Enter user in the Name box and the value ARISBP in the Value box.Oracle BPA Suite Installation and Administration Guide 19. Click on OK. and save your changes. 20. You find the new entry at the end of the list. 82 . jar. 22. Then. please check the settings and the path to the file ojdbc5. 83 . If you do not receive a confirmation message. enter a password for the ARISBP user. and click on OK.Oracle BPA Suite Installation and Administration Guide 21. Save your changes. and test the database connection by clicking on Test connection on the Data sources page. click on Browse. 25. Select the Local file system option.war).com. You find this file on the installation media. 84 . or you can download it from www. 24. and select the path to the WAR file (businesspublisher. enter /businesspublisher. In the Context root box. Run the War deployment by clicking on Applications/Enterprise Applications/Install New Application in the views.oracle.Oracle BPA Suite Installation and Administration Guide 23. select the settings as shown. and on the following pages.Oracle BPA Suite Installation and Administration Guide 26. 85 . Click on Next. Oracle BPA Suite Installation and Administration Guide 27. Click on Browse. 86 . click on Next and then on Finish.Oracle BPA Suite Installation and Administration Guide 28. The installation starts. A progress bar is displayed during installation. Enable the option Oracle JDBC Driver Data Source. 87 . 29. and click on Apply. Check your entries. home and generic JVM variables. If about 100 users have simultaneous access. we recommend that you make more memory available to the server process.Oracle BPA Suite Installation and Administration Guide 30. 88 . Configure the system by defining the Home directory aris.businesspublisher. Save the changes when the master installation has been completed succesfully. allocate 2048 MB. 31. Depending on the number of users with simultaneous access to the system. Please note the selected settings in the illustrations. Open the page Application servers/<server>/Process Definition/Java Virtual Machine 89 .Oracle BPA Suite Installation and Administration Guide 32. and click on Custom Properties. 90 . Enter the value -Xmx2048m in the Generic JVM arguments box.Oracle BPA Suite Installation and Administration Guide 33. Oracle BPA Suite Installation and Administration Guide 34. and enter the name aris. The Home directory is defined. and save the changes. You find it in the installation directory of IBM Websphere Application Server under the directory Profiles/<name of the profile>/installedApps/<server name><node>cell. Click on Apply.home in the Name box. Please note the lower-case spelling. 36. 35. enter the path to the directory businesspublisher. 91 .businesspublisher.war. Click on New. In the Value box. Click on Java Authentication and Authorization Service/Application logins/New. Enable Name Service by disabling all check boxes on the page Security/Secure administration. you first have to enable the Enable administrative security check box. and infrastructure and by adjusting the settings as shown. Enter the value NativeLogin in the Alias box. and save the changes. To disable. applications.Oracle BPA Suite Installation and Administration Guide 37. 38. Click on Apply. 40. You can later use the file dumpNameSpace. Click on Apply. and save the changes. 92 . 41. 39.bat to check whether the settings are correct. Click on Apply. 48. Enable the Select from special subjects option. Click on Security/Secure administration. Paste the copied entry into the Module class name box.war/config/bpl ogin. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. 45. 43. and save the changes. click on Apply. applications. Click on Environment/Naming/CORBA Naming Service Groups. 44.ear/businesspublisher. 93 .cfg. and infrastructure/Java Authentication and Authentication Service/Application logins. 47.Oracle BPA Suite Installation and Administration Guide 42. and save the changes. and copy the entry marked in the following graphic. 46. select all roles for Everyone. Click on NativeLogin/JAAS login modules/New. and click on Apply.Oracle BPA Suite Installation and Administration Guide 49. enable the Select from special subjects option. Click on Add. 50. 51. 94 . select all roles for All Authenticated. Save your changes. Run the file <installation directory>/IBM/WebSphere/AppServer/profiles/<Appsrv01 >/bin/dumpNameSpace.bat. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. Restart the server. Check the settings by starting the file <installation directory>/IBM/WebSphere/AppServer/profiles/<Appsrv01 >/bin/dumpNameSpace.cfg. which you use as nameserviceprefix (see above).Oracle BPA Suite Installation and Administration Guide 52. 54. <bpservicehost value="<fully qualified name> or <IP address>"/> e. Ensure that these values are also transferred to the files Oracle BPA Suite installation directory>\Oracle BPA Suite<Version>\Server\config\defaultServerSettings.bat. 56. d. Copy the value that is highlighted green to the clipboard. 53. you also find the entry /nodes/ids-5dke28k3adwNode01/servers/server1.cfg and userSettings.war/config/we bappserver. Save your changes.ear/businesspublisher. 57. Customize the file as follows: a. Here. 55. nameserviceprefix="/nodes/<node>/servers/<server name>"/> Paste the content of the clipboard here. 95 . <bpserviceport value="9100" b. usenameservice="true" c.cfg. aris.database.war/config/batchserver.war/config/webappserver. Customize the configuration file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<CellName>/businesspublisher.idsscheer.AOra cleDAO</env-entryvalue> </env-entry> 59.businesspublisher.lang. Save your changes. you also find the marked entries in the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<CellName>/businesspublisher. 58.cfg. 60.ear/busines spublisher.cfg. 96 . You find more information about this in the file.String</env-entry-type> <env-entry-value> com.dao. Ensure that the database connection is set for Oracle here: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.Oracle BPA Suite Installation and Administration Guide If the installation was successful.application.ear/busines spublisher. or you can download it from www. We cannot guarantee proper functioning of supported third-party systems. Procedure 1. 61. Open the administration console of your IBM WebSphere Application Server in the browser (http://localhost:9060/ibm/console).15 in combination with an Oracle database 10g. Prerequisite Copy the file jtds.2 Step-by-step instructions (MS SQL Server 2005 database) This procedure describes the adjustments to an IBM WAS 6.6. Always follow the instructions provided in the installation manuals of the relevant manufacturer.0. You have created and configured an MS SQL Server 2005 database (Page 234). You need the file businesspublisher.1. and create a JDBC provider. 97 . After the installation. and restart IBM Websphere Application Server and Oracle Business Process Publisher. 2. Click on Resources/JDBC/JDBC Provider in the views.1. Save the changes.0. please observe the manufacturers' instructions. If you install a database yourself. click on Start/Programs/IBM Websphere/Application Server V6.Oracle BPA Suite Installation and Administration Guide Ensure that the value of the key name value is maintained with the name of the batch server and the key host value with the IP address or the fully qualified name.oracle.1/Profile/Appsrv01/Start Server.com.3. 2. or contact Oracle Corporation support. particularly announcements concerning releases on their Internet pages.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server/MSSQL) to a directory of your choice. You find this file on the installation media. 3.war for WAR deployment. always follow the instructions provided in the MS SQL Installation Guide. The system is now running with IBM WAS 6. Note When you combine various technologies.15 (en) if you are using an MS SQL Server 2005 database. 5. Enter the name in the Name box and a description in the Description box.Oracle BPA Suite Installation and Administration Guide 4. 7. 6. In the Provider type box. select the entry WebSphere embedded ConnectJDBC driver for MS SQL Server. 98 . Select the SQL Server entry in the Database type box. select the Connection pool data source entry. Then click on Next. select the Cell entry and click on New. In the Scope box. In the Implementation type box. 8. jar. base.jar. 10. and spy. and. util. 99 . enter the path to the files sqlserver.Oracle BPA Suite Installation and Administration Guide 9. in the Class path box. and check your settings in the summary. Click on Next.jar.jar. Click on Next. Oracle BPA Suite Installation and Administration Guide 11. Click on Resources/JDBC/Data source in the views. and save the configuration. 100 . Click on Finish. and click on New. The new JDBC provider is created. 12. select the entry Cell in the Scope box. 101 . Enter the names in the Data source name and JNDI name box. and click on Next.Oracle BPA Suite Installation and Administration Guide 13. and click on Next. select SQL JDBC Driver. 14. Select the option Select an existing JDBC provider. and select the settings shown. Click on Finish. server name. Click on Next. and check the settings in the summary. Enter the database name. 17. 16. 102 .Oracle BPA Suite Installation and Administration Guide 15. and port numbers. You must save the master configuration. Oracle BPA Suite Installation and Administration Guide 18. Select the following settings on the page Data sources/businesspublisherdb: 103 . Oracle BPA Suite Installation and Administration Guide 19. Configure database access on the page Data sources/businesspublisherdb/Custom properties. 104 . Enter user in the Name box. for example. 21.Oracle BPA Suite Installation and Administration Guide 20. and save your changes. 105 . and the value ARISBP in the Value box. You find the new entry at the end of the list. Click on OK. 106 . and click on OK. Then.Oracle BPA Suite Installation and Administration Guide 22. enter a password for the ARISBP user. please check the settings. To test the database connection. If you do not receive a corresponding message.Oracle BPA Suite Installation and Administration Guide 23. click on Test connection. Run the War deployment by clicking on Applications/Install New Application in the views. 107 . 24. click on Browse.oracle.com. and select the path to the WAR file (businesspublisher. or you can download it from www. In the Context root box.war). 26. Select the Local file system option. You find this file on the installation media.Oracle BPA Suite Installation and Administration Guide 25. enter /businesspublisher. 108 . and. 109 . on the following pages. Click on Next. select the settings as shown.Oracle BPA Suite Installation and Administration Guide 27. Click on Browse. 110 .Oracle BPA Suite Installation and Administration Guide 28. click on Next and then on Finish. Check your entries. 111 .Oracle BPA Suite Installation and Administration Guide 29. and click on Apply. The installation starts. 30. Enable the businesspublisherdb option. Save the changes when the master installation has been completed succesfully.Oracle BPA Suite Installation and Administration Guide 31. allocate 2048 MB. Please note the selected settings in the illustrations. 112 .home and generic JVM variables. If about 100 users have simultaneous access.businesspublisher. Configure the system by defining the Home directory aris. 32. we recommend that you make more memory available to the server process. Depending on the number of users with simultaneous access to the system. Open the page Application servers/<server>/Process Definition/Java Virtual Machine 113 .Oracle BPA Suite Installation and Administration Guide 33. Enter the value -Xmx2048m in the Generic JVM arguments box. and click on Custom Properties. 114 .Oracle BPA Suite Installation and Administration Guide 34. home in the Name box. The Home directory is defined. 115 . You find it in the installation directory of IBM Websphere Application Server under the directory Profiles/<name of the profile>/installedApps/<server name><node>cell. enter the path to the directory businesspublisher.Oracle BPA Suite Installation and Administration Guide 35. In the Value box. 36. Please note the lower-case spelling. and enter the name aris. 37. Click on Apply. and save the changes.businesspublisher. Click on New.war. and save the changes. Enter the value NativeLogin in the Alias box. To disable. 42. Click on Apply. 39. you first have to enable the Enable administrative security check box. 40. You can later use the file dumpNameSpace. applications.Oracle BPA Suite Installation and Administration Guide 38. 116 .bat to check whether the settings are correct. Click on Apply. Enable Name Service by disabling all check boxes on the page Security/Secure administration. 41. Click on Java Authentication and Authorization Service/Application logins/New. and infrastructure and by adjusting the settings as shown. and save the changes. 117 .war/config/bpl ogin. 45. 46. select all roles for Everyone. and save the changes. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. and copy the entry marked in the following graphic. 47.Oracle BPA Suite Installation and Administration Guide 43. applications. Click on Security/Secure administration. Click on NativeLogin/JAAS login modules/New. Paste the copied entry into the Module class name box. and save the changes. Enable the Select from special subjects option.ear/businesspublisher. and infrastructure/Java Authentication and Authentication Service/Application logins. click on Apply. Click on Environment/Naming/CORBA Naming Service Groups. 48. 44.cfg. 49. Click on Apply. 52. 118 . 53. Run the file <installation directory>/IBM/WebSphere/AppServer/profiles/<Appsrv01 >/bin/dumpNameSpace. Click on Add.bat. 51. Copy the value that is highlighted green to the clipboard. select all roles for All Authenticated. and click on Apply.Oracle BPA Suite Installation and Administration Guide 50. enable the Select from special subjects option. Save your changes. ear/businesspublisher. usenameservice="true" c.cfg and userSettings. 55. 58. which you use as nameserviceprefix (see above).cfg. Customize the file as follows: a. Check the settings by starting the file <installation directory>/IBM/WebSphere/AppServer/profiles/<Appsrv01 >/bin/dumpNameSpace.war/config/we bappserver. Here. Restart the server. <bpserviceport value="9100" b.Oracle BPA Suite Installation and Administration Guide 54. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. 57. nameserviceprefix="/nodes/<node>/servers/<server name>"/> Paste the content of the clipboard here.cfg. Ensure that these values are also transferred to the files Oracle BPA Suite installation directory>\Oracle BPA Suite<Version>\Server\config\defaultServerSettings. Save your changes. 56. you also find the entry /nodes/ids-5dke28k3adwNode01/servers/server1.bat. 119 . d. <bpservicehost value="<fully qualified name> or <IP address>"/> e. 62.war/config/batchserver.database . <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java. You find more information about this in the file.lang.dao. you also find the marked entries in the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<CellName>/businesspublisher. Customize the configuration file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<CellName>/businesspublisher. 60. Save your changes.application.businesspublisher.String</env-entry-type> <env-entryvalue>com.cfg.ear/busines spublisher. 120 . Ensure that the database connection is set for MSSQL.AMSSQLDAO</env-entry-value> </env-entry> 61.war/config/webappserver.ear/busines spublisher.cfg. 59.Oracle BPA Suite Installation and Administration Guide If the installation was successful.aris.idsscheer. visit http://support.0.1. Always follow the instructions provided in the installation manuals of the relevant manufacturer. Always follow the instructions provided in the installation manuals of the relevant manufacturer. Note When you combine various technologies.15) and approved databases under RedHat ES 5 x64. We cannot guarantee proper functioning of supported third-party systems. particularly announcements concerning releases on their Internet pages. or contact Oracle Corporation support.microsoft.microsoft. particularly announcements concerning releases on their Internet pages. If you select this procedure. or contact Oracle Corporation support.1. 2. The system is now running with IBM WAS 6.15 in combination with an MS SQL Server 2005 database.com/kb/914277/en-us).Oracle BPA Suite Installation and Administration Guide Ensure that the value of the key name value is maintained with the name of the batch server and the key host value with the IP address or the fully qualified name. Tip For additional information about Microsoft SQL Server 2005.0. please observe the manufacturers' instructions. you must make some settings in the administration console of IBM WebSphere.0.6. 121 .4 IBM WebSphere Application Server (WAS 6.com/kb/914277/en-us (http://support. Note When you combine various technologies. Restart IBM Websphere Application Server and Oracle Business Process Publisher. 63. We cannot guarantee proper functioning of supported third-party systems.15) under RHELx64 This chapter describes the installation of Oracle Business Process Publisher Server in combination with IBM WebSphere Application Server (WAS 6.1. please observe the manufacturers' instructions. war for WAR deployment. Use of the database character set AL32UTF8 is mandatory. You find this file on the installation media. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data).cfg (see below). We recommend a block size of 8K. and you achieve better performance and higher availability. Prerequisite Copy the file from the directory installation media/Setups/All OS/Oracle Business Process Publisher Server/Oracle/IBM Websphere to a directory of your choice. 122 . you must customize the configuration file webappserver.g. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. unlimited growth. always follow the instructions provided in the Oracle Installation Guide. To use other names or existing tablespaces. You need the file businesspublisher. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. You have created an Oracle database and configured it as follows. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database.com. We recommend that you set the tablespaces for automatic.6.oracle.Oracle BPA Suite Installation and Administration Guide 2. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP.xml (see below).1. If the option for automatic growth is not set. If you install a database yourself. Enter it in the configuration file businesspublisher. You can select any password. Otherwise.4.15 (en) if you are using an Oracle database 10g.1 Step-by-step instructions (Oracle database) This procedure describes the adjustments to an IBM WAS 6. regular monitoring (e. If you prefer another name. you run the risk of completely exhausting the memory in the tablespaces. The name of the Oracle user is assumed to be ARISBP.0. This keeps the two systems from competing for resources. or you can download it from www. In the Implementation type box. 6.Oracle BPA Suite Installation and Administration Guide The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. 7. Select the Oracle JDBC Driver entry in the Provider type box. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. GRANT CREATE TABLE TO ARISBP. 3. GRANT CREATE VIEW TO ARISBP. In the Scope box. Select the Oracle entry in the Database type box. select the Connection pool data source entry. 123 . After the installation. GRANT QUERY REWRITE TO ARISBP. 5. and create a JDBC provider. Click on Resources/JDBC/JDBC Provider in the views.1/Profile/<Appsrv01>/Start Server. 4. click on Start/Programs/IBM Websphere/Application Server V6. 2. Procedure 1. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. select the Cell entry and click on New. Open the administration console of your IBM WebSphere Application Server in the browser (http://localhost:9060/ibm/console). GRANT ALTER SESSION TO ARISBP. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. Oracle BPA Suite Installation and Administration Guide 8. Then click on Next. 124 . Enter the name in the Name box and a description in the Description box. Click on Next. 125 . Click on Next. Click on Finish. correct the path on the page JDBC providers/Oracle JDBC Driver. The new JDBC provider is created. If the value has not been correctly transferred.Oracle BPA Suite Installation and Administration Guide 9. and check your settings in the summary. and enter the path to the ojdbc file in the Class path box (see Prerequisites). 10. 11. and save the configuration. Oracle BPA Suite Installation and Administration Guide 12. 13. select the entry Cell in the Scope box. enter the entries shown in the graphic. 126 . and click on Next. and click on New. Click on Resources/JDBC/Data source in the views. In the Data source name and JNDI name box. and click on Next. Click on Finish.Oracle BPA Suite Installation and Administration Guide 14. Click on Next. Enter the URL for the Oracle database server using the following syntax: jdbc:oracle:thin:@<Servername>:<Port>:<Instance>. and select the settings shown. and check the settings in the summary. select Oracle JDBC Driver. Select the option Select an existing JDBC provider. 17. 15. You must save the master configuration. 16. 127 . 128 . Click on the link Oracle JDBC Driver DataSource. and on New to create a user with access privileges.Oracle BPA Suite Installation and Administration Guide 18. Configure database access on the page Data sources/Oracle JDBC Driver DataSource/Custom properties. on Custom Properties. Click on OK. You find the new entry at the end of the list.Oracle BPA Suite Installation and Administration Guide 19. and save your changes. 129 . 20. Enter user in the Name box and the value ARISBP in the Value box. 22. If you do not receive a confirmation message. Save your changes. and click on OK.Oracle BPA Suite Installation and Administration Guide 21. 130 . Then. and test the database connection by clicking on Test connection on the Data sources page.jar. please check the settings and the path to the file ojdbc5. enter a password for the ARISBP user. click on Browse. enter /businesspublisher. 24. Select the Local file system option.war). Run the War deployment by clicking on Applications/Enterprise Applications/Install New Application in the views. In the Context root box. and select the path to the WAR file (businesspublisher.Oracle BPA Suite Installation and Administration Guide 23. 25. You find this file on the installation media.com.oracle. or you can download it from www. 131 . Click on Next. and on the following pages. select the settings as shown.Oracle BPA Suite Installation and Administration Guide 26. 132 . 133 .Oracle BPA Suite Installation and Administration Guide 27. Click on Browse. Check your entries. 29. click on Next and then on Finish. The installation starts.Oracle BPA Suite Installation and Administration Guide 28. Enable the option Oracle JDBC Driver Data Source. A progress bar is displayed during installation. and click on Apply. 134 . businesspublisher. 31. Please note the selected settings in the illustrations. Configure the system by defining the Home directory aris.home and generic JVM variables. Save the changes when the master installation has been completed succesfully. allocate 2048 MB. If about 100 users have simultaneous access. 135 . Depending on the number of users with simultaneous access to the system. we recommend that you make more memory available to the server process.Oracle BPA Suite Installation and Administration Guide 30. Oracle BPA Suite Installation and Administration Guide 32. Open the page Application servers/<server>/Process Definition/Java Virtual Machine 136 . 137 .Oracle BPA Suite Installation and Administration Guide 33. and click on Custom Properties. Enter the value -Xmx2048m in the Generic JVM arguments box. Oracle BPA Suite Installation and Administration Guide 34. The Home directory is defined. In the Value box. 35. and enter the name aris. You find it in the installation directory of IBM Websphere Application Server under the directory Profiles/<name of the profile>/installedApps/<server name><node>cell. 36. Click on New. 138 . and save the changes. enter the path to the directory businesspublisher.businesspublisher. Please note the lower-case spelling.war.home in the Name box. Click on Apply. Click on Java Authentication and Authorization Service/Application logins/New. 39. 139 . To disable. and save the changes.Oracle BPA Suite Installation and Administration Guide 37. Click on Apply. Enable Name Service by disabling all check boxes on the page Security/Secure administration. Click on Apply.bat to check whether the settings are correct. You can later use the file dumpNameSpace. and save the changes. applications. 40. 38. and infrastructure and by adjusting the settings as shown. 41. you first have to enable the Enable administrative security check box. Enter the value NativeLogin in the Alias box. 140 . Click on Apply. 48. Click on Security/Secure administration. and save the changes. Paste the copied entry into the Module class name box. 47.cfg. 44.Oracle BPA Suite Installation and Administration Guide 42. and infrastructure/Java Authentication and Authentication Service/Application logins. and copy the entry marked in the following graphic. click on Apply. and save the changes.war/config/bpl ogin. 46. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. Click on NativeLogin/JAAS login modules/New. applications. select all roles for Everyone. Click on Environment/Naming/CORBA Naming Service Groups. Enable the Select from special subjects option. 45. 43.ear/businesspublisher. Customize the file as follows: a. usenameservice="true" 141 . <bpserviceport value="9100" b. Click on Add.ear/businesspublisher. 51. 50.war/config/we bappserver. enable the Select from special subjects option. 52.cfg. Save your changes. select all roles for All Authenticated. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. and click on Apply.Oracle BPA Suite Installation and Administration Guide 49. 142 .1. 55. Customize the configuration file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<CellName>/businesspublisher.15 in combination with an Oracle database 10g.AOra cleDAO</env-entryvalue> </env-entry> 54. and restart IBM Websphere Application Server and Oracle Business Process Publisher. Save the changes.String</env-entry-type> <env-entry-value> com.cfg. Save your changes. d.lang. 53.war/config/batchserver. Ensure that the value of the key name value is maintained with the name of the batch server and the key host value with the IP address or the fully qualified name.cfg. You find more information about this in the file. nameserviceprefix="/nodes/<node>/servers/<server name>"/> Paste the content of the clipboard here.cfg and userSettings.aris. Ensure that the database connection is set for Oracle here: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java. <bpservicehost value="<fully qualified name> or <IP address>"/> e.idsscheer.dao.database.businesspublisher. Ensure that these values are also transferred to the files Oracle BPA Suite installation directory>\Oracle BPA Suite<Version>\Server\config\defaultServerSettings.Oracle BPA Suite Installation and Administration Guide c. Save your changes.0.ear/busines spublisher. 56. The system is now running with IBM WAS 6.application. Open the administration console of your IBM WebSphere Application Server in the browser (http://localhost:9060/ibm/console). After the installation. 143 . Prerequisite Copy the file jtds. Click on Resources/JDBC/JDBC Provider in the views. You need the file businesspublisher.4. please observe the manufacturers' instructions. Procedure 1. or contact Oracle Corporation support.Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies. If you install a database yourself.war for WAR deployment. You find this file on the installation media. 3. You have created and configured an MS SQL Server 2005 database (Page 234). and create a JDBC provider.1.1/Profile/Appsrv01/Start Server.6.com. always follow the instructions provided in the MS SQL Installation Guide. 2.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server/MSSQL) to a directory of your choice.2 Step-by-step instructions (MS SQL Server 2005 database) This procedure describes the adjustments to an IBM WAS 6. 2. click on Start/Programs/IBM Websphere/Application Server V6.15 (en) if you are using an MS SQL Server 2005 database. We cannot guarantee proper functioning of supported third-party systems.0. or you can download it from www. Always follow the instructions provided in the installation manuals of the relevant manufacturer. particularly announcements concerning releases on their Internet pages.oracle. In the Implementation type box. select the Cell entry and click on New.Oracle BPA Suite Installation and Administration Guide 4. Then click on Next. Enter the name in the Name box and a description in the Description box. select the entry WebSphere embedded ConnectJDBC driver for MS SQL Server. 7. select the Connection pool data source entry. 6. Select the SQL Server entry in the Database type box. 144 . 5. 8. In the Scope box. In the Provider type box. 10. and check your settings in the summary.jar. in the Class path box.jar. util.Oracle BPA Suite Installation and Administration Guide 9. Click on Next.jar. base. and spy. Click on Next. and.jar. 145 . enter the path to the files sqlserver. The new JDBC provider is created. 12. Click on Resources/JDBC/Data source in the views. and click on New.Oracle BPA Suite Installation and Administration Guide 11. 146 . Click on Finish. and save the configuration. select the entry Cell in the Scope box. and click on Next. Enter the names in the Data source name and JNDI name box. 14. select SQL JDBC Driver. and click on Next.Oracle BPA Suite Installation and Administration Guide 13. 147 . Select the option Select an existing JDBC provider. and port numbers. Click on Next. You must save the master configuration. 16. server name. 148 . and check the settings in the summary. 17. and select the settings shown.Oracle BPA Suite Installation and Administration Guide 15. Click on Finish. Enter the database name. Select the following settings on the page Data sources/businesspublisherdb: 149 .Oracle BPA Suite Installation and Administration Guide 18. Oracle BPA Suite Installation and Administration Guide 19. Configure database access on the page Data sources/businesspublisherdb/Custom properties. 150 . 21.Oracle BPA Suite Installation and Administration Guide 20. 151 . You find the new entry at the end of the list. Click on OK. and save your changes. for example. and the value ARISBP in the Value box. Enter user in the Name box. Oracle BPA Suite Installation and Administration Guide 22. and click on OK. 152 . enter a password for the ARISBP user. Then. Run the War deployment by clicking on Applications/Install New Application in the views. 153 . click on Test connection. please check the settings. If you do not receive a corresponding message. 24.Oracle BPA Suite Installation and Administration Guide 23. To test the database connection. and select the path to the WAR file (businesspublisher.com. Select the Local file system option.oracle. 26.war). You find this file on the installation media. or you can download it from www. click on Browse. In the Context root box. 154 . enter /businesspublisher.Oracle BPA Suite Installation and Administration Guide 25. on the following pages. 155 . and. select the settings as shown.Oracle BPA Suite Installation and Administration Guide 27. Click on Next. Oracle BPA Suite Installation and Administration Guide 28. Click on Browse. 156 . and click on Apply. 157 .Oracle BPA Suite Installation and Administration Guide 29. click on Next and then on Finish. Check your entries. Enable the businesspublisherdb option. The installation starts. 30. we recommend that you make more memory available to the server process. Configure the system by defining the Home directory aris.home and generic JVM variables. If about 100 users have simultaneous access. Please note the selected settings in the illustrations. Depending on the number of users with simultaneous access to the system. 32. 158 . allocate 2048 MB.Oracle BPA Suite Installation and Administration Guide 31. Save the changes when the master installation has been completed succesfully.businesspublisher. Open the page Application servers/<server>/Process Definition/Java Virtual Machine 159 .Oracle BPA Suite Installation and Administration Guide 33. Oracle BPA Suite Installation and Administration Guide 34. Enter the value -Xmx2048m in the Generic JVM arguments box. and click on Custom Properties. 160 . Click on New.businesspublisher. The Home directory is defined. and save the changes. In the Value box. and enter the name aris. enter the path to the directory businesspublisher. Please note the lower-case spelling. 161 .Oracle BPA Suite Installation and Administration Guide 35. 36. Click on Apply.war. You find it in the installation directory of IBM Websphere Application Server under the directory Profiles/<name of the profile>/installedApps/<server name><node>cell.home in the Name box. 37. 162 . and save the changes. Enable Name Service by disabling all check boxes on the page Security/Secure administration. Click on Apply. To disable. You can later use the file dumpNameSpace. Enter the value NativeLogin in the Alias box.Oracle BPA Suite Installation and Administration Guide 38. 41. and infrastructure and by adjusting the settings as shown. you first have to enable the Enable administrative security check box. Click on Apply. 42.bat to check whether the settings are correct. 40. and save the changes. Click on Java Authentication and Authorization Service/Application logins/New. applications. 39. and save the changes. Click on Environment/Naming/CORBA Naming Service Groups. select all roles for Everyone. 46. Click on NativeLogin/JAAS login modules/New.war/config/bpl ogin. Paste the copied entry into the Module class name box. 163 . click on Apply. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. 49. applications. and copy the entry marked in the following graphic. 45.ear/businesspublisher. Click on Apply. Enable the Select from special subjects option. 44.cfg.Oracle BPA Suite Installation and Administration Guide 43. Click on Security/Secure administration. and infrastructure/Java Authentication and Authentication Service/Application logins. 48. 47. and save the changes. enable the Select from special subjects option. Click on Add. Customize the file as follows: a.cfg. usenameservice="true" 164 . 53. 51. Open the file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<idsID>/businesspublisher. and click on Apply.ear/businesspublisher. 52. <bpserviceport value="9100" b.war/config/we bappserver.Oracle BPA Suite Installation and Administration Guide 50. select all roles for All Authenticated. Save your changes. String</env-entry-type> <env-entryvalue>com. Ensure that the value of the key name value is maintained with the name of the batch server and the key host value with the IP address or the fully qualified name. 55.Oracle BPA Suite Installation and Administration Guide c.war/config/batchserver.database .cfg. The system is now running with IBM WAS 6. Restart IBM Websphere Application Server and Oracle Business Process Publisher.com/kb/914277/en-us (http://support. 58. Tip For additional information about Microsoft SQL Server 2005.microsoft.dao.1.cfg and userSettings. visit http://support.businesspublisher.ear/busines spublisher.idsscheer. Save your changes.AMSSQLDAO</env-entry-value> </env-entry> 56. <bpservicehost value="<fully qualified name> or <IP address>"/> e. Ensure that these values are also transferred to the files Oracle BPA Suite installation directory>\Oracle BPA Suite<Version>\Server\config\defaultServerSettings. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.aris.microsoft.application.0.lang. d. Customize the configuration file <installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01 >/installedApps/<CellName>/businesspublisher.com/kb/914277/en-us). 54. Save your changes. 57. You find more information about this in the file.cfg. 165 . nameserviceprefix="/nodes/<node>/servers/<server name>"/> Paste the content of the clipboard here.15 in combination with an MS SQL Server 2005 database. Ensure that the database connection is set for MSSQL. 166 . Back up the configuration files webappserver. Always follow the instructions provided in the installation manuals of the relevant manufacturer.war/config/) to a secure directory located outside this installation directory.oracle. please observe the manufacturers' instructions.4. Exit Oracle Business Process Publisher Server.3 Deployment of a new WAR file If you have installed Oracle Business Process Publisher Server in combination with IBM WebSphere Application Server (WAS 6. or you can download it from www.6. Procedure 1.war. you can update the system by using the new file businesspublisher.ear/businesspublisher.0. We cannot guarantee proper functioning of supported third-party systems. You find this file on the installation media. 2. 2.war for WAR deployment. Afterward.Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies.com.cfg and batchserver. or contact Oracle Corporation support.cfg (<installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01>/installe dApps/<idsID>/businesspublisher. Prerequisite You need the file businesspublisher.1.15) and one of the approved databases under RedHat ES 5 x64. particularly announcements concerning releases on their Internet pages. you must perform all exports again. The directory structure should look as follows: <Installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01>/installe dApps/<ids-ID>. 5. Run the War deployment by clicking on Applications/Install New Application in the views.Oracle BPA Suite Installation and Administration Guide 3. 6.com. In the Context root box. You find this file on the installation media. or you can download it from www. 7.oracle. and select the path to the WAR file (businesspublisher. Ensure that the directory is deleted. Select the Local file system option. 4.war). and uninstall businesspublisher. Open the administration console of your IBM WebSphere Application Server in the browser (http://localhost:9060/ibm/console). click on Browse. 167 . enter /businesspublisher. 168 .Oracle BPA Suite Installation and Administration Guide 8. Click on Next. on the following pages. select the settings as shown. and. 169 . Click on Browse. Check your entries.Oracle BPA Suite Installation and Administration Guide 9. The installation starts. click on Next and then on Finish. 10. 13. please observe the manufacturers' instructions. We cannot guarantee proper functioning of supported third-party systems.6. Clear the corresponding database of the Oracle or MS SQL server. particularly announcements concerning releases on their Internet pages. Save the changes when the master installation has been completed succesfully. Restart <ARIS_Business_Publisher_Server>. 170 .cfg back into their original directory (<installation directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01>/installe dApps/<idsID>/businesspublisher. version 11g under Windows This chapter describes the installation of Oracle Business Process Publisher Server in combination with Oracle WebLogic Server version 11g and approved databases. Note When you combine various technologies.war/config/). and perform the exports. 12. 14. or contact Oracle Corporation support. If you select this procedure.ear/businesspublisher. 2. you must make some settings in the administration console of Oracle WebLogic Server 11g.Oracle BPA Suite Installation and Administration Guide 11. Move the previously backed up configuration files webappserver.5 Oracle WebLogic Server.cfg and batchserver. Always follow the instructions provided in the installation manuals of the relevant manufacturer. Use of the database character set AL32UTF8 is mandatory. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). unlimited growth. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time.1 Step-by-step instructions (Oracle database)_WebLogic11g This procedure describes the adjustments to an Oracle WebLogic Server 11g (en) if you are using an Oracle database 11g. This keeps the two systems from competing for resources.6. If you install a database yourself. You need the file businesspublisher. regular monitoring (e.g. change the name there as well: 171 .com. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher.oracle.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a directory of your choice. and you achieve better performance and higher availability. Prerequisite Copy the file ojdbc5.5.cfg (see below). Otherwise. always follow the instructions provided in the Oracle Installation Guide. If you prefer another name.war for WAR deployment. you run the risk of completely exhausting the memory in the tablespaces. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. We recommend a block size of 8K. The name of the Oracle user is assumed to be ARISBP. We recommend that you set the tablespaces for automatic. you must customize the configuration file webappserver. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. You have created an Oracle database and configured it as follows. You can select any password.Oracle BPA Suite Installation and Administration Guide 2. or you can download it from www. If the option for automatic growth is not set. To use other names or existing tablespaces. You find this file on the installation media. After installation. GRANT CREATE TABLE TO ARISBP. The port number depends on your current configuration. GRANT CREATE VIEW TO ARISBP. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted.Oracle BPA Suite Installation and Administration Guide CREATE USER ARISBP IDENTIFIED BY ARISBP. Procedure 1. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. open the administration console of WebLogic Server in your browser at http://<server name>:<port>/console. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. GRANT QUERY REWRITE TO ARISBP. 172 . ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. The Login dialog box is displayed. GRANT ALTER SESSION TO ARISBP. Select the Deployment node in the navigation bar on the left. An overview page is displayed. 4. and upload it. 173 . 3. Select the file businesspublisher. Log in to Oracle WebLogic Server.war from your hard drive.Oracle BPA Suite Installation and Administration Guide 2. Select Install this deployment as an application. Select an existing cluster on which the application will be available.Oracle BPA Suite Installation and Administration Guide 5. 6. Define how the war file is to be installed. 174 . 8. Select Copy this application onto every target for me. Specify access to the source. This means that the source is available via file access and is not saved in a database. Define businesspublisher as the default application name.Oracle BPA Suite Installation and Administration Guide 7. Select the general application properties and a security model. 175 . Oracle BPA Suite Installation and Administration Guide 9. 176 . take me to the deployment's configuration screen to test the configuration. Select Yes. Oracle BPA Suite Installation and Administration Guide 10. Test the configuration. 177 . 12. 178 . Configure the data source. Define jdbc/businesspublisherdb as the JNDI name. Select the Services/JDBC/Data Sources node in the navigation on the left.Oracle BPA Suite Installation and Administration Guide 11. Define the database type and the JNDI address to be used by Oracle Business Process Publisher. Click on New. Select the database type and the associated database driver. 14. 179 .Oracle BPA Suite Installation and Administration Guide 13. Configure Supports Global Transactions and One-Phase Commit. Oracle BPA Suite Installation and Administration Guide 15. the host on which the database server runs. the port. Define the database name (instance name). and the password to be used to log in to the database. 180 . the user name. 181 . Specify the cluster on which the new data source is available.Oracle BPA Suite Installation and Administration Guide 16. Test the database connection. 17. Display a summary of the data sources. Define the root directory of the Web application for the aris. Adjust the settings for the Java Virtual Machine.businesspublisher.dirs=%DOMAIN_HOME%/servers/%BP_INSTALL%/WEB -INF/lib/endorsed 182 .Oracle BPA Suite Installation and Administration Guide 18. Set the correct Corba server for Oracle Business Process Publisher. Java has a mechanism that can be used to define external libraries: set JAVA_OPTIONS=%JAVA_OPTIONS% Djava. Ensure that each Web application server uses its specific Corba library. To do this.home option: set BP_INSTALL=AdminServer/tmp/_WL_user/businesspublisher/1xhs au/war set JAVA_OPTIONS=%JAVA_OPTIONS% Daris.home=%DOMAIN_HOME%/servers/%BP_INS TALL% 21. You must specify the library to be used by the server.cmd in the directory %beahome%\user_projects\domains\%YourDomain%\bin. Add the following configuration entries for Oracle Business Process Publisher Server at the end of the file to extend the JVM options of the J2EE server.endorsed. open the file setDomainEnf.businesspublisher. 19. 20. 2.1.Oracle BPA Suite Installation and Administration Guide This directory must contain a copy of the file orbacus.5. Search for the string bpservicehost. Open file webappserver. always follow the instructions provided in the MS SQL Installation Guide.15 (en) if you are using an MS SQL Server 2005 database.30.oracle. 24.config=%DOMAIN_HOME%/servers/%BP _INSTALL%/config/bplogin.security.3"/>). 2. or you can download it from www.2 Step-by-step instructions (MS SQL Server 2005 database)_WebLogic This procedure describes the adjustments to an IBM WAS 6. 183 .login.auth. <bpservicehost value="172.3. assuming that 1024 MB are required for every 100 simultaneous users.config. You find this file in directory WEB-INF/lib/endorsed of Oracle Business Process Publisher.auth.jar.0.cfg for Oracle Business Process Publisher is located in the configuration directory of the application: set JAVA_OPTIONS=%JAVA_OPTIONS% Djava. Specify the Java variable java. If you install a database yourself.login. Make the setting you want in file setDomainEnf. which must point to a configuration file in which the login modules are defined.cfg 23.6.cfg. You find this file on the installation media. 22.com.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server/MSSQL) to a directory of your choice.252.war for WAR deployment.cmd. You need the file businesspublisher.cfg in the directory %BP_INSTALL%\config\webappserver. and set the value for the IP address to a fully qualified computer name (e. Allocate memory to the server process.g. The configuration file bplogin. You have created and configured an MS SQL Server 2005 database (Page 234).security. 25. Prerequisite Copy the file jtds.4. The Login dialog box is displayed.Oracle BPA Suite Installation and Administration Guide Procedure 1. 2. An overview page is displayed. open the administration console of WebLogic Server in your browser at http://<server name>:<port>/console. Log in to Oracle WebLogic Server. After installation. 184 . The port number depends on your current configuration. Select the Deployment node in the navigation bar on the left. Define how the war file is to be installed.war from your hard drive.Oracle BPA Suite Installation and Administration Guide 3. Select Install this deployment as an application. 185 . and upload it. Select the file businesspublisher. 5. 4. Select an existing cluster on which the application will be available. 186 .Oracle BPA Suite Installation and Administration Guide 6. Define businesspublisher as the default application name. Select the general application properties and a security model. 7. This means that the source is available via file access and is not saved in a database. 9. take me to the deployment's configuration screen to test the configuration.Oracle BPA Suite Installation and Administration Guide 8. Specify access to the source. 187 . Select Copy this application onto every target for me. Select Yes. Test the configuration. 188 .Oracle BPA Suite Installation and Administration Guide 10. Oracle BPA Suite Installation and Administration Guide 11. Define the database type and the JNDI address to be used by Oracle Business Process Publisher. Select the Services/JDBC/Data Sources node in the navigation on the left. Configure the data source. 12. Define jdbc/businesspublisherdb as the JNDI name. 189 . Click on New. Oracle BPA Suite Installation and Administration Guide 13. Select the database type and the associated database driver. 14. Configure Supports Global Transactions and One-Phase Commit. 190 Oracle BPA Suite Installation and Administration Guide 15. Define the database name (instance name), the host on which the database server runs, the port, the user name, and the password to be used to log in to the database. 191 Oracle BPA Suite Installation and Administration Guide 16. Test the database connection. 17. Specify the cluster on which the new data source is available. 192 Oracle BPA Suite Installation and Administration Guide 18. Display a summary of the data sources. 19. Adjust the settings for the Java Virtual Machine. To do this, open the file setDomainEnf.cmd in the directory %beahome%\user_projects\domains\%YourDomain%\bin. 20. Add the following configuration entries for Oracle Business Process Publisher Server at the end of the file to extend the JVM options of the J2EE server. Define the root directory of the Web application for the aris.businesspublisher.home option: set BP_INSTALL=AdminServer/tmp/_WL_user/businesspublisher/1xhs au/war set JAVA_OPTIONS=%JAVA_OPTIONS% Daris.businesspublisher.home=%DOMAIN_HOME%/servers/%BP_INS TALL% 21. Set the correct Corba server for Oracle Business Process Publisher. You must specify the library to be used by the server. Ensure that each Web application server uses its specific Corba library. Java has a mechanism that can be used to define external libraries: set JAVA_OPTIONS=%JAVA_OPTIONS% Djava.endorsed.dirs=%DOMAIN_HOME%/servers/%BP_INSTALL%/WEB -INF/lib/endorsed 193 Oracle BPA Suite Installation and Administration Guide This directory must contain a copy of the file orbacus.4.3.2.jar. You find this file in directory WEB-INF/lib/endorsed of Oracle Business Process Publisher. 22. Specify the Java variable java.security.auth.login.config, which must point to a configuration file in which the login modules are defined. The configuration file bplogin.cfg for Oracle Business Process Publisher is located in the configuration directory of the application: set JAVA_OPTIONS=%JAVA_OPTIONS% Djava.security.auth.login.config=%DOMAIN_HOME%/servers/%BP _INSTALL%/config/bplogin.cfg 23. Allocate memory to the server process, assuming that 1024 MB are required for every 100 simultaneous users. Make the setting you want in file setDomainEnf.cmd. 24. Open file webappserver.cfg in the directory %BP_INSTALL%\config\webappserver.cfg. 25. Search for the string bpservicehost, and set the value for the IP address to a fully qualified computer name (e.g. <bpservicehost value="172.30.252.3"/>). 2.6.6 Oracle Business Process Publisher Report Server installations This chapter describes the Oracle Business Process Publisher Report Server installations for the approved Web Application Servers. After the standard installation, reports are run by Oracle Business Process Publisher Server. You can additionally install a Report Server (Page 194) to optimize system performance when running reports. After you install Oracle Business Process Publisher Report Server, exports are managed by Oracle Business Process Publisher Server and reports are run by Oracle Business Process Publisher Report Server. To be able to work with Oracle Business Process Publisher Report Server, the same database and database server must be used as for the Oracle Business Process Publisher Server installation. Note If you do not install the server with the setup program, you must adjust the configuration file batchserver.cfg. 194 Oracle BPA Suite Installation and Administration Guide 2.6.6.1 Apache Tomcat Web Application Server under Windows This chapter describes the installation of Apache Tomcat Web Application Server under Microsoft Windows. Note When you combine various technologies, please observe the manufacturers' instructions, particularly announcements concerning releases on their Internet pages. We cannot guarantee proper functioning of supported third-party systems. Always follow the instructions provided in the installation manuals of the relevant manufacturer, or contact Oracle Corporation support. 2.6.6.1.1 Step-by-step instructions (standard database) This procedure describes the standard installation of Apache Tomcat Web Application Server if you are using a Derby database. With this database system, up to 10 users can access exports simultaneously. For a larger number of users, you need the Oracle (Page 288) database system or MS SQL Server 2005. Depending on the Oracle Business Process Publisher Server license purchased, these systems enable all users to simultaneously work on exports. Procedure 1. Ensure that the system requirements for all products and functionalities are met. 2. Insert the Oracle BPA Suite installation media into the appropriate drive. If the start page is not displayed automatically, click on the name of your drive in Windows Explorer and run the OracleBPA.exe program. 3. Click on Install Oracle Business Process Publisher Server. 4. The installation program's Welcome page opens. Click on Next. 5. Once you have read the license agreements and accept them, click on Yes. The Select target path page opens. If other Oracle BPA Suite products are already installed on the computer, this step is skipped and the directory in which the other products are installed is used. 6. Select the installation directory. To use the installation directory suggested in the Target folder box, click on Next. To install the products in a directory different from the one suggested, click on 195 Oracle BPA Suite Installation and Administration Guide Change. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box, and then click on OK. Click on Next. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. The Select program folder page opens. 7. Select the program directory in which to place the program shortcut. If other Oracle BPA Suite products are already installed on the computer, this step is skipped and the directory in which the other products are installed is used. The program directory for Oracle BPA Suite is created. To use a different name, enter a name in the Program folder box or select the program folder in the Existing folders box, and then click on Next. 8. Select the option Oracle Business Process Publisher Report Server. The page Oracle Business Process Publisher Server opens. 9. Enter the computer name or IP address of the computer on which Oracle Business Process Publisher Server is installed. 10. Enable the Standard Database System check box if you want to use the standard database. 11. Check your settings in the summary. If your settings are correct, click on Next. The components will now be installed. 12. Click on Finish. The installation is complete and the installation program closes. 13. If you want to use another database instead of the Derby database, ensure that the appropriate database is installed and adjust the database management system for use with Oracle Business Process Publisher Server (Page 233). 14. Communicate the URL (<root directory of Oracle Business Process Publisher Server>/<context>) that allows users to access every Publisher export and administrators to manage exports. After the standard installation of Oracle Business Process Publisher Server, the URL is http://<server name>:9090/businesspublisher if you did not change the default settings during installation. 196 Otherwise. To use other names or existing tablespaces. Use of the database character set AL32UTF8 is mandatory. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. This description assumes you are using Apache Tomcat. regular monitoring (e.Oracle BPA Suite Installation and Administration Guide 15. If you have installed Oracle Business Process Publisher Server on an external computer. unlimited growth. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). change the IP address in the configuration file. always follow the instructions provided in the Oracle Installation Guide. the URL is http://<server name>:9090/businesspublisher if you did not change the default settings during installation. If you use this database.cfg (see below).6. If you install a database yourself. Prerequisite You have created an Oracle database and configured it as follows. you run the risk of completely exhausting the memory in the tablespaces. This keeps the two systems from competing for resources. you must customize the configuration file webappserver. If the option for automatic growth is not set. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. 197 .6. After the standard installation of Oracle Business Process Publisher Server. all enabled users can work simultaneously with a Publisher export. 2.1.g. To create a Publisher export and enable users to work with it. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. We recommend a block size of 8K.2 Step-by-step instructions (Oracle database configured)_tomcat Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. you must start Oracle Business Process Publisher Server and communicate the URL. and you achieve better performance and higher availability. We recommend that you set the tablespaces for automatic. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. Procedure 1. You can select any password. GRANT CREATE TABLE TO ARISBP. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX.\BPServer\tomcat\conf\catalina\localhost\ with a text editor.xml (see below). Enter it in the configuration file businesspublisher. 2. GRANT QUERY REWRITE TO ARISBP.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" 198 . Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax.sql. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP.Oracle BPA Suite Installation and Administration Guide You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. GRANT ALTER SESSION TO ARISBP.xml in the Oracle Business Process Publisher Server installation directory . The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. If you prefer another name. GRANT CREATE VIEW TO ARISBP. The name of the Oracle user is assumed to be ARISBP. Open the file businesspublisher.. Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle. port.driver.jdbc.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname.application.html (http://jakarta. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites). Open the file webappserver. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3.html)--> username="ARISBP" password="ARISBP" <!-. please maintain them here. a.cfg in the Oracle Business Process Publisher Server installation directory .businesspublisher.org/commons/dbcp/configuration. b.apache.lang. For an explanation of these values.Oracle BPA Suite Installation and Administration Guide <!-.A OracleDAO</env-entryvalue> </env-entry> 199 .Configure the DBCP (database connection pool) with these values.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.database.org/commons/dbcp/configuration.dao.String</env-entry-type> <env-entry-value> com.. go to: http://jakarta.idsscheer.apache. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.aris. 2. We cannot guarantee proper functioning of supported third-party systems. If other Oracle BPA Suite products are already installed on the computer. this step is skipped and the directory in which the other products are installed is used. particularly announcements concerning releases on their Internet pages. Always follow the instructions provided in the installation manuals of the relevant manufacturer.2. Click on Install Oracle Business Process Publisher Server. Once you have read the license agreements and accept them. or contact Oracle Corporation support. 3.jar exists in the Oracle Business Process Publisher Server installation directory . The Select target path page opens. We assume that you are using version 10. 5. click on Next.. The installation program's Welcome page opens. To use the installation directory suggested in the Target folder box. click on the name of your drive in Windows Explorer and run the OracleBPA. Select the installation directory. Click on Next. The Select program folder page opens. 200 . You find the file on the installation media. Install Oracle Business Process Publisher Report Server Procedure 1.exe program. Ensure that the system requirements for all products and functionalities are met. Insert the Oracle BPA Suite installation media into the appropriate drive. Note When you combine various technologies. 4. click on Yes. Click on Next.Oracle BPA Suite Installation and Administration Guide 4.\BPServer\tomcat\common\lib. Ensure that the JDBC driver ojdbc5.3. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. 6. If the start page is not displayed automatically. To install the products in a directory different from the one suggested. click on Change. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. please observe the manufacturers' instructions.0. and then click on OK. The page Oracle Business Process Publisher Server opens. Prerequisite You have created an Oracle database and configured it as follows. 11. and then click on Next.3 Step-by-step instructions (existing Oracle database)_tomcat Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. Select the option Oracle Business Process Publisher Report Server.1. Click on Finish. Enter the port number (1521 is set as default). This keeps the two 201 . Click on Next. 8. The installation is complete and the installation program closes. If your settings are correct. To use an Oracle database. The program directory for Oracle BPA Suite is created. and database user (ARISBP is set as default). enable the Oracle Database check box. To use a different name. This description assumes you are using Apache Tomcat. all enabled users can work simultaneously with a Publisher export.6. If you install a database yourself. click on Next. If other Oracle BPA Suite products are already installed on the computer.Oracle BPA Suite Installation and Administration Guide 7. Check your settings in the summary. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. Select the program directory in which to place the program shortcut. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. enter a name in the Program folder box or select the program folder in the Existing folders box. 10.6. always follow the instructions provided in the Oracle Installation Guide. 2. 9. 12. this step is skipped and the directory in which the other products are installed is used. Click on Next. If you use this database. service name of your database (BUPU1020 is set as default). 13. Enter the computer name or IP address of the computer on which Oracle Business Process Publisher Server is installed. The components will now be installed. xml (see below). you must customize the configuration file webappserver. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). We recommend a block size of 8K. regular monitoring (e. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. GRANT QUERY REWRITE TO ARISBP. you run the risk of completely exhausting the memory in the tablespaces. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. 202 .g. unlimited growth. The name of the Oracle user is assumed to be ARISBP. You can select any password. GRANT CREATE VIEW TO ARISBP. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database.Oracle BPA Suite Installation and Administration Guide systems from competing for resources. and you achieve better performance and higher availability.cfg (see below). Otherwise. If you prefer another name. GRANT CREATE TABLE TO ARISBP. To use other names or existing tablespaces. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA. GRANT ALTER SESSION TO ARISBP. We recommend that you set the tablespaces for automatic. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. If the option for automatic growth is not set. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP. Use of the database character set AL32UTF8 is mandatory. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. Enter it in the configuration file businesspublisher. port.apache. a.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname. 2.sql.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor. For an explanation of these values.org/commons/dbcp/configuration.jdbc.driver. 203 . Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax.org/commons/dbcp/configuration..html)--> username="ARISBP" password="ARISBP" <!-.Oracle BPA Suite Installation and Administration Guide Procedure 1. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3.apache.\BPServer\tomcat\conf\catalina\localhost\ with a text editor.cfg in the Oracle Business Process Publisher Server installation directory . please maintain them here.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" <!-.Configure the DBCP (database connection pool) with these values.. Open the file businesspublisher. go to: http://jakarta.html (http://jakarta. Open the file webappserver.xml in the Oracle Business Process Publisher Server installation directory . Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites).Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle. Click on Install Oracle Business Process Publisher Server.jar exists in the Oracle Business Process Publisher Server installation directory . Install Oracle Business Process Publisher Report Server Procedure 1.idsscheer. We cannot guarantee proper functioning of supported third-party systems. Note When you combine various technologies. Ensure that the system requirements for all products and functionalities are met..A OracleDAO</env-entryvalue> </env-entry> 4.lang. or contact Oracle Corporation support.businesspublisher. 4. If the start page is not displayed automatically. Insert the Oracle BPA Suite installation media into the appropriate drive. Ensure that the JDBC driver ojdbc5.0. The installation program's Welcome page opens.dao. Always follow the instructions provided in the installation manuals of the relevant manufacturer.database. 2. 3.exe program.3. click on the name of your drive in Windows Explorer and run the OracleBPA. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java. You find the file on the installation media. Click on Next.application.aris. please observe the manufacturers' instructions.Oracle BPA Suite Installation and Administration Guide b.String</env-entry-type> <env-entry-value> com. 204 .\BPServer\tomcat\common\lib. We assume that you are using version 10. particularly announcements concerning releases on their Internet pages.2. Select the option Oracle Business Process Publisher Report Server. The Select target path page opens. 11. 205 . 12. To install the products in a directory different from the one suggested. The Select program folder page opens. Click on Next. click on Yes. 8.Oracle BPA Suite Installation and Administration Guide 5. The program directory for Oracle BPA Suite is created. If the check is not successful. Select the installation directory. If other Oracle BPA Suite products are already installed on the computer. this step is skipped and the directory in which the other products are installed is used. 10. enable the Oracle Database check box. To use an Oracle database. Click on Next. enter a name in the Program folder box or select the program folder in the Existing folders box. Once you have read the license agreements and accept them. 9. The page Oracle Business Process Publisher Server opens. Select the program directory in which to place the program shortcut. 6. To use a different name. and then click on OK. If other Oracle BPA Suite products are already installed on the computer. The installation program checks whether an sqlplus command is installed and whether a link can be established to it. If the check is successful. click on Change. and then click on Next. The database may be installed locally or on a different computer. Click on Configure and Connect Existing Oracle Database Instance. an error message is output. Enter the computer name or IP address of the computer on which Oracle Business Process Publisher Server is installed. this step is skipped and the directory in which the other products are installed is used. Click on Next. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. click on Next. the dialog box Configure and Connect Existing Oracle Database Instance opens. 7. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters. To use the installation directory suggested in the Target folder box. If you install a database yourself.6. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. We recommend that you set the tablespaces for automatic. all enabled users can work simultaneously with a Publisher export. click on Next. Enter the port number (1521 is set as default). Prerequisite You have created an Oracle database and configured it as follows. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. you must customize the configuration file webappserver. unlimited growth. We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. service name of your database (BUPU1020 is set as default). Click on Next. Use of the database character set AL32UTF8 is mandatory. always follow the instructions provided in the Oracle Installation Guide. This keeps the two systems from competing for resources. 16. The installation is complete and the installation program closes.1.cfg (see below). you run the risk of completely exhausting the memory in the tablespaces. Otherwise. The components will now be installed.4 Step-by-step instructions (new Oracle database)_tomcat Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database.Oracle BPA Suite Installation and Administration Guide 13. and database user (ARISBP is set as default). 2. Check your settings in the summary. If your settings are correct. 14.6. If you use this database. Select the data tablespace and the index tablespace in the dialog box. This description assumes you are using Apache Tomcat. 15. Click on Next. We recommend a block size of 8K. To use other names or existing tablespaces. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). Click on Finish. If the 206 . and you achieve better performance and higher availability. If you prefer another name. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA.xml (see below). We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. regular monitoring (e. go to: 207 . GRANT QUERY REWRITE TO ARISBP.sql.Oracle BPA Suite Installation and Administration Guide option for automatic growth is not set. GRANT ALTER SESSION TO ARISBP.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" <!-. Open the file businesspublisher. Procedure 1.\BPServer\tomcat\conf\catalina\localhost\ with a text editor. GRANT CREATE VIEW TO ARISBP.. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. For an explanation of these values. You can select any password.g. 2. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. The name of the Oracle user is assumed to be ARISBP.Configure the DBCP (database connection pool) with these values. Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP. Enter it in the configuration file businesspublisher. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. GRANT CREATE TABLE TO ARISBP.xml in the Oracle Business Process Publisher Server installation directory . 208 . Ensure that the JDBC driver ojdbc5.dao.database.html)--> username="ARISBP" password="ARISBP" <!-.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3.0. Open the file webappserver.org/commons/dbcp/configuration.cfg in the Oracle Business Process Publisher Server installation directory . b. a.application.driver.businesspublisher.3. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites).aris.Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle. We assume that you are using version 10.apache.String</env-entry-type> <env-entry-value> com.\BPServer\tomcat\common\lib. port. please maintain them here.2..idsscheer.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.apache..jdbc.A OracleDAO</env-entryvalue> </env-entry> 4.jar exists in the Oracle Business Process Publisher Server installation directory .html (http://jakarta. You find the file on the installation media. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.org/commons/dbcp/configuration.Oracle BPA Suite Installation and Administration Guide http://jakarta.lang. click on the name of your drive in Windows Explorer and run the OracleBPA. Install Oracle Business Process Publisher Report Server Procedure 1. Ensure that the system requirements for all products and functionalities are met. Once you have read the license agreements and accept them. click on Yes. Click on Next. We cannot guarantee proper functioning of supported third-party systems. 7. this step is skipped and the directory in which the other products are installed is used. 3. click on Change. To install the products in a directory different from the one suggested. 2. Click on Install Oracle Business Process Publisher Server. this step is skipped and the directory in which the other products are installed is used. 209 . Select the installation directory. To use the installation directory suggested in the Target folder box. If the start page is not displayed automatically. If other Oracle BPA Suite products are already installed on the computer.Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies. please observe the manufacturers' instructions. The program directory for Oracle BPA Suite is created. Note Note that the name of the installation directory must not contain any spaces or country-specific special characters.exe program. particularly announcements concerning releases on their Internet pages. The Select target path page opens. The installation program's Welcome page opens. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. 4. and then click on OK. If other Oracle BPA Suite products are already installed on the computer. Always follow the instructions provided in the installation manuals of the relevant manufacturer. Select the program directory in which to place the program shortcut. 6. click on Next. The Select program folder page opens. Insert the Oracle BPA Suite installation media into the appropriate drive. 5. or contact Oracle Corporation support. Click on Next. 10. click on the Browse button. box. The page Oracle Business Process Publisher Server opens. 12. service name of your database (BUPU1020 is set as default). The database may be installed locally or on a different computer. Port 1521 is the default. c. Click on Next. To install the database in a different directory than the one suggested. 9. a. The components will now be installed. SYSTEM. It must be a port that is not used.Oracle BPA Suite Installation and Administration Guide To use a different name. Note that the name of the directory must not contain any country-specific special characters. Check your settings in the summary. etc. Enter the computer name or IP address of the computer on which Oracle Business Process Publisher Server is installed. Click on Next. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. Enter the port number (1521 is set as default). d. This is checked in the next step. enable the Oracle Database check box. If your settings are correct. The installation is complete and the installation program closes. 14. click on Next. b. enter a name in the Program folder box or select the program folder in the Existing folders box. and then click on Next. and database user (ARISBP is set as default). Click on Finish. The name of the new database is BPA. Click on Create New Oracle Database Instance. Click on Next. and then click on OK. The Create New Oracle Database Instance dialog box opens. 11. e. Select the directory for the database files of the database being created. f. Select the option Oracle Business Process Publisher Report Server. Enter the relevant path in the Path box or navigate to the relevant directory in the Directories box. 210 . 8. 13. To use an Oracle database. Enter the port number of the new Oracle Listener. 15. and confirm your entry. Enter the password for the system users in the Password for SYS. Click on Next. Select the Oracle database installation to be used. Copy the JDBC driver jTDS. c. Adjust the path to the database file.cfg. On the Security tab. 2. The script creates the specified data groups.1. Open the Server properties dialog box. a.sql (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a directory of your choice. If you specify the ARISBP11 database name. you must also change them in the configuration file businesspublisher. ARISBPDATA: contains all database objects ARISBPINDEX: contains all index data d. If you have changed the names in the script.6. Procedure 1.xml. and password according to your choice. You have installed Microsoft SQL Server 2005 under MS Windows.6.sql. 211 . Create a database using the script create_db.5 Step-by-step instructions (MS SQL Server 2005 database) Please adjust the system as required to manage Oracle Business Process Publisher in combination with an MS SQL Server 2005 database.xml and webappserver. you must also change them in the configuration files businesspublisher. 3.Oracle BPA Suite Installation and Administration Guide 2. Open the script for editing. Prerequisite Copy the file create_db. b. Microsoft SQL Server 2005 is not included in the package. Ensure that Latin1_General_CI_AI sorting is selected for the COLLATE statement. If you use the MS SQL Server 2005 database. user name. select the SQL Server and Windows authentication mode option. which is not possible with the standard database. Ensure that the path has been created before you run the script.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the Tomcat installation directory under common/lib. all users covered by the license can simultaneously work with a Publisher export. lang.com/kb/914277/en-us).\BPServer\tomcat\conf\catalina\localhost\businesspublisher.instance=<name of instance>. b.Driver.dao. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.AMSSQLDAO</env-entry-value> </env-entry> Tip For additional information about Microsoft SQL Server 2005.idsscheer. Customize the configuration file ..String</env-entry-type> <env-entryvalue>com.instance =MSSQLSRV. Ensure that the entries in the following line are correct: <bp-mssql schema="ARISBPDATA" filegroupdata="ARISBPDATA" filegroup-index="ARISBPINDEX" /> If you have changed the names in the script.application. Ensure that the URL has been adjusted correctly.database .Oracle BPA Suite Installation and Administration Guide 4. jdbc:jtds:sqlserver://hostname:1433/ARISBP11.jdbc.businesspublisher. use it instead of ARISBP11.jtds.microsoft. visit http://support.\BPServer\tomcat\webapps\businesspublisher\config\webappserv er. Ensure that the driverClassName property is set to net.aris. Change the user name and password. for example. you must adjust them here.microsoft. for example as follows: jdbc:jtds:sqlserver://hostname:<Port>/ARISBP11 If you have specified a database name of your choice. 5.. a.sourceforge. c. Customize the configuration file .cfg. If you are using named instances. 212 .com/kb/914277/en-us (http://support. complete the URL with the following entry: .xml: a. 6. Ensure that the database connection is set for MSSQL. The Select program folder page opens. Click on Next. enter a name in the Program folder box or select the program folder in the Existing folders box. click on the name of your drive in Windows Explorer and run the OracleBPA. 6. The program directory for Oracle BPA Suite is created. Install Oracle Business Process Publisher Report Server Procedure 1. or contact Oracle Corporation support. particularly announcements concerning releases on their Internet pages. To use a different name. If other Oracle BPA Suite products are already installed on the computer. 2. If the start page is not displayed automatically. 8. this step is skipped and the directory in which the other products are installed is used.Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies. The installation program's Welcome page opens. Enter the computer name or IP address of the computer on which Oracle Business Process Publisher Server is installed. The page Oracle Business Process Publisher Server opens. 213 . Select the program directory in which to place the program shortcut. please observe the manufacturers' instructions. this step is skipped and the directory in which the other products are installed is used. The Select target path page opens. Click on Additional Installations. 3. click on Yes. 5. We cannot guarantee proper functioning of supported third-party systems. If other Oracle BPA Suite products are already installed on the computer. 9. 4.exe program. and then click on Next. Click on Next. Select the option Oracle Business Process Publisher Report Server. Once you have read the license agreements and accept them. Always follow the instructions provided in the installation manuals of the relevant manufacturer. Click on Install Oracle Business Process Repository. Ensure that the system requirements for all products and functionalities are met. 7. Insert the Oracle BPA Suite installation media into the appropriate drive. The installation program's Welcome page opens. 11. Click on Acrobat Reader <Version>. Enter the name or IP address of the computer on which your Oracle Business Process Publisher Server is installed. The page Default application for viewing PDF opens. The installation is complete and the installation program closes. 5. 7. you install the viewer for displaying PDF documents such as the Methods Manual. If the start page is not displayed automatically. Procedure 1. 13. Enter the port number (1521 is set as default). 214 . Enable the option button for the required viewer version. To install the program in a different directory than the one suggested. click on Next. 12. Check your settings in the summary. click on Browse. 2.7 Acrobat Reader Here. and database user (ARISBP is set as default). 4. click on Next and continue with the next step. Click on Next. Note that the name of the installation directory must not contain any country-specific special characters. Click on Next. click on the name of your drive in Windows Explorer and run the OracleBPA. Click on Additional Installations. Enter the desired path in the Path box or navigate to the desired directory in the Directories box. service name of your database (BUPU1020 is set as default). Click on OK. If your settings are correct. 3.Oracle BPA Suite Installation and Administration Guide 10.exe program. enable the MS SQL Server check box. 2. To use the suggested installation directory. The components will now be installed. and click on Next. 6. Click on Install. Click on Finish. To use an MS SQL Server. Click on Next. click on the name of your drive in Windows Explorer and run the OracleBPA. 5. Otherwise. The installation is performed and a message is displayed when it is complete. Once you have read the license agreements and accept them. If the start page is not displayed automatically. 4. Click on Java Runtime Environment to start the JRE setup. Procedure 1. Click on Finish to exit the JRE installation program.8 Java Runtime Environment To use Oracle BPA Suite via a browser. Note Install JRE in a path whose directory name does not include any spaces. If you are using software systems that install their own JRE: Please make sure that in the environment variables the path of the SUN JRE is entered before the ones of software systems having their own JRE. it may not be possible to run Oracle Business Process Architect via a browser. JRE cannot be executed.exe program. To perform a different installation. Otherwise. install SUN Java Runtime Environment (JRE) if you have not yet done so. 2. This section describes the standard installation process. 3. Enable the Default option and click on Next.Oracle BPA Suite Installation and Administration Guide 2. enable the Adapted option button during JRE installation. 215 . enable the relevant check box and click on Next. to edit them there. For further information please refer to the online help. 2. After having transferred the new models you can prepare them graphically by means of automatic layout generation. you can define processes and transfer them to an Oracle BPA Suite database later.Oracle BPA Suite Installation and Administration Guide 2. In this way. even without Oracle BPA Suite installed. and to return them to Oracle BPA Suite again. Thus.1 Oracle BPA Suite Process Generator Oracle Process Generator enables you to transfer objects and models to Excel. you can quickly enter large quantities of data using object tables. In addition. you can easily define new objects or process models of the EPC type in an Excel table and transfer them to Oracle BPA Suite databases. In addition.9 System add-ons This chapter describes the installation of system add-ons. 216 .9. attributes are entered and edited independently of an installed Oracle BPA Suite. 3 Oracle Business Process Repository . Open the list item Management. 2. The Control Panel of your operating system opens. 2. You can also connect to an Oracle Business Process Repository to create databases there and work with them.10.System architecture Oracle BPA Suite has the following components: Oracle Business Process Repository Oracle Business Process Publisher Server Database server (standard database system or other database system) Oracle BPA Suite client products Oracle Business Process Repository Site Manager (includes HTML Generator and Oracle BPA Suite Web Report Server) Web server (Oracle BPA Suite Web Client Components) 2.Oracle BPA Suite Installation and Administration Guide 2. 2. 217 . and select Settings/Control Panel. Open the Windows Start menu. Procedure 1.2 Oracle Business Process Architect installations Oracle Business Process Architect installations (option Oracle BPA Suite WITH LOCAL STANDARD DATABASE SYSTEM) are suitable for users who only work with local databases or who want to access local databases and databases on the network.Exit a service Prerequisite Ensure on your computer that you have the privilege to exit Windows services that have been started.10.1 Oracle BPA Suite . This allows you to create databases on your computer and work with them without other users being able to access them.10. The standard database system is also installed with this installation.10 Additional installation information and principles This chapter provides installation information and basics. when uninstalling) Directory <Oracle BPA Suite installation directory>\LocalServer\sysconfig Directory <Oracle BPA Suite installation directory>\html Directory <Oracle BPA Suite installation directory>\script In a server installation in directory <Oracle BPA Suite installation directory>\server\backup Files from <Oracle BPA Suite installation directory>\server\data (user databases. the relevant files and directories are backed up. check whether the service Oracle BPA Suite Server 11g has been started.4 Automatic backup When you perform an update. In the Status column. 5.1 and select Exit. make changes to a program. 4. or uninstall a component. A selection of files is listed here to provide examples: In a client installation in directory <Oracle BPA Suite installation directory>\backup<date>: Files from <Oracle BPA Suite installation directory>\LocalServer\data (user databases. add languages. when uninstalling) Directory <Oracle BPA Suite installation directory>\server\sysconfig Directory <Oracle BPA Suite installation directory>\server\templates 218 . The service Oracle BPA Suite Server 11g is now exited. If so.Oracle BPA Suite Installation and Administration Guide 3. right-click on the service Oracle BPA Suite Server 7. Then open the list item Services.10. 2. 10.5. run the Oracle BPA Suite setup again and select the Modify Program option. click on Cancel. Once you have determined which languages are installed. When you install additional languages. In this case. you need to install them for both Oracle Business Process Repository and the Oracle BPA Suite client.10. If you make any changes to the Oracle BPA Suite client or Oracle Business Process Repository. To find out which languages have been installed for Oracle BPA Suite.Oracle BPA Suite Installation and Administration Guide 2. Installed languages are enabled on the Select Language page of the Oracle BPA Suite setup.1 Installation The Oracle BPA Suite client is already installed on the computer. you need to ensure that both Oracle Business Process Repository and the Oracle BPA Suite client are included. when you perform a version update. you need to ensure that both have the same version and are installed with the same languages after the changes: Therefore. you have to consider these particular issues when an Oracle BPA Suite client and Oracle Business Process Repository are installed on the same computer. If you install Oracle Business Process Repository afterward. 219 .Oracle BPA Suite client and Oracle Business Process Repository on the same computer Oracle BPA Suite clients and Oracle Business Process Repository use shared components that can only be installed once per computer. Therefore. 2. there is no need for you to add the installation directory for Oracle Business Process Repository.5 Particular issues . its installation directory will automatically be inserted into the directory structure (<Oracle BPA Suite installation directory>\server). During the installation of Oracle Business Process Repository. you must select the same languages as for the previous installation of the Oracle BPA Suite client. you uninstall programs using the Setup or from Start/Control Panel/Software. its files and directories are automatically integrated into the Oracle Business Process Repository directory structure.2 Uninstall You can uninstall Oracle Business Process Repository and Oracle BPA Suite clients individually without affecting the operability of the remaining component. you must select the same languages as for the previous installation of Oracle Business Process Repository. you uninstall Oracle Business Process Repository (Page 43) or Oracle BPA Suite clients by deleting the relevant directories in the installation directory. Installed languages are enabled on the Select Language page of the Oracle Business Process Repository setup. 2.Oracle BPA Suite Installation and Administration Guide Oracle Business Process Repository is already installed on the computer. run the Oracle Business Process Repository setup again and select the Modify program option. Under Unix/Linux. click on Cancel. there is no need for you to add the installation directory for the Oracle BPA Suite client. To find out which languages have been installed for Oracle Business Process Repository. During the installation of the Oracle BPA Suite client.5. Once you have determined which languages are installed. If you then install the Oracle BPA Suite client. In this case. The order in which they were installed is irrelevant.10. Under Windows. 220 . we recommend that you make use of the Oracle Corporation installation support. please read the following pages.1 Oracle Business Process Repository Oracle database management system for Oracle Business Process Repository If you wish to run Oracle Business Process Repository based on Oracle as the database management system. You can also assign other names for the two tablespaces. you must later adapt the configuration.1.1. 3. The block size should be 8K. 3. particularly announcements concerning releases on their Internet pages. We cannot guarantee proper functioning of supported third-party systems. please observe the manufacturers' instructions. Always follow the instructions provided in the installation manuals of the relevant manufacturer.1 3. Note A relatively small Oracle BPA Suite database occupies on the order of 100 MB per tablespace. Procedure Create two permanent tablespaces ARISDATA and ARISINDEX for the indices. The size required for the tablespaces ultimately depends on the anticipated number of Oracle BPA Suite databases and 221 . Note When you combine various technologies.1. Please read the information about Oracle Business Process Repository and database approvals. To set up your database server. In this case.1.Oracle BPA Suite Installation and Administration Guide 3 3.1 Set up the database We assume use of database character set AL32UTF8.1.1 Administration Database management systems This chapter describes how to set up and manage databases on different database management systems. or contact Oracle Corporation support.1. at least the Oracle client software must be available on the computer on which you intend to run the scripts.1. The scripts create the two Oracle users arisadm71 and ARIS71: arisadm71 This user is only used as a schema for the database objects required by BPA. 3. For this reason. you can use the scripts available on the Oracle BPA Suite installation media in the Setups\DBMS\Oracle directory.1. you can have the server setup program create the database objects. at least the Oracle client software must be available on the computer on which you intend to run the scripts. Since this is difficult to predict.1. Alternatively.2 Use SQL*Plus scripts The scripts install the database objects required for operating Oracle BPA Suite in an existing Oracle database.1. 222 . 3. Since the scripts rely on SQL*PLUS. The user ARIS71 itself does not have any database objects.1. The system privilege assigned to the user ARIS71 is CREATE SESSION.1.Oracle BPA Suite Installation and Administration Guide their size.1 Install Oracle BPA Suite database objects To install the database objects that are required to operate Oracle BPA Suite. The privileges assigned to this user are: CREATE TABLE CREATE VIEW CREATE TRIGGER ARIS71 This is the user that Oracle Business Process Repository uses to access the data in the schema arisadm71. It solely has object privileges for the database objects in the schema arisadm71.1. Since the scripts rely on SQL*PLUS. it does not require a CREATE SESSION privilege. Oracle Business Process Repository never connects to this user.1. it is best to start with 4 GB per tablespace and keep an eye on the trend toward exhausting that capacity. the scripts for importing the database objects required for operating Oracle BPA Suite can be run. 223 .sql SQL*Plus script for creating the user arisadm71 appuserc. you must adjust configurations in the file envset.sql Procedures for managing Oracle BPA Suite databases.bat is called by the file install. you need the bash as Shell.Oracle BPA Suite Installation and Administration Guide 3.sh is called by the file install. envset.2. install.1.sql SQL*PLUS script for removing the users arisadm71 and ARIS71.bat.sh).bat Batch files for adjusting settings The file envset.1 Available SQL*Plus scripts Once the Oracle database is created.sql SQL*Plus script for creating the connection user ARIS71 schema_aris. The following scripts are available: install.sh Bash script for adjusting settings The file envset. you need the bash as Shell.sh).bat (or install. deinstall.1. To run this script under Unix.1.1.sql SQL*PLUS script for creating a procedure that produces a spreadsheet set for an Oracle BPA Suite database basemgr.bat Windows batch files for running SQL*Plus scripts envset.sh Bash script for running SQL*Plus scripts To run this script under Unix. Before you run scripts by calling them from install.bat (or envset. adminc.sh. 3.sh.1. enter the host name (or IP address) on which the Oracle instance is running. enter an Oracle user who has a DBA role.2 Run batch files install.sh).3 Configure the installation scripts Before you run the scripts. Adjustments can be made in the file envset.1 Connection data You can change connection data.bat and envset. 4.1.sh file must be adjusted.2.1.1. You find this on the installation media under Setups\DBMS\Oracle. which you find on the installation media under Setups\DBMS\Oracle. Procedure 1. Find the line SET DL_ORA_BIN_PATH=. If this path is already in the system path. and specify the path to the directory where the Oracle binaries reside.1.1.1.bat file (or envset. 2. which you find on the installation media under Setups\DBMS\Oracle.1. you must adjust them to your environment. Enter the port in the line SET TARGET_PORT=1521.bat and envset.3.sh with a text editor. 3.1.bat or envset. 224 .1.sh If you have adjusted configurations (Page 224) in the envset.1. Provide it with a password in the line SET INSTALL_PWD=manager. Open the file envset.1. you can call the batch file install.2 Change tablespace names If you have assigned other names to the tablespaces (Page 221). In the line SET TARGET_HOST=localhost. 3.Oracle BPA Suite Installation and Administration Guide 3. you can leave the value empty. 6.1.1. In the line SET INSTALL_USER=system. First copy these files to the hard drive of the computer on which they will be run.sh). To do this. 3.1.bat/install.bat or envset. First copy these files to the hard drive of the computer on which they will be run. the envset. 3. for example the Oracle user SYSTEM. In the line SET TARGET_SERVICE_NAME=BPA. enter the service name (or Oracle SID).1. edit the files envset. 5.bat (or install.sh. Open the file envset. but immediately after Oracle Business Process Repository starts for the first time. 2. To select another password for the Oracle user ARIS71 in advance. 225 . and replace the tablespace name ARISDATA with the one you selected. and replace the tablespace name ARISINDEX with the one you selected.sh file before the scripts are used. Procedure 1. edit the envset.1. you must specify it in the file Lockservice.bat or envset.cfg in the config directory of Oracle Business Process Repository Site Manager with a text editor.1. you should change it immediately. Open the file envset.cfg.1. The default password for this user is *ARIS!1dm9n#. Find the line arisadm_pwd_=*ARIS!1dm9n#. To prevent misuse. 2. and change the password.bat or envset. Find the line SET DLAPP_PWD=*ARIS!1dm9n#. Find the line SET DL_TS_INDEX=ARISINDEX. You can also change the password later at any time using the Oracle BPA Suite function DBMS password.sh with a text editor. Find the line SET DL_TS_DATA=ARISDATA. After Oracle Business Process Repository starts. while the key arisadm_pwd without a final underscore identifies the encrypted password. 3. 4.cfg in the config directory of Oracle Business Process Repository Site Manager. 3. Note The password is specified in plain text in the file Lockservice.1. it encrypts the password in the file Lockservice. 3.Oracle BPA Suite Installation and Administration Guide Procedure 1.sh with a text editor. The key arisadm_pwd_ with final underscore identifies the password as a plain text password.bat and envset.cfg. You can specify another temporary tablespace in the line SET DL_TS_TEMP=TEMP if needed.3. Open the file Lockservice. the arisadm_pwd_ variant is converted into the arisadm_pwd variant. and change the password. 5.3 Change the password for Oracle user ARIS71 Change the password for the Oracle user ARIS71. For Oracle Business Process Repository to use the new password. 3.3.1.cfg in the config directory of Oracle Business Process Repository Site Manager with a text editor. 6. 5. and replace the default value in this line with the user name you want. Oracle Business Process Repository only connects to the Oracle user ARIS71. 2. 226 . 3. for example. this user does not need a working password.1.2 Configure Oracle Business Process Repository URL For Oracle Business Process Repository to connect to your Oracle instance. 3.cfg in the config directory of Oracle Business Process Repository Site Manager. and replace the default value in this line with the user name you want.1. 4. Find the lines arisadm_schema=BPAadm11 and arisadm_user=bpa11.4 Change the password for Oracle user arisadm71 The user arisadm71 solely serves as a schema for data required by Oracle BPA Suite.1. you must specify this in the file Lockservice.1. The scripts give user arisadm71 an impossible password.5 Change user names Instead of ARIS71 and arisadm71.sh with a text editor. 3.1. and change them to match the user names you have selected.1. For Oracle Business Process Repository to use the new user names. Find the line SET DLADM_SCHEMA=arisadm71. please select different user names for each installation. The latter has privileges for the schema arisadm71. In this case. Since Oracle Business Process Repository does not connect directly to the Oracle user arisadm71. if you want to use the same Oracle database for several installations of Oracle Business Process Repository.1.Oracle BPA Suite Installation and Administration Guide 3.1. This can be useful.cfg in the config directory of Oracle Business Process Repository Site Manager. you must specify the URL in the file Lockservice.1. Open the file envset. Procedure 1. you can select other names for the required Oracle users.1.bat or envset. Open the file Lockservice. Find the line SET DLAPP_USER=ARIS71. please read the following pages. We cannot guarantee proper functioning of supported third-party systems. you need to purchase it from Microsoft. and BPA with the name of your instance. please observe the manufacturers' instructions. Note When you combine various technologies. 227 . you need the following components: Microsoft SQL Server for installing the SQL Server on a Microsoft Server If you want to use this server. 3. Open the file Lockservice.2. or contact Oracle Corporation support. and replace host with your computer name. To set up your database server. particularly announcements concerning releases on their Internet pages.1.1. Oracle BPA Suite SQL Server scripts The scripts are located on the Oracle BPA Suite installation CD in the Setups\DBMS\MSSQL directory.cfg in the config directory of Oracle Business Process Repository Site Manager with a text editor.1. Always follow the instructions provided in the installation manuals of the relevant manufacturer.Oracle BPA Suite Installation and Administration Guide Procedure 1.1 Required programs. 3. drivers. 1521 with your port. we recommend that you make use of the Oracle Corporation installation support.2 MS SQL database management system for Oracle Business Process Repository If you wish to run (Page 27) Oracle Business Process Repository based on Microsoft SQL (MS SQL) as the database management system.1. 2. and scripts To use Oracle BPA Suite with an SQL Server on a 32-bit Windows platform. Find the line url=jdbc:oracle:thin:@host:1521:ARIS. Please read the information about Oracle Business Process Repository and database approvals. you can use the scripts available on the installation media in the Setups\DBMS\MSSQL directory. That is.bat file. Select the option SQL Server and Windows authentication mode as server authentication.1.3 Set up the database To install the database with the database objects that are required to operate Oracle BPA Suite. 228 . 3.sql: SQL script for creating a procedure that produces a spreadsheet set for an Oracle BPA Suite database schema_bo. The scripts create a database ARIS71 and a login ARIS71.1. The scripts consist of the following files: inst.sql: Deletes the ARIS71 database.2.Oracle BPA Suite Installation and Administration Guide 3.sql: SQL script for creating a procedure that produces a spreadsheet set for a BO database.sql: SQL script for creating the ARIS71 database install.1. Set the option Enable triggers to generate additional triggers to TRUE.sql: SQL script for deleting database objects from the ARIS71 database and the ARIS71 login drop_db.bat: Windows batch file for running scripts deinstall. createdb.1.bat. you must configure the inst.2. Set the timeout value for remote queries to 0.2 Notes on installing SQL Server Server sorting must be case-insensitive. Select the server sorting Latin1_General_CI_AI for example.sql: SQL script for creating the ARIS71 login and the database objects in the ARIS71 database schema_aris. the sorting name must contain the character sequence _CI_. Before you run the scripts by calling inst. This user serves to run the SQL scripts. edit the inst. 3. Open the file inst. Find the line SET MSSQL_IDS_FILEGROUP_FILE_DIR=C:\msqldata\ARIS71 and specify the path in which the database files are to be created for the database.2. 3.bat file. 229 .cfg file of Oracle Business Process Repository.1.1 Configure the installation scripts Procedure 1.1. First copy these files to the hard drive of the computer on which they will be run. Open the file inst.bat with a text editor. Adjust (Page 231) the URL in the Lockservice.2. 3. 3. Ensure that the directory exists.1. Find the line SET MSSQL_IDS_DATABASE_NAME=ARIS71. 2.bat with a text editor. and find the line SET MSSQL_IDS_MSSQL_LOGIN_NAME=localhost\username 2.3.1. you must edit the inst. Replace the expression localhost\username with a user name that has administrative access to the database server.1.3. To prevent misuse.2 Change the password for the login user ARIS71 The default password for the login user ARIS71 is *ARIS!1dm9n#.1.3. Edit the inst.bat file before the scripts are used.1 Change the name of the database You can select another name for the database instead of ARIS71. You can change the password later at any time using the Oracle BPA Suite function DBMS password.1.bat file.Oracle BPA Suite Installation and Administration Guide 3. To select another password for the login user ARIS71 in advance. You find this on the installation media under Setups\DBMS\MSSQL. Procedure 1.1. you should change it immediately. and change the name of the database.2. To do this. Procedure 1. 4. 3.cfg. Note The password is specified in plain text in the file Lockservice.1. Find the line SET MS SQL_IDS_APP_USER=ARIS71. 5.cfg in the config directory of Oracle Business Process Repository Site Manager.3. The key arisadm_pwd_ with final underscore identifies the password as a plain text password. 230 . Open the file Lockservice. Find the line arisadm_pwd_=*ARIS!1dm9n#. the arisadm_pwd_ variant is converted into the arisadm_pwd variant. while the key arisadm_pwd without a final underscore identifies the encrypted password. and change it to match the user names you have selected. 3. and change the password.1. 4. For Oracle Business Process Repository to use the new password. and replace the default value in this line with the user name you want. Procedure 1.3 Change the user name ARIS71 You can select another name for required SQL Server users instead of ARIS71. you must specify these in the file Lockservice. After Oracle Business Process Repository starts.cfg in the config directory of Oracle Business Process Repository Site Manager.1. 3.cfg. Find the line arisadm_user=ARIS71.bat with a text editor. and change it as needed. you must specify it in the file Lockservice.cfg in the config directory of Oracle Business Process Repository Site Manager with a text editor. but immediately after Oracle Business Process Repository starts for the first time. For Oracle Business Process Repository to use the new user names.2. Find the line SET MSSQL_IDS_APP_PWD=*ARIS!1dm9n#.cfg in the config directory of Oracle Business Process Repository Site Manager with a text editor. it encrypts the password in the file Lockservice. Open the file Lockservice. 2.Oracle BPA Suite Installation and Administration Guide 2. Open the file inst. cfg in the config directory of Oracle Business Process Repository Site Manager with a text editor. To set up your database server.1. Procedure 1. particularly announcements concerning releases on their Internet pages.2 Configure Oracle Business Process Repository URL For Oracle Business Process Repository to connect to your MS SQL instance. you must specify the URL in the file Lockservice. Note Sometimes the name MSSQLSERVER does not work.instance=MSSQL SERVER.3.1.1. Note When you combine various technologies. or contact Oracle Corporation support.1. 2.3 IBM DB2 database management system for Oracle Business Process Repository If you wish to run (Page 28) Oracle Business Process Repository based on DB2 as the database management system. Open the file Lockservice. and replace host with the computer name and ARIS71 with the name of the database (if you selected another database name when you modified the scripts).Oracle BPA Suite Installation and Administration Guide 3. please read this page. Find the line url=jdbc:jtds:sqlserver://host:1433/ARIS71. We cannot guarantee proper functioning of supported third-party systems. remove the expression . replace MSSQLSERVER with the name of your instance.2. 3. Please read the information about Oracle Business Process Repository and database approvals. 231 . Always follow the instructions provided in the installation manuals of the relevant manufacturer. although you are using a default instance. In this case. we recommend that you make use of the Oracle Corporation installation support.cfg in the config directory of Oracle Business Process Repository Site Manager. please observe the manufacturers' instructions.instance=MSSQLSERVER at the end of the URL. If you are using a named database instance. UPDATE ALERT CFG FOR DATABASE ON ARIS USING db. UPDATE DB CFG FOR ARIS USING AUTO_MAINT ON.67 PREFETCHSIZE 8 TRANSFERRATE 0. 232 . USE OF TABLESPACE ARISLOB TO USER db2aris. GRANT GRANT GRANT GRANT GRANT CONNECT ON DATABASE TO USER db2aris. 3. CONNECT TO ARIS.67 PREFETCHSIZE 8 TRANSFERRATE 0. CREATE LARGE TABLESPACE ARISLOB PAGESIZE 4 K MANAGED BY AUTOMATIC STORAGE EXTENTSIZE 8 OVERHEAD 12. The script is located on the Oracle BPA Suite installation media in the directory Setups\DBMS\DB2. UPDATE DB CFG FOR ARIS USING AUTO_TBL_MAINT ON. Enter the password *ARIS!1dm9n# for this user. CREATE DATABASE ARIS AUTOMATIC STORAGE YES ON 'E:\db2data' DBPATH ON 'E:\' USING CODESET UTF-8 TERRITORY EN. SIZE 20000 AUTOMATIC CREATE REGULAR TABLESPACE ARISDATA PAGESIZE 8 K MANAGED BY AUTOMATIC STORAGE EXTENTSIZE 8 OVERHEAD 12.18 BUFFERPOOL ARISBP DROPPED TABLE RECOVERY OFF. USE OF TABLESPACE ARISDATA TO USER db2aris. 2. UPDATE DB CFG FOR ARIS USING AUTO_RUNSTATS ON.db_backup_req SET THRESHOLDSCHECKED YES.18 BUFFERPOOL ARISBP DROPPED TABLE RECOVERY OFF. CREATE SYSTEM TEMPORARY TABLESPACE ARISTEMP PAGESIZE 8 K MANAGED BY AUTOMATIC STORAGE EXTENTSIZE 8 OVERHEAD 12.18 BUFFERPOOL IBMDEFAULTBP. UPDATE DATABASE CONFIGURATION USING LOGSECOND 40 IMMEDIATE. Assign this user to the DB2USERS user group.67 PREFETCHSIZE 8 TRANSFERRATE 0.67 PREFETCHSIZE 8 TRANSFERRATE 0. you can use the following script after you have adapted the paths (UTF-8 is absolutely necessary). CREATE BUFFERPOOL ARISBP IMMEDIATE PAGESIZE 8 K. Oracle Business Process Repository uses a free DB2 database user to connect to the DB2 database.tb_reorg_req SET THRESHOLDSCHECKED YES. CREATETAB ON DATABASE TO USER db2aris. UPDATE ALERT CFG FOR DATABASE ON ARIS USING db. UPDATE ALERT CFG FOR DATABASE ON ARIS USING db.tb_runstats_req SET THRESHOLDSCHECKED YES.18 BUFFERPOOL ARISBP. CREATE REGULAR TABLESPACE ARISINDEX PAGESIZE 8 K MANAGED BY AUTOMATIC STORAGE EXTENTSIZE 8 OVERHEAD 12.Oracle BPA Suite Installation and Administration Guide Procedure 1. UPDATE DATABASE CONFIGURATION USING LOGFILSIZ 5000 DEFERRED. Create an operating system user with the name db2aris on the DB2 host computer. To create the DB2 database. USE OF TABLESPACE ARISINDEX TO USER db2aris. or password. user name.installation directory/server/config). see chapter Oracle Business Process Publisher (Page 44).2 Oracle Business Process Publisher Server Please read this section if you performed the standard installation of Oracle Business Process Publisher Server and want to use an Oracle or MS SQL database instead of the Derby database. always follow the instructions provided by their respective manufacturers. To use a different database name. the password entered in the file is automatically encrypted to prevent misuse. you first have to rename the arisadm_pwd key to arisadm_pwd_ again and enter the new password directly after =. For additional information. The DBMS password cannot be changed in the program interface. CONNECT RESET. The password is automatically encrypted after restart. If you wish to change the password afterward. you have to change these entries in the configuration file Lockservice. you should change it immediately.1. To change the entries. 233 . Once you have defined the password and started Oracle Business Process Repository. 3. Notes If you install databases yourself. replace the following values: arisadm_user=db2aris arisadm_schema=db2aris url=jdbc:db2://myhost:50000/ARIS arisadm_pwd_=*ARIS!1dm9n# You can only change the password here. The key is also renamed from arisadm_pwd_ (unencrypted) to arisadm_pwd (encrypted).Oracle BPA Suite Installation and Administration Guide CREATE SCHEMA db2aris AUTHORIZATION db2aris.. To prevent misuse. Note The default password for this user is *ARIS!1dm9n#.cfg (.. Procedure 1.Oracle BPA Suite Installation and Administration Guide 3. b. Create a database using the script create_db. Open the script for editing. If you have changed the names in the script. 2. a. Microsoft SQL Server 2005 is not included in the package. Ensure that the path has been created before you run the script.xml. Adjust the path to the database file.sql (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a directory of your choice. user name.2. Prerequisite Copy the file create_db. select the SQL Server and Windows authentication mode option. On the Security tab. Open the Server properties dialog box. You have installed Microsoft SQL Server 2005 under MS Windows. 3.sql. and password according to your choice.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the Tomcat installation directory under common/lib. If you specify the ARISBP11 database name. you must also change them in the configuration file businesspublisher.cfg. Ensure that Latin1_General_CI_AI sorting is selected for the COLLATE statement. If you use the MS SQL Server 2005 database. which is not possible with the Derby database.1. 234 .xml and webappserver. c.1 Manage a system with an MS SQL database Please adjust the system as required to manage Oracle Business Process Publisher in combination with an MS SQL Server 2005 database. all users provided with a license key can simultaneously work with a Publisher export. you must also change them in the configuration files businesspublisher. ARISBPDATA: contains all database objects ARISBPINDEX: contains all index data d. The script creates the specified data groups. Copy the JDBC driver jTDS. 6. c.. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.lang.businesspublisher. a.microsoft. Ensure that the URL has been adjusted correctly. Ensure that the driverClassName property is set to net.jdbc.Oracle BPA Suite Installation and Administration Guide 4. b.database . If you are using named instances.cfg. 235 .instance=<name of instance>. Customize the configuration file . Ensure that the entries in the following line are correct: <bp-mssql schema="ARISBPDATA" filegroupdata="ARISBPDATA" filegroup-index="ARISBPINDEX" /> If you have changed the names in the script.idsscheer. Customize the configuration file .sourceforge. 5.dao.\BPServer\tomcat\conf\catalina\localhost\businesspublisher. visit http://support.jtds.com/kb/914277/en-us).Driver. Ensure that the database connection is set for MSSQL. for example.String</env-entry-type> <env-entryvalue>com.aris.xml: a.AMSSQLDAO</env-entry-value> </env-entry> Tip For additional information about Microsoft SQL Server 2005.com/kb/914277/en-us (http://support.instance =MSSQLSRV. for example as follows: jdbc:jtds:sqlserver://hostname:<Port>/ARISBP11 If you have specified a database name of your choice. Change the user name and password.. complete the URL with the following entry: .\BPServer\tomcat\webapps\businesspublisher\config\webappserv er.application. jdbc:jtds:sqlserver://hostname:1433/ARISBP11. use it instead of ARISBP11. you must adjust them here.microsoft. [sp_fulltext_database] @action = 'disable' END TRY BEGIN CATCH END CATCH GO ALTER DATABASE [ARISBP11] SET ANSI_NULL_DEFAULT OFF GO ALTER DATABASE [ARISBP11] SET ANSI_NULLS OFF GO ALTER DATABASE [ARISBP11] SET ANSI_PADDING OFF GO ALTER DATABASE [ARISBP11] SET ANSI_WARNINGS OFF GO ALTER DATABASE [ARISBP11] SET ARITHABORT OFF GO ALTER DATABASE [ARISBP11] SET AUTO_CLOSE OFF GO ALTER DATABASE [ARISBP11] SET AUTO_CREATE_STATISTICS ON GO ALTER DATABASE [ARISBP11] SET AUTO_SHRINK OFF GO ALTER DATABASE [ARISBP11] SET AUTO_UPDATE_STATISTICS ON GO 236 .sql USE master GO CREATE DATABASE [ARISBP11] ON PRIMARY (NAME = N'ARISBPPRIM'. FILEGROWTH = 100MB).mdf' .ndf' . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPLOG. FILENAME = N'C:\mssqldata\ARISBP11\ARISBPPRIM. SIZE = 10MB . particularly announcements concerning releases on their Internet pages. FILEGROWTH = 10MB) COLLATE Latin1_General_CI_AI GO EXEC dbo. SIZE = 10MB . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPINDEX. or contact Oracle Corporation support.ndf' .ldf' .Oracle BPA Suite Installation and Administration Guide Note When you combine various technologies.sp_dbcmptlevel @dbname=N'ARISBP11'. please observe the manufacturers' instructions. Sample script create_db. SIZE = 100MB . We cannot guarantee proper functioning of supported third-party systems. FILEGROUP [ARISBPINDEX] (NAME = N'ARISBPINDEX'. @new_cmptlevel=90 GO BEGIN TRY EXEC [ARISBP11]. Always follow the instructions provided in the installation manuals of the relevant manufacturer. FILEGROWTH = 10MB). SIZE = 100MB . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPDATA.[dbo]. FILEGROUP [ARISBPDATA] (NAME = N'ARISBPDATA'. FILEGROWTH = 100MB) LOG ON (NAME = N'ARISBPLOG'. FILEGROWTH = 10MB). SIZE = 10MB . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPLOG. SIZE = 10MB . SIZE = 100MB . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPDATA. FILEGROWTH = 100MB).1.1. FILEGROWTH = 10MB) COLLATE Latin1_General_CI_AI GO 237 . FILEGROUP [ARISBPDATA] (NAME = N'ARISBPDATA'.ndf' . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPINDEX. SIZE = 100MB . FILEGROWTH = 100MB) LOG ON (NAME = N'ARISBPLOG'.Oracle BPA Suite Installation and Administration Guide ALTER DATABASE [ARISBP11] SET CURSOR_CLOSE_ON_COMMIT OFF GO ALTER DATABASE [ARISBP11] SET CURSOR_DEFAULT GLOBAL GO ALTER DATABASE [ARISBP11] SET CONCAT_NULL_YIELDS_NULL OFF GO ALTER DATABASE [ARISBP11] SET NUMERIC_ROUNDABORT OFF GO ALTER DATABASE [ARISBP11] SET QUOTED_IDENTIFIER OFF GO ALTER DATABASE [ARISBP11] SET RECURSIVE_TRIGGERS ON GO ALTER DATABASE [ARISBP11] SET RECOVERY FULL GO ALTER DATABASE [ARISBP11] SET MULTI_USER GO ALTER DATABASE [ARISBP11] SET PAGE_VERIFY CHECKSUM GO CREATE LOGIN ARISBP11 WITH PASSWORD=N'ARISBP'.ndf' . FILENAME = N'C:\mssqldata\ARISBP11\ARISBPPRIM.mdf' .1 Sample script create_db. FILEGROUP [ARISBPINDEX] (NAME = N'ARISBPINDEX'. DEFAULT_DATABASE=[ARISBP11] GO USE [ARISBP11] GO CREATE USER [ARISBP11] FOR LOGIN [ARISBP11] GO CREATE SCHEMA [ARISBPDATA] GO ALTER USER ARISBP11 WITH DEFAULT_SCHEMA = ARISBPDATA.2.sql USE master GO CREATE DATABASE [ARISBP11] ON PRIMARY (NAME = N'ARISBPPRIM'.ldf' . GO GRANT CONTROL ON SCHEMA :: [ARISBPDATA] TO [ARISBP11] GO GRANT CREATE TABLE TO [ARISBP11] GO GRANT CREATE VIEW TO [ARISBP11] GO GRANT CREATE FUNCTION TO [ARISBP11] GO 3. [dbo].Oracle BPA Suite Installation and Administration Guide EXEC dbo.sp_dbcmptlevel @dbname=N'ARISBP11'. @new_cmptlevel=90 GO BEGIN TRY EXEC [ARISBP11]. DEFAULT_DATABASE=[ARISBP11] GO USE [ARISBP11] GO CREATE USER [ARISBP11] FOR LOGIN [ARISBP11] GO CREATE SCHEMA [ARISBPDATA] GO 238 .[sp_fulltext_database] @action = 'disable' END TRY BEGIN CATCH END CATCH GO ALTER DATABASE [ARISBP11] SET ANSI_NULL_DEFAULT OFF GO ALTER DATABASE [ARISBP11] SET ANSI_NULLS OFF GO ALTER DATABASE [ARISBP11] SET ANSI_PADDING OFF GO ALTER DATABASE [ARISBP11] SET ANSI_WARNINGS OFF GO ALTER DATABASE [ARISBP11] SET ARITHABORT OFF GO ALTER DATABASE [ARISBP11] SET AUTO_CLOSE OFF GO ALTER DATABASE [ARISBP11] SET AUTO_CREATE_STATISTICS ON GO ALTER DATABASE [ARISBP11] SET AUTO_SHRINK OFF GO ALTER DATABASE [ARISBP11] SET AUTO_UPDATE_STATISTICS ON GO ALTER DATABASE [ARISBP11] SET CURSOR_CLOSE_ON_COMMIT OFF GO ALTER DATABASE [ARISBP11] SET CURSOR_DEFAULT GLOBAL GO ALTER DATABASE [ARISBP11] SET CONCAT_NULL_YIELDS_NULL OFF GO ALTER DATABASE [ARISBP11] SET NUMERIC_ROUNDABORT OFF GO ALTER DATABASE [ARISBP11] SET QUOTED_IDENTIFIER OFF GO ALTER DATABASE [ARISBP11] SET RECURSIVE_TRIGGERS ON GO ALTER DATABASE [ARISBP11] SET RECOVERY FULL GO ALTER DATABASE [ARISBP11] SET MULTI_USER GO ALTER DATABASE [ARISBP11] SET PAGE_VERIFY CHECKSUM GO CREATE LOGIN ARISBP11 WITH PASSWORD=N'ARISBP'. Prerequisite You have created an Oracle database and configured it as follows.cfg (see below). We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. If you use this database. We recommend that you set the tablespaces for automatic. If the option for automatic growth is not set. This description assumes you are using Apache Tomcat. If you install a database yourself.Oracle BPA Suite Installation and Administration Guide ALTER GO GRANT GO GRANT GO GRANT GO GRANT GO USER ARISBP11 WITH DEFAULT_SCHEMA = ARISBPDATA. This keeps the two systems from competing for resources.2 Manage a system with an Oracle database Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. We recommend a block size of 8K.g. always follow the instructions provided in the Oracle Installation Guide. all enabled users can work simultaneously with a Publisher export. you run the risk of completely exhausting the memory in the tablespaces. regular monitoring (e. you must customize the configuration file webappserver. and you achieve better performance and higher availability. Otherwise. Use of the database character set AL32UTF8 is mandatory. CONTROL ON SCHEMA :: [ARISBPDATA] TO [ARISBP11] CREATE TABLE TO [ARISBP11] CREATE VIEW TO [ARISBP11] CREATE FUNCTION TO [ARISBP11] 3. unlimited growth. 239 . To use other names or existing tablespaces.1. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time.2. . GRANT CREATE TABLE TO ARISBP. For an explanation of these values. GRANT CREATE VIEW TO ARISBP.Oracle BPA Suite Installation and Administration Guide You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database.html (http://jakarta.Configure the DBCP (database connection pool) with these values. 2. We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted. If you prefer another name. GRANT QUERY REWRITE TO ARISBP.jdbc. You can select any password. Procedure 1.apache.xml (see below).org/commons/dbcp/configuration. The name of the Oracle user is assumed to be ARISBP. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:/Program Files/ARIS11/BPServer/tomcat/webapps/businesspublisher/" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax.driver. Open the file businesspublisher. go to: http://jakarta.html)--> username="ARISBP" password="ARISBP" <!-.OracleDriver" 240 . ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA.\BPServer\tomcat\conf\catalina\localhost\ with a text editor.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" <!-.org/commons/dbcp/configuration. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP.sql.Use the Oracle user name and password here (see Prerequisites> --> driverClassName="oracle. GRANT ALTER SESSION TO ARISBP. Enter it in the configuration file businesspublisher.apache. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP.xml in the Oracle Business Process Publisher Server installation directory . 2.jar exists in the Oracle Business Process Publisher Server installation directory . Note When you combine various technologies. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java. We cannot guarantee proper functioning of supported third-party systems.database. Ensure that the JDBC driver ojdbc5. or contact Oracle Corporation support. We assume that you are using version 10. 241 .\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.0. You find the file on the installation media.dao.idsscheer. port. 4. 5.. please observe the manufacturers' instructions.application.\BPServer\tomcat\common\lib. particularly announcements concerning releases on their Internet pages.AOra cleDAO</env-entryvalue> </env-entry> 6. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3.. please maintain them here.businesspublisher.Oracle BPA Suite Installation and Administration Guide url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname.String</env-entry-type> <env-entry-value> com.lang. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> If you have decided to use other tablespace names (see Prerequisites). Open the file webappserver.aris. Always follow the instructions provided in the installation manuals of the relevant manufacturer.cfg in the Oracle Business Process Publisher Server installation directory .3. backup and restore functions may require more RAM. Since manual and software are subject to different production cycles.Oracle BPA Suite Installation and Administration Guide 3.2 Oracle Business Process Repository All Oracle BPA Suite clients use Oracle Business Process Repository to access the database server and thus work with a common data basis. Note This manual describes the settings and features as they were at the time of print. minimum and recommended system requirements are specified. To ensure optimum load distribution and better protection against failure. The default server includes: Oracle Business Process Repository Oracle Business Process Repository Site Manager Oracle BPA Suite Converter This section describes processor. The minimum system requirements must be met in order for the Oracle BPA Suite products to work properly. and software requirements of the various server and client computers for Oracle BPA Suite. system configuration.g. a faster processor. the description of settings and features may differ from actual settings and features. and using the product. large databases can involve extended runtimes. Use of report. 242 . Information about discrepancies is provided in the Readme file that accompanies the product. Please read this file and take the information into account when installing. In general. runtime behavior might improve. Depending on the application scenario (e. In some cases. On the other hand. Meeting the recommended system requirements will assure good performance even with large data volumes. more than one Oracle Business Process Repository can be used. For simultaneous use of other applications. memory. additional memory. if more RAM is available than listed below. it is advisable to use up-to-date hardware taking into account the number of users who will be accessing the same Oracle Business Process Repository. setting up. Merge or Simulation). or system extension may be required. You need at least 1 GB RAM for a 32-bit system. please contact Oracle Corporation support.Oracle BPA Suite Installation and Administration Guide Hardware Processor Recommended Intel Pentium IV 3.4 GHz RAM 64-bit system 2 GB RAM 32-bit system 1 GB RAM In 32-bit systems.4 GHz Minimum Intel Pentium IV 2. If you use Oracle BPA Suite Converter. If you use Oracle Business Process Simulator. 512 MB The system requirements depend on the number of users (1 GB main memory for 50 users) and use of certain features. 243 . For additional information. the maximum size of a Virtual Machine (VM) is 1 GB. 64-bit systems need at least 2 GB RAM. you may need more memory for your Oracle Business Process Repository. the export process is canceled. If you create a Publisher export and use links to large files (>15 MB). 30% of main memory is automatically reserved for simulation. If the memory is insufficient. you need an additional 256 MB RAM and 512 MB hard disk space for converting a database. if you wish to display Japanese characters.6. Approvals are also valid for subsequent updates.0_04 is now called JRE 6. an internal JRE version is automatically used. SUN Microsystems guarantees compatibility between the JRE patch levels.6. the approval is valid for both JRE 1.0_04 and subsequent patches that are in the public domain (Java SE on the SUN home page except Java SE for Business) and generally released by SUN. Depends on the database systems used.0_04 and JRE 1. your installation is not used by Oracle BPA Suite.0. You do not need to install JRE separately. The following are approved: Java Runtime Environment (JRE) 1. you must rename the font.0_05 and for any subsequent patch from the public domain Java SE of the SUN home page (except for Java SE for Business). 244 . copy the file jaxb-api.0_04 and subsequent patches are approved for an Oracle BPA Suite product.Oracle BPA Suite Installation and Administration Guide Software Operating systems Network High-speed network (>=100 Mbit) between database server and Oracle Business Process Repository. If JRE 1.properties.6. For example. Note SUN renamed the JRE versions. JRE Windows If you have Oracle Business Process Repository installed and start Oracle BPA Suite products as programs. Therefore. etc.6 update 3 or an older version. Oracle BPA Suite products are tested using the JRE that is current at the time of release. Update 4.6. Cyrillic. Your JRE installation is only used if you start Oracle BPA Suite products from your browser. If you are using JRE 1. the Oracle BPA Suite approvals for JREs are valid for all patch levels of a version. If you have already installed JRE. the corresponding file in directory <JRE installation directory>\<version>\lib must be named font. To display different character sets (Japanese.jar from the directory <Web Client Components>\lib to the directory <Java JRE installation directory>/endorsed.ja file to font. Arabic.properties.6.properties.). JRE 1. or 2007 installed.0_01\lib\endorsed. If pop-up blockers are activated for the domain. Output If. it may not always be possible to open report output in PDF format from a Publisher export. for example. 2003. Please first install the appropriate JRE 1.Oracle BPA Suite Installation and Administration Guide e. use the following command line entry to start the program: -Dsun.d3d=false Unix Oracle Business Process Repository requires JRE 1. SSL capability is already integrated into Oracle BPA Suite and only needs to be activated when needed. you want to output documents in PDF format using Microsoft Word or Microsoft Excel. If you have Java 6 update 10 installed. please ensure that the tables have been saved in XLS format.6. installation of Java 6 update 10 may cause delays in the Designer and Matrices modules. you must have Adobe Reader and Microsoft Office version 2000.6. Depending on your graphics card and driver configuration. Please note that you must repeat this procedure for every update of version 3 or older. Communication between clients and Oracle Business Process Repository takes place via the CORBA protocol IIOP (Internet Inter Object Request Broker Protocol). all applications that are linked in your models should be installed. If the directory endorsed does not exist. In this case. C:\Program Files\Java\jre1. We therefore recommend installation of version 4 or higher. If Oracle BPA Suite clients within the intranet or in a VPN environment (Virtual Private Network) access Oracle Business Process Repository.6 for your operating system. If you use reports to import data from Excel tables. 2002. In addition.java2d. 245 . Protocols (Page 249) Data exchange between browser-capable Oracle BPA Suite clients and Oracle Business Process Repository can be encrypted with SSL (1024bit RSA). problems may occur despite better performance. no firewall is required.g. you must create it. discrepancies may exist. However. This information was current at the time of printing.0.2 (32-bit) (6) Windows Server 2003 SP1.Operating system and database system platforms Note We support the integration of databases of the versions listed in the table below only as long as they are supported by the respective manufacturer. Oracle Corporation offers customized solutions.2.1) Express Edition (Universal) (2.2. 3.1 Oracle Business Process Repository .2 + R2 SP2 (6) (32/64-bit) Windows Server 2008 (6) (32/64bit) HP-UX 11 Yes Yes Yes Yes Yes Yes Yes Yes Yes No Yes Yes No No No Yes Yes No No 246 . If other platforms or databases are released after this guide has gone to press. Therefore.2.1.Oracle BPA Suite Installation and Administration Guide Note Oracle Business Process Repository does not support NAT (Network Address Translation) by default. and 11.x (2) MS SQL Enterprise Edition 2005 (2) IBM DB2 UDB 9. Please read the release information in the current Readme file. Approved combinations Standard database system (1.3) Oracle 10g R2 (10.7) Yes Oracle 10. 10.5 (2) Windows XP Pro + SP1. you will be informed about them in the Release Notes. Additional information is available from our support. (7) You can use a maximum of 1 GB RAM and only one processor.2.Oracle BPA Suite Installation and Administration Guide Standard database system (1.1) Express Edition (Universal) (2. 247 . this size is problematic if Oracle Business Process Repository and Oracle Business Process Publisher use the database on the same computer.x (2) MS SQL Enterprise Edition 2005 (2) IBM DB2 UDB 9. (3) We recommend a maximum database size of 1 GB.5 (2) Sun Solaris 9. 10. database license included in the Oracle Business Process Repository license. The maximum database size is 4 GB.0. (2) Database must be provided by the customer.7) Yes Oracle 10.2. You can only start one instance per computer.3) Oracle 10g R2 (10. 10 (4) RedHat Enterprise Linux 5 (5) VMWare ESX No Yes No No Yes Yes Yes No No No Yes Yes No No (1)Only with 32-bit Java. (4) Tested with SPARC + Intel processors (5) Tested with RedHat ES5 (32/64-bit) (6) Itanium processors have not been approved for Oracle BPA Suite installations on Windows systems. Oracle BPA Suite standard platform. and 11.1. Number of users 1 . The servers must work within a network that runs at a transmission speed of at least 100 Mbits.2.100 Business Server site Quantity: 1 CPU: 2 Main memory: 2 GB DBMS: External systems CPU(1): 1 Main memory: 2 GB 101 . Using the recommended sizes enables good system performance.4 GHz (2) Please contact Oracle Corporation support.200 Business Server site Quantity: 1 CPU: 2 Main memory: 2 GB DBMS: External systems CPU(1): 2 Main memory: 2 GB 201 .Oracle BPA Suite Installation and Administration Guide 3.2 Recommended user-related server dimensioning The following table provides an overview of the server configurations that we recommend depending on the current number of users with access.- 51 .50 Server scenario Single server Business Server Quantity: 1 CPU(1): 1 Main memory: 2 GB Database server DBMS: Standard database system CPU(1): -. 3. 248 .Main memory: -.400 Business Server site (2) Quantity: 2 CPU: 2 Main memory: 2 GB DBMS: External systems CPU(1): 2 Main memory: 2 GB n(3) * 200 Business Server site (2) Quantity: n (3) CPU: 2 Main memory: 2 GB DBMS: External systems CPU(1): 4 Main memory: 4 GB (1) Pentium IV. 2. 3. 3. 249 .g.3.4 Configure Oracle Business Process Repository During the installation process.2 Oracle BPA Suite on the intranet/VPN If Oracle BPA Suite clients within the intranet or in a VPN environment (Virtual Private Network) access Oracle Business Process Repository.2. 3. Communication between clients and Oracle Business Process Repository takes place via the CORBA protocol IIOP (Internet Inter Object Request Broker Protocol).3 Protocols used Different protocols are used for communication depending on the equipment level. The RAM required for JavaScript reports varies greatly. This file is overwritten for each subsequent setup. setupServerSettings.cfg Contains all settings that you specified during installation.1 Oracle BPA Suite on the Internet/SSL Data exchange between browser-capable Oracle BPA Suite clients and Oracle Business Process Repository can be encrypted with SSL (1024-bit RSA).2.2. and HTTP are required. the following files are created among others in the directory <Oracle BPA Suite installation directory>/server/config: defaultServerSettings. 3. the paths. Oracle BPA Suite requires a fully functional TCP/IP infrastructure. For the full equipment level. IIOP (CORBA). This file is overwritten for each subsequent setup. e. Therefore. data can be exchanged SSL-encrypted via the IIOP protocol (see Oracle BPA Suite on the Internet/SSL (Page 249)). SSL capability is already integrated into Oracle BPA Suite and only needs to be activated when needed. TCP/IP. we recommend that you run these under UNIX or on a 64-bit system. Alternatively.3.Oracle BPA Suite Installation and Administration Guide (3) n stands for a number of Business Server sites greater than 1. no firewall is required.cfg Contains all default settings in an XML structure. cfg. The configuration files are deleted.cfg. Note If Oracle Business Process Repository does not start properly after the configuration has been changed. for example. 250 . you wish to use SSL software. you have to change ports as a result of a port conflict with external software. Ensure that you enter the attributes in the correct XML structure. line-by-line debug output for the Report Server. You find the XML structure and all default attributes in the file defaultServerSettings in the same directory. You enter all configuration changes as XML tags in the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. This allows you to change all default settings according to your requirements. They are backed up in the backup directory. an e-mail is to be sent automatically to an address of your choice (Page 256) in response to errors and warnings reported by Oracle Business Process Repository. You need to change this configuration file if. your configuration changes are preserved.cfg. Please only change the file userServerSettings. If you run an update installation of the current version.cfg. and the default settings of these attributes are used. Oracle Business Process Repository. Once you have corrected or deleted incorrect entries. All configuration changes are entered in the file userServerSettings.cfg Contains all configuration changes that you have made after installation. the computer on which you have installed Oracle Business Process Repository has two network cards. the configuration files are converted when Oracle Business Process Repository is started. check the XML structure of the file userServerSettings. and Oracle Business Process Repository Site Manager. This file is not overwritten. you want to enable a detailed. In older program versions. If you run subsequent setups. you want to change the behavior of the HTML Generator (Page 255). These changes are not overwritten in an Oracle Business Process Repository update. the related changes are undone when you restart the server.Oracle BPA Suite Installation and Administration Guide userServerSettings. you want to configure the connections between the clients. configuration changes were entered in different files. Insert the following: <accounting state="on" /> 3.4. Insert the following: <startmode debugoutput="on" debuglevel="ALL" /> 3. Use this setting to log information about Oracle Business Process Repository.2 Log messages Logging is disabled by default. Save the file. Save the file. 3. Note If you have installed Oracle Business Process Repository on a Unix operating system and have enabled SSL encryption. Enable logging if the system does not work properly.4. Use this setting to log login procedures for an Oracle Business Process Repository.2. and restart Oracle Business Process Repository. SSL capability is already integrated in Oracle BPA Suite. 2.cfg with a text editor. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. Tip If you enter the following. Oracle Business Process Repository must run under the root account. only information is output: <startmode debugoutput="on" debuglevel="INFO" /> 3. 251 . All messages are output in the log file.3 SSL encryption of data transmission via Secure Socket Layer Using SSL (1024 Bit RSA) you can exchange encrypted data between the Java-based products and Oracle Business Process Repository.4.Oracle BPA Suite Installation and Administration Guide 3.2. The login and logout times for each user are output in the log file.2.cfg with a text editor. and restart Oracle Business Process Repository. 1.1 Log logins Logging is disabled by default. 2. 1. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. you continue to use the hotfix package as a ZIP file. Besides the patch setup.cfg with a text editor. 2.2. Save the file. This file is located in the directory %BPAHOME11g% server\html. Procedure Automatic installation The SSL certificates are automatically updated when you use the patch setup. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. 3.de/pub/ARIS/HELPDESK/ARIS701/hotfix/ARIS_Patch_Setup/).4. and restart Oracle Business Process Repository. Insert the following: <profiles> <public ssl="443" /> </profiles> If the default port 16070 is already in use. see the Setup descriptions (ftp://ftp. 5.cfg to change the configuration. 252 .4 Update SSL certificates Ensure that the certificates installed for your Oracle Business Process Repository are up to date. From now on. the hotfix package can be installed with the Silent install option. you can use any other port that is available. Ensure that the system date matches the current date. <profiles> <public port="<available port number>" /> </profiles> 4. These certificates can only be used to exchange data between Java-based products and Oracle Business Process Repository. Using this ZIP file. 3.idsscheer.Oracle BPA Suite Installation and Administration Guide Procedure 1. For additional information. Warning Please only use the file userServerSettings. This ensures that the validity of the SSL certificates (Page 252) is checked correctly. use index_ssl. This ensures that your changes are preserved in future update installations. The other Oracle Business Process Repository configuration files are overwritten for each installation.html as the start file for the databases. \server\endorsed. . Ensure that your program version matches the one of this certificate.idsscheer. The certificate has been updated.5 Configure Oracle Business Process Repository/Oracle Business Process Repository Site Manager connection The following entries specify the intervals at which Oracle Business Process Repository Site Manager checks whether the license service is active: <licenseservice_client timeout_interval="300000" heartbeat_interval="50000" /> </licenseservice_client> The heartbeat_interval="50000" entry specifies that Oracle Business Process Repository sends a ping to Oracle Business Process Repository Site Manager every 50 seconds (= 50. Copy the file ssl. 3.2.. Download the SSL certificate upCert_SSL_<program version> from our server (ftp://ftp. Start Oracle Business Process Repository. If not.000 milliseconds) whether Oracle Business Process Repository is still logged in with the corresponding licenses. 253 .Oracle BPA Suite Installation and Administration Guide Manual installation 1. 2.jar to the Endorsed directory of your Oracle Business Process Repository installation. all licenses used via this Oracle Business Process Repository will be released. e.de/pub/ARIS/HELPDESK/CERTIFICATES/). The timeout_interval="300000" entry specifies that Oracle Business Process Repository Site Manager checks every 5 minutes (= 300. 3.000 milliseconds) and thus indicates that its licenses are still in use. Exit Oracle Business Process Repository. 4. the following entries handle the locks in the database: <lockservice_client timeout_interval="300000" heartbeat_interval="50000" /> </lockservice_client> The heartbeat_interval="50000" entry specifies that Oracle Business Process Repository sends a ping to Oracle Business Process Repository Site Manager every 50 seconds (= 50.4. Similarly.000 milliseconds) to indicate that its locks are still valid.g. 2. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. 1. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. Insert the following: <reportserver active="false" /> 3.4.2. 2. You can always run VB scripts locally. all locks generated via this Oracle Business Process Repository will be lifted. If not. The change has been applied.Oracle BPA Suite Installation and Administration Guide The timeout_interval="300000" entry specifies that Oracle Business Process Repository Site Manager checks every 5 minutes (= 300. Save the file.6 Configure client/Oracle Business Process Repository connection While each client pings Oracle Business Process Repository every 25 seconds. The Report Server is no longer running. and restart Oracle Business Process Repository. 1.4. If you do not want to start any VB scripts on Oracle Business Process Repository. This entry determines the period within which a user can contact Oracle Business Process Repository via the client without having to log in again. you can deactivate the Report Server.cfg with a text editor. Therefore.000 milliseconds) whether Oracle Business Process Repository is still logged in with the corresponding licenses. 3.7 Deactivate Report Server The Report Server is running by default.2. more resources are available for Oracle Business Process Repository. 254 .cfg with a text editor. Save the file. As a result. 3. the following setting causes Oracle Business Process Repository to check every 90 seconds (value in milliseconds) which client is still connected. Insert the following: <appservertimer timeout_interval="60000" /> </appservertimer> 3. fewer system resources are needed and system performance improves. and restart Oracle Business Process Repository. more resources are available for Oracle Business Process Repository. HTML Generator creates an index_lan. you can deactivate the simulation server.cfg contains the path in which the created files are saved. fewer system resources are needed and system performance improves.cfg (server\config directory) to control its behavior. A language ID is entered in this section for each of the interface languages installed on the Oracle Business Process Repository.4. executable Web Client Components directory that you can copy directly to your Web server. For each of these IDs. You can use the file userServerSettings.html files in the directory C:\<default directory>\Oracle BPA Suite11g\server\html. It updates the access files whenever databases are created.html file in the Web Client Components structure: 255 . If you are not using Oracle Business Process Simulator on an Oracle Business Process Repository. this directory will always contain a current. or deleted. If you accept all default values during installation.2.8 Deactivate simulation server The simulation server is running by default. 3.2. The simulation server is no longer running. and restart Oracle Business Process Repository. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings.4. In a default server installation.cfg with a text editor. Save the file.Oracle BPA Suite Installation and Administration Guide 3. The htmlgen section of the file defaultServerSettings.Current database lists HTML Generator creates all index files and the file aris_database. 1.9 HTML Generator . 2. renamed. A dialog box prompts you to specify where the HTML Generator is to be installed.html for the Web Client Components. As a result. Therefore. Insert the following: <simuserver active="false" /> 3. the HTML Generator is switched on and generates the index. cfg to change the configuration. 3.4. If your work is not limited to the use of only one Oracle Business Process Repository.html" database_template="aris_database_ssl.html"/> </genlist> </htmlgen> You can run the HTML Generator manually at any time by executing the htmlgen.Please edit only these paths for HTMLgenerator configuration --> <outputpath path="C:/wwwroot/Oracle BPA Suite11g"/> </htmlgen> Please note that you must insert the output and backup paths in the file userServerSettings. you need to adjust the paths on the computer on which Oracle Business Process Repository Site Manager is installed. This ensures that your changes are preserved in future update installations. The e-mail contains 256 . It is possible to notify (Page 256) several administrators at the same time.10 Activate Oracle BPA Suite Notify Service Administrators of Oracle BPA Suite sites can have messages sent by the Oracle BPA Suite notify service when problems arise. The other Oracle Business Process Repository configuration files are overwritten for each installation. you can specify that an e-mail be sent to an e-mail address of your choice when the behavior of the Oracle BPA Suite site triggers warnings or error messages.2.cfg.cfg.bat file in the Oracle Business Process Repository directory.Oracle BPA Suite Installation and Administration Guide <htmlgen> <languagelist default="de"> <language tag="de"/> <language tag="en"/> <language tag="ja"/> </languagelist> <!-. Warning Please only use the file userServerSettings. Insert the following entry: <htmlgen> path="e:/inetpub/wwwroot/bpa11"/><backuppath path="e:/inetpub/wwwroot/bpa11/backup"/> </htmlgen> You make other changes in the same way: <htmlgen> <appserver name="myspecialhost" /> <genlist> <genfile target_dir="ssl" target_name="dblist. In the file userServerSettings. Insert the following: Example <adminagent> <mailing state="on" language ="en" warnings ="on" username="adminservice" address="adminservice@yourcompany. Procedure 1. Prerequisite The username account (see the following example) must exist on your e-mail server. 4. Please refer to the table for possible values.com" /> </mailing> </adminagent> 3. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. 257 . Entry state Value on off Meaning The mail function is switched on. The mail function is switched off. off E-mails will be sent only for errors. the language code is set to English. language en Contains the relevant language code. warnings on E-mails will be sent for warnings and errors. Warnings or error messages are sent by e-mail to the administrators. and restart Oracle Business Process Repository. Save the file. In this example.cfg with a text editor. 2.com"> <recipient address="adminservice@yourcompany. You can toggle the notification mode by setting the state value.Oracle BPA Suite Installation and Administration Guide the zipped files of the log and config directories. 3.zip under the specified backup path. enter the following. Insert the following: <htmlgen> <backupperiod period="7"/> </htmlgen> If you want to change the path.2. for example: <backuppath path="e:/wwwroot/bpa11/backup"/> 3.Oracle BPA Suite Installation and Administration Guide Entry username Value adminservice Meaning Name of the e-mail sender. The index_backup files are deleted after seven days.11 Restrict number of index_backup files When HTML Generator creates a new index_lan. and restart Oracle Business Process Repository. In the following example. You can decide how frequently the backup files (except the current ones) are to be deleted.html file.com Address of the e-mail recipients.com Address of the e-mail sender. 1.cfg with a text editor. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings. You can insert a list of addresses here. recipient address adminservice@your company. Save the file. In this example: adminservice address adminservice@your company. 258 . The interval is defined in days. The backup path is specified in the <htmlgen> section.4. the entry specifies that index_backup files are deleted after seven days. the existing index.html file is saved as index_backup (<date time>). 2. Find the file for the local database system in the <Oracle BPA Suite installation directory>\LocalServer\property directory.4.Oracle BPA Suite Installation and Administration Guide 3.cfg in the directory <Oracle BPA Suite installation directory>/Server/config: <jre> <maxMem server="1024m" /> </jre> The entry in the example specifies that Oracle Business Process Repository may use a (maximum) memory of 1024 megabytes.12 Provide additional memory If you use memory-intensive applications. we recommend that you provide additional memory to the local server LOCAL and Oracle Business Process Repository.cfg in the directory <Oracle BPA Suite installation directory>/LocalServer/config: maxMem=1024m Just change the value shown in bold. such as an XML import or Fast Merge. Server You can increase memory usage by inserting the following entries in the file userServerSettings. 3. Procedure 1.2. you need to ensure that the hardware requirements are met.Additional languages Using the readonly_properties.xml file. Open the file readonly_properties. you can specify which database languages are automatically created when creating databases.2.13 New database . The entry in the example above specifies that the local server LOCAL may use a maximum of 1024 megabytes of memory. To provide additional memory. 259 .4. for the Oracle BPA Suite Server in the <Oracle BPA Suite installation directory>\server\property directory.xml of the corresponding directory in a text editor. LocalServer You can increase memory usage by specifying the following entry in the file local. <property key="dbinitlanguages. change the name of the default language font in row 2 (Standard is the default value in the Spanish language text block). they must be entered with UTF-8 encoding. Modify the locale ID in row 9. for example. <property key="dbinitlanguages.Oracle BPA Suite Installation and Administration Guide 2. Change the general font name in row 8.es.es. if necessary (Main group is the default value in the Spanish language text block). Select a language text block.g.es. <property key="dbinitlanguages.es.commonfontname" datatype="STRING">Arial</property> 9. Note If you want to use country-specific special characters.es. If. <property key="dbinitlanguages.es. 3.commonfontsize" datatype="LONG">10</property> 6.es. if necessary (Arial is the default value in the Spanish language text block). if necessary (locale ID 1034 is the default value in the Spanish language text block). Copy the text block to the clipboard and paste it at the end of the file. Change the name of the main group in row 3. <property key="dbinitlanguages.1. Please use an UTF-8-enabled editor to encode country-specific special characters. regardless of the server platform and database management system used. <property key="dbinitlanguages. 4. 7. If required. e.5 Oracle BPA Suite Converter Oracle BPA Suite Converter is the program for converting data from older Oracle BPA Suite versions to work with Oracle BPA Suite 11g. <property key="dbinitlanguages. 8. 6.commonfontbold" datatype="BOOL">false</property> 2. you can use Oracle 260 .stdfontstylename" datatype="STRING">Standard</property> 3.1.2. the Spanish block: 1. 5. <property key="dbinitlanguages.maingroupname" datatype="STRING">Main group</property> 4.es. if necessary (codepage 1252 is the default value in the Spanish language text block).3. <property key="dbinitlanguages.es.lcid" datatype="LONG">1033</property> 3. Modify the codepage entry in row 6.dialogfontsize" datatype="LONG">8</property> 5. The conversion enables you to transfer databases of a different product version.codepage" datatype="LONG">1252</property> 7.charset" datatype="LONG">0</property> 8. you created a user database under an Oracle database for Oracle BPA Suite 10. Icons of Microsoft Office products are automatically displayed. the icons that are saved in the icons subdirectory in the installation directory of your Oracle Business Process Repository are used for linked files. The system requirements depend on the relevant usage scenario. you must restart Oracle Business Process Repository. if you run reports or create a Publisher export. save the graphics under the names bmp.log in directory <Oracle BPA Suite installation directory>\LocalServer\log\ or <Oracle BPA Suite installation directory>\server\log\). Once you have changed icons. 3. In case of doubt. please contact Oracle Corporation support. Assign file names that conform with the extension of the relevant application. As a rule.ico. Note If icons displayed in models are different from those in the report output or in Publisher export. in the icons subdirectory. you do not need any icons in the directory noted above unless you want to use your own icons. To create icons that represent bitmap graphics or text files.cfg (in directory <Oracle BPA Suite installation directory>\LocalServer\config\) or in the file local. You can convert databases directly from the relevant server.6 When are placed symbols displayed (server)? For example.ico and txt. If you have disk space problems when converting large databases (see file serverout. for example. To create and edit icons in ICO format.Oracle BPA Suite Installation and Administration Guide BPA Suite Converter to specify that this database be transferred to your local Oracle BPA Suite.cfg (in directory <Oracle BPA Suite installation directory>\server\config\).2. you can specify that more memory (Page 299) is allocated for database conversion in the file userServerSettings. you need a suitable application. all applications from which COM objects are used in Oracle BPA Suite databases must be installed on the computer you use for converting databases. Added icons are immediately available. 261 . You can change icons or add new ones. ensure that you have saved the corresponding icons in the installation directory of your Oracle Business Process Repository. For these applications. Databases containing links to Microsoft Word and Microsoft Excel documents can be converted only if Microsoft Word and Microsoft Excel version 2000 or higher are installed. . you can use the log files to find and resolve errors. The graphics must be (n*16) x 16 pixels in size. and create the images subdirectory. administrators must provide these icons. 262 . Open the installation directory of the relevant Oracle Business Process Repository .2. 3..png <Name of the second icon>. If you cannot resolve the problems. This is where you save the icon files in PNG format.server/templates/scriptservice/internal/. The file specifies the sequence in which the icons are displayed in the user interface. they will not be displayed in the Publisher export or report output. no icons from the images directory are displayed. 3.2.lst is missing.. The new icons are available to users in the Configure macros dialog box after restarting the program.png .lst file and save it in UTF-8 format.7 Add custom icons for macros For users to be able to add frequently used macros as icons to the toolbar. If the file images.8 Server log directory The activities of the Oracle Business Process Repository are recorded in the log directory of the server installation directory. please send an error description and the entire contents of the log and config directories to Oracle Corporation support. Prerequisite You have administration privileges for the Oracle Business Process Repository installation directory. The file must have the following structure: <Name of the first icon>. 3. Create an images. 2. Procedure 1. If problems occur during operation.Oracle BPA Suite Installation and Administration Guide If icons for placed attributes are missing there. 1 What are Oracle BPA Suite agents for? The Oracle BPA Suite agent system autonomously monitors and. you can specify that an e-mail be sent to an e-mail address of your choice when the behavior of the Oracle BPA Suite site triggers warnings or error messages.cfg. 3.Oracle BPA Suite Installation and Administration Guide 3. It is possible to notify (Page 256) several administrators at the same time. You can toggle the notification mode by setting the state value. either open the DOS window for Oracle Business Process Repository and press Ctrl + C. Administrators of Oracle BPA Suite sites can have messages sent by the Oracle BPA Suite notify service when problems arise. In the file userServerSettings. 3. in particular.3 How to exit Oracle BPA Suite agents Shutting down Oracle Business Process Repository correctly will also shut down the Oracle BPA Suite agent and all Oracle BPA Suite services. The e-mail contains the zipped files of the log and config directories. an Oracle BPA Suite agent monitors and manages all Oracle Business Process Repository processes (and the associated Oracle BPA Suite services) that are installed on one computer.3 Oracle BPA Suite agent The following section describes how the agent-based system in Oracle BPA Suite supports you in diagnosing and restoring Oracle BPA Suite services.3. starts and stops Oracle Business Process Repository processes and all dependent services. or shut down the service.3. Within the system. 263 .3.2 What tasks does an Oracle BPA Suite agent handle? An Oracle BPA Suite agent mainly performs the following tasks: Determining and providing Oracle BPA Suite service information Monitoring Oracle BPA Suite services by querying them at regular intervals (ping) Shutting down or rebooting Oracle BPA Suite services (automatically or after prompting) 3. To do so. Save the file.cfg.com" /> </mailing> </adminagent> 3.Oracle BPA Suite Installation and Administration Guide 3. Prerequisite The username account (see the following example) must exist on your e-mail server. Open the file <Oracle BPA Suite installation directory>\server\config\userServerSettings.3. you can specify that an e-mail be sent to an e-mail address of your choice when the behavior of the Oracle BPA Suite site triggers warnings or error messages. 264 . The mail function is switched off. Procedure 1. Entry state Value on off Meaning The mail function is switched on.4 Activate Oracle BPA Suite Notify Service Administrators of Oracle BPA Suite sites can have messages sent by the Oracle BPA Suite notify service when problems arise. Please refer to the table for possible values. 2. Warnings or error messages are sent by e-mail to the administrators. Insert the following: Example <adminagent> <mailing state="on" language ="en" warnings ="on" username="adminservice" address="[email protected] with a text editor. and restart Oracle Business Process Repository. You can toggle the notification mode by setting the state value.com"> <recipient address="adminservice@yourcompany. 4. The e-mail contains the zipped files of the log and config directories. In the file userServerSettings. It is possible to notify (Page 256) several administrators at the same time. Use of report. a faster processor.com Address of the e-mail sender.Oracle BPA Suite Installation and Administration Guide Entry language Value en Meaning Contains the relevant language code. warnings on E-mails will be sent for warnings and errors. You can insert a list of addresses here. 3. the language code is set to English. Name of the e-mail sender. runtime behavior might improve. recipient address adminservice@your company. All clients use Oracle Business Process Repository to access the database server and thus work with a common data basis. In this example. In this example: adminservice address adminservice@your company. additional memory. minimum and recommended system requirements are 265 . On the other hand. and software requirements of the various client computers.g. Depending on the application scenario (e. system configuration. This section describes the processor. large databases can involve extended runtimes.4 Java clients (application) Oracle Business Process Architect is a Java client that you start as an application. In some cases. off username adminservice E-mails will be sent only for errors. if more RAM is available than listed below. For simultaneous use of other applications. Merge or Simulation). or system extension may be required. memory. backup and restore functions may require more RAM.com Address of the e-mail recipients. Meeting the recommended system requirements will assure good performance even with large data volumes. 266 . Please read this file and take the information into account when installing. In general. it is advisable to use up-to-date hardware taking into account the number of users who will be accessing the same Oracle Business Process Repository. Additional requirements must be met for some programs. Note This manual describes the settings and features as they were at the time of print. the description of settings and features may differ from actual settings and features. Information about discrepancies is provided in the Readme file that accompanies the product. Since manual and software are subject to different production cycles. The table shows the requirements that apply for many of the Java-based programs. setting up. The minimum system requirements must be met in order for the Oracle BPA Suite products to work properly. Find out about specific requirements in the relevant sections.Oracle BPA Suite Installation and Administration Guide specified. and using the product. 0 GHz Client installation without local database system: 256 MB RAM Client installation with local database system: 512 MB RAM Bandwidth 128 k 56 k.4 GHz Client installation with and without local database system: 1 GB RAM Minimum Intel Pentium IV 2. 375 MB For single-user installation: sufficient disk space for each user database. For any patches/security patches that may be needed. Hard disk 375 MB For single-user installation: sufficient disk space for each user database. 32-bit) Windows Vista + Service Pack 1 (32-bit) Citrix Metaframe Presentation Server 4.0 Only in combination with Windows Server 2003 Standard Edition + Service Pack 2 (32/64-bit). see the Oracle BPA Suite release notes in the file Readme. Ultimate.txt on the Oracle BPA Suite installation media. However.Oracle BPA Suite Installation and Administration Guide Hardware Processor RAM Recommended Intel Pentium IV 2. Lower bandwidths are possible. RedHat ES5-Linux Without local server LOCAL 267 . lower bandwidths can result in reduced performance. TCP/IP Network communication Software Operating systems TCP/IP (Page 249) Details Windows XP Professional + Service Packs Windows Vista (Business. ). for example. You do not need to install JRE separately. your installation is not used by Oracle BPA Suite.properties. If you use reports to import data from Excel tables. JRE If you have Oracle Business Process Repository installed and start Oracle BPA Suite products as programs. report output cannot be displayed in PDF format. you must have Adobe Reader and Microsoft Office version 2000. you need to specify settings in the Tools/Internet Options/Security/Custom Level menu in Microsoft Internet Explorer. 2003. Cyrillic. version 6. Arabic. 2002.Oracle BPA Suite Installation and Administration Guide Software Browser Details Microsoft Internet Explorer.properties. For example. To display different character sets (Japanese.ja file to font.0 Microsoft Internet Explorer. the corresponding file in directory <JRE installation directory>\<version>\lib must be named font. you want to output documents in PDF format using Microsoft Word or Microsoft Excel. Your JRE installation is only used if you start Oracle BPA Suite products from your browser. or 2007 installed. If you have already installed JRE. you must rename the font. please ensure that the tables have been saved in XLS format. it may not always be possible to open report output in PDF format from a Publisher 268 . an internal JRE version is automatically used. Adjust your browser settings to ensure that the following actions are permitted: Running ActiveX controls and plug-ins Downloading signed ActiveX controls Executing JavaScript Pop-ups are permitted in the domain in which the Oracle Business Process Publisher is running. If pop-ups are blocked.properties. if you wish to display Japanese characters. If pop-up blockers are activated for the domain.0 Security settings (Microsoft Internet Explorer) If Java Runtime Environment (JRE) is not yet installed and needs to be downloaded. etc. Output If. version 7. Windows Server 2003 Active Directory has been tested. 3.4. resource requirements. LDAP Oracle BPA Suite supports LDAP. Multi-monitor operation Oracle BPA Suite products are approved for multi-monitor operation. therefore. all applications that are linked in your models should be installed.1 Oracle Business Process Simulator Oracle Business Process Simulator is integrated into Oracle Business Process Architect.Oracle BPA Suite Installation and Administration Guide Software Details export. Oracle Business Process Simulator includes the following model types: EPC EPC (material flow) EPC (column display) EPC (row display) EPC (table display) EPC (horizontal table display) PCD PCD (material flow) Office process Industrial process Schedule/Composite schedule 269 . the documentation refers to this system. The focus can also be laid on costs. execution time or resource usage. etc. This answers questions on throughput times. Based on process models and organizational structures. In addition. weak points. the simulation enables a comparison of actual and target processes in respect of practicability and efficiency. bottlenecks. Oracle Business Process Simulator is used for process analysis and process optimization. If you use Oracle Business Process Simulator. If you cannot resolve the problems. you need at least 1 GB RAM for a 32-bit system.2 Client log directory The program activities are logged in the directory <system drive>:\Documents and Settings\<user>\Oracle BPA Suite11\log. 3. Event diagrams that have been assigned to events. you can use the log files to find and resolve errors. 64-bit systems need at least 2 GB RAM. 30% of main memory is automatically reserved for simulation. 270 . If you use Oracle Light as a database. If you use Oracle Business Process Simulator. Oracle Business Process Simulator supports the same platforms as Oracle Business Process Repository (see Administration Guide).4. 64-bit systems need at least 2 GB RAM. Function allocation diagrams that have been assigned to functions. please send an error description and the entire contents of the log and config directories to Oracle Corporation support. Oracle Business Process Simulator accesses the Oracle Light instance. If problems occur during operation. You need at least 1 GB RAM for a 32-bit system.Oracle BPA Suite Installation and Administration Guide Business process diagram (BPMN) BPMN allocation diagram The following model types are included without having to be explicitly selected. and Organizational charts that have been assigned to human resources. 0 GHz with 1 MB of level 2 cache Processor Dual Intel Xeon 2. 400 MHz (2 x 2 GB) Dual Rank 2 GB DDR2 SDRAM RAM 2 GB DDR2 SDRAM RAM Controller SCSI with RAID1 option SCSI with RAID1 option SATA-RAID1.4 GHz with 1 MB of level 2 cache Up to 50 simultaneous users Intel Pentium IV. Web application server to database server: Integration in a 1000 MBit network Client connection: Internet connection If you create a Publisher export and use links to large files (>15 MB).000 rpm in RAID array SCSI with RAID1 option SATA-RAID1.Oracle BPA Suite Installation and Administration Guide 3. reports are run by Oracle Business Process Publisher Server. 10. 15.000 rpm in RAID array Hard disk RAID1. 2 x 73 GB SCSI hard drive. the export process is canceled. 10. You can additionally install a Report Server (Page 194) to optimize system performance when running reports. After the standard installation.000 rpm in RAID array Operating systems Network connection Depends on the database systems (Page 275) used. 2 x 73 GB SCSI hard drive.5 Oracle Business Process Publisher This chapter describes the system requirements and configuration of Oracle Business Process Publisher. 271 . 2 x 73 GB SCSI hard drive. Oracle Business Process Publisher Server For 100 simultaneous users Up to 100 simultaneous users Intel Xeon 3.8 GHz with 1 MB of level 2 cache RAM 4 GB DDR2 SDRAM RAM. 3. you may need more memory for your Oracle Business Process Repository. If the memory is insufficient. you want to output documents in PDF format using Microsoft Word or Microsoft Excel. Cyrillic.). etc. If pop-up blockers are activated for 272 . we cannot guarantee that links will work correctly (Page 339).0 Microsoft Internet Explorer. you need to specify settings in the Tools/Internet Options/Security/Custom Level menu in Microsoft Internet Explorer. 2002. the corresponding file in directory <JRE installation directory>\<version>\lib must be named font.6. JRE The following are approved: (Page 275) Java Runtime Environment (JRE) 1. for example. or 2007 installed. 2003.properties. To display different character sets (Japanese. For example.Oracle BPA Suite Installation and Administration Guide Computers of the Publisher export users Browser Microsoft Internet Explorer. report output cannot be displayed in PDF format. version 7. version 6. If pop-ups are blocked. Output If. it is highly unlikely that they cannot be used. if you wish to display Japanese characters. If you use reports to import data from Excel tables.properties.properties. Arabic.0 Firefox 1. Adjust your browser settings to ensure that the following actions are permitted: Running ActiveX controls and plug-ins Downloading signed ActiveX controls Executing JavaScript Pop-ups are permitted in the domain in which the Oracle Business Process Publisher is running. you must have Adobe Reader and Microsoft Office version 2000.x While Oracle Corporation has not approved the use of later versions.0X and patches that are in the public domain (Java SE on the SUN home page except Java SE for Business) and generally released by SUN. Security settings (Microsoft Internet Explorer) If Java Runtime Environment (JRE) is not yet installed and needs to be downloaded.x Firefox 2.ja file to font. you must rename the font. please ensure that the tables have been saved in XLS format. However. With this database system. 273 . You can additionally install a Report Server (Page 194) to optimize system performance when running reports. in addition to a Java environment (JDK). Note When you combine various technologies. which. The data is held in a relational database system and is exchanged with the program via a JDBC interface. up to 10 users can access a Publisher export simultaneously. Oracle Business Process Publisher Servers manage every Publisher export. all applications that are linked in your models should be installed. The standard database system and Apache Tomcat Web Application Server are automatically installed if you select the standard installation for Oracle Business Process Publisher Server. After the standard installation.5. Depending on the Oracle Business Process Publisher Server license purchased. Always follow the instructions provided in the installation manuals of the relevant manufacturer. Swimlane models cannot be exported optimally using a Derby database. it may not always be possible to open report output in PDF format from a Publisher export. particularly announcements concerning releases on their Internet pages. In addition. reports are run by Oracle Business Process Publisher Server. We cannot guarantee proper functioning of supported third-party systems. these systems enable all users to simultaneously work on a Publisher export. you require an external database system. A Publisher export is a Web application based on J2EE. For a larger number of users. or contact Oracle Corporation support. administrators can create exports of your Oracle BPA Suite databases after you have installed Oracle Business Process Publisher Server.Oracle BPA Suite Installation and Administration Guide the domain. please observe the manufacturers' instructions.1 Oracle Business Process Publisher Server Oracle Business Process Publisher is integrated in the Administration module of Oracle Business Process Architect. With these products. 3. require a Web application server (for example Apache Tomcat) as runtime environment. Java Servlets and Java Server Pages (JSP) are used. To use a server other than Apache Tomcat Web Application Server. Note When you combine various technologies.Oracle BPA Suite Installation and Administration Guide If you retain the settings of the installation program when you use the standard installation of Oracle Business Process Publisher Server. or contact Oracle Corporation support. please follow the Installation instructions (Page 44). 274 . Always follow the instructions provided in the installation manuals of the relevant manufacturer. particularly announcements concerning releases on their Internet pages. We cannot guarantee proper functioning of supported third-party systems. please observe the manufacturers' instructions. the context path and the free port to the Web server are entered automatically. Please read the current release information and the Readme file.5.0. and databases Tested and approved combinations are listed in the tables below. Tested Web application servers Platform Web server IBM WebSphere 6. Therefore. This information was current at the time of printing. particularly announcements concerning releases on their Internet pages.1. R2 SP2 (32/64-bit) Windows Server 2008 (32/64bit) Yes Yes Yes Yes Yes Yes No Yes Yes 275 . or contact Oracle Corporation support. please observe the manufacturers' instructions. discrepancies may exist in Service Releases.Oracle BPA Suite Installation and Administration Guide 3.x (32/64 bit) Oracle WebLogic 11g R 1 Windows Server 2003 SP1. Always follow the instructions provided in the installation manuals of the relevant manufacturer. servers.1.5. SP2 (32/64-bit) Windows Server 2003 SP2. Note When you combine various technologies.1 Approved platforms. We cannot guarantee proper functioning of supported third-party systems. applications.15 or higher TomCat 5. SP2 (32/64-bit) Windows Server 2003 SP2.0.x Apache 2. (2) Tested with Sparc processors (3) Tested with Intel Xeon processors (4) Tested with RedHat ES 5 Tested Web servers Platform Web server Apache 2.x Windows Server 2003 SP1. 10 (1.Oracle BPA Suite Installation and Administration Guide Platform Sun Solaris 9. 2.2. 3) Red Hat Enterprise (4) Linux 5 VMWare ESX Web server No Yes Yes Yes No Yes Yes Yes No (1) Installation only by Oracle Corporation Support. R2 SP2 (32/64-bit) Yes Yes Yes Yes 276 . Oracle BPA Suite Installation and Administration Guide Tested database systems Platform Database system Standard database system (10 users max. 4) Red Hat Enterprise (5) Linux 5 VMWare ESX Yes Yes Yes Yes Yes Yes Yes Yes No Yes No No No Yes Yes Yes No No No No No Yes No No 277 .1/10.2.0.6) MS SQL Server 2005 (2) Windows Server 2003 SP1.) (1) Oracle 10. 10 (2. R2 SP2 (32/64-bit) Windows Server 2008 (32/64bit) Sun Solaris 9. 3. SP2 (32/64-bit) Windows Server 2003 SP2.1 ) Express Edition (Univers al) (2.x (2) Oracle 10g R 2 (10.2/ 11. You can only start one instance per computer. The maximum database size is 4 GB. this size is problematic if Oracle Business Process Repository and Oracle Business Process Publisher use the database on the same computer. 278 . (3) Tested with Sparc processors (4) Tested with Intel Xeon processors (5) Tested with RedHat ES 5 (6) You can use a maximum of 1 GB RAM and only one processor.Oracle BPA Suite Installation and Administration Guide (1)Only with 32-bit Java (2) Installation only by Oracle Corporation Support. 1 Show all groups in the Explorer tree (Publisher Server) By default. If you want to place the start page in another directory. change the default value from off to on.Oracle BPA Suite Installation and Administration Guide 3. 3.3 Modify configuration files Free port to Web server (Page 281) Change IP address (Page 282) LDAP user management (Page 282) OIS user management (Page 288) E-mail settings (Page 281) Use an Oracle database (Page 288) MS SQL Server 2005 under MS Windows 3. Procedure 1. <show_all_groups> <switch value="on"/> </show_all_groups> 3.cfg in the Publisher Server installation directory .5.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.5. you need to change the path accordingly. To display empty groups as well in the Explorer tree.5. 279 . Prerequisite You have access privileges for the Publisher Server installation directory. Open the file webappserver.2 Context path The context path is the path to the directory where the index. Save the change and close the file.3. change the corresponding setting in the configuration file. only groups containing at least one item are displayed in exports. 2. In the <switch value="off"/> line.html start page for Oracle Business Process Publisher is located.. AOracleDAO</env-entry-value> </env-entry> If you are using a Tomcat environment..cfg from the Oracle Business Process Publisher Server installation directory in a text editor.2 Change the DAO of an Oracle database (Tomcat) Procedure 1. ensure that the ojdbc5. It is assumed that version 10.Oracle BPA Suite Installation and Administration Guide 4.. the Explorer tree displays all groups of the relevant databases.String</env-entry-type> <env-entryvalue>com. In case of deployment in a Tomcat Web application server environment. 3.d ao.3 is installed. Tip You can undo this setting at any time by entering the default value and restarting Oracle Business Process Publisher.5. 280 .application.3. 2.businesspublisher.0. In case of deployment on an Oracle Application Server.lang.\BPServer\tomcat\common\lib) of Oracle Business Process Publisher Server.jar JDBC driver is available in the installation directory (.cfg from the Oracle Business Process Publisher Server installation directory in a text editor.2.database.\ BPServer\tomcat\webapps\businesspublisher\config\webappserv er. open the configuration file .aris. open the configuration file . Restart Publisher Server. Ensure that the entry for DatabaseDAOClass refers to a valid DOA value and is specified as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java.\j2ee\home\applications\BusinessPublisher\businesspublisher\co nfig\webappserver. The file is located on the installation media under /Setups/All OS/Oracle Business Process Publisher Server.idsscheer. In each Publisher export.. In this section. for example. Procedure 1. Information about settings is provided in the <bpadmin> section.cfg in the Oracle Business Process Publisher Server installation directory . Prerequisite You have access privileges for the Oracle Business Process Publisher Server installation directory. 281 . 2.3. Save the changes and restart Oracle Business Process Publisher Server. Procedure 1. Open the file webappserver. you need to enter the required port in the Tomcat Server Port box. configure the mail server settings.\BPServer\tomcat\conf\catalina\localhost\ with a text editor. 3..xml in the Oracle Business Process Publisher Server installation directory .5. In the following line.4 Free port to Web server The installation program automatically enters 9090 as the port. 3. To use another free port on your Web server.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor. Prerequisite You have access privileges for the Oracle Business Process Publisher Server installation directory.Oracle BPA Suite Installation and Administration Guide 3.3. automatic e-mails containing the initial passwords are sent to the appropriate users. Save the change and close the file. Specify the required settings. Open the file businesspublisher. change the value for the port number: <Connector port="9090" />.3 E-mail settings If you reset passwords. 2.5. Find the <bpadmin> tag.. 3. 5 Change IP address If you have installed Oracle Business Process Publisher Server on an external computer rather than locally. Procedure 1. The change takes effect only after you have restarted Oracle Business Process Publisher Server.6 LDAP user management If you manage users via an LDAP system. authentication is performed using this system.Oracle BPA Suite Installation and Administration Guide The change takes effect only after you have restarted Oracle Business Process Publisher Server.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor. 3. you need to customize the configuration file. e.. Open the file webappserver. 282 . 3. Procedure 1. Prerequisite You have access privileges for the Oracle Business Process Publisher Server installation directory.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor. <bpservicehost value="172.cfg in the Oracle Business Process Publisher Server installation directory .123"/> 3. you must enter the IP address of the external computer in the configuration file.. 2.cfg in the Oracle Business Process Publisher Server installation directory . Open the file webappserver. Prerequisite You have access privileges for the Oracle Business Process Publisher Server installation directory.5.111.5.30.g. Save the change and close the file.3.3. To enable the Oracle Business Process Publisher administrator to map LDAP user groups to Oracle BPA Suite user groups. In the bpservicehost value line. change the value for the IP address of the computer on which Oracle Business Process Publisher Server is installed. 4. 2.3. Find the <ldap> tag. On the Security tab.5. select the SQL Server and Windows authentication mode option.7 Use Microsoft SQL database Please adjust the system as required to manage Oracle Business Process Publisher in combination with an MS SQL Server 2005 database. 3. configure the login using an LDAP system. 283 . Specify the required settings. In this section. 3. Warning If your LDAP server is set up so that it allows anonymous authentication (unauthenticated bind mechanism). Information about settings is provided in the <ldap> section. all users covered by the license can simultaneously work with a Publisher export.Oracle BPA Suite Installation and Administration Guide 2. Procedure 1. Save the changes and restart Oracle Business Process Publisher Server. Open the Server properties dialog box. which is not possible with the standard database. If you use the MS SQL Server 2005 database. users may be able to log in without a password. Copy the encrypted password to this file and restart the server. Prerequisite Copy the file create_db. Note You can use the administration interface for exports to encrypt (Page 286) the password of the LDAP user maintained here. Microsoft SQL Server 2005 is not included in the package. The Oracle Business Process Publisher administrator can now map Oracle BPA Suite user groups to LDAP user groups. You have installed Microsoft SQL Server 2005 under MS Windows.sql (installation media/Setups/All OS/Oracle Business Process Publisher Server) to a directory of your choice. sql. c. Change the user name and password. and password according to your choice.Oracle BPA Suite Installation and Administration Guide 3.sourceforge. The script creates the specified data groups.x ml: a. If you are using named instances. Ensure that Latin1_General_CI_AI sorting is selected for the COLLATE statement. Customize the configuration file .xml. b.jdbc. If you have changed the names in the script. a. If you specify the ARISBP11 database name. use it instead of ARISBP11. you must also change them in the configuration file businesspublisher. ARISBPDATA: contains all database objects ARISBPINDEX: contains all index data d. Ensure that the URL has been adjusted correctly. Ensure that the path has been created before you run the script.xml and webappserver. for example as follows: jdbc:jtds:sqlserver://hostname:<Port>/ARISBP11 If you have specified a database name of your choice.\BPServer\tomcat\conf\catalina\localhost\businesspublisher.instance=<name of instance>. c. Ensure that the driverClassName property is set to net..Driver. 4. jdbc:jtds:sqlserver://hostname:1433/ARISBP11. complete the URL with the following entry: .cfg. b.jar (installation media/Setups/All OS/Oracle Business Process Publisher Server) to the Tomcat installation directory under common/lib. you must also change them in the configuration files businesspublisher. Create a database using the script create_db. 284 . Open the script for editing. Adjust the path to the database file. Copy the JDBC driver jTDS.jtds. for example.instanc e=MSSQLSRV. user name. you must adjust them here. Always follow the instructions provided in the installation manuals of the relevant manufacturer. please observe the manufacturers' instructions.String</env-entry-type> <env-entryvalue>com.microsoft. visit http://support.application.cfg.AMSSQLDAO</env-entry-value> </env-entry> Tip For additional information about Microsoft SQL Server 2005.. Customize the configuration file .aris. 6. <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entry-name> <env-entry-type>java. or contact Oracle Corporation support.datab ase.Oracle BPA Suite Installation and Administration Guide 5.com/kb/914277/en-us).dao.lang. Ensure that the database connection is set for MSSQL. 285 . Ensure that the entries in the following line are correct: <bp-mssql schema="ARISBPDATA" filegroupdata="ARISBPDATA" filegroup-index="ARISBPINDEX" /> If you have changed the names in the script.businesspublisher. a.com/kb/914277/en-us (http://support.microsoft.\BPServer\tomcat\webapps\businesspublisher\config\webappse rver.idsscheer. particularly announcements concerning releases on their Internet pages. Note When you combine various technologies. We cannot guarantee proper functioning of supported third-party systems. 5. 6. 8.3. The password is now encrypted. Ensure that the configuration file <Oracle Business Process Publisher Server installation directory>\tomcat\webapps\businesspublisher\layouts\default\config\ aspectOrientedEntry. 5. You do not have to adjust this file unless it has been changed after installation. 4. 3.cfg. a default user and the related password must be entered in the configuration file webappserver. Enter the password to be encrypted. you can encrypt this password and enter it in the configuration file.cfg in the Oracle Business Process Publisher Server installation directory (.8 Encrypt LDAP password If users are authenticated via LDAP. 286 ..Oracle BPA Suite Installation and Administration Guide 3. Copy the encrypted password to the clipboard. Click on Information and then on the Encrypt LDAP password link in the Other box. and change the value from false to true.\BPServer\tomcat\webapps\businesspublisher\config\) with a text editor. Search for the tag <ldappwdcrypted value="false"/>. 7. Save the change and restart Oracle Business Process Publisher Server. and then click on Encrypt LDAP password. 2. Search for the tag <ldapdefaultpwd value="password"/>. To prevent misuse.9 Configure navigation carousel To display the navigation carousel in exports. 3. and paste the copied password as a value between the quotation marks.3. Log in as administrator to the Publisher export.cfg. 1.xml is configured for evaluation of the modeled structuring model.5. a structuring model must be modeled in the database. Open the file webappserver. This setting is selected by default. Save your changes.xml" proxyAdress="hades. 2. Ensure that the values of the keys are maintained as follows: <aoeDefinition exportName="*" isVisible="true" and <aoeDefinition exportName="no export" isVisible="true" Changes to this file take effect immediately without restarting Oracle Business Process Publisher Server. 2. you can insert links in this area. Procedure 1.ids-scheer.3.ids-scheer. 3. For example.xml with your editor. Open the file in an editor. Prerequisite You have access privileges for the Oracle Business Process Publisher Server installation directory.10 Display news The News section in the Home module is used in the standard export as an example. you can keep a list of links to the models or objects that have been changed or created since a specific date.cfg.com/idsupload/products/aris_news/aris_news.TODO synchronize access to feed-xml --> <url proto="http" location="http://www. Find the <news basename="news"> area. 287 . Tip The News area can be customized to meet your requirements. and enter the URL for your RSS feed. If you have knowledge of RSS feed and XML programming.de" proxyPort="3103" refresh="600"/> </news> 3. <news basename="news"> <!-.5.Oracle BPA Suite Installation and Administration Guide Procedure 1. Open the file \BPServer\tomcat\webapps\businesspublisher\layouts\default\conf ig\layout. e.3. Save the changes and restart Oracle Business Process Publisher Server. <LoginModuleSection value="OISLogin"/>..4:7001. i.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.4:7001">.cfg in the Oracle Business Process Publisher Server installation directory . 4. Find the <LoginModuleSection> tag. The Oracle Business Process Publisher administrator can now map Oracle BPA Suite user groups to OIS user groups. 5.5.. authentication is performed using this system.3. Open the file oisconfig. <oisproviderurl value="http://192.5.168. If you use this database. The default port is 7001. 3. Prerequisite You have access privileges for the Oracle Business Process Publisher Server installation directory. Procedure 1. To authenticate via the OIS system.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor. Find the <oisproviderurl> tag.12 Use an Oracle database (Tomcat) Please adjust your system as required to run Oracle Business Process Publisher in combination with Apache Tomcat Web application server and an Oracle database. 2. all enabled users can work simultaneously with a Publisher export.g. This description assumes you are using Apache Tomcat. 3.3.3.168.e. Specify the URL for the OIS system and the correct port number in the form of http://192. 288 .11 Configure OIS user management (Oracle Business Process Publisher Server) If you manage users via an OIS system. Open the file webappserver.Oracle BPA Suite Installation and Administration Guide 3.cfg in the Oracle Business Process Publisher Server installation directory . you must adapt the configuration file. Set the value OISLogin. always follow the instructions provided in the Oracle Installation Guide. query_rewrite_enabled=true query_rewrite_integrity=trusted You have created two tablespaces: ARISBPDATA (for table data) and ARISBPINDEX (for index data). ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA.Oracle BPA Suite Installation and Administration Guide Prerequisite You have created an Oracle database and configured it as follows. You can select any password. The name of the Oracle user is assumed to be ARISBP. you run the risk of completely exhausting the memory in the tablespaces. unlimited growth. Use of the database character set AL32UTF8 is mandatory. GRANT QUERY REWRITE TO ARISBP. ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX. you must customize the configuration file webappserver.xml (see below). GRANT ALTER SESSION TO ARISBP. GRANT CREATE TABLE TO ARISBP. regular monitoring (e. 289 . and you achieve better performance and higher availability. If you prefer another name. You have created an Oracle user that Oracle Business Process Publisher can use to connect to the database. If the option for automatic growth is not set. The Oracle user must have the following privileges GRANT CREATE SESSION TO ARISBP. which may cause important functions of Oracle Business Process Repository and Oracle Business Process Publisher to fail. To use other names or existing tablespaces.cfg (see below). We recommend that you use two separate Oracle databases for Oracle Business Process Repository and Oracle Business Process Publisher. change the name there as well: CREATE USER ARISBP IDENTIFIED BY ARISBP. If you install a database yourself. GRANT CREATE VIEW TO ARISBP. We recommend a block size of 8K.g. This keeps the two systems from competing for resources. We recommend that you set the tablespaces for automatic. Enter it in the configuration file businesspublisher. weekly) of the Oracle instance is required to ensure that the tablespaces are manually increased on time. Otherwise. go to: http://jakarta..apache.sql.html)--> username="ARISBP" password="ARISBP" <!-.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!-url="jdbc:oracle:thin:@hostname:port:sid where you replace hostname.DataSource" maxActive="30" maxIdle="30" maxWait="1000" initialSize="10" <!-.\BPServer\tomcat\webapps\businesspublisher\config\ with a text editor.org/commons/dbcp/configuration.html (http://jakarta. port. Open the file businesspublisher. and sid in the URL as appropriate--> connectionProperties="SetBigStringTryClob=true"/> </Context> 3.cfg in the Oracle Business Process Publisher Server installation directory . a. Procedure 1. Open the file webappserver. 2.Oracle BPA Suite Installation and Administration Guide We recommend that you turn off the Oracle recycle bin because large quantities of tables accumulate there when exports are deleted.\BPServer\tomcat\conf\catalina\localhost\ with a text editor.org/commons/dbcp/configuration. For an explanation of these values. Ensure that the following entries are correctly maintained: <bp-oracle tablespace-data="ARISBPDATA" tablespaceindex="ARISBPINDEX" /> 290 .apache.xml in the Oracle Business Process Publisher Server installation directory ..Use the Oracle user name and password here (see Prerequisites> -> driverClassName="oracle.jdbc.Configure the DBCP (database connection pool) with these values.driver. Ensure that the following entries are maintained: <Context path="/businesspublisher" docBase="C:\Program Files\Oracle BPA Suite11\BPServer\tomcat\webapps\businesspublisher\" debug="0" reloadable="false" crossContxt="true"> <Resource name="jdbc/businesspublisherdb" auth="Container" type="javax. AOracleDAO</env-entryvalue> </env-entry> 4.idsscheer.jar exists in the Oracle Business Process Publisher Server installation directory .\BPServer\tomcat\common\lib.2.String</env-entry-type> <env-entry-value> com. We cannot guarantee proper functioning of supported third-party systems.lang. b. which will lead to errors when used by Oracle Business Process Publisher. particularly announcements concerning releases on their Internet pages.13 Oracle restart After restarting the ORACLE server. Always follow the instructions provided in the installation manuals of the relevant manufacturer.aris.3.businesspublisher. The query is already commented out and included in the file businesspublisher. please maintain them here.xml.dao.0. We assume that you are using version 10.application. please observe the manufacturers' instructions. 291 . You can exclude this source of error by testing the connections of the connection pool via query in advance. links to the database may no longer function.5. Ensure that you have adjusted the entries for DatabaseDAOClass as follows: <env-entry> <description>The IDatabaseDAO Implementation Class</description> <env-entry-name>DatabaseDAOClass</env-entryname> <env-entry-type>java. You find the file on the installation media.3.Oracle BPA Suite Installation and Administration Guide If you have decided to use other tablespace names (see Prerequisites). or contact Oracle Corporation support. You need to insert the query as a value. Note When you combine various technologies.database. 3.. Ensure that the JDBC driver ojdbc5. 5. 3.xml in the Oracle Business Process Publisher Server installation directory . The export administration opens. As of now. the prerequisites mentioned above are automatically met. The reports only contain methods allowed for Oracle Business Process Publisher. Add the following value after the last value: validationQuery="select 'Y' from dual. you cannot use the report scripts provided with Oracle BPA Suite. Note Normally. 4. The reports only require read access to items. The reports do not call any dialog boxes. a new connection is established..4 Manage reports Administrators can manage reports in the administration interface of exports. Model. an error message is output during report execution. If they are no longer correct. If the prerequisites for Oracle Business Process Publisher reports are not met. 292 . or Object. Log in as a system administrator or administrator. Group. Some of these reports are interactive and use methods that are not supported by Oracle Business Process Publisher. 3. If you use a report template to create the reports in design view. Prerequisite You have exported report scripts and observed the following: The reports only evaluate the contexts Database.Oracle BPA Suite Installation and Administration Guide Procedure 1. 2. Locate the <Resource name= tag. Save your changes. the connections to the database will be tested.\BPServer\tomcat\conf\catalina\localhost\ with a text editor. Open the file businesspublisher. Procedure Add report 1. Make sure that one of the approved JRE versions is installed on all computers and the specific system requirements (Page 265) are met.properties. Click on Browse.arx) of the relevant report. you can create user-defined evaluation scripts or adapt existing scripts. For example. 3.). if you wish to display Japanese characters. To display different character sets (Japanese.properties. JRE The following are approved: Java Runtime Environment (JRE) 1. description. Cyrillic. the corresponding file in directory <JRE installation directory>\<version>\lib must be named font. Arabic. etc. and context are displayed in the table. click on Add. you can create report outputs based on a report script template in design view. setting options.ja file to font.0_04 and subsequent patches that are in the public domain (Java SE on the SUN home page except Java SE for Business) and generally released by SUN. Reports provided here must meet the prerequisites. Click on Upload. 3. Export files are created when you export a report script from Oracle Business Process Architect.6. Tip If you need additional evaluation scripts. Users can run newly added reports only after they log in again. you must rename the font. and select the report export file (*. If you are familiar with the JavaScript and Oracle BPA Suite Script programming languages. The report is removed from the list. In the Reports module. 4.6 Java clients (browser mode) This section describes the requirements and the setup.Oracle BPA Suite Installation and Administration Guide 2.properties. Report name. for example. and execution modes for starting Oracle BPA Suite products via your browser (as Web clients) rather than starting them as applications. Delete report Click on Delete . 293 . JRE 1.0_01\lib\endorsed. e. C:\Program Files\Java\jre1. 294 . enter the text/html MIME type for the properties file type.6.6.g.6. If JRE 1. copy the file jaxb-api.Oracle BPA Suite Installation and Administration Guide Note SUN renamed the JRE versions.6. use the following command line entry to start the program: -Dsun. Only then can the arisloader. SUN Microsystems guarantees compatibility between the JRE patch levels.cfg file be used. Update 4.0_04 and subsequent patches are approved for an Oracle BPA Suite product. Oracle BPA Suite products are tested using the JRE that is current at the time of release. you must create it.0 (IIS 6.0) with default settings.java2d. If you are using JRE 1.0_04 and JRE 1. In this case. Procedure Oracle Business Process Architect: Register the cfg MIME type with the Web server.6 update 3 or an older version.d3d=false IIS 6.0.0_04 is now called JRE 6. Therefore. If the directory endorsed does not exist. Web Publisher exports: For the Web site on which the Web Publisher exports will run. please proceed as follows to display the files listed below. We therefore recommend installation of version 4 or higher. Depending on your graphics card and driver configuration.6. Approvals are also valid for subsequent updates. Please note that you must repeat this procedure for every update of version 3 or older. the Oracle BPA Suite approvals for JREs are valid for all patch levels of a version. installation of Java 6 update 10 may cause delays in the Designer and Matrices modules.0 on Windows Server 2003 If you installed Internet Information Server 6.0_05 and for any subsequent patch from the public domain Java SE of the SUN home page (except for Java SE for Business). the approval is valid for both JRE 1. If you have Java 6 update 10 installed. problems may occur despite better performance. This allows Web Publisher export files to be identified.jar from the directory <Web Client Components>\lib to the directory <Java JRE installation directory>/endorsed. Pass the link on to users who want to work with Oracle Business Process Architect. Install a JRE approved for Oracle BPA Suite. the database list of the linked Oracle BPA Suite Site is displayed. If the Web Client Components are set up.cfg file: # Versioninfo # ARIS_Version=11g. Here are some examples of entries in the arisloader.cfg is saved in the directory %BPAHOME11g%server/html/config. Install the Web Client Components (see Installation Guide). When you navigate back to the Web Client Components installation directory using your browser.1 Installed files of Oracle BPA Suite By default. the link to the index_lan. you will find the link to the HTML test page at the end of the multilingual index page. This file controls the download of Java-based products if you click on a database shortcut on the home page. 2. and execution modes that are important for using Oracle BPA Suite products in a browser environment. Navigate to the Web Client Components installation directory using your browser. The file arisloader.6. 3.1. Ensure that the system requirements are met.html file. You need the downloaded JAR files to run Java-based products.Oracle BPA Suite Installation and Administration Guide 3. for example. Ensure that the directory name of the path does not contain any spaces or special characters.6. Procedure 1.260956 # File_Version=1 # Use variable DownloadClientPath to override the default directory where the files # of the ARIS Download Client are stored # Sample: # DownloadClientPath=C:Download Client DownloadClientPath= 295 .0. or otherwise the JRE cannot be run.1 Set up Java clients for browser use This section provides you with information on the setup. setting options. 4. the files you need to download the Java-based products to your computer are installed in the directory %BPAHOME11g%server/html/lib. 3. change_2.jar jar=ant.ecore_2.xmi_2.eclipse.jar jar=org.2.2.5.jar jar=CnvConnect.2.jar jar=bsscjhrs.jar jar=org.2.Oracle BPA Suite Installation and Administration Guide # DO NOT EDIT THIS SECTION! # Main Start Class jvmOptions=-Xms64m -Xmx256m -XX:NewSize=32m XX:MaxNewSize=64m # External Libraries jar=CcConfig.0.3.eclipse.jar jar=qname.0.jar:ignore jar=iText-2.0.jar jar=ociplugins.1.jar jar=CorticonFoundationAPI.0.eclipse.jar jar=commons-collections-3.0.core.eclipse.2.jar jar=JimiProClasses.3.v200705141058.1.3.1.emf.2.2.jar jar=CcLicense.jar jar=activation.emf.equinox.2.jar jar=orbacus.emf.2.2.jar jar=org.0.0.0.2.v200705141058.jar jar=lucene-analyzers-2.0.14.ecore.jar jar=jdo2-api-2.v20060603.2.jar jar=log4j-1.0.runtime_3.0.jar jar=castor-1.jar jar=ejb20.ecore.v200705141058.R32x_v20070118.jar jar=jide-develop.jar jar=iTextAsian.resources_3.jar jar=ant-launcher.osgi_3.edit_2.2.common_2.jar jar=org.jar jar=org.2.3.3.eclipse.0.jar jar=antlr.eclipse.common_3.jar jar=org.v200705141058.jar jar=tools.jar jar=org.0.jar jar=jh.2.jar jar=commons-dbcp-1.eclipse.2.jar jar=lucene-highlighter-2.jar jar=CcSaxpath-1.emf.1.core.0.jar jar=commons-discovery.R32x_v20061218.jar jar=js.jar jar=simulationstepcache-1.jar jar=lucene-core-2.emf.jar jar=poi-3.2.jar jar=ChartDirector.jar jar=commons-pool-1.jar jar=org.jar jar=jdom.jar jar=org.v200705141058.v20060603.jar jar=mail.2.jar jar=wsdl4j.2.jar jar=xercesImpl.7.jar jar=jaxb.jar jar=commons-lang-2.eclipse.2.jar jar=commons-configuration-1.jar 296 .jar jar=commons-logging.eclipse.4.2. 3.cfg is checked. BPAHOME11g= is an environment variable of the client computer and not an entry in the file arisloader.jar jar=cl_locale_de.jar jar=y.jar jar=y-annotations-1. The BPAHOME11g= environment variable allows you to copy the JAR files to any directory on any client computer.jar jar=y-graphlayout-2.Oracle BPA Suite Installation and Administration Guide jar=xml-apis. Note Please do not use any country-specific special characters in the path for BPAHOME11g= or DownloadClientPath=. The DownloadClientPath entry in the file arisloader. the JAR files are copied to the directory specified there.jar jar=y-reportdesigner-client-2. 2.jar jar=y-graphics-3.jar jar=y-utils-2.jar jar=y-lipo-1. the system searches for the BPAHOME11g environment variable. The entry and environment variables are queried in the following sequence: 1. The setup of ARIS Toolset enters for variable BPAHOME11g= the path to the installation directory of ARIS Toolset.jar jar=client.jar # ARIS Client jars jar=arismethod.jar jar=cl_locale.cfg.jar jar=cl_locale_en.jar jar=y-reportexecution-2.jar Use the DownloadClientPath= entry or the BPAHOME11g= environment variables to specify the directory on your computer to which the files of the Java-based products are copied after startup. If the system finds it.jar jar=y-reportdesigner-common-2. If a directory is assigned to this entry. 297 . the JAR files are copied to that directory. the JAR files are copied to the directory <installation directory>\Oracle BPA Suite<Version>\DownloadClient.jar jar=y-guiframework-6. If the environment variable is not found. If no directory is assigned to this entry. 6. During installation.properties.html (index_app.Oracle BPA Suite Installation and Administration Guide 3.html) and aris_database_app. a language update is performed automatically when a Java-based product opens a database. you must rename the font. To display different character sets (Japanese. 3.html) are stored.ja file to font.properties.3 Execution as application or applet We recommend that you run Java-based products as an application to prevent errors caused by your browser. the directory \template\htmlgen is created in which the files aris_database_lan. Even if you are able to start multiple Web clients.html (index_app.1. Cyrillic.properties.1. For example. the corresponding file in the installation directory must be called font. As a result. if you wish to display Japanese characters.6. The lines for starting Java-based clients differ as follows: File aris_database_lan.cfg file in the installation directory. You can install Java-based products as a client or launch them as an application via a browser as described below.2 Language update and character sets A language update for the Web Client Components and Oracle BPA Suite Server enters the language resource files in the arisloader.). for example Oracle Business Process Architect. we recommend that 298 .html (index_lan. the Java call remains open in the background.html) for starting Java-based clients as an application: var appletmode = (args['appletmode'] ? args['appletmode'] : "javaapp"). you may not be able to start a second Web client. Warning If you start a Web client via Internet Explorer. File aris_database_app. Arabic.html (index_lan. As a result.html) for starting Javabased clients as applets: var appletmode = (args['appletmode'] ? args['appletmode'] : "applet"). etc. bin file in the BPA11 subdirectory of the user profile (%userprofile%). They would have to be made manually. the following applies: The cid.1.Oracle BPA Suite Installation and Administration Guide you start only one Web client at a time because simultaneous access of multiple Web clients to one Java instance may lead to loss of data and program crashes. user-defined symbols in your databases. you can provide them with additional memory. for example.bin file must not be distributed because all clients will otherwise be identified as one and the same client. This is recommended if you use memoryintensive. After starting the Oracle BPA Suite products. To provide 256 MB of memory (recommended). open the Java control panel.6. Since the file is newly created when the client is started. there is no need to distribute it. Generally. 3.1. In the file arisloader.6. you can then assign the BPAHOME11g environment variable to the DownloadClientPath= entry for this path. updates or other changes by the Oracle BPA Suite installation program are no longer possible.5 Installation by software distribution Warning As a consequence of changing the standard installation as described in this section. Tip This setting affects all Java-based programs. 3. 299 .cfg. and change the Java applet runtime settings by entering the required Java runtime parameters for the JRE version you are using. you will find the cid. You can copy the JAR files of a Java-based product from the directory Oracle BPA Suite11g/DownloadClient to a directory on the client computer via software distribution.4 Provide additional memory If you use Java-based products as applets. Go to the control panel. enter -Xmx256m. cfg You can specify the following settings in the user.6.1.cfg When Oracle Business Process Architect is installed for the first time (Page 295). You can then start ARIS Business Optimizer in the browser. the internal user.cfg or user. To open the second Java-based product. 2.cfg file to the directory <installation directory>\server\html\config\oem02.cfg If Oracle Business Process Architect finds the user.5. Open the file user. which terminates the Java applet.2 Start a second Java-based product in the browser If you start Oracle Business Process Architect in the browser. 3.6. and save the file under the name user.1 Possible settings for user. and open the browser again.cfg. You can set up sample Java-based products and copy the generated user.Oracle BPA Suite Installation and Administration Guide 3. it uses this file instead of the preconfigured file (Page 300) user.6.cfg with a text editor.3 Configure user. You must delete the session ID in that case.5. Procedure 1. Switch to the config directory of your Web Client Components installation. the Java applet that is still active prevents it.1.1.2 Preconfigured user.5.tmp file in the config directory of your Web Client Components installation. enter your data (Page 300).cfg.cfg file is used when the application is first started.6. But if you try to start a second Java-based product. 3. the Java applet runs in the background in Internet Explorer. you must close the browser. in the same manner. such as ARIS Business Optimizer. You can update these files simultaneously via software distribution.cfg file: You can specify configuration settings. for example. for example. 300 . such as the default filter or grid width. 3. Local standard database system installations are not updated.2 Set up web clients for automatic update For installed Web clients. continue with the next step.3.6.g. If you update the ARIS Web Client Components of your Web server using a patch setup. e. you can configure the system to search a URL for current program files at startup. If the content of the arisloader. they will be downloaded. in our example http://WebServer/ BPA_autoupdate. Create a virtual directory that is mapped to the installation directory of the installed Web Client Components.1 Preparations for the automatic update To perform an automatic update. Assign a name to the Web directory. Install the Web Client Components (see user-defined installation of Oracle Business Process Repository in the Installation Guide) on your Web server. ARIS_autoupdate. 3. such as http://WebServer/BPA_autoupdate. the Web clients will automatically download the current files when the setup is run. by entering http://WebServer/BPA_autoupdate/config/arisloader. 3. 2.cfg in any Web browser. Test the auto-update URL. If current files are available. The automatic update is only performed for Java-based products.Oracle BPA Suite Installation and Administration Guide 3. 3.6. create a virtual directory on your Web server for which you enable client access.3.cfg file is displayed. 301 . If you update the virtual directory on your Web server by running a patch setup.6. Communicate the URL. the Web clients you set up will automatically download the updated files at the next startup. Procedure 1.3 Automatically update installed Web clients You can set up a virtual directory on your Web server that the installed Web clients can access to download newer versions. Note If LDAP authentication is enabled. Enter the URL for the automatic Oracle BPA Suite update.Oracle BPA Suite Installation and Administration Guide Procedure 1. If you want the user login to fulfill higher security requirements than the standard user management. 2. Make sure that user names in the LDAP system contain only valid characters and that users use secure passwords._ ! " § $ % & / ( ) = ? * + # < > . 3. which avoids redundant passwords. Moreover. 3. the system user system is never authenticated via the LDAP system. Start the Web client and click on View/Options. Every time the Web client is started. in our example http://WebServer/BPA_autoupdate. The system user system is an exception. you receive a corresponding message. click on Automatic updates. 5. correct the URL. 4. we recommend that you use LDAP authentication. users that have been created in the database can no longer log in. In the tree view. spaces. the user names and passwords only need to be maintained in the LDAP system. the specified URL is checked for updated program files.7 Central user login using LDAP The security level of this user authentication system meets the highest standards. you can still log in as the user system. If users are authenticated by an LDAP server rather than the Oracle BPA Suite database. Click on OK to close the options. administration is simplified since you only create user groups in the database and assign access and function privileges to them. With this 'single point of login'. . you can prevent that user from accessing any of the Oracle BPA Suite databases that use the LDAP login process. . : 302 . Unlike all other users. In this case. Alphanumeric characters. and the following characters are allowed in user names: . Enable the Enable automatic updates check box. If any are available. If a connection cannot be established. If the LDAP servers are down and databases cannot be accessed. Enable the Test connection check box. they can be downloaded. if you delete an LDAP user or change his password. Applicable restrictions and parameters depend on the particular system used. All other LDAP system connections required for specific projects are available from our Field Support on request.Database/Authentication system/LDAP settings pages. Help on using wizards and dialog boxes is available directly in the user interface. therefore. Click on Administration in the Modules bar.7. You have installed an LDAP server. To authenticate users via LDAP. The LDAP server software can be downloaded free of charge from the Internet or purchased. Follow the instructions in the dialog boxes.1 Configure LDAP server operation To enable user authentication via your LDAP system. you need to install an LDAP server and adjust your databases. no general configuration and connection description can be provided. comprehensive knowledge of the relevant system is required. Prerequisite You have the Database management function privilege. To connect LDAP. and log in to the database. 2.Oracle BPA Suite Installation and Administration Guide Due to significant differences in the various LDAP systems. Procedure 1. Click on the Properties button. You find general descriptions on the following pages. the documentation refers to this system. 3. 303 . You have created user groups in the databases and assigned function and access privileges to them. you must change database properties. Windows Server 2003 Active Directory has been tested and approved. Please note that any customization required by manufacture or customer is not covered by the standard software maintenance and maintenance contract of IDS Scheer AG. We therefore cannot guarantee proper functioning of Oracle BPA Suite in combination with different LDAP systems. The program is unable to verify whether your entries are correct. and correctly maintain all data on the Properties . Always refer to your LDAP system documentation because installation varies from system to system. Map LDAP user groups to Oracle BPA Suite user groups. if necessary.exe -keystore C:\Program Files\Oracle BPA Suite 11\server\jre\lib\security\cacerts -storepass changeit -import alias <dc> -file <path>\<certificate file> Now you need to specify the following settings for each database whose users are to log in using the LDAP server.2 Set Oracle Business Process Repository for LDAP server operation with SSL Procedure 1. and select Properties/Authentication system/LDAP settings/Connection. 4. enable the Automatically import users at login check box and. 5. 4. consult your LDAP system documentation. the user is authenticated via the LDAP server. you need to import LDAP users in the database. On the Filter and import properties page. authenticated LDAP users are automatically created as users in the database during their first login. 3. The program could be called as follows: Please note that you need to replace the terms in angle brackets (< >) with the actual terms without angle brackets: keytool. The program is located in the Oracle BPA Suite server installation directory>\server\jre\bin directory. If you do not select this option. select a user group. 6.7.exe. 304 .Oracle BPA Suite Installation and Administration Guide 3. Install the LDAP server you want to use. Import the certificate using the program Keytool. Right-click on the name of the database. 2. In Oracle BPA Suite. To do so. Example: You have installed Oracle BPA Suite Server in the directory C:\Program Files\Oracle BPA Suite 11\server\. Obtain the SSL certificate for your LDAP system. Enter the path to the Oracle BPA Suite server installation directory as the keystore parameter. As a result. From now on. 3. log in to the database that is managed on this Oracle Business Process Repository. save the directory <Oracle BPA Suite installation directory>\server\templates with all its subdirectories. If required. Database In Oracle Business Process Architect. Scripts In Oracle Business Process Architect. using the Backup (Page 316) command. Enable the Use SSL check box and ensure that the correct value is maintained in the Port box. Filters In Oracle Business Process Architect.zip. using the Backupconfig (Page 319) command. Method. using the Backup functionality in the pop-up menu of a database. you can open this file using an extraction program and restore the files of the sysconfig directory. the configuration files are backed up in the file backup_sysconfig. using the Export functionality in the pop-up menu for a filter (individual backup).Oracle BPA Suite Installation and Administration Guide 7. To back up all scripts and macros for an Oracle Business Process Repository. using the Backupconfig (Page 319) command. 305 . Every time Oracle Business Process Repository is launched. using the Backup functionality in the pop-up menu of a database. 3. In Oracle BPA Suite Site Administrator.8 Data backup Administrators have various options for backing up your data that is managed on an Oracle Business Process Repository. The connection to the LDAP system is established via SSL. configuration. This file is saved in the sysconfig directory. In Oracle BPA Suite Admintool (Page 312). using the Export functionality in the pop-up menu for a script (individual backup). In Oracle BPA Suite Admintool (Page 312). and queries In Oracle BPA Suite Admintool (Page 312). Alternatively. or uninstall a component. you must import the filters of the previous version containing all user attributes of the database. 306 . make changes to a program. A selection of files is listed here to provide examples: In a client installation in directory <Oracle BPA Suite installation directory>\backup<date>: Files from <Oracle BPA Suite installation directory>\LocalServer\data (user databases. Subsequently. the relevant files and directories are backed up. add languages. You can now customize attribute type groups and attribute types. you can also use Oracle BPA Suite Converter. restore the database of the previous version on your current Oracle Business Process Repository. Please note that you can only view user attributes in the current Oracle BPA Suite version if you have imported the corresponding filters from the previous version. To be able to apply user attributes from previous versions. when uninstalling) Directory <Oracle BPA Suite installation directory>\server\sysconfig Directory <Oracle BPA Suite installation directory>\server\templates Note User attributes of the Free attributes attribute type group from previous Oracle BPA Suite versions are no longer used as of version 11g.Oracle BPA Suite Installation and Administration Guide When you perform an update. when uninstalling) Directory <Oracle BPA Suite installation directory>\LocalServer\sysconfig Directory <Oracle BPA Suite installation directory>\html Directory <Oracle BPA Suite installation directory>\script In a server installation in directory <Oracle BPA Suite installation directory>\server\backup Files from <Oracle BPA Suite installation directory>\server\data (user databases. These user attributes are only created and thus visible once the filters have been imported. 2.1 and higher. Enable the option button for the Oracle BPA Suite version to be used as the source for conversion. Select the Oracle BPA Suite Server on which the converted database is to be saved. Click on Next.1 Transfer data from earlier Oracle BPA Suite versions This chapter provides information on data transfers from databases of Oracle BPA Suite 10.1. for example.1. The contents of user databases can be transferred in their entirety using Oracle BPA Suite Converter. Click on Next. 307 .3. What data will be transferred? You can continue to use data from Oracle BPA Suite 10. 3. Select the source containing the Oracle BPA Suite user database that you want to transfer to your new Oracle BPA Suite installation.1 and higher. The Oracle BPA Suite Converter Wizard opens.Oracle BPA Suite Installation and Administration Guide 3. Ensure that the Oracle Business Process Repository has been launched with access to the databases. Transfer databases User databases contain the structural and process-oriented organization of your company. Click on Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Converter 11g if you installed Oracle BPA Suite in the program group suggested by the installation program. 7. Enter the server name and click on OK. 8. The data to be transferred can exist locally within an Oracle BPA Suite installation or on the network. Procedure 1. 6. click on Add.3. you can transfer user databases and configuration databases. To add a server to the list. 4. 5.8. Using Oracle BPA Suite Converter. Create a backup copy of your databases. Enter the server name and click on OK. To add a server to the list. Select the user database you would like to transfer. Existing items and user-defined symbols in the configuration database on the target server will be overwritten with items and user-defined symbols having identical GUIDs. 3. d. Assignments of attributes to attribute type groups that already exist in the configuration database on the target server will be overwritten. Enable the check boxes for the configuration database items you wish to transfer. f. c. Note To convert databases locally (LOCAL server).Oracle BPA Suite Installation and Administration Guide Based on your settings you now have one or several of the following options. free attributes and units of free attributes that already exist in a certain language in the configuration database on the target server will be overwritten. Click on Next. Names of user-defined symbols. if they do not exist on the target server. 2. e. 308 . Oracle BPA Suite Network server Select an Oracle BPA Suite server in the Network server box. Items and method extensions in the configuration database on the target server remain unchanged if they do not exist on the source server. click on Add. you need to launch the LOCAL server of the appropriate Oracle BPA Suite version before starting Oracle BPA Suite Converter. To start LOCAL. Items and method extensions in the configuration database on the source server will be transferred. click on LOCAL in the tree view in the Explorer module. Click on Next. Procedure 1. a. Local system Local database directory: Enable the Local option button. Enabling all check boxes has the following effects: b. Oracle BPA Suite Installation and Administration Guide User-defined symbols are always transferred. font formats.1. Tip The procedure description and the Select configuration data wizard page of the online help for Oracle BPA Suite Converter include instructions for selecting individual item groups.1. When you transfer item groups with Oracle BPA Suite Converter. and chart definitions are managed in the configuration. 3.1 Configuration Method and evaluation filters. 6. To start data transfer. from the configuration of Oracle BPA Suite 10. 4.8. 5.8. The converted database is saved. The contents of the configuration are available to all user databases on a given server. 10. Oracle BPA Suite Converter closes. Click on Next. 7. the assignment of user-defined symbols to objects in the databases still exists. Enter the database administrator password and the password for the configuration database of the source server. 8.1. such as filters or model templates. click on Finish. Once the data transfer has been completed successfully a message appears. Click on OK.3. Click on Next. Click on Next. In other words.1 Transfer item groups of the configuration You can use Oracle BPA Suite Converter to transfer all or individual item groups. Enter the database administrator password and the password for the configuration database of the target server. 9.1 and higher.1. the reference to the respective database is not affected. for example. 309 . a number is added to the name of the converted database. You can transfer individual configuration items. If the name of the converted database already exists on the target server. 3. templates. You cannot disable this check box. Check the settings you specified in the wizard. 8. Procedure 1.8. Open the Configuration/Conventions database item. Run Oracle BPA Suite Script Converter (Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Script Converter 7. and templates You can transfer filters. Click on OK.1. Right-click on Filter.1. 3. The Select scripts to be converted dialog box opens. Font formats. 3. decide how conflicts are to be solved during import by enabling the relevant check boxes. 5. and chart definitions that you have exported in XML format (ACC. Select the import file and. languages. 7. 310 . Use Oracle BPA Suite Script Converter to transfer VB scripts and import converted scripts to the required Oracle Business Process Repository. or template. Procedure 1. language. if required. 6.1. 2. Click on Select scripts. 4. In the navigation bar. 2.2 Transfer custom or modified scripts of previous Oracle BPA Suite versions You can import user-generated or modified scripts and semantic checks that you wrote in JavaScript in previous Oracle BPA Suite versions. Activate the Administration module. Copy the VB scripts to the appropriate script directories of the directory Oracle BPA Suite <installation directory>\script. The Import dialog box opens.Oracle BPA Suite Installation and Administration Guide 3.1). 3. The following description refers to Oracle Business Process Architect. AMC. click on the plus sign (+) next to the server into whose configuration you wish to import the filter. and ATC files). Run Oracle Business Process Architect. font format. font formats. templates. Languages or Templates and select Import.2 Transfer exported filters. you are informed which scripts are affected and why Oracle BPA Suite Script Converter did not update them. Tip It is also possible to back up user databases online.8. For additional information. Use Oracle BPA Suite Admintool to back up all user databases. Click on Convert. select the scripts to be converted. Navigate to the appropriate script directory. please contact Oracle Corporation support. The selected scripts are listed in the Oracle BPA Suite Script Converter output window. Scripts that are not updated remain on the list. Use Oracle BPA Suite Admintool to back up configuration data. you proceed as follows. 2. A message is displayed when the update is complete. Use the BPAadm11 backup all <directory> command if you use the Oracle BPA Suite Admintool in interactive mode. Note If not all scripts have been updated. write-protected scripts cannot be updated. Repeat the script selection for all relevant directories.Oracle BPA Suite Installation and Administration Guide 4. The Oracle BPA Suite System Maintenance and Administration training session provides instructions on backup procedures and concepts. For example. Use the BPAadm11 backupconfig <directory> command if you use the Oracle BPA Suite Admintool in interactive mode. Oracle BPA Suite Script Converter updates all scripts in the list and removes them from the output window. and click on Open. 311 . 5. Procedure 1. 3.2 Back up users and configuration To back up the entire content of a database server. This file is saved in the sysconfig directory. 3. the configuration files are backed up in the file backup_sysconfig. for example. If required. Oracle BPA Suite databases should not be edited using Windows Explorer. You can start Oracle BPA Suite Admintool from any client computer and access the databases on the server: Click on Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Admintool 11g if you accepted the program group suggested by the installation program. The program is a console application and runs in the MS DOS input window.zip. you can open this file using an extraction program and restore the files of the sysconfig directory. 3. this may result in program malfunction.8.3 Automatic backup of current configuration files Every time Oracle Business Process Repository is launched. The individual commands of the program are supplied as command line parameters.8. Warning As a basic rule. You can restore it using the Restoreconfig command. The program provides information on the success and effect of each command executed.Oracle BPA Suite Installation and Administration Guide 3.9 Data management with Oracle BPA Suite Admintool You can use Oracle BPA Suite Admintool commands (Page 313) to manage the Oracle BPA Suite databases of a server and to change administrator passwords. we strongly recommend that you protect these scripts at the operating system level because passwords are unencrypted. if you use scripts for daily backups. For example.4 Save method changes Running the Backupconfig (Page 319) command in Oracle BPA Suite Admintool (Page 312) backs up all data for the configuration and method of an Oracle Business Process Repository. The MS DOS input window opens and Oracle BPA Suite Admintool is launched in interactive mode. If you rename database folders or copy files. 312 . Note To use Oracle BPA Suite Admintool outside of interactive mode. you need to enter a command to navigate to the Oracle BPA Suite installation directory (for example.e. 3. to the directory C:\Program Files\Oracle BPA Suite). you replace <directory> with the name of an existing directory. i.9. this command could be: backup all e:\backup Parts of commands that are enclosed in square brackets are optional. To work outside of interactive mode. For example. you must enter the parameter Oracle Business Process Repository. if you use scripts for daily backups. Example: delete [<database name>] [all] After the command. as well as passwords.2 Oracle BPA Suite Admintool commands In this section. For example. The MS DOS input window opens and Oracle BPA Suite Admintool is launched in interactive mode. Parts of commands that are enclosed in angle brackets must be replaced with the appropriate designations or names. Example: In the Backup all <directory> command. If parameters include spaces you need to enclose the parameter in quotation marks.Oracle BPA Suite Installation and Administration Guide 3. 313 . all program commands are listed with their syntax both in interactive mode (Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Admintool 11g) and outside of interactive mode. we strongly recommend that you protect these scripts at the operating system level because passwords are unencrypted.1 Start Oracle BPA Suite Admintool You can start Oracle BPA Suite Admintool from any client computer and access the databases on the server: Click on Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Admintool 11g if you accepted the program group suggested by the installation program.9. you can use these if you need to.. you can either enter a database name or use all to specify that all databases be deleted. The following options can be used in Oracle BPA Suite Admintool: 314 .. enter the following: Interactive mode copy Sales data "Sales data 2005" Outside of interactive mode BPAadm11 copy Sales data "Sales data 2005" Syntax A command line in Oracle BPA Suite Admintool has the following syntax: BPAadm11 [<option>] <command> [<command argument 1>] ..Oracle BPA Suite Installation and Administration Guide If you want to create the Sales data database with the name Sales data 2005. for example. If the password is not correct. -u <user> <password> Specifies the alternative password for the system user. The default password is DBADMIN (uppercase).Oracle BPA Suite Installation and Administration Guide Option -s <server name> Description Indicates the server on which the command is to be performed. the program will prompt you to enter the correct password before the selected command can be performed. Oracle BPA Suite is set as the default. -l <file name> Activates logging of all program operations. -pa <password> Indicates the Site Administrator password. -cf <command file> Specifies the command file with executable commands that is to be started. If the password is not correct. the program will prompt you to enter the correct password before the selected command can be performed. 315 . In interactive mode. The default password is CFGADMIN (uppercase). The log file indicates which operation was performed at what time and with what result. The default password is SITEADMIN (uppercase). -p <password> Indicates the database administrator password for the specified server. -pc <password> Indicates the configuration administrator password for the specified server. -sc <schema context> Indicates the context of the schema. the server can be changed via the server command. it is recommended that you back up your user databases every day. you will be prompted to supply the Database Administrator password before each command is executed. system messages in Oracle BPA Suite Admintool are always output in the Oracle BPA Suite installation language. ADB. '&' in the password). enter the following command call and press Enter: backup <database name> <backup directory> The name of the backup file consists of the name of the database and the appended file extension. we strongly recommend that you protect these scripts at the operating system level because passwords are unencrypted. if you use scripts for daily backups. you need to enclose the value in quotes. If you have not entered a password. On the server. To back up a database as an ADB file. please observe the following: If you are working with Oracle BPA Suite Admintool on the server computer.2. 316 . For additional information. To avoid the risk of losing this data. 3.Oracle BPA Suite Installation and Administration Guide Notes When working with Oracle BPA Suite Admintool. The contents of these databases are subject to constant development. For example. If you use values with special characters (e.9.1 Backup Backs up a database as a compressed file with the ADB (Oracle BPA Suite database) file extension to a folder of your choice.g. Oracle BPA Suite databases may contain your company's organizational structure and business processes. for example. important information is added. Every time a user opens a database and supplements a model for example. use the -s localhost parameter. please refer to the help and support center for your operating system. For example. The database administrator password is DBADMIN. To back up all databases on a server as ADB files. 317 . You can use the following switch: All: Backs up all databases on the selected database server. 3.2. The backup file is to be saved to the Backup folder on a data carrier.9. databases that have been backed up as ADB files can be imported into and registered on a server. Oracle BPA Suite Admintool is launched directly in interactive mode and you can enter the desired command. Enter the following command line and press Enter: backup project e:\backup Once you have identified yourself as the database administrator. the command is executed.1. Procedure 1. if you use scripts for daily backups. we strongly recommend that you protect these scripts at the operating system level because passwords are unencrypted. Run Oracle BPA Suite Admintool (Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Admintool 11g).Oracle BPA Suite Installation and Administration Guide Warning If a file of the same name already exists in the backup directory.1 Example The Project database to be backed up is located on the LOCAL server. 2. Interactive mode backup [<database name>] [all] <backup directory> [<new database name>] Outside of interactive mode BPAadm11 backup [<database name>] [all] <backup directory> [<new database name>] Using the Restore (Page 326) command. enter the following command call and press Enter. it will be overwritten. it is recommended that you back up your user databases every day.2 Backupasn Saves a database as a compressed file with the file extension ADB. <head> or <work> can be used.cmd file. Extracts the status of the specified change list number <asn> from a versioned database <dbname> to an ADB file of the <archivedir> directory. Every time a user opens a database and supplements a model for example.1. Then use the time control software to specify the times at which the data backup is to be performed.cmd to <Oracle BPA Suite installation directory>\JavaClient.9.2.9. This program can be run regularly using time control software. To avoid the risk of losing this data.2. copy the file backup. Instead of <asn>.2 Data backup using a batch program (batch file) If you want to back up data automatically at a particular time every day. if you use scripts for daily backups. The contents of these databases are subject to constant development. All registered databases will be backed up at the specified time to the directory you previously entered in the backup. Databases may contain your company's organizational structure and business processes.Oracle BPA Suite Installation and Administration Guide 3. 3. enter the following command call and press Enter: backupasn <database name> <backup directory> <change list number> 318 .cmd batch program in the addons\ServerBackup directory on the Oracle BPA Suite installation media. we strongly recommend that you protect these scripts at the operating system level because passwords are unencrypted. for example. To back up the state of a specific change list number of a versioned database as an ADB file. To perform time-controlled data backups. Oracle BPA Suite provides support with the backup. Warning For example. <head> stands for the last versioned state and <work> for the current state that is not versioned yet. important information is added. 3 Backupconfig Saves the Oracle BPA Suite configuration data (filters. templates. and Restoreversioned (Page 327) command. use the Restoreconfig command. enter the following command call and press Enter: backupasn <database name> <backup directory> work The name of the backup file consists of the name of the database and the appended file extension ADB. Using the Restore (Page 326). enter the following command call and press Enter: Interactive mode backupconfig <backup directory> <new file name> Outside of interactive mode BPAadm11 backupconfig <backup directory> <new file name> To restore (Page 328) configuration files. it will be overwritten.2. and charts) to the specified directory in the appropriate file format. databases that have been backed up as ADB files can be imported in and registered on a server. 3. To save the Oracle BPA Suite configuration data. enter the following command call and press Enter: backupasn <database name> <backup directory> head To back up the state of a versioned database that is not versioned yet as an ADB file.9. Restoreasn (Page 327). 319 . Warning If a file of the same name already exists in the backup directory.Oracle BPA Suite Installation and Administration Guide To back up the current state of a versioned database as an ADB file. If a database already exists with the name specified in the second parameter. you will be prompted for it by the system) configadminpassword <current password> Outside of interactive mode BPAadm11 configadminpassword <new password> <current password> 3. you can specify the server to which you want to copy the database by typing a colon behind the target database name and adding the server name.4 Configadminpassword Changes the configuration administrator password.2.2.9. To copy a database. Example The SalesDB database is to be duplicated on the LOCAL server. The database administrator password is DBADMIN.Oracle BPA Suite Installation and Administration Guide 3. enter the following command call and press Enter: Interactive mode copy <source database name> [all] <target database name> Outside of interactive mode BPAadm11 copy <source database name> [all] <target database name> Optionally. To change the configuration administrator password. enter the following command call and press Enter: Interactive mode (the new password must not be entered in interactive mode. the database cannot be copied. 320 . In batch mode.9.5 Copy Copies databases to a server. The copy of the database is to be named New salesDB. you can also enter the database administrator password and specify that all databases are to be copied: copy <source database name> <target database name> [all] [:<server>] [/<server password>] Note Database names must be unique. Oracle BPA Suite Admintool is launched directly in interactive mode and you can enter the desired command.7 Dbmspassword Changes the password of the DBMS user. you will be prompted for it by the system) dbmspassword <current password> Outside of interactive mode BPAadm11 dbmspassword <new password> <current password>.2. The Oracle DBMS user is called ARIS71. 3. 2. Run Oracle BPA Suite Admintool (Start/Programs/Oracle BPA Suite/Administration/Oracle BPA Suite Admintool 11g). configurations or user login information from the Oracle BPA Suite site to a selected directory. Enter the following command line and press Enter: copy SalesDB "New salesDB" If you have identified yourself as the database administrator. 3.Oracle BPA Suite Installation and Administration Guide Procedure 1. This change is helpful if the DBMS (Database Management System) in use is also used by applications other than Oracle BPA Suite.6 Createdb Creates a new database. Interactive mode download [logs] [configs] [accounting] <target directory> all 321 . This may be the case with the Oracle DBMS.2. To change the password of the DBMS user: Interactive mode (the new password must not be entered in interactive mode.2.9. The default password is arisadmin (lower case). Interactive mode createdb SalesDB Outside of interactive mode BPAadm11 createdb SalesDB 3.8 Download Saves log files. the command is executed.9.9. To delete a database from the selected database server. enter the following command call and press Enter: Interactive mode help <command> 322 .11 Help Displays a help text for every available command.2. configs for configurations and accounting for user information. Outside of interactive mode BPAadm11 download [logs] [configs] [accounting] <target directory> 3. as well as the parameters that must be entered with the command.9. You can use the following switches: All: Deletes all databases on the selected database server.10 Exit Exits interactive mode and closes the Oracle BPA Suite Admintool window.2. The Exit command can only be executed in interactive mode.9. To call help for a specific command. The help text describes the actions that will be performed as a consequence of the command. enter the following command call and then press Enter: exit 3. Force: Deletes the relevant databases even though users are still logged in. enter the following command call and press Enter: Interactive mode delete [<database name>] [all] [force] Outside of interactive mode BPAadm11 delete [<database name>] [all] [force] 3.2.Oracle BPA Suite Installation and Administration Guide Logs stands for log files.9.9 Delete Removes databases from the database server and deregisters them. To exit interactive mode as well as the program. You need to log in to each server only once. enter the following command call and press Enter.9. Interactive mode kill [<session ID>] [all] Outside of interactive mode BPAadm11 kill [<session ID>] [all] 323 . To terminate a user's connection to databases on the specified server.Oracle BPA Suite Installation and Administration Guide Outside of interactive mode BPAadm11 help <command> To see an overview of help. 3.2. enter the following command call and press Enter.2.9. To enter a sequence of commands within the program. Changes which have not yet been saved are lost and must be made again after Oracle BPA Suite has been restarted. enter the following command call outside of interactive mode and press Enter: BPAadm11 interactive 3. This connection is identified by the connection ID that you can display using the Sessions command. You can use the following switch: all: Terminates all connections with databases on the selected database server. in which you can enter several commands in a prompt sequence without having to exit the program.12 Interactive Switches to interactive mode.13 Kill Terminates a user's connection to databases on the selected database server. you can navigate through the Help. By pressing the Enter key. Warning All users whose connection to databases on the specified server was terminated with the Kill function cannot properly exit Oracle BPA Suite. enter the following command call and press Enter. To display all databases that can be opened by Oracle BPA Suite. which means that a set number of maintenance tasks is performed depending on the database.Oracle BPA Suite Installation and Administration Guide 3. Refer to your database management system documentation for information regarding specific maintenance tasks. enter the following command call and press Enter.15 Maintain Starts maintenance for the specified database.9. for example. 324 . such as backup or XML export. In this way. Interactive mode maintain [<database name>] [all] Outside of interactive mode BPAadm11 maintain [<database name>] [all] 3. To display the server activities.2. all databases of the Oracle BPA Suite and Business Optimizer context are output. Maintenance is database system-specific.2.16 Monitor Shows all current server activities. enter the following command call and press Enter.9.14 List Displays all databases that are registered on a database server and that can be opened by Oracle BPA Suite. Interactive mode list [all] Outside of interactive mode BPAadm11 list [all] 3. You can use the following switch: all: Starts maintenance for all databases on the database server.2.9. You can use the following switch: all: Lists all databases regardless of context. To perform maintenance for a database. To change the database administrator password.2. Oracle BPA Suite searches the database for object and connection definitions that do no longer have occurrences in models.9.18 Rename Renames a database. To rename a database. 325 .2.2. These are deleted.17 Password Changes the database administrator password for the selected server. enter the following command call and press Enter. enter the following command call and press Enter.19 Reorg Reorganizes a database. you should not enable this option since it may be possible and intended for certain definitions to exist without having any occurrences.Oracle BPA Suite Installation and Administration Guide Interactive mode monitor Outside of interactive mode BPAadm11 monitor 3. the current password must be entered. Interactive mode password <new password> <current password> Outside of interactive mode BPAadm11 password <new password> <current password> 3. Interactive mode rename <old database name> <new database name> [force] Outside of interactive mode BPAadm11 rename <previous database name> <new database name> [force] 3.9. If you are using an object library.9. First. You can use the following switch: force: Renames the database even if users are connected to it. To import one or more ADB files in a directory to a server and register them there.Oracle BPA Suite Installation and Administration Guide A database can only be reorganized if no user is logged in to the database.9. You are therefore given the opportunity to rename the database when importing.2. 326 . You can use the following switch: overwrite: Overwrites a database on the database server that has the same name as the one imported.20 Restore Imports individual databases that were backed up as ADB files. Interactive mode reorg [<database name>] [all] Outside of interactive mode BPAadm11 reorg [<database name>] [all] 3. enter the following command call and press Enter. or imports all ADB files of a directory to the current database server. enter the following command call and press Enter. You can use the following switch: all: Reorganizes all databases on the selected database server. Interactive mode restore <backup file> [overwrite] Directory with multiple ADB files: restore <backup directory> [overwrite] Outside of interactive mode BPAadm11 restore <backup file> [overwrite] Directory with multiple ADB files: BPAadm11 restore <backup directory> [<new database name>] [overwrite] To import an ADB file and rename the database at the same time. To reorganize a database. The database directory must not contain a database that has the same name as the one to be imported. enter the following command call and press Enter. enter the following command call and press Enter. The overwrite option can only be used for backup files of the current program version. You are therefore given the opportunity to rename the database when importing. head stands for the last versioned state. You can use the following switch: overwrite: Overwrites a database on the database server that has the same name as the one imported. Interactive mode restoreversioned <backup file> [<database name>] [overwrite] Directory with multiple ADB files: restoreversioned <backup directory> [overwrite] Outside of interactive mode BPAadm11 restoreversioned <backup file> <database name> [overwrite] Directory with multiple ADB files: BPAadm11 restoreversioned <backup directory> [overwrite] 3.22 Restoreasn Creates a versionable database <dbname> of a specific state from an ADB file <archive> of an unversioned database. 327 . Can also back up all adb/bdb files of a directory.Oracle BPA Suite Installation and Administration Guide Interactive mode restore <backup file> [<new database name>] [overwrite] Outside of interactive mode BPAadm11 restore <backup file> [<new database name>] [overwrite] 3.21 Restoreversioned Creates a versionable database <dbname> from an ADB file <archive> of an unversioned database. To import one or more ADB files in a directory to a server and register them there. Either a change list number <asn> or head can be selected as the state.2.9.2.9. Can also back up all adb/bdb files of a directory. The database directory must not contain a database that has the same name as the one to be imported. The overwrite option can only be used for backup files of the current program version. 23 Restoreconfig Saves the Oracle BPA Suite configuration data (filters. and charts) to the specified directory in the appropriate file format.2. enter the following command call and press Enter. 3.24 Server Can be run in interactive mode only.9.2. 328 . enter the following command call and press Enter: server <server> [<password>] You can enter the Site administrator password now or wait for it to be requested later. To terminate the current server connection and create a new one. Interactive mode restoreasn <ADB file> <change list numberasn> <database name> [overwrite] or restoreasn <archive> head <dbname> [overwrite] Directory with multiple ADB files: restoreasn <backup directory> [overwrite] Outside of interactive mode BPAadm11 <ADB file> <change list numberasn> <database name> [overwrite] or BPAadm11 restoreasn head <archive> <dbname>[overwrite] 3. use the Backupconfig (Page 319) command. All commands that are entered thereafter relate to the new server. To save the Oracle BPA Suite configuration data. templates. To import one or more ADB files in a directory to a server and register them there.Oracle BPA Suite Installation and Administration Guide You can use the following switch: overwrite: Overwrites a database on the database server that has the same name as the one imported. It terminates the current connection to the server and permits connecting to another server.9. enter the following command call and press Enter: Interactive mode restoreconfig <path\file name> Outside of interactive mode BPAadm11 restoreconfig <path\file name> To back up ACB files. 25 Sessions Displays all users who are logged in to a database on the specified server.9. Users sorted by user name: Interactive mode sessions byuser Outside of interactive mode BPAadm11 sessions byuser Users sorted by process identifier: Interactive mode sessions bypid Outside of interactive mode BPAadm11 sessions bypid Users sorted by database name: Interactive mode sessions bydatabase Outside of interactive mode BPAadm11 sessions bydatabase 329 . The following information is displayed: TCP/IP host name of the computer that the user used when logging in to the database User name Connection ID Name of the application that established the connection The user name displayed is based on the value specified in the Username environmental variable of the computer from which the user logged in to the database.2.Oracle BPA Suite Installation and Administration Guide 3. The following options are available for displaying information about all current users of databases on the specified server. The information displayed can be sorted either by user name or database name. To change the Site administrator password: Interactive mode (the new password must not be entered in interactive mode. The default password after installation is SITEADMIN.2.9. To display this information for one or all databases.Oracle BPA Suite Installation and Administration Guide 3.9. This is case sensitive. enter the following command calls and press Enter: Interactive mode Information about a database: statistic <database name> Information about all databases: statistic all Outside of interactive mode Information about a database: BPAadm11 statistic <database name> Information about all databases: BPAadm11 statistic all 330 . you will be prompted for it by the system) siteadminpassword <current password> Outside of interactive mode BPAadm11 siteadminpassword <new password> <current password> 3.26 Siteadminpassword Changes the password of Oracle BPA Suite Site Administrator.2.27 Statistic Displays the following information for the evaluated database: All models All users All font formats You can use the following switch: all: Outputs all information about the database. 9. provided the necessary system requirements are met.29 Version Outputs the version number of the Oracle BPA Suite Admintool program. Ensure that the Report Server is enabled. It is installed with the Oracle BPA Suite Site Administrator installation. To display the status of a client-server connection.10 Evaluation (scripting) The VB report execution environment enables you to run Visual Basic reports when you work with Java-based products. Interactive mode: Version Outside of interactive mode BPAadm11 version Tip To output the version number of an Oracle Business Process Repository. To display version numbers.2.28 Status Displays the status of a client-server connection. enter the following command call and press Enter: Interactive mode status <server> Outside of interactive mode BPAadm11 status <server> 3. enter the following command call and press Enter. The VB report execution environment runs under Windows. 3.Oracle BPA Suite Installation and Administration Guide 3. 331 . please use the Status (Page 331) command.2. With Oracle Business Process Architect you can also create and run JavaScript reports.9. Afterward. you ensure that memory requirements are optimized when the reports are run. To achieve this. we recommend a 64-bit Windows installation or a Unix installation due to the upper memory limit of 1. 3. you can take the following steps.10. For example. that is. This reduces the execution time of your reports and the risk of reaching the memory limits of your system. Note If you observe certain requirements (Page 332) when creating report scripts. it is advisable to clear them. for example: Avoid storing lists of Oracle BPA Suite objects in global variables if possible. JavaScript reports The RAM required for JavaScript reports varies greatly. Use "short" functions to keep data only as long as it is required. you ensure that memory requirements are optimized when the reports are run. This measure provides additional memory for report execution in the long term even if the memory requirements in Java and using JavaScripts cannot be controlled directly.Oracle BPA Suite Installation and Administration Guide Visual Basic reports You need about 10 MB RAM plus about 25 MB RAM for each simultaneously run Visual Basic report.1 Optimize memory requirements If you observe certain requirements (Page 332) when creating report scripts. to create four reports at the same time. Please also note the information on script development (Page 331). If you want to run report scripts that process large quantities of database items. 332 . If lists containing a large number of objects are no longer needed. This reduces the execution time of your reports and the risk of reaching the memory limits of your system. This helps enable Java's garbage collection to delete these objects from the memory. the database objects should no longer be kept in memory. you need 10 MB plus four times 25 MB RAM. a total of 110 MB RAM.2 GB main memory for Oracle Business Process Repository. Only use database objects within the report for as long as is necessary. and semantic checks) in the Administration module.10. you must have Adobe Reader and Microsoft Office version 2000. please ensure that the tables have been saved in XLS format. or 2007 installed. please ensure that the tables have been saved in XLS format. 2003. The reports are saved in your Temp directory. for example. 2002. you must configure the file userServerSettings. In Oracle Business Process Architect. You can always run these locally. To save them in a different directory. all applications that are linked in your models should be installed. or 2007 must be installed on the computer on which Oracle Business Process Repository Site Manager is installed. Note The Report Server is running by default. Please also note the information on script development (Page 331). If you use reports to import data from Excel tables.Oracle BPA Suite Installation and Administration Guide 3. it may not always be possible to open report output in PDF format from a Publisher export.2 GB main memory for Oracle Business Process Repository. In addition. If you use reports to import data from Excel tables. 2003. If you want to run report scripts that process large quantities of database items. use the Save As functionality in the output program. we recommend a 64-bit Windows installation or a Unix installation due to the upper memory limit of 1. Microsoft Office version 2000. you can manage evaluation scripts (reports. 2002. 333 . To shut down the Report Server.cfg as follows. macros. transformations. you can shut down (Page 254) the Report Server to avoid unnecessary use of system resources.2 Report formats and report files Visual Basic reports To generate DOC and XLS output formats. The RAM required for JavaScript reports varies greatly. If you do not want to start any VB scripts on an Oracle Business Process Repository. All reports If. If pop-up blockers are activated for the domain. you want to output documents in PDF format using Microsoft Word or Microsoft Excel. and files on the client.3 Windows API functions Since reports are run on the server. or opening dialog boxes.g. dialogs that are called from a script via Windows API functions cannot be displayed on the client. You find the parameters for these methods in the corresponding help files. for example. programs. = 0.10. For this reason. The relevant programs and files are run or opened via the default methods on the server.Oracle BPA Suite Installation and Administration Guide 3. The same applies to running Shell and ShellExecute. running. = 3 BrowseForFiles 334 . GetSaveFileName (Win API) GetFilePath (Sax Basic) SHBrowseForFolder (Win API) ShellExecute (Win API) Shell BrowseForFolders BrowseForFiles Option parameter e.g. Replace the default methods as shown in the following table: Default GetOpenFileName (Win API) Oracle BPA Suite Script BrowseForFiles Option parameter e. Oracle BPA Suite Script has special methods for displaying. Multiple files can be selected if you increase this parameter by + 8. options variable globally valid and allows you to run the report as a Web report: Dim nDlg_Options As Long bIsOk = False If bIsOk Then Begin Dialog UserDialog 440.100.14.21 CancelButton 320.1.21 End Dialog Dim Dlg As UserDialog End If If Dlg.380.1 OptionGroup.77."Option2" OKButton 210.100."Option1" OptionButton 20.1.35.14."ARIS Report" ' %GRID:10. when a message box (MsgBox) is used in the DialogFunc to output an error message.14.options OptionButton 20. an error occurs here because the Dlg.Oracle BPA Suite Installation and Administration Guide 3. Such nested dialogs occur.1 OptionGroup.7."ARIS Report" ' %GRID:10."Option2" OKButton 210. 335 . The following change makes the Dlg.77. Example of a local report: bIsOk = False If bIsOk Then Begin Dialog UserDialog 440.options = 0 Then .10.. If this report is run on a server..14.5 Nested dialogs Nested dialogs are not permitted in Web reports.77.100. To have the Web report output this message box.380.21 End Dialog Dim Dlg As UserDialog nDlg_Options = Dlg.21 CancelButton 320."Option1" OptionButton 20.. 3.112. you need to integrate it in such a way that it appears only after the dialog box generated with DialogFunc is closed.380.14.options End If If nDlg_Options = 0 Then .380.options variable is not globally valid.14. for example..100. this differs from use in the local report because you must declare the scope of the dialog variables.35.4 Dialog variables When you use dialog variables in a report.7.10.options OptionButton 20.77.112. you do not need any icons in the directory noted above unless you want to use your own icons.ico.10.server/templates/scriptservice/internal/.6 Icons for placed attributes For example. Once you have changed icons. for example.ico and txt. Icons of Microsoft Office products are automatically displayed.. ensure that you have saved the corresponding icons in the installation directory of your Oracle Business Process Repository. the icons that are saved in the icons subdirectory in the installation directory of your Oracle Business Process Repository are used for linked files. they will not be displayed in the Publisher export or report output. if you run reports or create a Publisher export. Open the installation directory of the relevant Oracle Business Process Repository . Procedure 1. save the graphics under the names bmp. 336 . you need a suitable application. For these applications. To create icons that represent bitmap graphics or text files. Note If icons displayed in models are different from those in the report output or in Publisher export. 3. Assign file names that conform with the extension of the relevant application.10. administrators must provide these icons. in the icons subdirectory. You can change icons or add new ones. Added icons are immediately available. and create the images subdirectory. To create and edit icons in ICO format.Oracle BPA Suite Installation and Administration Guide 3. If icons for placed attributes are missing there. Prerequisite You have administration privileges for the Oracle Business Process Repository installation directory. you must restart Oracle Business Process Repository.7 Add custom icons for macros For users to be able to add frequently used macros as icons to the toolbar. we cannot exclude the possibility of problems arising from unpredictable incompatibility issues with certain hardware/software combinations. This applies. In some cases. no icons from the images directory are displayed.lst file and save it in UTF-8 format.. Note Despite the approval of our software for operation with the listed operating system versions and other software and hardware requirements. The file specifies the sequence in which the icons are displayed in the user interface. please contact Oracle Corporation support. use other Office applications. The graphics must be (n*16) x 16 pixels in size. 3. If the file images.png <Name of the second icon>. or export from Web Publisher. This is where you save the icon files in PNG format. for example.Oracle BPA Suite Installation and Administration Guide 2. operational faults may occur when you display graphics in Oracle BPA Suite. The new icons are available to users in the Configure macros dialog box after restarting the program.11 Known restrictions Knowing how the system is going to be used is essential to determining an optimal technical configuration. Versions more recent than those listed below have not been tested or approved for use. to the use of certain printers/printer drivers or graphic cards/graphic card drivers under certain operating system versions.. When a hardware key is used for copy protection of software programs.png . 337 . Create an images. 3. The file must have the following structure: <Name of the first icon>. poor performance of the parallel interface may lead to delays or even errors. For specific cases. create reports.lst is missing. If you have formatted a text with the Algerian character set. add the following expression to the file: <reportdir font_location="/Fonts/" > </reportdir> 338 . We cannot guarantee proper functioning of supported third-party systems.xxxxxx. If you install additional character sets in a directory of your choice.cfg in the directory install_bpa11.sh/config must be adjusted.Oracle BPA Suite Installation and Administration Guide When you combine various technologies. for example. If the memory is insufficient. Reports in PDF format Windows operating systems If you select PDF as the output format and create the report script in design view. Links If you create a Publisher export and use links to large files (>15 MB). the file userServerSettings. particularly announcements concerning releases on their Internet pages. only the character sets of the computer (C:\Windows\Fonts) on which Oracle Business Process Repository is installed are used. and this is not in the specified directory. or contact Oracle Corporation support. Printers/plotters Oracle BPA Suite printouts are not generated correctly with the HP Design Jet 800 plotter driver and compatible drivers in HPGL mode. the export process is canceled. Please also note the error sources described (Page 339). To do this. the default character set is used to output this text. Additional character sets that you install in C:\Windows\Fonts are automatically considered. you may need more memory for your Oracle Business Process Repository. Unix operating systems There is no default directory for character sets under Unix operating systems. Always follow the instructions provided in the installation manuals of the relevant manufacturer. please observe the manufacturers' instructions. Access can also be limited to files of a specific type. links may no longer work. which can sometimes lead to errors. de or en. e.sun. If you create a Publisher export and use links to large files (>15 MB). If the memory is insufficient.do?bug_id=5040856). Many factors play a role in this process. since the MIME type cannot be determined directly. the names will not be displayed correctly. for example. etc. All files that have been linked in databases are managed on a file server. the linked file is displayed.com/bugdatabase/view_bug. you should use only Western European characters in computer names. Your system administrator may have defined these restrictions in various places: Server Operating system of the server Client Operating system of the client Central settings (with Active Directory. When you click on a link in a browser. you may need more memory for your Oracle Business Process Repository. Using file servers is one way to exclude the possibility of faulty links. Some systems do not return files without an extension. If you publish OLE objects whose file names are written in Japanese characters in another language. 3.g. These files cannot be opened. If. Type of file (MIME type) Not every browser can display all files. Ensure that all system requirements are met and only the approved browsers are used.) Proxy and its operating system 339 . the export process is canceled.1 When do links work? A link is a connection between resources.11. replace the Japanese (or other) file names with English ones. To be able to open the files. you install a security update for your browser that is not approved by IDS Scheer.Oracle BPA Suite Installation and Administration Guide Characters Because of a known error in JVM (Sun) (http://bugs. Syntax Local link without drive link The link file:///C:/Program Files/Internet Explorer/readme. for example. a URL is processed in 8-bit representation.Oracle BPA Suite Installation and Administration Guide Correct notation Depending on your system configuration. External links Correctly written and absolute links pose no problems. you must place these links in quotation marks. you install a security update for your browser that is not approved by IDS Scheer.. Different errors may also occur depending on system and security settings.txt Local link with local drive link 340 . Many systems cannot process more characters than that.txt opens a file in the local directory structure C:\Program Files\Internet Explorer\readme. These restrictions are not at all uniform and differ between various browsers and different versions and patches. or with spaces and special characters. No problems should be expected if you: Maintain links in English and without any spaces and special characters If you maintain links in languages such as Japanese. a distinction must be made between local and external links. Unicode coding must be handled separately. etc. The browser handles these as external links. links may no longer work. Type of link Depending on the domain from which a link is started or to which a link leads. Local links All links to local files are subject to strict security restrictions. Generally. All links to files that were copied from Oracle Business Process Publisher to the Oracle Business Process Publisher Server also work correctly. the notation of the link may also cause errors. Links are no longer than 1024 characters. If. Oracle BPA Suite Installation and Administration Guide The link file:///U:/ARIS/businesspublisher/tomcat 5. these links cannot be resolved if you use an Oracle Business Process Repository. user_pref("capability. More frequently.txt opens a file in the local directory structure U:\ARIS\\businesspublisher\tomcat 5. with U representing a direct link to a local directory. External link with network drive link The link file:///V:/External/Version. opens a file in the drive structure \\SERVER\www\trace.policy.checkloaduri. These links only work if you manage the database on the local server local.default\ users. user_pref("capability.txt. All local access is blocked automatically.en abled". without a drive link) to any resource in the network is possible with a UNC path.policy. Security risks Not every browser always makes interactive reference to possible security risks.16/RUNNING. file://SERVER/www/trace.5.txt. or file://///SERVER/www/trace. You can remove blocking of specific sites by adjusting or creating the file <drive>:\Documents and Settings\<USER>\Application data\Mozilla\Firefox\Profiles\<GENERATED_NAME>. Direct access (i.sites". "allAccess").txt.txt.policynames". 341 . "localfilelinks").txt.e. "http://pcsomeone").txt. functional links are blocked. Firefox generates a message in the error console in these cases (Tools/Error console).16\RUNNING.policy.txt opens a file in the network structure V:\External\Version. Authorizations Missing authorizations and the storage location of linked files may be reasons for faulty links. If locally saved files are linked in a database. for example.5. UNC link (Universal Naming Convention) UNC path The link with a different syntax.localfilelinks. file:///\\SERVER\www\trace.localfilelinks. but does not distinguish between local and external links.js: user_pref("capability. with V representing a direct connection to a network drive. It is a component of a 3-tier architecture. ensure that your authorization concept permits access to linked documents. 3. such as the Islamic and traditional Japanese calendar.2 Calendar Oracle BPA Suite supports the Gregorian calendar. Oracle BPA Suite agent Program that autonomously monitors and manages Oracle Business Process Repository processes. A Application server Computer on which applications are run. Oracle Business Process Architect Modeling tool of the Oracle BPA Suite product family that runs within a browser or as an application (Page 298) and that can be used in a LAN and a WAN. are not supported.Oracle BPA Suite Installation and Administration Guide If you have enabled the Copy documents check box on the Include links page of the Profile Wizard (View/Options/Publisher export profiles) and started Oracle Business Process Repository as a service. Oracle Business Process Architect thus enables so to speak Internet modeling of business processes. 3. It converts Oracle BPA Suite data of previous Oracle BPA Suite versions to the current Oracle BPA Suite format.12 Glossary Please select a subentry.11. Other calendars. 342 . Oracle Business Process Repository Oracle BPA Suite application server (see Application server) Oracle BPA Suite Converter Conversion component of Oracle BPA Suite. 343 . coordinates access to programs and data by means of a license and lock service.Oracle BPA Suite Installation and Administration Guide Oracle BPA Suite HTML Generator Program module that automatically generates the HTML files needed by Java-based clients when they are launched via a browser. System that is used to run Java programs. J JRE Java Runtime Environment. D Database server Computer on which the Oracle BPA Suite Repository is installed. F Firewall Technology (hardware and/or software) that controls the data flow between internal and external (unprotected) networks and provides protective mechanisms to combat unauthorized access. one database server and one Oracle Business Process Repository Site Manager. the Java Interpreter. Oracle BPA Suite Clients access the database server on which the Oracle BPA Suite Repository containing the Oracle BPA Suite databases resides via the Oracle Business Process Repository. Oracle BPA Suite Site At least one Oracle Business Process Repository. Oracle BPA Suite Site Administrator Central management component with which administrative accesses can be provided to all Oracle BPA Suite sites simultaneously. for instance. and the host operating system. Oracle Business Process Repository Site Manager Central component of Oracle BPA Suite Site that. The main components are the Java Virtual Machine. LDAP Lightweight Directory Access Protocol. This means that data storage and data access is 'spread' across these hard drives. The access data for user login to Oracle BPA Suite is stored centrally on the LDAP server so it does not have to be managed separately for each database. The system system user is created automatically for every database. System users can be created by the system manager (user system) or by another system user. System user Users who have all function and access privileges in a database. which improves access time and avoids complete loss of data should a drive fail. The name system cannot be 344 . Security software for encrypting data that is exchanged between programs. Protocol that provides access to centrally managed libraries of information and directories. This network has broad bandwidth. O Oracle Relational database system that can be used for Oracle BPA Suite installations.Oracle BPA Suite Installation and Administration Guide L LAN Local Area Network. It saves having to search the whole network for data. Network within a company. S SSL Secure Socket Layer. Method of linking several hard drives and accessing these as if accessing a single hard drive. R RAID Redundant Array of Independent Disks. This user has all function and access privileges. The function and access privileges of system users cannot be changed. you can create additional system users. Authorized persons can use this emergency user to log in to any database. even if you use an LDAP system or an OIS system.Oracle BPA Suite Installation and Administration Guide changed. To withdraw privileges from a system user. another system user must disable the System user check box on the former user's Function privileges properties page. As a result. A system user should immediately change the password manager to prevent unauthorized access. 'system' user Enter the user name system if you log in for the first time after you have installed the program or created a new database. documents and other files and folders that users or programs within a network can access. To avoid problems. e. The system system user is created automatically for every database. the user has no access privileges. the user's privileges can be changed. This network has low bandwidth. Web server A server containing the HTML pages. W WAN Wide Area Network. The name system cannot be changed. images. You should immediately change the password manager to prevent unauthorized access. Web Client Components WWW components that are accessed by Web clients. 345 . Oracle Business Process Architect when they are started via a Web browser. After this. Network that transports data both within the company network and via the Internet.g. Yemen Basque .Kuwait Arabic .g. System language Afrikaans .Oracle BPA Suite Installation and Administration Guide 3.Libya Arabic . code page=1252.Spain Belarussian .Saudi Arabia Arabic .Bulgaria Catalan .Algeria Arabic .13.Albania Arabic .Egypt Arabic . Arabic .Syria Arabic .Morocco Arabic . e.Bahrain Arabic . e. The language groups and code page are also represented by a number. The language group is preceded by a minus sign (-).Spain Locale ID 1078 1052 5121 15361 3073 2049 11265 13313 12289 4097 6145 8193 16385 1025 10241 7169 14337 9217 1069 1059 1026 1027 346 .A.Oman Arabic .Lebanon Arabic .Jordan Arabic .g.Iraq Arabic .U.Qatar Arabic .Belarus Bulgarian .South Africa Albanian . -1252.Tunisia Arabic .1 Appendix System language and locale IDs The locale ID designates a language within a language group.13 3.E. United Kingdom English .Luxembourg French .South Africa English .Faeroe Islands Farsi .Denmark Dutch .Singapore Chinese .PRC Chinese .Iran Finnish .Croatia Czech .Ireland English .United States Estonian .Taiwan Croatian .France French .Canada English .Finland French .Estonia Faeroese .Australia English .Caribbean English .Czech Republic Danish .New Zealand English .Switzerland Locale ID 3076 2052 4100 1028 1050 1029 1030 2067 1043 3081 10249 4105 9225 6153 8201 5129 7177 11273 2057 1033 1061 1080 1065 1035 2060 3084 1036 5132 4108 347 .Netherlands English .Belize English .Oracle BPA Suite Installation and Administration Guide System language Chinese .Belgium Dutch .Trinidad English .Belgium French .Jamaica English .Canada French .Hong Kong Chinese . Switzerland Japanese .Korea Latvian .Slovakia Slovene .Liechtenstein German .Germany German .Lithuania Norwegian .Indonesia Italian .Slovenia Spanish .Austria German .Switzerland Greek .Israel Hungarian .Argentina Spanish .Poland Portuguese .Hungary Icelandic .Greece Hebrew .Romania Russian .Iceland Indonesian .Russia Serbian .Oracle BPA Suite Installation and Administration Guide System language German .Portugal Romanian .Norway (Bokmal) Norwegian .Norway (Nynorsk) Polish .Serbia (Latin) Slovak .Japan Korean .Latvia Lithuanian .Bolivia Locale ID 3079 1031 5127 4103 2055 1032 1037 1038 1039 1057 1040 2064 1041 1042 1062 1063 1044 2068 1045 1046 2070 1048 1049 3098 2074 1051 1060 11274 16394 348 .Brazil Portuguese .Luxembourg German .Italy Italian .Serbia (Cyrillic) Serbian . Costa Rica Spanish .Peru Spanish .Uruguay Spanish .Colombia Spanish .Mexico Spanish .Ukraine Vietnamese .Sweden Thai .Chile Spanish .El Salvador Spanish .Panama Spanish .Finland Swedish .Oracle BPA Suite Installation and Administration Guide System language Spanish .Dominican Republic Spanish .Thailand Turkish .Spain (Traditional Sort) Spanish .Puerto Rico Spanish .Paraguay Spanish .Honduras Spanish .Ecuador Spanish .Spain (Modern Sort) Spanish .Vietnam Locale ID 13322 9226 5130 7178 12298 17418 4106 18442 2058 19466 6154 15370 10250 20490 3082 1034 14346 8202 2077 1053 1054 1055 1058 1066 349 .Guatemala Spanish .Turkey Ukrainian .Venezuela Swedish .Nicaragua Spanish . Port 16070 16071 16072 16073 16074 16075 16076 Name aris71_name_public aris71_name_private aris71_admin aris71_admin_agent aris71_Olite aris71_local_public aris71_local_Olite For Public Name Service Private Name Service Admin Service Agent Service Standard database system Public Name Service local Standard database system local 16077 16078 16079 16080 16081 16083 aris71_local_private aris71_local_admin aris71_bp_service aris71_simuserver aris71_local_simuserver aris71_bp_report Private Name Service local Admin Service local Business Publisher Service Simulation Service Simulation Service local Business Publisher Report Service 350 .Oracle BPA Suite Installation and Administration Guide 3.13.2 Port numbers The following port numbers are entered in the Services file of your Windows installation. This file is located in the system32/drivers/etc/ Windows directory. 270 Configadminpassword .259 H Help .default .298 Application .318 Backupconfig .298 Approved platforms Oracle Business Process Repository .295 Language update and character sets .17 Oracle BPA Suite Site Administrator .298 Citrix .5 Install Oracle Business Process Publisher Server .295 C Character set .7 Install an Oracle BPA Suite client (Windows) .242 Automatic backup .322 I Install an Oracle BPA Suite client (Linux) .316 Backupasn .255 Delete .322 Expand memory .265 Client log .5 Install Oracle Business Process Publisher Report Server 194 Install Oracle Business Process Publisher Server .user-defined .254 Copy .userdefined .41 Oracle Business Process Repository Site Manager 21 B Backup .44 Install Oracle Business Process Repository (Windows) .44 Install Oracle Business Process Repository (Windows) default .254 Deactivate simulation server .321 D Dbmspassword .12 Install Oracle Business Process Repository (Windows) .214 Administration Browser use (Java-based products) .218 Install an Oracle BPA Suite client (Linux) .322 Download .Oracle BPA Suite Installation and Administration Guide Index A Acrobat Reader .319 Browser use (Java-based products) .218 E Evaluation .299 Applet .12 Install Oracle Business Process Repository (Windows) .320 Configuration database .309 Configure client connection .7 Install an Oracle BPA Suite client (Windows) .298 Software distribution .321 i .320 Createdb .321 Deactivate Report Server .331 Exit .17 Installation Automatic backup .20 Oracle BPA Suite Web Client Components . 251 Expand memory .X) (Windows) .44 Install Oracle Business Process Publisher Report Server .298 Language update and character sets .221 Standard installation .273 IBM WebSphere Application Server (WAS 6.216 Interactive .231 Log login .328 Sessions .325 ii .320 Copy .194 Oracle Business Process Repository Configure client connection 254 Configure Oracle Business Process Repository Site Manager connection 253 Deactivate Report Server 254 Deactivate simulation server .325 Restore .316 Backupasn .323 Rename .327 Server .227 Oracle database .Oracle BPA Suite Installation and Administration Guide Software distribution .12 User-defined installation 17 L Language update .324 Locale ID .323 List .325 Reorg .251 Log messages (debugging) 251 M Maintain .66 Install Apache Tomcat Web Application Server (Windows) .329 Siteadminpassword .299 IBM DB2 database .323 Kill .295 K Kill .331 Version .330 Statistic .344 List .322 Download .318 Backupconfig .320 Createdb .263 Oracle BPA Suite Notify Service .346 Log login .74 Install Apache Tomcat Web Application Server (Solaris/Linux) .326 Restoreasn .255 Enable SSL .331 Oracle BPA Suite agent .256 Oracle Business Process Publisher Server .324 Memory-optimized scripts 332 Monitor .327 Restoreconfig .322 Interactive .324 Maintain .324 Password .251 Log messages (debugging) 251 MS SQL database .321 Dbmspassword .319 Configadminpassword .324 Monitor .328 Restoreversioned .0.323 J Java Runtime Environment 215 Java-based products .322 Help .298 LDAP .265 O Oracle BPA Suite Admintool Backup .324 Multi-monitor operation .321 Exit .321 Delete .299 System add-ons .330 Status . 23 Installation with IBM DB2 28 Installation with MS SQL Server .222 SSL encryption .346 P Password .326 Restoreasn .298 Start a program in the browser .295 Start Oracle BPA Suite Admintool .259 Oracle BPA Suite Converter .327 T Transfer data from earlier Oracle BPA Suite versions 307 V Version .251 Start a program as an Applet 298 Start a program as an application .313 Statistic .216 System language .260 Oracle BPA Suite UML Designer .325 Restore .325 Reorg .330 Status .27 Installation with newly created Oracle database instance .21 Installation with existing Oracle database instance .299 Software requirements Additional memory .265 Oracle Business Process Publisher .330 Software distribution .328 Server LOG .327 Restoreconfig .271 Oracle Business Process Repository .265 Web Client Components 265 SQL*Plus scripts Import .25 Oracle Business Process Simulator .331 S Server .328 Restoreversioned .265 Oracle Business Process Architect .325 R Rename .329 Siteadminpassword .Oracle BPA Suite Installation and Administration Guide Oracle Business Process Repository Site Manager Configure Oracle Business Process Repository Site Manager connection 253 Installation with configured Oracle database instance .262 Sessions .331 System add-ons .242 iii .
Copyright © 2024 DOKUMEN.SITE Inc.