Escolar Documentos
Profissional Documentos
Cultura Documentos
Contents
1 Manual conventions ..............................................................................................1
2 Installation..........................................................................................................2
2.1 Installation options .....................................................................................3
2.2 Client installation - Windows operating system................................................5
2.3 Client install and uninstall - Linux operating system .........................................7
2.4 Oracle Business Process Repository installations (Windows operating system) .....8
2.4.1 Default (recommended for up to 50 users) ............................................... 12
2.4.1.1 Initial installation ........................................................................ 12
2.4.1.2 Subsequent installation ................................................................ 14
2.4.1.3 Update installation....................................................................... 15
2.4.2 User-defined (advanced installation)........................................................ 17
2.4.2.1 Oracle Business Process Repository................................................ 18
2.4.2.2 Oracle BPA Suite Site Administrator ............................................... 20
2.4.2.3 Oracle Business Process Repository Site Manager............................. 21
2.4.2.3.1 Step-by-step instructions - Use existing Oracle database
(prepared for Oracle BPA Suite) ................................................ 21
2.4.2.3.2 Step-by-step - Configure and connect existing Oracle database
instance ................................................................................ 23
2.4.2.3.3 Step-by-step - Create new Oracle database instance.................... 25
2.4.2.3.4 Step-by-step - Microsoft SQL Server .......................................... 27
2.4.2.3.5 Step-by-step - IBM DB2 ........................................................... 28
2.4.2.4 Oracle BPA Suite Web Client Components ....................................... 30
2.5 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 Apache Tomcat Web Application Server under Windows.............................. 44
2.6.1.1 Step-by-step instructions (standard database) ................................ 45
2.6.1.2 Step-by-step instructions (Oracle database) .................................... 47
2.6.1.3 Step-by-step instructions (existing Oracle database)_tomcat ............. 51
2.6.1.4 Step-by-step instructions (new Oracle database)_tomcat .................. 56
2.6.1.5 Step-by-step instructions (MS SQL Server 2005 database) ................ 61
2.6.2 Apache Tomcat Web Application Server under Solaris/Linux ........................ 66
2.6.2.1 Step-by-step instructions (Oracle database) .................................... 69
2.6.2.2 Step-by-step instructions (MS SQL Server 2005 database) ................ 72
2.6.3 IBM WebSphere Application Server (WAS 6.1.0.15) under Windows ............. 74
2.6.3.1 Step-by-step instructions (Oracle database) .................................... 75
2.6.3.2 Step-by-step instructions (MS SQL Server 2005 database) ................ 97
2.6.4 IBM WebSphere Application Server (WAS 6.1.0.15) under RHELx64 ........... 121
2.6.4.1 Step-by-step instructions (Oracle database) .................................. 122
2.6.4.2 Step-by-step instructions (MS SQL Server 2005 database) .............. 143
2.6.4.3 Deployment of a new WAR file .................................................... 166
I
Oracle BPA Suite Installation and Administration Guide
II
Oracle BPA Suite Installation and Administration Guide
III
Oracle BPA Suite Installation and Administration Guide
3.5.3.1 Show all groups in the Explorer tree (Publisher Server)................... 279
3.5.3.2 Change the DAO of an Oracle database (Tomcat)........................... 280
3.5.3.3 E-mail settings.......................................................................... 281
3.5.3.4 Free port to Web server ............................................................. 281
3.5.3.5 Change IP address .................................................................... 282
3.5.3.6 LDAP user management ............................................................. 282
3.5.3.7 Use Microsoft SQL database ........................................................ 283
3.5.3.8 Encrypt LDAP password.............................................................. 286
3.5.3.9 Configure navigation carousel ..................................................... 286
3.5.3.10 Display news ............................................................................ 287
3.5.3.11 Configure OIS user management (Oracle Business Process
Publisher Server) ...................................................................... 288
3.5.3.12 Use an Oracle database (Tomcat) ................................................ 288
3.5.3.13 Oracle restart ........................................................................... 291
3.5.4 Manage reports .................................................................................. 292
3.6 Java clients (browser mode)..................................................................... 293
3.6.1 Set up Java clients for browser use........................................................ 295
3.6.1.1 Installed files of Oracle BPA Suite ................................................ 295
3.6.1.2 Language update and character sets ............................................ 298
3.6.1.3 Execution as application or applet ................................................ 298
3.6.1.4 Provide additional memory ......................................................... 299
3.6.1.5 Installation by software distribution ............................................. 299
3.6.1.5.1 Possible settings for user.cfg .................................................. 300
3.6.1.5.2 Preconfigured user.cfg ........................................................... 300
3.6.1.5.3 Configure user.cfg................................................................. 300
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 Preparations for the automatic update .......................................... 301
3.6.3.2 Set up web clients for automatic update ....................................... 301
3.7 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 Transfer data from earlier Oracle BPA Suite versions ................................ 307
3.8.1.1 Configuration............................................................................ 309
3.8.1.1.1 Transfer item groups of the configuration ................................. 309
3.8.1.1.2 Transfer exported filters, font formats, languages, and
templates ............................................................................ 310
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
V
Oracle BPA Suite Installation and Administration Guide
1 Manual conventions
Note
This manual describes the settings and features as they were at the time
of print. Since manual and software are subject to different production
cycles, 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. Please read this file and take
the information into account when installing, setting up, and using the
product.
Notation/Formatting Example
Menu items, shortcut keys, dialog boxes, file Click on OK.
names, keyboard entries, etc. are written in
Enter the path in the
bold.
sample.txt file.
1
Oracle BPA Suite Installation and Administration Guide
2 Installation
Note
When you perform an update, add a language (Modify Program
option), or repeat an installation (Repair Program option), the system
checks if a CFG file was changed manually. If so, a backup copy of that
file is generated before the new CFG file is installed. For example, if you
have modified the arisclient.cfg file manually, it is backed up (Page
218) in the <Oracle BPA Suite installation
directory>\javaclient\backup\config directory. The settings from
the previous installation are retained, for example the installation path,
the program group, and the languages you installed.
2
Oracle BPA Suite Installation and Administration Guide
Warning
Please only use the file userServerSettings.cfg to change the
configuration. This ensures that your changes are preserved in future
update installations. The other Oracle Business Process Repository
configuration files are overwritten for each installation.
If you insert an Oracle BPA Suite installation media in your drive, the
start page opens automatically. If it is not displayed automatically, click
on the name of your drive in Windows Explorer and run the program
OracleBPA.exe.
3
Oracle BPA Suite Installation and Administration Guide
Installation media
Oracle BPA Suite Opens the Oracle BPA Suite news page on the
news IDS Scheer home page in your Web browser.
Additional installations
4
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Ensure that the system requirements for all products and
functionalities are met.
2. Insert the Oracle BPA Suite installation media into your 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.
4. 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. The Select program folder page
opens.
5
Oracle BPA Suite Installation and Administration Guide
10. Enable the check boxes for the desired interface and method
languages. Click on Next. The Start Copy Operation page opens.
11. Check the settings in the Start Copy Operation dialog box. If these
are correct, click on Next. The products will now be installed. The
system notifies you when the installation is complete.
12. If you do not want to create a desktop shortcut to launch Oracle BPA
Suite products, disable the Create Desktop Shortcut check box.
Click on Finish.
6
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,
please refer to the chapter entitled Transfer data from earlier
versions of Oracle BPA Suite in the Administration Guide).
Procedure
1. Ensure that the system requirements for all products and
functionalities are met.
3. When you are in the directory to which you copied the file, enter
./install_bpa11gR1.xxxxxx.sh to install an Oracle BPA Suite
product.
You can start the install_bpa11gR1.xxxxxx.sh file from any
directory of your choice. To do so, you need to enter the full path in
front of the file name.
Configuration is performed automatically with the installation.
You can reconfigure the software at any time after installation with
the configure.sh script in the directory
JavaClient.xxxxxx/setup/. The software is ready to run
immediately. Use the appropriate Launcher.exe file in the directory
JavaClient.xxxxxx/ to start an Oracle BPA Suite product.
7
Oracle BPA Suite Installation and Administration Guide
Uninstall
To uninstall a client, you first have to exit the application and then
delete the installation folder.
Procedure
1. 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.
8
Oracle BPA Suite Installation and Administration Guide
Note
This manual describes the settings and features as they were at the time
of print. Since manual and software are subject to different production
cycles, 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. Please read this file and take
the information into account when installing, setting up, and using the
product.
2 GB RAM
32-bit system
1 GB RAM In 32-bit
systems, the maximum
size of a Virtual Machine
(VM) is 1 GB.
9
Oracle BPA Suite Installation and Administration Guide
Software Details
Operating Depends on the database systems used.
systems
Network High-speed network (>=100 Mbit) between database server and Oracle
Business Process Repository.
JRE Windows
If you have Oracle Business Process Repository installed and start Oracle
BPA Suite products as programs, an internal JRE version is automatically
used. You do not need to install JRE separately. If you have already installed
JRE, your installation is not used by Oracle BPA Suite.
Your JRE installation is only used if you start Oracle BPA Suite products from
your browser.
The following are approved: Java Runtime Environment (JRE) 1.6.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.
Note
SUN renamed the JRE versions. JRE 1.6.0_04 is now called JRE 6.0, Update
4. Approvals are also valid for subsequent updates.
Oracle BPA Suite products are tested using the JRE that is current at the
time of release.
If JRE 1.6.0_04 and subsequent patches are approved for an Oracle BPA
Suite product, the approval is valid for both JRE 1.6.0_04 and JRE
1.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). SUN
Microsystems guarantees compatibility between the JRE patch levels.
Therefore, the Oracle BPA Suite approvals for JREs are valid for all patch
levels of a version.
If you are using JRE 1.6 update 3 or an older version, copy the file jaxb-
api.jar from the directory <Web Client Components>\lib to the
directory <Java JRE installation directory>/endorsed, e.g.
C:\Program Files\Java\jre1.6.0_01\lib\endorsed.
If the directory endorsed does not exist, you must create it. Please
10
Oracle BPA Suite Installation and Administration Guide
Software Details
note that you must repeat this procedure for every update of version 3 or
older. We therefore recommend installation of version 4 or higher.
If you have Java 6 update 10 installed, problems may occur despite
better performance. Depending on your graphics card and driver
configuration, installation of Java 6 update 10 may cause delays in the
Designer and Matrices modules.
In this case, use the following command line entry to start the program:
-Dsun.java2d.d3d=false
Protocols Data exchange between browser-capable Oracle BPA Suite clients and Oracle
(Page 249) Business Process Repository can be encrypted with SSL (1024-bit RSA).
SSL capability is already integrated into Oracle BPA Suite and only needs to
be activated when needed.
Output If, for example, you want to output documents in PDF format using Microsoft
Word or Microsoft Excel, you must have Adobe Reader and Microsoft Office
version 2000, 2002, 2003, or 2007 installed. If you use reports to import
data from Excel tables, please ensure that the tables have been saved in
XLS format. If pop-up blockers are activated for the domain, it may not
always be possible to open report output in PDF format from a Publisher
export.
Note
Oracle Business Process Repository does not support NAT (Network
Address Translation) by default. However, Oracle Corporation offers
customized solutions. Additional information is available from our
support.
11
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Ensure that the system requirements (Page 242) for all components
are met.
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.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met.
2. Insert the Oracle BPA Suite installation media into your 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.
12
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.
10. Enable the check boxes for the languages in which you want to install
the program. Ensure that all languages you want to provide to the
Oracle BPA Suite clients are installed. Click on Next.
12. Select the installation directory for your Oracle BPA Suite Web Client
Components files. To use the suggested installation directory, click
on Next and continue with the next step. Note that the name of the
installation directory must not contain any country-specific special
characters.
To install the program in a directory different from the one
suggested, e.g. on your active Web server, click on Browse. Enter
the desired path in the Path box, or navigate to the desired directory
in the Directories box. Click on OK. Click on Next.
13
Oracle BPA Suite Installation and Administration Guide
14. Check the settings in the Installation Overview dialog box. If these
are correct, click on Next. The products will now be installed.
15. Confirm the Welcome dialog and, once the driver is installed,
completion of the installation. Click on Finish.
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.
Previously used databases and filters are not affected by the subsequent
installation. If you want to use the supplied demo database rather than
the current one, you can copy it to your server using the Restore
function.
If files have to be reinstalled during setup, the old files are saved in a
backup directory. Therefore, they are still available after installation. The
contents of the HTML directories are examples of such files.
Procedure
1. Ensure that the system requirements are met for all components.
2. Insert the Oracle BPA Suite installation media into your 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.
14
Oracle BPA Suite Installation and Administration Guide
5. 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. Click on OK
after having done so or if no Oracle Business Process Repository is
running.
7. Enable the check boxes for the languages you want to add. Click on
Next. Please ensure that all languages you selected for the installed
Oracle BPA Suite products are installed.
Tip
To install an additional language later, you must run setup again.
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.
Previously used databases and filters are not affected by the installation.
If you want to use the supplied demo database rather than the current
one, you can copy it to your server using the Restore function.
If files have to be reinstalled during setup, the old files are saved in a
backup directory. Therefore, they are still available after installation. The
contents of the HTML directories are examples of such files.
15
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Ensure that the system requirements are met for all components.
2. Insert the Oracle BPA Suite installation media into your 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.
6. 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 after having
done so or if no Oracle Business Process Repository is running.
8. Click on Finish.
Tip
To install an additional language later, you must run setup again.
16
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Ensure that the system requirements are met for all components
(see chapter Hardware and software requirements in the
Administration Guide).
5. You can import the demo database into your database system.
17
Oracle BPA Suite Installation and Administration Guide
Once the database is registered with Oracle BPA Suite, you receive a
corresponding message.
Tip
To install an Oracle BPA Suite Site, perform the installation on every
computer you intend to use as an Oracle Business Process Repository in
the Oracle BPA Suite Site.
This section describes in detail the steps that the installation program
performs when you install an Oracle Business Process Repository.
Tip
To install an Oracle BPA Suite Site, perform the installation on every
computer you intend to use as an Oracle Business Process Repository in
the Oracle BPA Suite Site.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
2. Insert the Oracle BPA Suite installation media into your 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.
18
Oracle BPA Suite Installation and Administration Guide
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. The Select program folder page opens.
10. Enter the name of the computer on which Oracle Business Process
Repository Site Manager has been installed. Click on Next.
12. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
19
Oracle BPA Suite Installation and Administration Guide
The detailed description below explains the steps that the installation
program performs when you install Oracle BPA Suite Site Administrator.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
2. Insert the Oracle BPA Suite installation media into your 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.
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.
8. Enable the check boxes for the languages in which you want to install
the program. Ensure that all languages you want to provide are
installed. Click on Next. Click on USER-DEFINED (ADVANCED
INSTALLATION), recommended for 50 or more users.
10. 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.
11. Disable all check boxes except for the Oracle BPA Suite Site
Administrator check box.
20
Oracle BPA Suite Installation and Administration Guide
13. Check the settings in the Start Copy Operation dialog box. If these
are correct, click on Next. The products will now be installed.
This section describes in detail the steps that the installation program
performs when you install Oracle Business Process Repository Site
Manager.
Warning
You may install Oracle Business Process Repository Site Manager only
once for each Oracle BPA Suite Site.
The database objects required for operating Oracle BPA Suite have
already been created (Page 221) (for example, using the SQL*PLUS
scripts).
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
2. Insert the Oracle BPA Suite installation media into your drive. If the
installation media start page is not displayed automatically, double-
click on the OracleBPA.exe file.
21
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.
8. The Select Language page opens. Enable the check boxes for the
languages in which you want to install the program. Ensure that all
languages you want to provide are installed. Click on Next. The
Select Components page opens.
13. Enter the server, port, and service name for the database. The
default name of the database is BPA. Click on Next.
22
Oracle BPA Suite Installation and Administration Guide
15. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
You already have an Oracle database, but the database objects required
for operating Oracle BPA Suite have not been created (Page 221) there
yet. If you use Oracle Business Process Publisher, we recommend that
you work with two separate Oracle databases for Oracle Business
Process Repository and Oracle Business Process Publisher. This keeps
the two systems from competing for resources, and you achieve better
performance and higher availability.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
Ensure that Oracle SQLPlus is installed.
2. Insert the Oracle BPA Suite installation media into your drive. If the
installation media start page is not displayed automatically, double-
click on the OracleBPA.exe file.
23
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.
9. The Select Language page opens. Enable the check boxes for the
languages in which you want to install the program. Ensure that all
languages you want to provide are installed. Click on Next.
11. Disable all check boxes except the Oracle Business Process
Repository Site Manager check box. Click on Next.
16. If this happens, verify and correct the server name, port number,
service name for the database, and the password of the SYSTEM
user. Click on Next.
24
Oracle BPA Suite Installation and Administration Guide
17. Select the data tablespace and the index tablespace in the dialog
box. Click on Next.
19. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
You set up (Page 221) a new Oracle database instance and prepare it for
use with Oracle Business Process Analysis Suite.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
Ensure that Oracle SQLPlus is installed.
2. Insert the Oracle BPA Suite installation media into your drive. If the
installation media start page is not displayed automatically, double-
click on the OracleBPA.exe file.
25
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.
9. Enable the check boxes for the languages in which you want to install
the program. Ensure that all languages you want to provide are
installed. Click on Next.
11. Disable all check boxes except the Oracle Business Process
Repository Site Manager check box. Click on Next.
b. Select the directory for the database files of the database being
created. To install the database in a different directory than the
one suggested, click on the Browse button.
e. Enter the password for the system users in the Password for
SYS, SYSTEM, etc. box, and confirm your entry.
26
Oracle BPA Suite Installation and Administration Guide
16. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
You set up (Page 227) a new Microsoft SQL Server and prepare it for use
with Oracle Business Process Analysis Suite.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
2. Insert the Oracle BPA Suite installation media into your drive. If the
installation media start page is not displayed automatically, double-
click on the OracleBPA.exe file.
27
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.
9. Enable the check boxes for the languages in which you want to install
the program. Ensure that all languages you want to provide are
installed. Click on Next.
11. Disable all check boxes except the Oracle Business Process
Repository Site Manager check box. Click on Next.
12. Enable the Microsoft SQL Server option, and click on Next.
14. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
You set up (Page 231) a new DB2 server and prepare it for use with
Oracle Business Process Analysis Suite.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
28
Oracle BPA Suite Installation and Administration Guide
2. Insert the Oracle BPA Suite installation media into your drive. If the
installation media start page is not displayed automatically, double-
click on the OracleBPA.exe file.
Note
Note that the name of the installation directory must not contain any
spaces or country-specific special characters.
9. Enable the check boxes for the languages in which you want to install
the program. Ensure that all languages you want to provide are
installed. Click on Next.
11. Disable all check boxes except the Oracle Business Process
Repository Site Manager check box. Click on Next.
29
Oracle BPA Suite Installation and Administration Guide
14. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
If you want to use Oracle BPA Suite via a browser, you need to install
Oracle BPA Suite Web Client Components.
Oracle BPA Suite Web Client Components consist of passive Web server
components (e.g. HTML files) only.
/lan
30
Oracle BPA Suite Installation and Administration Guide
This is the start directory commonly used. It runs the Java-based Oracle
BPA Suite products as an applet and enables direct access to the Oracle
Business Process Repository.
/ssl
If you select this directory for launching Java-based Oracle BPA Suite
products, the data exchange is encrypted (for further information,
please refer to the chapter on SSL encryption of data transmission
via Secure Socket Layer in the Administration Guide).
/app
If you select this directory for launching Java-based Oracle BPA Suite
products, they are run as an application, not as an applet (for further
information, please refer to the chapter on Execution as application
or applet in the Administration Guide).
Note
To enable SSL encryption, open the file userServerSettings.cfg and
add the following entry:
<profiles>
</profiles>
Please note that the output and backup paths must be modified
accordingly in the userServerSettings.cfg file. If your work is not
limited to the use of only one Oracle Business Process Repository, you
need to adjust the paths on the computer on which Oracle Business
Process Repository Site Manager is installed. Insert the following entry:
<htmlgen>
path="e:/inetpub/wwwroot/bpa11"/><backuppath
path="e:/inetpub/wwwroot/bpa11/backup"/>
</htmlgen>
31
Oracle BPA Suite Installation and Administration Guide
<htmlgen>
<genlist>
<genfile target_dir="ssl"
target_name="dblist.html"
database_template="aris_database_ssl.html"/>
</genlist>
</htmlgen>
Warning
Please only use the file userServerSettings.cfg to change the
configuration. This ensures that your changes are preserved in future
update installations. The other Oracle Business Process Repository
configuration files are overwritten for each installation.
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
2. Insert the Oracle BPA Suite installation media into your 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.
6. Once you have read the license agreements and accept them, click
on Yes.
9. Disable all check boxes except Oracle BPA Suite Web client
components. Click on Next. The Select target path page opens.
32
Oracle BPA Suite Installation and Administration Guide
10. Select the installation directory for your Oracle BPA Suite Web Client
Components files. To use the suggested installation directory, click
on Next and continue with the next step. Note that the name of the
installation directory must not contain any country-specific special
characters.
To install the program in a directory different from the one
suggested, e.g. on your active Web server, click on Browse. Enter
the desired path in the Path box, or navigate to the desired directory
in the Directories box. Click on OK. Click on Next.
11. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed. The installation
process generates the \html directory in the specified path. A path
is relative within the directory so that you can change the name of
the path specified during installation without any negative impact.
For multilingual pages, the start pages index_app.html,
index_lan.html, and index_ssl.html are located in the directory
\html. For monolingual pages, they reside in the directory
\html\<languageid>. 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.
Note
If you install Oracle Business Process Repository Site Manager and
Oracle BPA Suite Web Client Components in one step, the installation
program enters the path to the HTML Generator in the file
setupServerSettings.cfg of the Oracle Business Process Repository
Site Manager computer.
Warning
Please only use the file userServerSettings.cfg to change the
configuration. This ensures that your changes are preserved in future
update installations. The other Oracle Business Process Repository
configuration files are overwritten for each installation.
33
Oracle BPA Suite Installation and Administration Guide
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. Since manual and software are subject to different production
cycles, 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. Please read this file and take
the information into account when installing, setting up, and using the
product.
34
Oracle BPA Suite Installation and Administration Guide
2 GB RAM
32-bit system
1 GB RAM In 32-bit
systems, the maximum
size of a Virtual Machine
(VM) is 1 GB.
35
Oracle BPA Suite Installation and Administration Guide
Software Details
Operating Depends on the database systems used.
systems
Network High-speed network (>=100 Mbit) between database server and Oracle
Business Process Repository.
JRE Oracle Business Process Repository requires JRE 1.6. Please first install the
appropriate JRE 1.6 for your operating system.
Protocols Data exchange between browser-capable Oracle BPA Suite clients and Oracle
(Page 249) Business Process Repository can be encrypted with SSL (1024-bit RSA).
SSL capability is already integrated into Oracle BPA Suite and only needs to
be activated when needed.
Output If, for example, you want to output documents in PDF format using Microsoft
Word or Microsoft Excel, you must have Adobe Reader and Microsoft Office
version 2000, 2002, 2003, or 2007 installed. If you use reports to import
data from Excel tables, please ensure that the tables have been saved in
XLS format. If pop-up blockers are activated for the domain, it may not
always be possible to open report output in PDF format from a Publisher
export.
Note
Oracle Business Process Repository does not support NAT (Network
Address Translation) by default. However, Oracle Corporation offers
customized solutions. Additional information is available from our
support.
36
Oracle BPA Suite Installation and Administration Guide
This section describes in detail the steps that must be performed when
you install Oracle Business Process Repository.
Tip
To install an Oracle BPA Suite Site, perform the installation on every
computer you intend to use as an Oracle Business Process Repository in
the Oracle BPA Suite Site.
Step-by-step instructions
Prerequisite
A database instance for Oracle BPA Suite must have been created on the
database server.
Procedure
1. Ensure that the system requirements are met for all products and
features (please refer to chapter Administration, Hardware and
software requirements).
4. You must enter a fully qualified name for the computer on which
Oracle Business Process Repository Site Manager is installed, for
example computerxyz.domainxyz.com. You can start the file
install_bpr11gR1.xxxxxx.sh from any directory. To do so, you
need to enter the full path in front of the file name.
To change the installation path, specify the additional option -
installdir <absolute path of the desired installation
directory>.
37
Oracle BPA Suite Installation and Administration Guide
Note
The Oracle BPA Suite Web Client Components (Page 41) are installed
automatically at the same time.
This section describes in detail the steps that must be performed when
you install Oracle Business Process Repository Site Manager.
Warning
You may install Oracle Business Process Repository Site Manager only
once for each Oracle BPA Suite Site.
Step-by-step instructions
Procedure
1. Ensure that the system requirements for all products and
functionalities are met (see chapter Administration (Page 221)).
38
Oracle BPA Suite Installation and Administration Guide
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.
Tip
To install an Oracle BPA Suite Site, perform the installation on every
computer you intend to use as an Oracle Business Process Repository in
the Oracle BPA Suite Site.
Step-by-step instructions
Prerequisite
A database instance for Oracle BPA Suite must have been created on the
database server.
39
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)).
40
Oracle BPA Suite Installation and Administration Guide
Note
The Oracle BPA Suite Web Client Components (Page 41) are installed
automatically at the same time.
Oracle BPA Suite Web Client Components consist of passive Web server
components (e.g. HTML files) only.
/lan
41
Oracle BPA Suite Installation and Administration Guide
This is the start directory commonly used. It runs the Java-based Oracle
BPA Suite products as an applet and enables direct access to the Oracle
Business Process Repository.
/ssl
If you select this directory for launching Java-based Oracle BPA Suite
products, the data exchange is encrypted (for further information,
please refer to the chapter on SSL encryption of data transmission
via Secure Socket Layer in the Administration Guide).
/app
If you select this directory for launching Java-based Oracle BPA Suite
products, they are run as an application, not as an applet (for further
information, please refer to the chapter on Execution as application
or applet in the Administration Guide).
Note
To enable SSL encryption, open the file userServerSettings.cfg and
add the following entry:
<profiles>
</profiles>
Please note that the output and backup paths must be modified
accordingly in the userServerSettings.cfg file. If your work is not
limited to the use of only one Oracle Business Process Repository, you
need to adjust the paths on the computer on which Oracle Business
Process Repository Site Manager is installed. Insert the following entry:
<htmlgen>
path="e:/inetpub/wwwroot/bpa11"/><backuppath
path="e:/inetpub/wwwroot/bpa11/backup"/>
</htmlgen>
42
Oracle BPA Suite Installation and Administration Guide
<htmlgen>
<genlist>
<genfile target_dir="ssl"
target_name="dblist.html"
database_template="aris_database_ssl.html"/>
</genlist>
</htmlgen>
Warning
Please only use the file userServerSettings.cfg to change the
configuration. This ensures that your changes are preserved in future
update installations. The other Oracle Business Process Repository
configuration files are overwritten for each installation.
2.5.5 Uninstall
Procedure
1. Use the script y-serverstopper.sh in the folder <installation
directory>/server.xxxxxx to exit Oracle Business Process
Repository.
43
Oracle BPA Suite Installation and Administration Guide
Note
Due to methodological and functional changes, you may no longer be
able to open an existing Publisher export. If this happens, you must
perform exports again. The browser caches should be cleared after an
update installation.
Note
When you combine various technologies, please observe the
manufacturers' instructions, particularly announcements concerning
releases on their Internet pages. We cannot guarantee proper
44
Oracle BPA Suite Installation and Administration Guide
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.
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.
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.
45
Oracle BPA Suite Installation and Administration Guide
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. Enable the Standard Database System check box if you want to
use the standard database. Click on Next.
12. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
14. 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).
To create a Publisher export and enable users to work with it, you must
start Oracle Business Process Publisher Server and communicate the
URL. 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.
46
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
weekly) of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
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. You can select any
password. Enter it in the configuration file
businesspublisher.xml (see below). If you prefer another
name, change the name there as well:
CREATE USER ARISBP IDENTIFIED BY ARISBP;
The Oracle user must have the following privileges
GRANT CREATE SESSION TO ARISBP;
GRANT ALTER SESSION TO ARISBP;
47
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
48
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.A
OracleDAO</env-entry-
value>
</env-entry>
4. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
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.
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.
49
Oracle BPA Suite Installation and Administration Guide
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.
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.
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 Oracle database, enable the Oracle Database check box.
50
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. 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.
15. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
51
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
52
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.A
OracleDAO</env-entry-
value>
</env-entry>
53
Oracle BPA Suite Installation and Administration Guide
4. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
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.
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.
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.
54
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.
The Select program folder 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.
13. If this happens, verify and correct the server name, port number,
service name for the database, and the password of the SYSTEM
user. Click on Next.
14. Select the data tablespace and the index tablespace in the dialog
box. Click on Next.
15. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
55
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
weekly) of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
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. You can select any
password. Enter it in the configuration file
businesspublisher.xml (see below). If you prefer another
name, change the name there as well:
CREATE USER ARISBP IDENTIFIED BY ARISBP;
The Oracle user must have the following privileges
GRANT CREATE SESSION TO ARISBP;
56
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
57
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.A
OracleDAO</env-entry-
value>
</env-entry>
4. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
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.
58
Oracle BPA Suite Installation and Administration Guide
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.
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.
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.
59
Oracle BPA Suite Installation and Administration Guide
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 Oracle database, enable the Oracle Database check box.
b. Select the directory for the database files of the database being
created. To install the database in a different directory than the
one suggested, click on the Browse button.
e. Enter the password for the system users in the Password for
SYS, SYSTEM, etc. box, and confirm your entry.
14. 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.
15. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
60
Oracle BPA Suite Installation and Administration Guide
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.
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.
61
Oracle BPA Suite Installation and Administration Guide
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.
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.
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.
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.
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.
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.
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.
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
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.
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-tomcat-
5.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.
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"
67
Oracle BPA Suite Installation and Administration Guide
8. Enter the new license key in the License key line, e.g.
<license key="C99999-XXX_Business_Publisher-
V71LdeLenPdU250-XXXX..."/>
68
Oracle BPA Suite Installation and Administration Guide
69
Oracle BPA Suite Installation and Administration Guide
This provides you with the standard configuration, which you now
adjust.
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.
70
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.AOra
cleDAO</env-entry-
value>
</env-entry>
71
Oracle BPA Suite Installation and Administration Guide
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.
This provides you with the standard configuration, which you now
adjust.
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.
73
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.
If you select this procedure, you must make some settings in the
administration console of IBM WebSphere.
74
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.
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.
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 an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
75
Oracle BPA Suite Installation and Administration Guide
Procedure
1. After the installation, click on Start/Programs/IBM
Websphere/Application Server
V6.1/Profile/<Appsrv01>/Start Server.
76
Oracle BPA Suite Installation and Administration Guide
4. In the Scope box, select the Cell entry and click on New.
6. Select the Oracle JDBC Driver entry in the Provider type box.
77
Oracle BPA Suite Installation and Administration Guide
9. Click on Next, and enter the path to the ojdbc file in the Class path
box (see Prerequisites). If the value has not been correctly
transferred, correct the path on the page JDBC providers/Oracle
JDBC Driver.
78
Oracle BPA Suite Installation and Administration Guide
13. In the Data source name and JNDI name box, enter the entries
shown in the graphic, and click on Next.
79
Oracle BPA Suite Installation and Administration Guide
14. Select the option Select an existing JDBC provider, select Oracle
JDBC Driver, and click on Next.
15. Enter the URL for the Oracle database server using the following
syntax: jdbc:oracle:thin:@<Servername>:<Port>:<Instance>,
and select the settings shown.
16. Click on Next, and check the settings in the summary. Click on
Finish.
80
Oracle BPA Suite Installation and Administration Guide
81
Oracle BPA Suite Installation and Administration Guide
19. Enter user in the Name box and the value ARISBP in the Value
box.
20. Click on OK, and save your changes. You find the new entry at the
end of the list.
82
Oracle BPA Suite Installation and Administration Guide
21. Then, enter a password for the ARISBP user, and click on OK.
22. Save your changes, and test the database connection by clicking on
Test connection on the Data sources page. If you do not receive a
confirmation message, please check the settings and the path to the
file ojdbc5.jar.
83
Oracle BPA Suite Installation and Administration Guide
24. Select the Local file system option, click on Browse, and select the
path to the WAR file (businesspublisher.war). You find this file on
the installation media, or you can download it from www.oracle.com.
84
Oracle BPA Suite Installation and Administration Guide
26. Click on Next, and on the following pages, select the settings as
shown.
85
Oracle BPA Suite Installation and Administration Guide
86
Oracle BPA Suite Installation and Administration Guide
28. Enable the option Oracle JDBC Driver Data Source, and click on
Apply.
29. Check your entries, click on Next and then on Finish. The
installation starts. A progress bar is displayed during installation.
87
Oracle BPA Suite Installation and Administration Guide
30. Save the changes when the master installation has been completed
succesfully.
88
Oracle BPA Suite Installation and Administration Guide
89
Oracle BPA Suite Installation and Administration Guide
33. Enter the value -Xmx2048m in the Generic JVM arguments box,
and click on Custom Properties.
90
Oracle BPA Suite Installation and Administration Guide
91
Oracle BPA Suite Installation and Administration Guide
37. Enable Name Service by disabling all check boxes on the page
Security/Secure administration, applications, and
infrastructure and by adjusting the settings as shown. To disable,
you first have to enable the Enable administrative security check
box.
You can later use the file dumpNameSpace.bat to check whether
the settings are correct.
92
Oracle BPA Suite Installation and Administration Guide
45. Paste the copied entry into the Module class name box.
48. Enable the Select from special subjects option, select all roles for
Everyone, click on Apply, and save the changes.
93
Oracle BPA Suite Installation and Administration Guide
49. Click on Add, enable the Select from special subjects option,
select all roles for All Authenticated, and click on Apply.
94
Oracle BPA Suite Installation and Administration Guide
a. <bpserviceport value="9100"
b. usenameservice="true"
c. nameserviceprefix="/nodes/<node>/servers/<server
name>"/>
Paste the content of the clipboard here.
e. Ensure that these values are also transferred to the files Oracle
BPA Suite installation directory>\Oracle BPA
Suite<Version>\Server\config\defaultServerSettings.cfg
and userSettings.cfg.
95
Oracle BPA Suite Installation and Administration Guide
If the installation was successful, you also find the marked entries in
the file <installation
directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01
>/installedApps/<CellName>/businesspublisher.ear/busines
spublisher.war/config/webappserver.cfg.
58. 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-entry-
value>
</env-entry>
96
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.
61. Save the changes, and restart IBM Websphere Application Server and
Oracle Business Process Publisher.
The system is now running with IBM WAS 6.1.0.15 in combination with
an Oracle database 10g.
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.
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. After the installation, click on Start/Programs/IBM
Websphere/Application Server V6.1/Profile/Appsrv01/Start
Server.
97
Oracle BPA Suite Installation and Administration Guide
4. In the Scope box, select the Cell entry and click on New.
98
Oracle BPA Suite Installation and Administration Guide
9. Click on Next, and, in the Class path box, enter the path to the files
sqlserver.jar, base.jar, util.jar, and spy.jar.
99
Oracle BPA Suite Installation and Administration Guide
100
Oracle BPA Suite Installation and Administration Guide
13. Enter the names in the Data source name and JNDI name box,
and click on Next.
14. Select the option Select an existing JDBC provider, select SQL
JDBC Driver, and click on Next.
101
Oracle BPA Suite Installation and Administration Guide
15. Enter the database name, server name, and port numbers, and
select the settings shown.
16. Click on Next, and check the settings in the summary. Click on
Finish.
102
Oracle BPA Suite Installation and Administration Guide
103
Oracle BPA Suite Installation and Administration Guide
104
Oracle BPA Suite Installation and Administration Guide
20. Enter user in the Name box, for example, and the value ARISBP in
the Value box.
21. Click on OK, and save your changes. You find the new entry at the
end of the list.
105
Oracle BPA Suite Installation and Administration Guide
22. Then, enter a password for the ARISBP user, and click on OK.
106
Oracle BPA Suite Installation and Administration Guide
107
Oracle BPA Suite Installation and Administration Guide
25. Select the Local file system option, click on Browse, and select the
path to the WAR file (businesspublisher.war). You find this file on
the installation media, or you can download it from www.oracle.com.
108
Oracle BPA Suite Installation and Administration Guide
27. Click on Next, and, on the following pages, select the settings as
shown.
109
Oracle BPA Suite Installation and Administration Guide
110
Oracle BPA Suite Installation and Administration Guide
30. Check your entries, click on Next and then on Finish. The
installation starts.
111
Oracle BPA Suite Installation and Administration Guide
31. Save the changes when the master installation has been completed
succesfully.
112
Oracle BPA Suite Installation and Administration Guide
113
Oracle BPA Suite Installation and Administration Guide
34. Enter the value -Xmx2048m in the Generic JVM arguments box,
and click on Custom Properties.
114
Oracle BPA Suite Installation and Administration Guide
115
Oracle BPA Suite Installation and Administration Guide
38. Enable Name Service by disabling all check boxes on the page
Security/Secure administration, applications, and
infrastructure and by adjusting the settings as shown. To disable,
you first have to enable the Enable administrative security check
box.
You can later use the file dumpNameSpace.bat to check whether
the settings are correct.
116
Oracle BPA Suite Installation and Administration Guide
46. Paste the copied entry into the Module class name box.
49. Enable the Select from special subjects option, select all roles for
Everyone, click on Apply, and save the changes.
117
Oracle BPA Suite Installation and Administration Guide
50. Click on Add, enable the Select from special subjects option,
select all roles for All Authenticated, and click on Apply.
118
Oracle BPA Suite Installation and Administration Guide
a. <bpserviceport value="9100"
b. usenameservice="true"
c. nameserviceprefix="/nodes/<node>/servers/<server
name>"/>
Paste the content of the clipboard here.
e. Ensure that these values are also transferred to the files Oracle
BPA Suite installation directory>\Oracle BPA
Suite<Version>\Server\config\defaultServerSettings.cfg
and userSettings.cfg.
119
Oracle BPA Suite Installation and Administration Guide
If the installation was successful, you also find the marked entries in
the file <installation
directory>/IBM/WebSphere/AppServer/profiles/<AppSrv01
>/installedApps/<CellName>/businesspublisher.ear/busines
spublisher.war/config/webappserver.cfg.
59.
60. 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-entry-
value>com.idsscheer.aris.businesspublisher.application.dao.database
.AMSSQLDAO</env-entry-value>
</env-entry>
120
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.
The system is now running with IBM WAS 6.1.0.15 in combination with
an MS SQL Server 2005 database.
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).
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.
If you select this procedure, you must make some settings in the
administration console of IBM WebSphere.
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.
121
Oracle BPA Suite Installation and Administration Guide
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.
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 an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
weekly) of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
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. You can select any
password. Enter it in the configuration file
businesspublisher.xml (see below). If you prefer another
name, change the name there as well:
CREATE USER ARISBP IDENTIFIED BY ARISBP;
122
Oracle BPA Suite Installation and Administration Guide
Procedure
1. After the installation, click on Start/Programs/IBM
Websphere/Application Server
V6.1/Profile/<Appsrv01>/Start Server.
4. In the Scope box, select the Cell entry and click on New.
6. Select the Oracle JDBC Driver entry in the Provider type box.
123
Oracle BPA Suite Installation and Administration Guide
124
Oracle BPA Suite Installation and Administration Guide
9. Click on Next, and enter the path to the ojdbc file in the Class path
box (see Prerequisites). If the value has not been correctly
transferred, correct the path on the page JDBC providers/Oracle
JDBC Driver.
125
Oracle BPA Suite Installation and Administration Guide
13. In the Data source name and JNDI name box, enter the entries
shown in the graphic, and click on Next.
126
Oracle BPA Suite Installation and Administration Guide
14. Select the option Select an existing JDBC provider, select Oracle
JDBC Driver, and click on Next.
15. Enter the URL for the Oracle database server using the following
syntax: jdbc:oracle:thin:@<Servername>:<Port>:<Instance>,
and select the settings shown.
16. Click on Next, and check the settings in the summary. Click on
Finish.
127
Oracle BPA Suite Installation and Administration Guide
128
Oracle BPA Suite Installation and Administration Guide
19. Enter user in the Name box and the value ARISBP in the Value
box.
20. Click on OK, and save your changes. You find the new entry at the
end of the list.
129
Oracle BPA Suite Installation and Administration Guide
21. Then, enter a password for the ARISBP user, and click on OK.
22. Save your changes, and test the database connection by clicking on
Test connection on the Data sources page. If you do not receive a
confirmation message, please check the settings and the path to the
file ojdbc5.jar.
130
Oracle BPA Suite Installation and Administration Guide
24. Select the Local file system option, click on Browse, and select the
path to the WAR file (businesspublisher.war). You find this file on
the installation media, or you can download it from www.oracle.com.
131
Oracle BPA Suite Installation and Administration Guide
26. Click on Next, and on the following pages, select the settings as
shown.
132
Oracle BPA Suite Installation and Administration Guide
133
Oracle BPA Suite Installation and Administration Guide
28. Enable the option Oracle JDBC Driver Data Source, and click on
Apply.
29. Check your entries, click on Next and then on Finish. The
installation starts. A progress bar is displayed during installation.
134
Oracle BPA Suite Installation and Administration Guide
30. Save the changes when the master installation has been completed
succesfully.
135
Oracle BPA Suite Installation and Administration Guide
136
Oracle BPA Suite Installation and Administration Guide
33. Enter the value -Xmx2048m in the Generic JVM arguments box,
and click on Custom Properties.
137
Oracle BPA Suite Installation and Administration Guide
138
Oracle BPA Suite Installation and Administration Guide
37. Enable Name Service by disabling all check boxes on the page
Security/Secure administration, applications, and
infrastructure and by adjusting the settings as shown. To disable,
you first have to enable the Enable administrative security check
box.
You can later use the file dumpNameSpace.bat to check whether
the settings are correct.
139
Oracle BPA Suite Installation and Administration Guide
45. Paste the copied entry into the Module class name box.
48. Enable the Select from special subjects option, select all roles for
Everyone, click on Apply, and save the changes.
140
Oracle BPA Suite Installation and Administration Guide
49. Click on Add, enable the Select from special subjects option,
select all roles for All Authenticated, and click on Apply.
a. <bpserviceport value="9100"
b. usenameservice="true"
141
Oracle BPA Suite Installation and Administration Guide
c. nameserviceprefix="/nodes/<node>/servers/<server
name>"/>
Paste the content of the clipboard here.
e. Ensure that these values are also transferred to the files Oracle
BPA Suite installation directory>\Oracle BPA
Suite<Version>\Server\config\defaultServerSettings.cfg
and userSettings.cfg.
Save your changes.
53. 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-entry-
value>
</env-entry>
56. Save the changes, and restart IBM Websphere Application Server and
Oracle Business Process Publisher.
The system is now running with IBM WAS 6.1.0.15 in combination with
an Oracle database 10g.
142
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.
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. After the installation, click on Start/Programs/IBM
Websphere/Application Server V6.1/Profile/Appsrv01/Start
Server.
143
Oracle BPA Suite Installation and Administration Guide
4. In the Scope box, select the Cell entry and click on New.
144
Oracle BPA Suite Installation and Administration Guide
9. Click on Next, and, in the Class path box, enter the path to the files
sqlserver.jar, base.jar, util.jar, and spy.jar.
145
Oracle BPA Suite Installation and Administration Guide
146
Oracle BPA Suite Installation and Administration Guide
13. Enter the names in the Data source name and JNDI name box,
and click on Next.
14. Select the option Select an existing JDBC provider, select SQL
JDBC Driver, and click on Next.
147
Oracle BPA Suite Installation and Administration Guide
15. Enter the database name, server name, and port numbers, and
select the settings shown.
16. Click on Next, and check the settings in the summary. Click on
Finish.
148
Oracle BPA Suite Installation and Administration Guide
149
Oracle BPA Suite Installation and Administration Guide
150
Oracle BPA Suite Installation and Administration Guide
20. Enter user in the Name box, for example, and the value ARISBP in
the Value box.
21. Click on OK, and save your changes. You find the new entry at the
end of the list.
151
Oracle BPA Suite Installation and Administration Guide
22. Then, enter a password for the ARISBP user, and click on OK.
152
Oracle BPA Suite Installation and Administration Guide
153
Oracle BPA Suite Installation and Administration Guide
25. Select the Local file system option, click on Browse, and select the
path to the WAR file (businesspublisher.war). You find this file on
the installation media, or you can download it from www.oracle.com.
154
Oracle BPA Suite Installation and Administration Guide
27. Click on Next, and, on the following pages, select the settings as
shown.
155
Oracle BPA Suite Installation and Administration Guide
156
Oracle BPA Suite Installation and Administration Guide
30. Check your entries, click on Next and then on Finish. The
installation starts.
157
Oracle BPA Suite Installation and Administration Guide
31. Save the changes when the master installation has been completed
succesfully.
158
Oracle BPA Suite Installation and Administration Guide
159
Oracle BPA Suite Installation and Administration Guide
34. Enter the value -Xmx2048m in the Generic JVM arguments box,
and click on Custom Properties.
160
Oracle BPA Suite Installation and Administration Guide
161
Oracle BPA Suite Installation and Administration Guide
38. Enable Name Service by disabling all check boxes on the page
Security/Secure administration, applications, and
infrastructure and by adjusting the settings as shown. To disable,
you first have to enable the Enable administrative security check
box.
You can later use the file dumpNameSpace.bat to check whether
the settings are correct.
162
Oracle BPA Suite Installation and Administration Guide
46. Paste the copied entry into the Module class name box.
49. Enable the Select from special subjects option, select all roles for
Everyone, click on Apply, and save the changes.
163
Oracle BPA Suite Installation and Administration Guide
50. Click on Add, enable the Select from special subjects option,
select all roles for All Authenticated, and click on Apply.
a. <bpserviceport value="9100"
b. usenameservice="true"
164
Oracle BPA Suite Installation and Administration Guide
c. nameserviceprefix="/nodes/<node>/servers/<server
name>"/>
Paste the content of the clipboard here.
e. Ensure that these values are also transferred to the files Oracle
BPA Suite installation directory>\Oracle BPA
Suite<Version>\Server\config\defaultServerSettings.cfg
and userSettings.cfg.
The system is now running with IBM WAS 6.1.0.15 in combination with
an MS SQL Server 2005 database.
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).
165
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.
Prerequisite
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.
Procedure
1. Exit Oracle Business Process Publisher Server.
166
Oracle BPA Suite Installation and Administration Guide
6. Select the Local file system option, click on Browse, and select the
path to the WAR file (businesspublisher.war). You find this file on
the installation media, or you can download it from www.oracle.com.
167
Oracle BPA Suite Installation and Administration Guide
168
Oracle BPA Suite Installation and Administration Guide
9. Click on Browse.
10. Check your entries, click on Next and then on Finish. The
installation starts.
169
Oracle BPA Suite Installation and Administration Guide
11. Save the changes when the master installation has been completed
succesfully.
If you select this procedure, you must make some settings in the
administration console of Oracle WebLogic Server 11g.
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.
170
Oracle BPA Suite Installation and Administration Guide
Prerequisite
Copy the file ojdbc5.jar (installation media/Setups/All
OS/Oracle Business Process Publisher Server) 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 an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
weekly) of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
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. You can select any
password. If you prefer another name, change the name there as
well:
171
Oracle BPA Suite Installation and Administration Guide
Procedure
1. After installation, open the administration console of WebLogic
Server in your browser at http://<server
name>:<port>/console.
The port number depends on your current configuration. The Login
dialog box is displayed.
172
Oracle BPA Suite Installation and Administration Guide
173
Oracle BPA Suite Installation and Administration Guide
174
Oracle BPA Suite Installation and Administration Guide
175
Oracle BPA Suite Installation and Administration Guide
176
Oracle BPA Suite Installation and Administration Guide
177
Oracle BPA Suite Installation and Administration Guide
12. Define the database type and the JNDI address to be used by Oracle
Business Process Publisher. Define jdbc/businesspublisherdb as
the JNDI name.
178
Oracle BPA Suite Installation and Administration Guide
13. Select the database type and the associated database driver.
179
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.
180
Oracle BPA Suite Installation and Administration Guide
17. Specify the cluster on which the new data source is available.
181
Oracle BPA Suite Installation and Administration Guide
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
182
Oracle BPA Suite Installation and Administration Guide
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"/>).
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.
183
Oracle BPA Suite Installation and Administration Guide
Procedure
1. After installation, open the administration console of WebLogic
Server in your browser at http://<server
name>:<port>/console.
The port number depends on your current configuration. The Login
dialog box is displayed.
184
Oracle BPA Suite Installation and Administration Guide
185
Oracle BPA Suite Installation and Administration Guide
186
Oracle BPA Suite Installation and Administration Guide
187
Oracle BPA Suite Installation and Administration Guide
188
Oracle BPA Suite Installation and Administration Guide
12. Define the database type and the JNDI address to be used by Oracle
Business Process Publisher. Define jdbc/businesspublisherdb as
the JNDI name.
189
Oracle BPA Suite Installation and Administration Guide
13. Select the database type and the associated database driver.
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
17. Specify the cluster on which the new data source is available.
192
Oracle BPA Suite Installation and Administration Guide
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
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"/>).
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
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.
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.
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.
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.
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.
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).
196
Oracle BPA Suite Installation and Administration Guide
To create a Publisher export and enable users to work with it, you must
start Oracle Business Process Publisher Server and communicate the
URL. 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.
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
weekly) of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
197
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
198
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.A
OracleDAO</env-entry-
value>
</env-entry>
199
Oracle BPA Suite Installation and Administration Guide
4. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
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.
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.
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.
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.
200
Oracle BPA Suite Installation and Administration Guide
10. To use an Oracle database, enable the Oracle Database check box.
11. 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.
12. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
201
Oracle BPA Suite Installation and Administration Guide
202
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
203
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.A
OracleDAO</env-entry-
value>
</env-entry>
4. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
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.
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.
204
Oracle BPA Suite Installation and Administration Guide
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.
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.
10. To use an Oracle database, enable the Oracle Database check box.
205
Oracle BPA Suite Installation and Administration Guide
13. 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.
14. Select the data tablespace and the index tablespace in the dialog
box. Click on Next.
15. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
206
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
207
Oracle BPA Suite Installation and Administration Guide
http://jakarta.apache.org/commons/dbcp/configuration.html
(http://jakarta.apache.org/commons/dbcp/configuration.html)-->
username="ARISBP" password="ARISBP" <!-- Use the Oracle
user name and password here (see Prerequisites> -->
driverClassName="oracle.jdbc.driver.OracleDriver"
url="jdbc:oracle:thin:@localhost:1521:ARISBP" <!--
url="jdbc:oracle:thin:@hostname:port:sid where you replace
hostname, port, and sid in the URL as appropriate-->
connectionProperties="SetBigStringTryClob=true"/>
</Context>
com.idsscheer.aris.businesspublisher.application.dao.database.A
OracleDAO</env-entry-
value>
</env-entry>
4. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
208
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.
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.
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.
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.
209
Oracle BPA Suite Installation and Administration Guide
10. To use an Oracle database, enable the Oracle Database check box.
b. Select the directory for the database files of the database being
created. To install the database in a different directory than the
one suggested, click on the Browse button.
e. Enter the password for the system users in the Password for
SYS, SYSTEM, etc. box, and confirm your entry.
13. 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.
14. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
210
Oracle BPA Suite Installation and Administration Guide
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.
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.
211
Oracle BPA Suite Installation and Administration Guide
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.
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).
212
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.
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.
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. The Select program folder page
opens.
213
Oracle BPA Suite Installation and Administration Guide
10. To use an MS SQL Server, enable the MS SQL Server check box.
11. 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.
12. Check your settings in the summary. If your settings are correct,
click on Next. The components will now be installed.
Here, you install the viewer for displaying PDF documents such as the
Methods Manual.
Procedure
1. If the start page is not displayed automatically, click on the name of
your drive in Windows Explorer and run the OracleBPA.exe
program.
5. Enable the option button for the required viewer version, and click on
Next.
7. Click on Install.
214
Oracle BPA Suite Installation and Administration Guide
To use Oracle BPA Suite via a browser, install SUN Java Runtime
Environment (JRE) if you have not yet done so. This section describes
the standard installation process. To perform a different installation,
enable the Adapted option button during JRE installation.
Procedure
1. 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. Once you have read the license agreements and accept them, enable
the relevant check box and click on Next.
Note
Install JRE in a path whose directory name does not include any spaces.
Otherwise, JRE cannot be executed.
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.
Otherwise, it may not be possible to run Oracle Business Process
Architect via a browser.
215
Oracle BPA Suite Installation and Administration Guide
216
Oracle BPA Suite Installation and Administration Guide
The standard database system is also installed with this installation. This
allows you to create databases on your computer and work with them
without other users being able to access them. You can also connect to
an Oracle Business Process Repository to create databases there and
work with them.
Prerequisite
Ensure on your computer that you have the privilege to exit Windows
services that have been started.
Procedure
1. Open the Windows Start menu, and select Settings/Control Panel.
The Control Panel of your operating system opens.
217
Oracle BPA Suite Installation and Administration Guide
4. In the Status column, check whether the service Oracle BPA Suite
Server 11g has been started.
5. If so, right-click on the service Oracle BPA Suite Server 7.1 and
select Exit.
The service Oracle BPA Suite Server 11g is now exited.
218
Oracle BPA Suite Installation and Administration Guide
Oracle BPA Suite clients and Oracle Business Process Repository use
shared components that can only be installed once per computer.
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 make any changes to the Oracle BPA Suite client or Oracle
Business Process Repository, you need to ensure that both have the
same version and are installed with the same languages after the
changes:
Therefore, when you perform a version update, you need to ensure
that both Oracle Business Process Repository and the Oracle BPA
Suite client are included.
When you install additional languages, you need to install them for
both Oracle Business Process Repository and the Oracle BPA Suite
client.
2.10.5.1 Installation
To find out which languages have been installed for Oracle BPA Suite,
run the Oracle BPA Suite setup again and select the Modify Program
option. Installed languages are enabled on the Select Language page
of the Oracle BPA Suite setup. Once you have determined which
languages are installed, click on Cancel.
219
Oracle BPA Suite Installation and Administration Guide
During the installation of the Oracle BPA Suite client, you must select
the same languages as for the previous installation of Oracle Business
Process Repository.
To find out which languages have been installed for Oracle Business
Process Repository, run the Oracle Business Process Repository setup
again and select the Modify program option. Installed languages are
enabled on the Select Language page of the Oracle Business Process
Repository setup. Once you have determined which languages are
installed, click on Cancel.
2.10.5.2 Uninstall
You can uninstall Oracle Business Process Repository and Oracle BPA
Suite clients individually without affecting the operability of the
remaining component. The order in which they were installed is
irrelevant.
220
Oracle BPA Suite Installation and Administration Guide
3 Administration
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.
Procedure
Create two permanent tablespaces ARISDATA and ARISINDEX for the
indices.
You can also assign other names for the two tablespaces. In this case,
you must later adapt the configuration.
Note
A relatively small Oracle BPA Suite database occupies on the order of
100 MB per tablespace. The size required for the tablespaces ultimately
depends on the anticipated number of Oracle BPA Suite databases and
221
Oracle BPA Suite Installation and Administration Guide
their size. Since this is difficult to predict, it is best to start with 4 GB per
tablespace and keep an eye on the trend toward exhausting that
capacity.
To install the database objects that are required to operate Oracle BPA
Suite, you can use the scripts available on the Oracle BPA Suite
installation media in the Setups\DBMS\Oracle directory. Since the
scripts rely on SQL*PLUS, at least the Oracle client software must be
available on the computer on which you intend to run the scripts.
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. Oracle Business Process Repository never connects to this user. For
this reason, it does not require a CREATE SESSION privilege. 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. The user ARIS71 itself does not have
any database objects. It solely has object privileges for the database
objects in the schema arisadm71. The system privilege assigned to the
user ARIS71 is CREATE SESSION.
The scripts install the database objects required for operating Oracle
BPA Suite in an existing Oracle database. Since the scripts rely on
SQL*PLUS, at least the Oracle client software must be available on the
computer on which you intend to run the scripts.
Alternatively, you can have the server setup program create the
database objects.
222
Oracle BPA Suite Installation and Administration Guide
Once the Oracle database is created, the scripts for importing the
database objects required for operating Oracle BPA Suite can be run.
install.bat
Windows batch files for running SQL*Plus scripts
envset.bat
Batch files for adjusting settings The file envset.bat is called by the file
install.bat.
Before you run scripts by calling them from install.bat (or install.sh),
you must adjust configurations in the file envset.bat (or envset.sh).
install.sh
Bash script for running SQL*Plus scripts To run this script under Unix,
you need the bash as Shell.
envset.sh
Bash script for adjusting settings The file envset.sh is called by the file
install.sh. To run this script under Unix, you need the bash as Shell.
adminc.sql
SQL*Plus script for creating the user arisadm71
appuserc.sql
SQL*Plus script for creating the connection user ARIS71
schema_aris.sql
SQL*PLUS script for creating a procedure that produces a spreadsheet
set for an Oracle BPA Suite database
basemgr.sql
Procedures for managing Oracle BPA Suite databases.
deinstall.sql
SQL*PLUS script for removing the users arisadm71 and ARIS71.
223
Oracle BPA Suite Installation and Administration Guide
Before you run the scripts, you must adjust them to your environment.
Adjustments can be made in the file envset.bat or envset.sh, which
you find on the installation media under Setups\DBMS\Oracle.
You can change connection data. To do this, edit the files envset.bat and
envset.sh, which you find on the installation media under
Setups\DBMS\Oracle. First copy these files to the hard drive of the
computer on which they will be run.
Procedure
1. Open the file envset.bat or envset.sh with a text editor.
If you have assigned other names to the tablespaces (Page 221), the
envset.bat and envset.sh file must be adjusted. You find this on the
installation media under Setups\DBMS\Oracle. First copy these files
to the hard drive of the computer on which they will be run.
224
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file envset.bat or envset.sh with a text editor.
Change the password for the Oracle user ARIS71. The default password
for this user is *ARIS!1dm9n#. You can also change the password
later at any time using the Oracle BPA Suite function DBMS password.
To prevent misuse, you should change it immediately. To select another
password for the Oracle user ARIS71 in advance, edit the envset.bat
and envset.sh file before the scripts are used.
Procedure
1. Open the file envset.bat or envset.sh with a text editor.
3. For Oracle Business Process Repository to use the new password, you
must specify it in the file Lockservice.cfg in the config directory of
Oracle Business Process Repository Site Manager.
Note
The password is specified in plain text in the file Lockservice.cfg, but
immediately after Oracle Business Process Repository starts for the first
time, it encrypts the password in the file Lockservice.cfg. The key
arisadm_pwd_ with final underscore identifies the password as a plain
text password, while the key arisadm_pwd without a final underscore
identifies the encrypted password. After Oracle Business Process
Repository starts, the arisadm_pwd_ variant is converted into the
arisadm_pwd variant.
225
Oracle BPA Suite Installation and Administration Guide
Instead of ARIS71 and arisadm71, you can select other names for the
required Oracle users. This can be useful, for example, if you want to
use the same Oracle database for several installations of Oracle Business
Process Repository. In this case, please select different user names for
each installation.
Procedure
1. Open the file envset.bat or envset.sh with a text editor.
4. For Oracle Business Process Repository to use the new user names,
you must specify this in the file Lockservice.cfg in the config
directory of Oracle Business Process Repository Site Manager.
226
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file Lockservice.cfg in the config directory of Oracle
Business Process Repository Site Manager with a text editor.
If you wish to run (Page 27) Oracle Business Process Repository based
on Microsoft SQL (MS SQL) as the database management system, please
read the following pages.
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.
227
Oracle BPA Suite Installation and Administration Guide
To install the database with the database objects that are required to
operate Oracle BPA Suite, you can use the scripts available on the
installation media in the Setups\DBMS\MSSQL directory.
Before you run the scripts by calling inst.bat, you must configure the
inst.bat file.
228
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Edit the inst.bat file, and find the line
SET MSSQL_IDS_MSSQL_LOGIN_NAME=localhost\username
You can select another name for the database instead of ARIS71. To do
this, you must edit the inst.bat file. You find this on the installation
media under Setups\DBMS\MSSQL. First copy these files to the hard
drive of the computer on which they will be run.
Procedure
1. Open the file inst.bat with a text editor.
The default password for the login user ARIS71 is *ARIS!1dm9n#. You
can change the password later at any time using the Oracle BPA Suite
function DBMS password. To prevent misuse, you should change it
immediately. To select another password for the login user ARIS71 in
advance, edit the inst.bat file before the scripts are used.
Procedure
1. Open the file inst.bat with a text editor.
229
Oracle BPA Suite Installation and Administration Guide
Note
The password is specified in plain text in the file Lockservice.cfg, but
immediately after Oracle Business Process Repository starts for the first
time, it encrypts the password in the file Lockservice.cfg. The key
arisadm_pwd_ with final underscore identifies the password as a plain
text password, while the key arisadm_pwd without a final underscore
identifies the encrypted password. After Oracle Business Process
Repository starts, the arisadm_pwd_ variant is converted into the
arisadm_pwd variant.
You can select another name for required SQL Server users instead of
ARIS71.
Procedure
1. Open the file inst.bat with a text editor.
3. For Oracle Business Process Repository to use the new user names,
you must specify these in the file Lockservice.cfg in the config
directory of Oracle Business Process Repository Site Manager.
230
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file Lockservice.cfg in the config directory of Oracle
Business Process Repository Site Manager with a text editor.
Note
Sometimes the name MSSQLSERVER does not work, although you are
using a default instance. In this case, remove the expression
;instance=MSSQLSERVER at the end of the URL.
If you wish to run (Page 28) Oracle Business Process Repository based
on DB2 as the database management system, please read this page.
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.
231
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Create an operating system user with the name db2aris on the DB2
host computer. Oracle Business Process Repository uses a free DB2
database user to connect to the DB2 database.
CONNECT TO ARIS;
232
Oracle BPA Suite Installation and Administration Guide
CONNECT RESET;
Note
The default password for this user is *ARIS!1dm9n#. To prevent
misuse, you should change it immediately.
You can only change the password here. The DBMS password cannot be
changed in the program interface.
Once you have defined the password and started Oracle Business
Process Repository, the password entered in the file is automatically
encrypted to prevent misuse. The key is also renamed from
arisadm_pwd_ (unencrypted) to arisadm_pwd (encrypted).
If you wish to change the password afterward, you first have to rename
the arisadm_pwd key to arisadm_pwd_ again and enter the new
password directly after =. The password is automatically encrypted after
restart.
Notes
If you install databases yourself, always follow the instructions provided
by their respective manufacturers.
233
Oracle BPA Suite Installation and Administration Guide
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.
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.
234
Oracle BPA Suite Installation and Administration Guide
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.
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).
235
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.
236
Oracle BPA Suite Installation and Administration Guide
237
Oracle BPA Suite Installation and Administration Guide
238
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have created an Oracle database and configured it as follows. If
you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the two
systems from competing for resources, and you achieve better
performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table data)
and ARISBPINDEX (for index data). To use other names or
existing tablespaces, you must customize the configuration file
webappserver.cfg (see below). We recommend that you set the
tablespaces for automatic, unlimited growth. Otherwise, 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. If the
option for automatic growth is not set, regular monitoring (e.g.
weekly) of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
239
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
240
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, port, and sid in the URL as appropriate-->
connectionProperties="SetBigStringTryClob=true"/>
</Context>
6. Ensure that the JDBC driver ojdbc5.jar exists in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\common\lib. We assume that you are using
version 10.2.0.3. You find the file on the installation media.
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.
241
Oracle BPA Suite Installation and Administration Guide
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. Since manual and software are subject to different production
cycles, 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. Please read this file and take
the information into account when installing, setting up, and using the
product.
242
Oracle BPA Suite Installation and Administration Guide
2 GB RAM
32-bit system
1 GB RAM In 32-bit
systems, the maximum
size of a Virtual Machine
(VM) is 1 GB.
243
Oracle BPA Suite Installation and Administration Guide
Software
Operating Depends on the database systems used.
systems
Network High-speed network (>=100 Mbit) between database server and Oracle
Business Process Repository.
JRE Windows
Your JRE installation is only used if you start Oracle BPA Suite products
from your browser.
Note
SUN renamed the JRE versions. JRE 1.6.0_04 is now called JRE 6.0,
Update 4. Approvals are also valid for subsequent updates.
Oracle BPA Suite products are tested using the JRE that is current at
the time of release.
If JRE 1.6.0_04 and subsequent patches are approved for an Oracle
BPA Suite product, the approval is valid for both JRE 1.6.0_04 and
JRE 1.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).
SUN Microsystems guarantees compatibility between the JRE patch
levels. Therefore, the Oracle BPA Suite approvals for JREs are valid
for all patch levels of a version.
If you are using JRE 1.6 update 3 or an older version, copy the file
jaxb-api.jar from the directory <Web Client Components>\lib
to the directory <Java JRE installation directory>/endorsed,
244
Oracle BPA Suite Installation and Administration Guide
-Dsun.java2d.d3d=false
Unix
Oracle Business Process Repository requires JRE 1.6. Please first install
the appropriate JRE 1.6 for your operating system.
Protocols (Page Data exchange between browser-capable Oracle BPA Suite clients and
249) Oracle Business Process Repository can be encrypted with SSL (1024-
bit RSA).
SSL capability is already integrated into Oracle BPA Suite and only
needs to be activated when needed.
Output If, for example, you want to output documents in PDF format using
Microsoft Word or Microsoft Excel, you must have Adobe Reader and
Microsoft Office version 2000, 2002, 2003, or 2007 installed. If you use
reports to import data from Excel tables, please ensure that the tables
have been saved in XLS format. If pop-up blockers are activated for
the domain, it may not always be possible to open report output in PDF
format from a Publisher export.
245
Oracle BPA Suite Installation and Administration Guide
Note
Oracle Business Process Repository does not support NAT (Network
Address Translation) by default. However, Oracle Corporation offers
customized solutions. Additional information is available from our
support.
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.
Approved combinations
(32/64-bit)
246
Oracle BPA Suite Installation and Administration Guide
9, 10
(4)
(5)
(1)Only with 32-bit Java, Oracle BPA Suite standard platform, database
license included in the Oracle Business Process Repository license.
(6) Itanium processors have not been approved for Oracle BPA Suite
installations on Windows systems.
(7) You can use a maximum of 1 GB RAM and only one processor. 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.
247
Oracle BPA Suite Installation and Administration Guide
248
Oracle BPA Suite Installation and Administration Guide
(3) n stands for a number of Business Server sites greater than 1. The
RAM required for JavaScript reports varies greatly. Therefore, we
recommend that you run these under UNIX or on a 64-bit system.
SSL capability is already integrated into Oracle BPA Suite and only needs
to be activated when needed.
During the installation process, the following files are created among
others in the directory <Oracle BPA Suite installation
directory>/server/config:
defaultServerSettings.cfg
Contains all default settings in an XML structure. This file is
overwritten for each subsequent setup.
setupServerSettings.cfg
Contains all settings that you specified during installation, e.g. the
paths. This file is overwritten for each subsequent setup.
249
Oracle BPA Suite Installation and Administration Guide
userServerSettings.cfg
Contains all configuration changes that you have made after
installation. This file is not overwritten. If you run subsequent setups,
your configuration changes are preserved.
In older program versions, configuration changes were entered in
different files. If you run an update installation of the current version,
the configuration files are converted when Oracle Business Process
Repository is started. All configuration changes are entered in the file
userServerSettings.cfg. The configuration files are deleted. They
are backed up in the backup directory.
You enter all configuration changes as XML tags in the file <Oracle BPA
Suite installation directory>\server\config\userServerSettings.cfg.
This allows you to change all default settings according to your
requirements. Ensure that you enter the attributes in the correct XML
structure. You find the XML structure and all default attributes in the file
defaultServerSettings in the same directory. Please only change the
file userServerSettings.cfg. These changes are not overwritten in an
Oracle Business Process Repository update.
Note
If Oracle Business Process Repository does not start properly after the
configuration has been changed, check the XML structure of the file
userServerSettings.cfg. Once you have corrected or deleted incorrect
entries, the related changes are undone when you restart the server,
and the default settings of these attributes are used.
250
Oracle BPA Suite Installation and Administration Guide
The login and logout times for each user are output in the log file.
Tip
If you enter the following, only information is output:
Using SSL (1024 Bit RSA) you can exchange encrypted data between the
Java-based products and Oracle Business Process Repository. SSL
capability is already integrated in Oracle BPA Suite.
Note
If you have installed Oracle Business Process Repository on a Unix
operating system and have enabled SSL encryption, Oracle Business
Process Repository must run under the root account.
251
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Ensure that the system date matches the current date. This ensures
that the validity of the SSL certificates (Page 252) is checked
correctly. These certificates can only be used to exchange data
between Java-based products and Oracle Business Process
Repository.
5. From now on, use index_ssl.html as the start file for the databases.
This file is located in the directory %BPAHOME11g% server\html.
Warning
Please only use the file userServerSettings.cfg to change the
configuration. This ensures that your changes are preserved in future
update installations. The other Oracle Business Process Repository
configuration files are overwritten for each installation.
Ensure that the certificates installed for your Oracle Business Process
Repository are up to date.
Procedure
Automatic installation
The SSL certificates are automatically updated when you use the patch
setup. Besides the patch setup, you continue to use the hotfix package
as a ZIP file. Using this ZIP file, the hotfix package can be installed with
the Silent install option. For additional information, see the Setup
descriptions (ftp://ftp.ids-
scheer.de/pub/ARIS/HELPDESK/ARIS701/hotfix/ARIS_Patch_Setup/).
252
Oracle BPA Suite Installation and Administration Guide
Manual installation
1. Download the SSL certificate upCert_SSL_<program version>
from our server (ftp://ftp.ids-
scheer.de/pub/ARIS/HELPDESK/CERTIFICATES/). Ensure that your
program version matches the one of this certificate.
253
Oracle BPA Suite Installation and Administration Guide
The Report Server is running by default. If you do not want to start any
VB scripts on Oracle Business Process Repository, you can deactivate the
Report Server. As a result, fewer system resources are needed and
system performance improves. You can always run VB scripts locally.
254
Oracle BPA Suite Installation and Administration Guide
The simulation server is running by default. If you are not using Oracle
Business Process Simulator on an Oracle Business Process Repository,
you can deactivate the simulation server. As a result, fewer system
resources are needed and system performance improves.
HTML Generator creates all index files and the file aris_database.html
for the Web Client Components. It updates the access files whenever
databases are created, renamed, or deleted. You can use the file
userServerSettings.cfg (server\config directory) to control its
behavior.
255
Oracle BPA Suite Installation and Administration Guide
<htmlgen>
<languagelist default="de">
<language tag="de"/>
<language tag="en"/>
<language tag="ja"/>
</languagelist>
<!-- 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.cfg. If your work is not limited to the use of only
one Oracle Business Process Repository, you need to adjust the paths on
the computer on which Oracle Business Process Repository Site Manager
is installed. 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.html"
database_template="aris_database_ssl.html"/>
</genlist>
</htmlgen>
You can run the HTML Generator manually at any time by executing the
htmlgen.bat file in the Oracle Business Process Repository directory.
Warning
Please only use the file userServerSettings.cfg to change the
configuration. This ensures that your changes are preserved in future
update installations. The other Oracle Business Process Repository
configuration files are overwritten for each installation.
Administrators of Oracle BPA Suite sites can have messages sent by the
Oracle BPA Suite notify service when problems arise. It is possible to
notify (Page 256) several administrators at the same time.
256
Oracle BPA Suite Installation and Administration Guide
the zipped files of the log and config directories. You can toggle the
notification mode by setting the state value.
Prerequisite
The username account (see the following example) must exist on your
e-mail server.
Procedure
1. Open the file <Oracle BPA Suite installation
directory>\server\config\userServerSettings.cfg with a text editor.
257
Oracle BPA Suite Installation and Administration Guide
In this example:
adminservice
258
Oracle BPA Suite Installation and Administration Guide
LocalServer
You can increase memory usage by specifying the following entry in the
file local.cfg in the directory <Oracle BPA Suite installation
directory>/LocalServer/config:
maxMem=1024m
Just change the value shown in bold. The entry in the example above
specifies that the local server LOCAL may use a maximum of 1024
megabytes of memory.
Server
You can increase memory usage by inserting the following entries in the
file userServerSettings.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.
Procedure
1. Open the file readonly_properties.xml of the corresponding
directory in a text editor.
259
Oracle BPA Suite Installation and Administration Guide
Note
If you want to use country-specific special characters, they must be
entered with UTF-8 encoding. Please use an UTF-8-enabled editor to
encode country-specific special characters.
Oracle BPA Suite Converter is the program for converting data from
older Oracle BPA Suite versions to work with Oracle BPA Suite 11g,
regardless of the server platform and database management system
used. The conversion enables you to transfer databases of a different
product version. If, for example, you created a user database under an
Oracle database for Oracle BPA Suite 10.1.3.1, you can use Oracle
260
Oracle BPA Suite Installation and Administration Guide
If you have disk space problems when converting large databases (see
file serverout.log in directory <Oracle BPA Suite installation
directory>\LocalServer\log\ or <Oracle BPA Suite installation
directory>\server\log\), you can specify that more memory (Page
299) is allocated for database conversion in the file
userServerSettings.cfg (in directory <Oracle BPA Suite installation
directory>\LocalServer\config\) or in the file local.cfg (in directory
<Oracle BPA Suite installation directory>\server\config\).
As a rule, all applications from which COM objects are used in Oracle
BPA Suite databases must be installed on the computer you use for
converting databases. 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.
For example, if you run reports or create a Publisher export, the icons
that are saved in the icons subdirectory in the installation directory of
your Oracle Business Process Repository are used for linked files. Icons
of Microsoft Office products are automatically displayed. For these
applications, you do not need any icons in the directory noted above
unless you want to use your own icons.
You can change icons or add new ones. To create and edit icons in ICO
format, you need a suitable application. Assign file names that conform
with the extension of the relevant application.
To create icons that represent bitmap graphics or text files, for example,
save the graphics under the names bmp.ico and txt.ico.
Added icons are immediately available. Once you have changed icons,
you must restart Oracle Business Process Repository.
Note
If icons displayed in models are different from those in the report output
or in Publisher export, ensure that you have saved the corresponding
icons in the installation directory of your Oracle Business Process
Repository, in the icons subdirectory.
261
Oracle BPA Suite Installation and Administration Guide
If icons for placed attributes are missing there, they will not be displayed
in the Publisher export or report output.
Prerequisite
You have administration privileges for the Oracle Business Process
Repository installation directory.
Procedure
1. Open the installation directory of the relevant Oracle Business
Process Repository ..server/templates/scriptservice/internal/,
and create the images subdirectory.
The new icons are available to users in the Configure macros dialog
box after restarting the program. If the file images.lst is missing, no
icons from the images directory are displayed.
262
Oracle BPA Suite Installation and Administration Guide
Within the system, 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.
Administrators of Oracle BPA Suite sites can have messages sent by the
Oracle BPA Suite notify service when problems arise. It is possible to
notify (Page 256) several administrators at the same time.
263
Oracle BPA Suite Installation and Administration Guide
Administrators of Oracle BPA Suite sites can have messages sent by the
Oracle BPA Suite notify service when problems arise. It is possible to
notify (Page 256) several administrators at the same time.
Prerequisite
The username account (see the following example) must exist on your
e-mail server.
Procedure
1. Open the file <Oracle BPA Suite installation
directory>\server\config\userServerSettings.cfg with a text editor.
264
Oracle BPA Suite Installation and Administration Guide
In this example:
adminservice
265
Oracle BPA Suite Installation and Administration Guide
The table shows the requirements that apply for many of the Java-based
programs. Additional requirements must be met for some programs.
Find out about specific requirements in the relevant sections.
Note
This manual describes the settings and features as they were at the time
of print. Since manual and software are subject to different production
cycles, 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. Please read this file and take
the information into account when installing, setting up, and using the
product.
266
Oracle BPA Suite Installation and Administration Guide
Software Details
Operating Windows XP Professional + Service Packs
systems Windows Vista (Business, Ultimate; 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).
For any patches/security patches that may be needed, see the
Oracle BPA Suite release notes in the file Readme.txt on the
Oracle BPA Suite installation media.
RedHat ES5-Linux
Without local server LOCAL
267
Oracle BPA Suite Installation and Administration Guide
Software Details
Browser Microsoft Internet Explorer, version 6.0
Microsoft Internet Explorer, version 7.0
JRE If you have Oracle Business Process Repository installed and start
Oracle BPA Suite products as programs, an internal JRE version is
automatically used. You do not need to install JRE separately. If
you have already installed JRE, your installation is not used by
Oracle BPA Suite.
Your JRE installation is only used if you start Oracle BPA Suite
products from your browser.
Output If, for example, you want to output documents in PDF format
using Microsoft Word or Microsoft Excel, you must have Adobe
Reader and Microsoft Office version 2000, 2002, 2003, or 2007
installed. If you use reports to import data from Excel tables,
please ensure that the tables have been saved in XLS format. If
pop-up blockers are activated for the domain, it may not always
be possible to open report output in PDF format from a Publisher
268
Oracle BPA Suite Installation and Administration Guide
Software Details
export.
LDAP Oracle BPA Suite supports LDAP. Windows Server 2003 Active
Directory has been tested; therefore, the documentation refers to
this system.
269
Oracle BPA Suite Installation and Administration Guide
270
Oracle BPA Suite Installation and Administration Guide
Processor Dual Intel Xeon Intel Xeon 3.4 GHz Intel Pentium IV,
2.8 GHz with 1 with 1 MB of level 2 3.0 GHz with 1 MB
MB of level 2 cache of level 2 cache
cache
Controller SCSI with RAID1 SCSI with RAID1 SCSI with RAID1
option option option
If you create a Publisher export and use links to large files (>15 MB),
you may need more memory for your Oracle Business Process
Repository. If the memory is insufficient, the export process is canceled.
271
Oracle BPA Suite Installation and Administration Guide
While Oracle Corporation has not approved the use of later versions, it
is highly unlikely that they cannot be used. However, we cannot
guarantee that links will work correctly (Page 339).
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, report output cannot be displayed in PDF
format.
JRE The following are approved: (Page 275) Java Runtime Environment
(JRE) 1.6.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.
Output If, for example, you want to output documents in PDF format using
Microsoft Word or Microsoft Excel, you must have Adobe Reader and
Microsoft Office version 2000, 2002, 2003, or 2007 installed. If you use
reports to import data from Excel tables, please ensure that the tables
have been saved in XLS format. If pop-up blockers are activated for
272
Oracle BPA Suite Installation and Administration Guide
the domain, it may not always be possible to open report output in PDF
format from a Publisher export.
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.
273
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, the
context path and the free port to the Web server are entered
automatically.
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.
274
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.
This information was current at the time of printing. Therefore, discrepancies may exist in Service Releases. Please read
the current release information and the Readme file.
275
Oracle BPA Suite Installation and Administration Guide
276
Oracle BPA Suite Installation and Administration Guide
277
Oracle BPA Suite Installation and Administration Guide
(6) You can use a maximum of 1 GB RAM and only one processor. 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
Oracle BPA Suite Installation and Administration Guide
The context path is the path to the directory where the index.html
start page for Oracle Business Process Publisher is located. If you
want to place the start page in another directory, you need to change
the path accordingly.
Prerequisite
You have access privileges for the Publisher Server installation
directory.
Procedure
1. Open the file webappserver.cfg in the Publisher Server
installation directory
..\BPServer\tomcat\webapps\businesspublisher\config\
with a text editor.
279
Oracle BPA Suite Installation and Administration Guide
In each Publisher export, the Explorer tree displays all groups of the
relevant databases.
Tip
You can undo this setting at any time by entering the default value
and restarting Oracle Business Process Publisher.
Procedure
1. In case of deployment in a Tomcat Web application server
environment, open the configuration file ..\
BPServer\tomcat\webapps\businesspublisher\config\webappserv
er.cfg from the Oracle Business Process Publisher Server
installation directory in a text editor.
In case of deployment on an Oracle Application Server, open the
configuration file
..\j2ee\home\applications\BusinessPublisher\businesspublisher\co
nfig\webappserver.cfg from the Oracle Business Process
Publisher Server installation directory in a text editor.
280
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have access privileges for the Oracle Business Process Publisher
Server installation directory.
Procedure
1. Open the file webappserver.cfg in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\webapps\businesspublisher\config\
with a text editor.
Prerequisite
You have access privileges for the Oracle Business Process Publisher
Server installation directory.
Procedure
1. Open the file businesspublisher.xml in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
2. In the following line, change the value for the port number:
<Connector port="9090" />.
281
Oracle BPA Suite Installation and Administration Guide
The change takes effect only after you have restarted Oracle
Business Process Publisher Server.
Prerequisite
You have access privileges for the Oracle Business Process Publisher
Server installation directory.
Procedure
1. Open the file webappserver.cfg in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\webapps\businesspublisher\config\
with a text editor.
Prerequisite
You have access privileges for the Oracle Business Process Publisher
Server installation directory.
Procedure
1. Open the file webappserver.cfg in the Oracle Business Process
Publisher Server installation directory
..\BPServer\tomcat\webapps\businesspublisher\config\
with a text editor.
282
Oracle BPA Suite Installation and Administration Guide
2. Find the <ldap> tag. In this section, configure the login using an
LDAP system.
Warning
If your LDAP server is set up so that it allows anonymous
authentication (unauthenticated bind mechanism), users may be able
to log in without a password.
Note
You can use the administration interface for exports to encrypt (Page
286) the password of the LDAP user maintained here. Copy the
encrypted password to this file and restart the server.
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.
283
Oracle BPA Suite Installation and Administration Guide
b. Adjust the path to the database file. Ensure that the path has
been created before you run the script.
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;instanc
e=MSSQLSRV.
284
Oracle BPA Suite Installation and Administration Guide
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).
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.
285
Oracle BPA Suite Installation and Administration Guide
If users are authenticated via LDAP, a default user and the related
password must be entered in the configuration file
webappserver.cfg. To prevent misuse, you can encrypt this
password and enter it in the configuration file.
286
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file in an editor.
Prerequisite
You have access privileges for the Oracle Business Process Publisher
Server installation directory.
Procedure
1. Open the file
\BPServer\tomcat\webapps\businesspublisher\layouts\default\conf
ig\layout.cfg.xml with your editor.
Tip
The News area can be customized to meet your requirements. For
example, you can keep a list of links to the models or objects that
have been changed or created since a specific date.
287
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have access privileges for the Oracle Business Process Publisher
Server installation directory.
Procedure
4. Find the <oisproviderurl> tag. Specify the URL for the OIS
system and the correct port number in the form of
http://192.168.3.4:7001. The default port is 7001, e.g.
<oisproviderurl value="http://192.168.3.4:7001">.
288
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have created an Oracle database and configured it as follows.
If you install a database yourself, always follow the instructions
provided in the Oracle Installation Guide. We recommend that you
use two separate Oracle databases for Oracle Business Process
Repository and Oracle Business Process Publisher. This keeps the
two systems from competing for resources, and you achieve
better performance and higher availability.
Use of the database character set AL32UTF8 is mandatory.
We recommend a block size of 8K.
query_rewrite_enabled=true
query_rewrite_integrity=trusted
You have created two tablespaces: ARISBPDATA (for table
data) and ARISBPINDEX (for index data). To use other
names or existing tablespaces, you must customize the
configuration file webappserver.cfg (see below). We
recommend that you set the tablespaces for automatic,
unlimited growth. Otherwise, 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. If the option for
automatic growth is not set, regular monitoring (e.g. weekly)
of the Oracle instance is required to ensure that the
tablespaces are manually increased on time.
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. You can select any
password. Enter it in the configuration file
businesspublisher.xml (see below). If you prefer another
name, change the name there as well:
CREATE USER ARISBP IDENTIFIED BY ARISBP;
The Oracle user must have the following privileges
GRANT CREATE SESSION TO ARISBP;
GRANT ALTER SESSION TO ARISBP;
GRANT CREATE TABLE TO ARISBP;
GRANT CREATE VIEW TO ARISBP;
GRANT QUERY REWRITE TO ARISBP;
ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA;
ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX;
289
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
290
Oracle BPA Suite Installation and Administration Guide
com.idsscheer.aris.businesspublisher.application.dao.database.
AOracleDAO</env-entry-
value>
</env-entry>
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.
291
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Open the file businesspublisher.xml in the Oracle Business
Process Publisher Server installation directory
..\BPServer\tomcat\conf\catalina\localhost\ with a text
editor.
Prerequisite
You have exported report scripts and observed the following:
The reports only evaluate the contexts Database, Group, Model,
or Object.
The reports do not call any dialog boxes.
The reports only require read access to items.
If you use a report template to create the reports in design view,
the prerequisites mentioned above are automatically met.
The reports only contain methods allowed for Oracle Business
Process Publisher.
Note
Normally, you cannot use the report scripts provided with Oracle BPA
Suite. Some of these reports are interactive and use methods that are
not supported by Oracle Business Process Publisher. If the
prerequisites for Oracle Business Process Publisher reports are not
met, an error message is output during report execution.
Procedure
Add report
1. Log in as a system administrator or administrator. The export
administration opens.
292
Oracle BPA Suite Installation and Administration Guide
3. Click on Browse, and select the report export file (*.arx) of the
relevant report.
Export files are created when you export a report script from
Oracle Business Process Architect, for example. Reports provided
here must meet the prerequisites.
4. Click on Upload.
Tip
If you need additional evaluation scripts, you can create report
outputs based on a report script template in design view. If you are
familiar with the JavaScript and Oracle BPA Suite Script
programming languages, you can create user-defined evaluation
scripts or adapt existing scripts.
Delete report
Click on Delete .
Make sure that one of the approved JRE versions is installed on all
computers and the specific system requirements (Page 265) are met.
JRE
The following are approved: Java Runtime Environment (JRE)
1.6.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.
293
Oracle BPA Suite Installation and Administration Guide
Note
SUN renamed the JRE versions. JRE 1.6.0_04 is now called JRE 6.0,
Update 4. Approvals are also valid for subsequent updates.
Oracle BPA Suite products are tested using the JRE that is current at
the time of release.
If JRE 1.6.0_04 and subsequent patches are approved for an
Oracle BPA Suite product, the approval is valid for both JRE
1.6.0_04 and JRE 1.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). SUN Microsystems guarantees compatibility
between the JRE patch levels. Therefore, the Oracle BPA Suite
approvals for JREs are valid for all patch levels of a version.
If you are using JRE 1.6 update 3 or an older version, copy the file
jaxb-api.jar from the directory <Web Client Components>\lib
to the directory <Java JRE installation directory>/endorsed,
e.g. C:\Program Files\Java\jre1.6.0_01\lib\endorsed.
If the directory endorsed does not exist, you must create it.
Please note that you must repeat this procedure for every update
of version 3 or older. We therefore recommend installation of
version 4 or higher.
If you have Java 6 update 10 installed, problems may occur
despite better performance. Depending on your graphics card and
driver configuration, installation of Java 6 update 10 may cause
delays in the Designer and Matrices modules.
In this case, use the following command line entry to start the
program:
-Dsun.java2d.d3d=false
Procedure
Oracle Business Process Architect: Register the cfg MIME type
with the Web server. Only then can the arisloader.cfg file be
used.
Web Publisher exports: For the Web site on which the Web
Publisher exports will run, enter the text/html MIME type for the
properties file type. This allows Web Publisher export files to be
identified.
294
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Ensure that the system requirements are met.
3. Install a JRE approved for Oracle BPA Suite. Ensure that the
directory name of the path does not contain any spaces or special
characters, or otherwise the JRE cannot be run.
Navigate to the Web Client Components installation directory
using your browser. If the Web Client Components are set up, you
will find the link to the HTML test page at the end of the
multilingual index page.
When you navigate back to the Web Client Components
installation directory using your browser, the database list of the
linked Oracle BPA Suite Site is displayed.
4. Pass the link on to users who want to work with Oracle Business
Process Architect, for example, the link to the index_lan.html file.
295
Oracle BPA Suite Installation and Administration Guide
# External Libraries
jar=CcConfig.jar
jar=CcLicense.jar
jar=CcSaxpath-1.0.jar
jar=ChartDirector.jar
jar=CnvConnect.jar
jar=CorticonFoundationAPI.jar
jar=JimiProClasses.jar
jar=activation.jar
jar=ant-launcher.jar
jar=ant.jar
jar=antlr.jar
jar=bsscjhrs.jar
jar=castor-1.0.5.jar
jar=commons-collections-3.2.jar
jar=commons-configuration-1.3.jar
jar=commons-dbcp-1.2.1.jar
jar=commons-discovery.jar
jar=commons-lang-2.2.jar
jar=commons-logging.jar
jar=commons-pool-1.3.jar
jar=ejb20.jar:ignore
jar=iText-2.0.7.jar
jar=iTextAsian.jar
jar=jaxb.jar
jar=jdo2-api-2.0.jar
jar=jdom.jar
jar=jh.jar
jar=jide-develop.jar
jar=js.jar
jar=log4j-1.2.14.jar
jar=lucene-analyzers-2.2.0.jar
jar=lucene-core-2.2.0.jar
jar=lucene-highlighter-2.2.0.jar
jar=mail.jar
jar=ociplugins.1.0.0.jar
jar=orbacus.4.3.2.jar
jar=org.eclipse.core.resources_3.2.2.R32x_v20061218.jar
jar=org.eclipse.core.runtime_3.2.0.v20060603.jar
jar=org.eclipse.emf.common_2.2.1.v200705141058.jar
jar=org.eclipse.emf.ecore.change_2.2.1.v200705141058.jar
jar=org.eclipse.emf.ecore.xmi_2.2.3.v200705141058.jar
jar=org.eclipse.emf.ecore_2.2.3.v200705141058.jar
jar=org.eclipse.emf.edit_2.2.2.v200705141058.jar
jar=org.eclipse.equinox.common_3.2.0.v20060603.jar
jar=org.eclipse.osgi_3.2.2.R32x_v20070118.jar
jar=poi-3.0.2.jar
jar=qname.jar
jar=simulationstepcache-1.0.0.jar
jar=tools.jar
jar=wsdl4j.jar
jar=xercesImpl.jar
296
Oracle BPA Suite Installation and Administration Guide
jar=xml-apis.jar
jar=y-annotations-1.jar
jar=y-graphics-3.jar
jar=y-graphlayout-2.jar
jar=y-guiframework-6.jar
jar=y-lipo-1.jar
jar=y-reportdesigner-client-2.jar
jar=y-reportdesigner-common-2.jar
jar=y-reportexecution-2.jar
jar=y-utils-2.jar
jar=y.jar
Note
Please do not use any country-specific special characters in the path
for BPAHOME11g= or DownloadClientPath=.
3. If the environment variable is not found, the JAR files are copied
to the directory <installation directory>\Oracle BPA
Suite<Version>\DownloadClient.
297
Oracle BPA Suite Installation and Administration Guide
A language update for the Web Client Components and Oracle BPA
Suite Server enters the language resource files in the arisloader.cfg
file in the installation directory. As a result, a language update is
performed automatically when a Java-based product opens a
database.
Warning
If you start a Web client via Internet Explorer, for example Oracle
Business Process Architect, the Java call remains open in the
background. As a result, you may not be able to start a second Web
client.
Even if you are able to start multiple Web clients, we recommend that
298
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.
If you use Java-based products as applets, you can provide them with
additional memory. This is recommended if you use memory-
intensive, user-defined symbols in your databases, for example.
Tip
This setting affects all Java-based programs.
Go to the control panel, open the Java control panel, and change the
Java applet runtime settings by entering the required Java runtime
parameters for the JRE version you are using. To provide 256 MB of
memory (recommended), enter -Xmx256m.
Warning
As a consequence of changing the standard installation as described
in this section, updates or other changes by the Oracle BPA Suite
installation program are no longer possible. They would have to be
made manually.
After starting the Oracle BPA Suite products, you will find the cid.bin
file in the BPA11 subdirectory of the user profile (%userprofile%).
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. In the file arisloader.cfg, you
can then assign the BPAHOME11g environment variable to the
DownloadClientPath= entry for this path.
299
Oracle BPA Suite Installation and Administration Guide
When Oracle Business Process Architect is installed for the first time
(Page 295), the internal user.cfg file is used when the application is
first started.
Procedure
1. Switch to the config directory of your Web Client Components
installation.
2. Open the file user.cfg with a text editor, enter your data (Page
300), and save the file under the name user.cfg. You can update
these files simultaneously via software distribution.
To open the second Java-based product, you must close the browser,
which terminates the Java applet, and open the browser again. You
can then start ARIS Business Optimizer in the browser.
300
Oracle BPA Suite Installation and Administration Guide
You can set up a virtual directory on your Web server that the
installed Web clients can access to download newer versions. If you
update the virtual directory on your Web server by running a patch
setup, the Web clients will automatically download the current files
when the setup is run.
Procedure
1. Install the Web Client Components (see user-defined installation
of Oracle Business Process Repository in the Installation Guide) on
your Web server.
If you update the ARIS Web Client Components of your Web server
using a patch setup, the Web clients you set up will automatically
download the updated files at the next startup.
For installed Web clients, you can configure the system to search a
URL for current program files at startup. If current files are available,
they will be downloaded.
301
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Start the Web client and click on View/Options.
4. Enter the URL for the automatic Oracle BPA Suite update, in our
example http://WebServer/BPA_autoupdate.
Every time the Web client is started, the specified URL is checked for
updated program files. If any are available, they can be downloaded.
Note
If LDAP authentication is enabled, users that have been created in the
database can no longer log in. The system user system is an
exception. Unlike all other users, the system user system is never
authenticated via the LDAP system. If the LDAP servers are down and
databases cannot be accessed, you can still log in as the user
system.
Make sure that user names in the LDAP system contain only valid
characters and that users use secure passwords. Alphanumeric
characters, spaces, and the following characters are allowed in user
names: . - _ ! " § $ % & / ( ) = ? * + # < > , ; :
302
Oracle BPA Suite Installation and Administration Guide
Prerequisite
You have the Database management function privilege.
You have installed an LDAP server.
You have created user groups in the databases and assigned
function and access privileges to them.
Procedure
1. Click on Administration in the Modules bar, and log in to the
database.
303
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Install the LDAP server you want to use. Always refer to your
LDAP system documentation because installation varies from
system to system.
2. Obtain the SSL certificate for your LDAP system. To do so, consult
your LDAP system documentation.
4. Enter the path to the Oracle BPA Suite server installation directory
as the keystore parameter. Example: You have installed Oracle
BPA Suite Server in the directory C:\Program Files\Oracle BPA
Suite 11\server\. 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.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.
304
Oracle BPA Suite Installation and Administration Guide
7. Enable the Use SSL check box and ensure that the correct value
is maintained in the Port box.
Database
In Oracle Business Process Architect, using the Backup
functionality in the pop-up menu of a database.
In Oracle BPA Suite Admintool (Page 312), using the Backup
(Page 316) command.
In Oracle BPA Suite Site Administrator, using the Backup
functionality in the pop-up menu of a database.
Filters
In Oracle Business Process Architect, using the Export
functionality in the pop-up menu for a filter (individual backup).
In Oracle BPA Suite Admintool (Page 312), using the
Backupconfig (Page 319) command.
Scripts
In Oracle Business Process Architect, using the Export
functionality in the pop-up menu for a script (individual backup).
To back up all scripts and macros for an Oracle Business Process
Repository, save the directory <Oracle BPA Suite installation
directory>\server\templates with all its subdirectories.
305
Oracle BPA Suite Installation and Administration Guide
Note
User attributes of the Free attributes attribute type group from
previous Oracle BPA Suite versions are no longer used as of version
11g. You can now customize attribute type groups and attribute
types.
Alternatively, you can also use Oracle BPA Suite Converter. 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.
306
Oracle BPA Suite Installation and Administration Guide
Transfer databases
User databases contain the structural and process-oriented
organization of your company, for example. The contents of user
databases can be transferred in their entirety using Oracle BPA Suite
Converter.
Procedure
1. Create a backup copy of your databases.
5. Click on Next.
6. Enable the option button for the Oracle BPA Suite version to be
used as the source for conversion.
7. Click on Next.
8. Select the source containing the Oracle BPA Suite user database
that you want to transfer to your new Oracle BPA Suite
installation.
307
Oracle BPA Suite Installation and Administration Guide
Based on your settings you now have one or several of the following
options.
Local system
Local database directory: Enable the Local option button.
Note
To convert databases locally (LOCAL server), you need to launch the
LOCAL server of the appropriate Oracle BPA Suite version before
starting Oracle BPA Suite Converter. To start LOCAL, click on LOCAL
in the tree view in the Explorer module.
Procedure
1. Click on Next.
3. Click on Next.
308
Oracle BPA Suite Installation and Administration Guide
4. Click on Next.
6. Click on Next.
8. Click on Next.
3.8.1.1 Configuration
You can use Oracle BPA Suite Converter to transfer all or individual
item groups, such as filters or model templates, from the
configuration of Oracle BPA Suite 10.1.3.1 and higher.
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.
When you transfer item groups with Oracle BPA Suite Converter,
the reference to the respective database is not affected. In other
words, the assignment of user-defined symbols to objects in the
databases still exists, for example.
309
Oracle BPA Suite Installation and Administration Guide
You can transfer filters, templates, and chart definitions that you have
exported in XML format (ACC, AMC, and ATC files).
Procedure
1. Run Oracle Business Process Architect.
3. In the navigation bar, click on the plus sign (+) next to the server
into whose configuration you wish to import the filter, font format,
language, or template.
6. Select the import file and, if required, decide how conflicts are to
be solved during import by enabling the relevant check boxes.
7. Click on OK.
Procedure
1. Copy the VB scripts to the appropriate script directories of the
directory Oracle BPA Suite <installation directory>\script.
310
Oracle BPA Suite Installation and Administration Guide
5. Repeat the script selection for all relevant directories. The selected
scripts are listed in the Oracle BPA Suite Script Converter output
window.
Note
If not all scripts have been updated, you are informed which scripts
are affected and why Oracle BPA Suite Script Converter did not
update them.
Procedure
1. Use Oracle BPA Suite Admintool to back up all user databases.
Use the BPAadm11 backup all <directory> command if you
use the Oracle BPA Suite Admintool in interactive mode.
Tip
It is also possible to back up user databases online. The Oracle BPA
Suite System Maintenance and Administration training session
provides instructions on backup procedures and concepts. For
additional information, please contact Oracle Corporation support.
311
Oracle BPA Suite Installation and Administration Guide
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, for example. The program is a console
application and runs in the MS DOS input window. The individual
commands of the program are supplied as command line parameters.
The program provides information on the success and effect of each
command executed.
Warning
As a basic rule, Oracle BPA Suite databases should not be edited
using Windows Explorer. If you rename database folders or copy files,
this may result in program malfunction.
You can start Oracle BPA Suite Admintool from any client computer
and access the databases on the server:
312
Oracle BPA Suite Installation and Administration Guide
You can start Oracle BPA Suite Admintool from any client computer
and access the databases on the server:
In this section, 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.
Note
To use Oracle BPA Suite Admintool outside of interactive mode, you
must enter the parameter Oracle Business Process Repository, as well
as passwords.
After the command, you can either enter a database name or use all
to specify that all databases be deleted.
313
Oracle BPA Suite Installation and Administration Guide
If you want to create the Sales data database with the name Sales
data 2005, for example, enter the following:
Interactive mode
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>] ...
The following options can be used in Oracle BPA Suite Admintool:
314
Oracle BPA Suite Installation and Administration Guide
Option Description
-s <server name> Indicates the server on which the
command is to be performed. In
interactive mode, the server can be
changed via the server command.
315
Oracle BPA Suite Installation and Administration Guide
Notes
When working with Oracle BPA Suite Admintool, please observe the
following:
If you are working with Oracle BPA Suite Admintool on the server
computer, use the -s localhost parameter.
If you have not entered a password, you will be prompted to
supply the Database Administrator password before each
command is executed.
If you use values with special characters (e.g. '&' in the
password), you need to enclose the value in quotes. For additional
information, please refer to the help and support center for your
operating system.
On the server, system messages in Oracle BPA Suite Admintool
are always output in the Oracle BPA Suite installation language.
For example, if you use scripts for daily backups, we strongly
recommend that you protect these scripts at the operating system
level because passwords are unencrypted.
3.9.2.1 Backup
The name of the backup file consists of the name of the database
and the appended file extension, ADB.
316
Oracle BPA Suite Installation and Administration Guide
Warning
If a file of the same name already exists in the backup directory, it
will be overwritten.
Interactive mode
backup [<database name>] [all] <backup directory> [<new
database name>]
3.9.2.1.1 Example
Procedure
1. Run Oracle BPA Suite Admintool (Start/Programs/Oracle BPA
Suite/Administration/Oracle BPA Suite Admintool 11g). Oracle BPA
Suite Admintool is launched directly in interactive mode and you
can enter the desired command.
317
Oracle BPA Suite Installation and Administration Guide
Warning
For example, if you use scripts for daily backups, we strongly
recommend that you protect these scripts at the operating system
level because passwords are unencrypted.
3.9.2.2 Backupasn
318
Oracle BPA Suite Installation and Administration Guide
The name of the backup file consists of the name of the database
and the appended file extension ADB.
Warning
If a file of the same name already exists in the backup directory, it
will be overwritten.
3.9.2.3 Backupconfig
Saves the Oracle BPA Suite configuration data (filters, templates, and
charts) to the specified directory in the appropriate file format.
To save the Oracle BPA Suite configuration data, enter the following
command call and press Enter:
Interactive mode
backupconfig <backup directory> <new file name>
319
Oracle BPA Suite Installation and Administration Guide
3.9.2.4 Configadminpassword
3.9.2.5 Copy
Interactive mode
copy <source database name> [all] <target database name>
Note
Database names must be unique. If a database already exists with
the name specified in the second parameter, the database cannot be
copied.
Example
The SalesDB database is to be duplicated on the LOCAL server. The
database administrator password is DBADMIN. The copy of the
database is to be named New salesDB.
320
Oracle BPA Suite Installation and Administration Guide
Procedure
1. Run Oracle BPA Suite Admintool (Start/Programs/Oracle BPA
Suite/Administration/Oracle BPA Suite Admintool 11g).
Oracle BPA Suite Admintool is launched directly in interactive
mode and you can enter the desired command.
3.9.2.6 Createdb
Interactive mode
createdb SalesDB
3.9.2.7 Dbmspassword
Changes the password of the DBMS user. This change is helpful if the
DBMS (Database Management System) in use is also used by
applications other than Oracle BPA Suite. This may be the case with
the Oracle DBMS. The Oracle DBMS user is called ARIS71. The
default password is arisadmin (lower case).
3.9.2.8 Download
Interactive mode
download [logs] [configs] [accounting] <target directory>
all
321
Oracle BPA Suite Installation and Administration Guide
Logs stands for log files, configs for configurations and accounting
for user information.
3.9.2.9 Delete
Force: Deletes the relevant databases even though users are still
logged in.
Interactive mode
delete [<database name>] [all] [force]
3.9.2.10 Exit
Exits interactive mode and closes the Oracle BPA Suite Admintool
window. The Exit command can only be executed in interactive mode.
3.9.2.11 Help
Displays a help text for every available command. The help text
describes the actions that will be performed as a consequence of the
command, as well as the parameters that must be entered with the
command.
To call help for a specific command, enter the following command call
and press Enter:
Interactive mode
help <command>
322
Oracle BPA Suite Installation and Administration Guide
3.9.2.12 Interactive
3.9.2.13 Kill
Warning
All users whose connection to databases on the specified server was
terminated with the Kill function cannot properly exit Oracle BPA
Suite. Changes which have not yet been saved are lost and must be
made again after Oracle BPA Suite has been restarted.
Interactive mode
kill [<session ID>] [all]
323
Oracle BPA Suite Installation and Administration Guide
3.9.2.14 List
Interactive mode
list [all]
3.9.2.15 Maintain
Interactive mode
maintain [<database name>] [all]
3.9.2.16 Monitor
Shows all current server activities, such as backup or XML export, for
example.
To display the server activities, enter the following command call and
press Enter.
324
Oracle BPA Suite Installation and Administration Guide
Interactive mode
monitor
3.9.2.17 Password
Interactive mode
password <new password> <current password>
3.9.2.18 Rename
Renames a database.
Interactive mode
rename <old database name> <new database name> [force]
3.9.2.19 Reorg
Reorganizes a database.
Oracle BPA Suite searches the database for object and connection
definitions that do no longer have occurrences in models. These are
deleted.
If you are using an object library, you should not enable this option
since it may be possible and intended for certain definitions to exist
without having any occurrences.
325
Oracle BPA Suite Installation and Administration Guide
Interactive mode
reorg [<database name>] [all]
3.9.2.20 Restore
The database directory must not contain a database that has the
same name as the one to be imported. You are therefore given the
opportunity to rename the database when importing.
Interactive mode
restore <backup file> [overwrite]
Directory with multiple ADB files:
restore <backup directory> [overwrite]
326
Oracle BPA Suite Installation and Administration Guide
Interactive mode
restore <backup file> [<new database name>] [overwrite]
3.9.2.21 Restoreversioned
The database directory must not contain a database that has the
same name as the one to be imported. You are therefore given the
opportunity to rename the database when importing.
Interactive mode
restoreversioned <backup file> [<database name>]
[overwrite]
Directory with multiple ADB files:
restoreversioned <backup directory> [overwrite]
3.9.2.22 Restoreasn
327
Oracle BPA Suite Installation and Administration Guide
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]
3.9.2.23 Restoreconfig
Saves the Oracle BPA Suite configuration data (filters, templates, and
charts) to the specified directory in the appropriate file format.
To save the Oracle BPA Suite configuration data, enter the following
command call and press Enter:
Interactive mode
restoreconfig <path\file name>
3.9.2.24 Server
328
Oracle BPA Suite Installation and Administration Guide
3.9.2.25 Sessions
The following options are available for displaying information about all
current users of databases on the specified server.
Interactive mode
sessions byuser
Interactive mode
sessions bypid
Interactive mode
sessions bydatabase
329
Oracle BPA Suite Installation and Administration Guide
3.9.2.26 Siteadminpassword
3.9.2.27 Statistic
Displays the following information for the evaluated database:
All models
All users
All font formats
Interactive mode
Information about a database:
statistic <database name>
Information about all databases:
statistic all
330
Oracle BPA Suite Installation and Administration Guide
3.9.2.28 Status
Interactive mode
status <server>
3.9.2.29 Version
Interactive mode:
Version
Tip
To output the version number of an Oracle Business Process
Repository, please use the Status (Page 331) command.
With Oracle Business Process Architect you can also create and run
JavaScript reports, provided the necessary system requirements are
met.
331
Oracle BPA Suite Installation and Administration Guide
JavaScript reports
The RAM required for JavaScript reports varies greatly. If you want to
run report scripts that process large quantities of database items, we
recommend a 64-bit Windows installation or a Unix installation due to
the upper memory limit of 1.2 GB main memory for Oracle Business
Process Repository. Please also note the information on script
development (Page 331).
Note
If you observe certain requirements (Page 332) when creating report
scripts, you ensure that memory requirements are optimized when
the reports are run. This reduces the execution time of your reports
and the risk of reaching the memory limits of your system.
332
Oracle BPA Suite Installation and Administration Guide
The RAM required for JavaScript reports varies greatly. If you want to
run report scripts that process large quantities of database items, we
recommend a 64-bit Windows installation or a Unix installation due to
the upper memory limit of 1.2 GB main memory for Oracle Business
Process Repository. Please also note the information on script
development (Page 331).
Note
The Report Server is running by default. If you do not want to start
any VB scripts on an Oracle Business Process Repository, you can
shut down (Page 254) the Report Server to avoid unnecessary use of
system resources. You can always run these locally. To shut down the
Report Server, you must configure the file userServerSettings.cfg
as follows.
All reports
If, for example, you want to output documents in PDF format using
Microsoft Word or Microsoft Excel, you must have Adobe Reader and
Microsoft Office version 2000, 2002, 2003, or 2007 installed. If you
use reports to import data from Excel tables, please ensure that the
tables have been saved in XLS format. If pop-up blockers are
activated for the domain, it may not always be possible to open
report output in PDF format from a Publisher export.
333
Oracle BPA Suite Installation and Administration Guide
Since reports are run on the server, dialogs that are called from a
script via Windows API functions cannot be displayed on the client, for
example. The same applies to running Shell and ShellExecute. The
relevant programs and files are run or opened via the default
methods on the server.
For this reason, Oracle BPA Suite Script has special methods for
displaying, running, or opening dialog boxes, programs, and files on
the client. You find the parameters for these methods in the
corresponding help files. Replace the default methods as shown in the
following table:
GetSaveFileName BrowseForFiles
GetFilePath BrowseForFiles
(Sax Basic)
SHBrowseForFolder BrowseForFolders
(Win API)
ShellExecute Shell
(Win API)
334
Oracle BPA Suite Installation and Administration Guide
When you use dialog variables in a report, this differs from use in the
local report because you must declare the scope of the dialog
variables.
Nested dialogs are not permitted in Web reports. Such nested dialogs
occur, for example, when a message box (MsgBox) is used in the
DialogFunc to output an error message. To have the Web report
output this message box, you need to integrate it in such a way that
it appears only after the dialog box generated with DialogFunc is
closed.
335
Oracle BPA Suite Installation and Administration Guide
For example, if you run reports or create a Publisher export, the icons
that are saved in the icons subdirectory in the installation directory
of your Oracle Business Process Repository are used for linked files.
Icons of Microsoft Office products are automatically displayed. For
these applications, you do not need any icons in the directory noted
above unless you want to use your own icons.
You can change icons or add new ones. To create and edit icons in
ICO format, you need a suitable application. Assign file names that
conform with the extension of the relevant application.
Added icons are immediately available. Once you have changed icons,
you must restart Oracle Business Process Repository.
Note
If icons displayed in models are different from those in the report
output or in Publisher export, ensure that you have saved the
corresponding icons in the installation directory of your Oracle
Business Process Repository, in the icons subdirectory.
If icons for placed attributes are missing there, they will not be
displayed in the Publisher export or report output.
Prerequisite
You have administration privileges for the Oracle Business Process
Repository installation directory.
Procedure
1. Open the installation directory of the relevant Oracle Business
Process Repository
..server/templates/scriptservice/internal/, and create the
images subdirectory.
336
Oracle BPA Suite Installation and Administration Guide
The new icons are available to users in the Configure macros dialog
box after restarting the program. If the file images.lst is missing, no
icons from the images directory are displayed.
Versions more recent than those listed below have not been tested or
approved for use.
Note
Despite the approval of our software for operation with the listed
operating system versions and other software and hardware
requirements, we cannot exclude the possibility of problems arising
from unpredictable incompatibility issues with certain
hardware/software combinations.
337
Oracle BPA Suite Installation and Administration Guide
Printers/plotters
Oracle BPA Suite printouts are not generated correctly with the HP
Design Jet 800 plotter driver and compatible drivers in HPGL mode.
Links
If you create a Publisher export and use links to large files (>15 MB),
you may need more memory for your Oracle Business Process
Repository. If the memory is insufficient, the export process is
canceled. Please also note the error sources described (Page 339).
338
Oracle BPA Suite Installation and Administration Guide
Characters
Because of a known error in JVM (Sun)
(http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5040856),
you should use only Western European characters in computer
names.
If you publish OLE objects whose file names are written in Japanese
characters in another language, e.g. de or en, the names will not be
displayed correctly. These files cannot be opened. To be able to open
the files, replace the Japanese (or other) file names with English
ones.
If you create a Publisher export and use links to large files (>15 MB),
you may need more memory for your Oracle Business Process
Repository. If the memory is insufficient, the export process is
canceled.
Using file servers is one way to exclude the possibility of faulty links.
All files that have been linked in databases are managed on a file
server.
339
Oracle BPA Suite Installation and Administration Guide
Correct notation
Depending on your system configuration, the notation of the link may
also cause errors. Generally, a URL is processed in 8-bit
representation. Unicode coding must be handled separately.
Type of link
Depending on the domain from which a link is started or to which a
link leads, a distinction must be made between local and external
links. Different errors may also occur depending on system and
security settings.
External links
Correctly written and absolute links pose no problems. All links to
files that were copied from Oracle Business Process Publisher to
the Oracle Business Process Publisher Server also work correctly.
The browser handles these as external links.
Local links
All links to local files are subject to strict security restrictions.
These restrictions are not at all uniform and differ between various
browsers and different versions and patches. If, for example, you
install a security update for your browser that is not approved by
IDS Scheer, links may no longer work.
Syntax
Local link without drive link
The link file:///C:/Program Files/Internet
Explorer/readme.txt opens a file in the local directory structure
C:\Program Files\Internet Explorer\readme.txt
Local link with local drive link
340
Oracle BPA Suite Installation and Administration Guide
Security risks
Not every browser always makes interactive reference to possible
security risks. More frequently, functional links are blocked.
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, these links cannot be
resolved if you use an Oracle Business Process Repository. These
links only work if you manage the database on the local server
local.
341
Oracle BPA Suite Installation and Administration Guide
3.11.2 Calendar
3.12 Glossary
Application server
Computer on which applications are run. It is a component of a 3-tier
architecture.
342
Oracle BPA Suite Installation and Administration Guide
Database server
Computer on which the Oracle BPA Suite Repository is installed.
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.
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.
JRE
Java Runtime Environment. System that is used to run Java
programs. The main components are the Java Virtual Machine, the
Java Interpreter, and the host operating system.
343
Oracle BPA Suite Installation and Administration Guide
LAN
Local Area Network. Network within a company. This network has
broad bandwidth.
LDAP
Lightweight Directory Access Protocol. Protocol that provides access
to centrally managed libraries of information and directories. It saves
having to search the whole network for data. 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.
Oracle
Relational database system that can be used for Oracle BPA Suite
installations.
RAID
Redundant Array of Independent Disks. Method of linking several
hard drives and accessing these as if accessing a single hard drive.
This means that data storage and data access is 'spread' across these
hard drives, which improves access time and avoids complete loss of
data should a drive fail.
SSL
Secure Socket Layer. Security software for encrypting data that is
exchanged between programs.
System user
Users who have all function and access privileges in a database.
System users can be created by the system manager (user system)
or by another system user. The system system user is created
automatically for every database. The name system cannot be
344
Oracle BPA Suite Installation and Administration Guide
'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. The system
system user is created automatically for every database. This user
has all function and access privileges. Authorized persons can use this
emergency user to log in to any database, even if you use an LDAP
system or an OIS system. The name system cannot be changed. You
should immediately change the password manager to prevent
unauthorized access. To avoid problems, you can create additional
system users.
WAN
Wide Area Network. Network that transports data both within the
company network and via the Internet. This network has low
bandwidth.
Web server
A server containing the HTML pages, images, documents and other
files and folders that users or programs within a network can access.
345
Oracle BPA Suite Installation and Administration Guide
3.13 Appendix
346
Oracle BPA Suite Installation and Administration Guide
347
Oracle BPA Suite Installation and Administration Guide
348
Oracle BPA Suite Installation and Administration Guide
349
Oracle BPA Suite Installation and Administration Guide
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.
350
Oracle BPA Suite Installation and Administration Guide
Index
A
E
Acrobat Reader - 214
Evaluation - 331
Administration
Browser use (Java-based products) - 295 Exit - 322
Language update and character sets - 298 Expand memory - 259
Software distribution - 299
Applet - 298
H
Application - 298 Help - 322
Approved platforms
I
Oracle Business Process Repository - 242
Automatic backup - 218 Install an Oracle BPA Suite
client (Linux) - 7
B Install an Oracle BPA Suite
client (Windows) - 5
Backup - 316
Install Oracle Business Process
Backupasn - 318
Publisher Report Server -
Backupconfig - 319 194
Browser use (Java-based products) - 295 Install Oracle Business Process
Publisher Server - 44
C
Install Oracle Business Process
Character set - 298 Repository (Windows) -
Citrix - 265 default - 12
Client log - 270 Install Oracle Business Process
Configadminpassword - 320 Repository (Windows) - user-
defined - 17
Configuration database - 309
Installation
Configure client connection - 254 Automatic backup - 218
Copy - 320 Install an Oracle BPA Suite
Createdb - 321 client (Linux) - 7
Install an Oracle BPA Suite
D client (Windows) - 5
Install Oracle Business
Dbmspassword - 321
Process Publisher Server
Deactivate Report Server - 254 - 44
Deactivate simulation server - 255 Install Oracle Business
Delete - 322 Process Repository
(Windows) - default - 12
Download - 321
Install Oracle Business
Process Repository
(Windows) - user-defined
- 17
Oracle BPA Suite Site
Administrator - 20
Oracle BPA Suite Web Client
Components - 41
Oracle Business Process
Repository Site Manager -
21
i
Oracle BPA Suite Installation and Administration Guide
ii
Oracle BPA Suite Installation and Administration Guide
S
Server - 328
Server LOG - 262
Sessions - 329
Siteadminpassword - 330
Software distribution - 299
Software requirements
Additional memory - 259
Oracle BPA Suite Converter
- 260
Oracle BPA Suite UML
Designer - 265
Oracle Business Process
Architect - 265
Oracle Business Process
Publisher - 271
Oracle Business Process
Repository - 242
iii