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
<BWA_DIR>/exe (<BWA_DIR> is the installation directory for your BWA instance:
/usr/sap/<sapsid>/TRX<instance_number>). 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 <BWA_DIR>/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 <sapsid>adm user.
ii. Enter cd <BWA_DIR> (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
<BWA_DIR>/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 <sapsid>adm user.
ii. Enter cd <BWA_DIR> (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:
<BWA_DIR>/exe/python_support
v. Enter cd <BWA_DIR>/exe/python_support
vi. Enter python license.py inst <filepath> (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 <BWA_DIR>/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=<filepath>
del Removes license keys from the system.
Syntax: license.py del sid=<sid> --hwkey=<hwkey> --
product=<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