Installing BR*Tools Studio

Show TOC

Prerequisites

To run the setup program for BR*Tools Studio you need to meet the following requirements:

20 MB of disk space on your BR*Tools Studio host
Java Runtime Edition (JRE) 1.4.2 or higher
SAPCAR extraction software as described in SAP Note 212876.
These executables in your PATH variable:
- SAPCAR
- java

To run BR*Tools Studio after installation you need to meet the following requirements:

Java Development Kit (JDK) 1.4.2 or higher
SAP BR*Tools 7.10 Patch 12 or higher, or BR*Tools 7.00 Patch 34 or higher
Web browser Microsoft® Internet Explorer or Mozilla® Firefox
A remote shell tool of your choice such as RSH, SSH, or PuTTY (optional)
Oracle Containers for Java EE (OC4J) 10g or higher (optional)

You can install and run BR*Tools Studio in two modes:

Dedicated server
You install BR*Tools Studio on your chosen database host to administer the local database instance only.
Multi-instance server
You install BR*Tools Studio on a standalone middle-tier host and add database instances as remote instances to the instance portfolio of the BR*Tools Studio server.

BR*Tools Studio does not require its own database.

Recommendation

Although BR*Tools Studio lets you add additional database instances to a dedicated BR*Tools Studio server, we strongly discourage you from doing so. This is due to the increasing load BR*Tools Studio server generates on its host as the instance portfolio expands.

Instead, we recommend you to run BR*Tools Studio server on a platform without a database host when running in multi-instance server mode, to avoid overloading the database host.

End of the recommendation.

Procedure

Set up the keystore file on the BR*Tools Studio host for incoming client calls:

Note
BR*Tools Studio implements a client-server architecture in which the BR*Tools Studio server resides in a web application server on the database host, while clients connect through a browser from outside. To ensure secure communication between the clients and the server, BR*Tools Studio uses the Secure Hyper Text Transfer Protocol (HTTPS) for communication, based on encryption via Secure Socket Layer (SSL). This method requires a keystore file, which serves as a server certificate for incoming client calls.

End of the note.
- If there is an SSL keystore file already available on the server that you intend to use, keep the corresponding file name and directory and the keystore password available during the installation of BR*Tools Studio.
- If there is no SSL keystore file available, create a keystore file on the server before starting the installation.
  
  Note
  You can create a keystore file using the keytool tool contained in your Java installation. You can find more information on this tool in your Java documentation.
  
  End of the note.
Install BR*Tools Studio in dedicated server or multi-instance server mode:
- Dedicated server mode,
  Log on to your database server as user orasid (UNIX) or sidadm (Windows) and create the following directory as your BR*Tools Studio home directory:
  
  oracle/<SID>/sap/brtools/studio
- Multi-instance server mode
  Log on to the chosen middle-tier host and choose any directory as your BR*Tools Studio home directory.
Move to the home directory of BR*Tools Studio and extract the BR*Tools Studio installation package to the directory with this command:
SAPCAR -xvf BRSTUDIO710EN__XXX.SAR
In your BR*Tools Studio home directory, call one of the following:
- UNIX
  csh setup.csh
- Windows
  setup.cmd
The BR*Tools Studio installer window appears and guides you through the installation process.
If you have installed BR*Tools Studio in multi-instance server mode, change to BR*Tools Studio home directory and install Oracle Containers for Java EE (OC4J) in the following subdirectory:
web-app-server/oc4j/

Oracle Containers for Java EE (OC4J) is available as a download from the Oracle Technology Network (OTN).

In dedicated server mode, BR*Tools Studio automatically uses the installation Oracle Containers for Java EE (OC4J) contained in the Oracle home directory of the database.

Note Note

BR*Tools Studio does not come with its own copy of BR*Tools executables. Instead, it uses the executables already contained on the individual database instances. Therefore, a correctly set-up SAP environment is crucial for BR*Tools Studio to work with each instance after installation

End of the note.

Result

After successful installation, BR*Tools Studio runs “out of the box”. You do not need to do anything else. However, make sure that you read Running BR*Tools Studio for the First Time.