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.
* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project