Set Up the SAP SDA Adapter for SAP MII

Set Up the SAP SDA Adapter for SAP MII
Set Up the SAP SDA Adapter for SAP MII
Table of Contents
Set Up the SAP SDA Adapter for SAP MII. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
2
INTERNAL USE ONLY
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Set Up the SAP SDA Adapter for SAP MII
Table of Contents
Set Up the SAP SDA Adapter for SAP MII
The SAP Smart Data Access (SAP SDA) adapter for SAP Manufacturing Integration and Intelligence (SAP MII) can
be used to connect an SAP MII back-end system through SAP SDA to an SAP HANA system. Queries on the SAP
MII side are exposed as virtual tables to SAP HANA. The adapter transforms queries to their virtual tables into
appropriate SAP MII service queries. The results from SAP MII are then transformed into rows of the virtual tables.
The host server of the SAP MII adapter requires a current Java Runtime Environment and an open port for
incoming requests from the SAP HANA engine. The SAP HANA database must be a minimum version of SPS 07.
1.
Unpack the SAR file to a location from which you would like to run the adapter.
The adapter can be started from any location - there is no installation necessary. It is recommended to run the
adapter on the SAP MII server in order to improve the performance of the connectivity from the adapter to
SAP MII. The adapter itself runs as a small process which listens to the configured port for incoming SQL
queries and sends corresponding service queries to an SAP MII system.
The directory structure of the SAR package is as follows:
○
(Package root) /
○
sda_mii_adapter/
○
bin/
○
2.
netprotadapter.jar
○
miiconfig.ini
○
miiconfig_mapping.json
○
netprotadapter_mii.sh
Configure the connection to the SAP MII server.
Before you can start the adapter server you have to configure the connection to the SAP MII server. The file
netprotadapter_mii.ini contains some placeholder values, which need to be replaced by values of your
existing landscape.
<adapterport> Specifies the port the adapter listens to. This is the target port in the SDA configuration of
the SAP HANA system. Make sure that this port is open for incoming requests from the
SAP HANA server.
<miiserver>
Specifies the MII server name or IP address. This is the server the adapter connects to.
<miiport>
Specifies the port for the MII connection.
<miicatalog>
Specifies the initial entry point to search for queries in the MII catalog (projects). It is
recommended to put all queries you would like to expose to the SAP HANA system under
one project node at MII. Replace the default tag name BA:CONC.1 with a valid MII tag
name in the miiconfig_mapping.json file. The tag name is used to get a valid
response from MII during the start-up phase, which can be used to extract the result
structure. The result structure is needed to defined the mapping to a virtual SAP HANA
table.
3.
Create the users.
Set Up the SAP SDA Adapter for SAP MII
Set Up the SAP SDA Adapter for SAP MII
INTERNAL USE ONLY
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
3
Before you start the adapter for the first time, you have to create a user that authenticates the incoming
connection from the SAP HANA server:
java -jar ./bin/netprotadapter.jar -admin "create user <username> password
<password>"
Additionally, you have to configure an SAP MII user name and password. The adapter uses these credentials
to connect the SAP MII server.
java -jar ./bin/netprotadapter.jar -admin "SET MII USER <username> password
<password>"
Optionally, you can create an administration user that allows you to administrate the adapter remotely:
java -jar ./bin/netprotadapter.jar -admin "create user <username> password
<password> admin"
To drop a user or change the password you can use the following commands:
java -jar ./bin/netprotadapter.jar -admin "drop user <username>"
java -jar ./bin/netprotadapter.jar -admin "alter user <username> password
<password>"
4.
Start the adapter.
To start the adapter from command line, run the following command:
java -jar ./bin/netprotadapter.jar -c <configuration file>
For a Linux environment, it is recommended to use a small script, which can start and stop the adapter.
○
Starting:
netprotadapter_mii.sh start <miiconfig.ini>
○
Stopping:
netprotadapter_mii.sh stop
○
Checking the status:
netprotadapter_mii.sh status
○
Restarting:
netprotadapter_mii.sh restart
5.
Configure the remote source in the SAP HANA studio.
a) Start the SAP HANA studio and add a new remote source according to the Adding Remote Data Sources
section of the SAP HANA Administration Guide.
b) In the configuration screen, enter the following information:
4
Source Name: <data source
name>
Specifies a useful data source name.
Adapter Name: HANA (ODBC)
Server: <hostname>
Specifies the name of host where the adapter is running.
INTERNAL USE ONLY
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
Set Up the SAP SDA Adapter for SAP MII
Set Up the SAP SDA Adapter for SAP MII
Port: <port number>
Specifies the port number the adapter is listen to. This port is
configured during adapter installation.
User Name: <user name>
Specifies the user name for the adapter. This user name is configured
during adapter installation.
Password: <password>
Specifies the password for the adapter user. This password is
configured during adapter installation.
Note
Administration Console
You can create an administration user that allows you to administrate the adapter remotely:
java -jar ./netprotadapter.jar -admin " create user <username> password
<password> admin"
With a SQL tool like HDBSQL you can connect to the adapter with the administration user.
hdbsql
-n <host:port> -u <admin user> -p <admin password>
The following administration commands are supported by the adapter:
Command
Description
SET TRACE <LAYER> LEVEL <LEVEL>
<LAYER> = DEFAULT, PROTOCOL, COMMUNICATION, PROTOCOLHANDLER
<LEVEL> = 1,2,3,4,5,6,7,8,9
Sets the trace level for the
adapter log file.
Gets the adapter log file.
GET LOG FILE
EXECUTE PROTOCOLHANDLER COMMAND MII RELOAD CATALOG
Reloads the SAP MII cata­
log information.
Note
Troubleshooting
The adapter writes a log file in its running directory, which contains information that can be used to analyze
problems. Trace levels can be configured in the adapter configuration file.
Related Information
SAP HANA Administration Guide
Set Up the SAP SDA Adapter for SAP MII
Set Up the SAP SDA Adapter for SAP MII
INTERNAL USE ONLY
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
5
www.sap.com/contactsap
© 2014 SAP AG or an SAP affiliate company. All rights reserved.
No part of this publication may be reproduced or transmitted in any
form or for any purpose without the express permission of SAP AG.
The information contained herein may be changed without prior
notice.
Some software products marketed by SAP AG and its distributors
contain proprietary software components of other software
vendors. National product specifications may vary.
These materials are provided by SAP AG and its affiliated
companies ("SAP Group") for informational purposes only, without
representation or warranty of any kind, and SAP Group shall not be
liable for errors or omissions with respect to the materials. The only
warranties for SAP Group products and services are those that are
set forth in the express warranty statements accompanying such
products and services, if any. Nothing herein should be construed as
constituting an additional warranty.
SAP and other SAP products and services mentioned herein as well
as their respective logos are trademarks or registered trademarks
of SAP AG in Germany and other countries.
Please see http://www.sap.com/corporate-en/legal/copyright/
index.epx for additional trademark information and notices.
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising