Page 1

Applying for and Installing an SAP License Key for BWA

Purpose To use your Business Warehouse Accelerator (BWA) software legally and in accordance with the contractual stipulations, your BWA system can only be operated with an SAP license key granted by SAP.

The SAP license key

is required as of BWA 7.20

is only valid for the assigned hardware and for the maximum number of BWA master blades

you have received is only valid for the specific system you requested it for

is not needed for BWA backup blades

is valid for a limited or an unlimited time period (desired period specified while applying for the SAP license key)

cannot be used for extra systems, but exclusively for the landscape it was purchased for

is needed for BWA test systems, but this license key is free of charge (specified while applying for the SAP license key)

only functions correctly when the date and time is correctly configured on each blade

When do I need to apply for an SAP license key for BWA?

After the BWA system has been initially installed by an SAP hardware partner, it is equipped with a temporary license, which is valid for 90 days. During this 90 days period you have to apply for a permanent license from SAP and install it. After an update the SAP license key is still valid in accordance with the contractual stipulations.

NOTE

The SAP license key will not be installed during an initial installation (by SAP hardware partners) or an update (by SAP customers) of the BWA system. The installation of the SAP license key is performed in a separate installation procedure by either the hardware partner or the customer.

What happens after exceeding the 90 days validity period?

If the 90 days validity period has been exceeded the BWA system stops working. You can get detailed

information about your stopped BWA system in the TREX Admin Tool (standalone): Choose Help License or check the trace log. While your BWA system does not work you can still install your license key.

Procedure ...

1. Installing the SAP Secu Lib

For the license key to work on your BWA system you need the SAP Secu Lib library. It will be installed automatically during a new installation and during a BWA update.

NOTE

If you do not have installed the SAP Secu Lib on your system, the following message will be displayed when you try to install a license key:

"The license key library has not been initialized yet."

Download this library from the SAP Service Marketplace and copy it to the directory

/exe ( is the installation directory for your BWA instance:

/usr/sap//TRX). For detailed information, see SAP

Note 870138.

2. Applying for an SAP License Key for BWA

Information about requesting the license key from SAP is available on the SAP Service Marketplace at http://service.sap.com/licensekey and in SAP Note 94998. To acquire a license key you need to provide the following information:

SAP-System-ID

Page 2

Hardware-Key

Product (=BWA)

Installation Number (if available)

System Number (if available)

To obtain this information for your system you can start the command python license.py

info in directory /exe/python_support. Before you have installed the first license on your BWA system the installation number and the system number are empty.

The license key will be provided in a specific file. This is an example of the content a file with the license key:

----- Begin SAP License -----

SAPSYSTEM=ACC

HARDWARE-KEY=Q1705742050

INSTNO=0120008639

BEGIN=20090715

EXPIRATION=

LKEY=MIIBOwYJKoZIhvcNAQcCoIIBLDCCASgCAQExCzAJBgUrDgMCGgUAMAsGCSqGSIb3D

QEHATGCAQcwggEDAgDDMFgwUjELMAkGA1UEBhMCREUxHDAaBgNVBAoTE215U0FQLmNvbSB

Xb3JrcGxhY2UxJTAjBgNVBAMTHG15U0FQLmNvbSDEb3JrcGxhY2UgQ0EgKGRzYSkCAgGhM

AkGBSsOAwIaBggQXTUAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBT

EPFw0wOTEyMjkwNzQ1MThaffMGCSqGSIb3DQEJBDEWBBRJkad73j3rZMEvhAjsiWGUXGUM

GTAJBgcqhkjOOAQDBC8wLQIVAIUII5TabLeFvQTNLVGgt79NoJ1qAhRz5xPV2Svk7As85p

TQ66MNF7K8QA==

SWPRODUCTNAME=BWA

SWPRODUCTLIMIT=0000000016

SYSTEM-NR=000000000310466641

3. Installing the SAP License Key

a. Installing the SAP License Key in the TREX Admin Tool (standalone)

i. Log on to your BWA system with the user adm user.

ii. Enter cd (in a command prompt).

iii. Enter ./TREXSettings.sh (in a command prompt).

iv. Copy the file with the license key to a directory on your BWA host; for example /exe/python_support

v. Enter ./TREXAdmin.sh (in a command prompt).

vi. Choose Help License Install License

vii. Navigate to the location of the SAP license key file and choose OK (file path for SAP license key file, see step 4 above).

b. Installing the SAP License Key on your BWA System

i. Log on to your BWA system with the user adm user.

ii. Enter cd (in a command prompt).

iii. Enter ./TREXSettings.sh (in a command prompt).

iv. Copy the file with the license key to a directory on your BWA host, for example: /exe/python_support

v. Enter cd /exe/python_support

vi. Enter python license.py inst (file path for SAP license key,

see step 4 above).

4. Displaying the Information about the SAP License Key

To display information about the SAP License Key on your system you have the following options:

Page 3

In the TREX Admin Tool (standalone) you will find the information under Help License.

Perform the corresponded functions (info, status, and list) of the license script (see section Functions of the License Script in this document).

5. Removing the SAP License Key

To remove the SAP License Key, choose Help License Remove License in the TREX Admin Tool (standalone).

Functions of the License Script

In addition to the installation of an SAP license key you can perform below mentioned commands with

the license script license.py. You start the license script license.py in the directory where it is

located, typically /exe/python_support. The syntax is:

python license.py command [options]

Commands Description

info Displays system info needed to apply for a license key no arguments.

NOTE

This information is also displayed in the TREX Admin Tool (standalone):

Help License.

inst Installs license key from file.

Syntax: license.py inst keyfile=

del Removes license keys from the system.

Syntax: license.py del sid= --hwkey= --product=

(e.g. license.py del --all=1 will remove all license keys)

list Lists all license keys installed no arguments.

NOTE

This information is also displayed in the TREX Admin Tool (standalone):

Help License.

status Checks current license no arguments.

NOTE

This information is also displayed in the TREX Admin Tool (standalone):

Help License.

Options Description

filepath SAP license key file path

sid System ID, use wildcard * for any system ID

hwkey Hardware key, use wildcard * for any hardware key

product Software product name, use wildcard * for any product

all all installed license keys