SAP MII - Installation Guide

PUBLICDocument Version: 15.2.0 – 2018-03-25

SAP MII - Installation Guide

© 2

020

SAP

SE o

r an

SAP affi

liate

com

pany

. All r

ight

s re

serv

ed.

THE BEST RUN

Content

1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

3 Preparation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

4 Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8

5 Post Installation Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

6 Follow-Up Activities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17

2 PUBLICSAP MII - Installation Guide

Content

1 Introduction

This guide describes the steps required to install SAP Manufacturing Integration and Intelligence (SAP MII) 15.4 using Software Update Manager (SUM). It specifies the sequence of the installation activities and their dependencies.

Integration

SAP MII 15.4 runs on SAP NetWeaver Java Application Server.

Naming Conventions

In this document, apply the following:

Variable Description

<SAPSID> SAP system ID in uppercase letters

NW 750 NetWeaver Java Application Server

ExampleLog on as user <SAPSID>adm.

If your SAP system ID is C11, log on as user C11adm.

SAP MII - Installation GuideIntroduction PUBLIC 3

2 Planning

To plan your SAP MII installation, do the following:

1. Read all documentation related to SAP MII. See the SAP Help Portsl page at http://help.sap.com/mii2. Verify your system landscape.

For information on the minimal system landscape required for SAP MII, see the SAP MII 15.4 Master Guide.3. You have installed SAP NetWeaver Java Application Server.

If you want to run SAP MII in a cluster, you must configure SAP NetWeaver Java Application Server accordingly and use shared or sticky sessions. For more information, see SAP Help Portal at http://help.sap.com/nwce

4. You have installed SAP ERP 6.0 (ECC 600 – ECC 606) to use the OEE functionality. You have implemented the notes 2088960, 2100514, and 2107505.

NoteMake sure that you import the newest SPAM/SAINT update before starting the installation. For more information about how to update the transaction, see SAP Library for SAP NetWeaver on SAP Help Portal at http://help.sap.com/nw702. Choose SAP NetWeaver SAP NetWeaver by Key CapabilitySolution Life Cycle Management by Key Capability Software Life Cycle Management Software Maintenance Software Package Manager Importing Support Packages with Support Package Manager

Importing a SPAM/SAINT Update . For more information about transaction SAINT, see SAP Note 504134 .

After installing SAP ERP, install the add-on for the OEE application on your application backend system using transaction SAINT.

For details in ERP and their respective releases, refer SAP Note 1804140 .

Additionally, to integrate the Shop Floor Dispatching & Monitoring tool with SAP OEE, the following ERP and their SP releases are required:

SAP ERP Release Support Package

SAP_APPL 617 Standard Release

SAP_APPL 616 02

SAP_APPL 606 07

SAP_APPL 605 10

SAP_APPL 604 13

SAP_APPL 603 12

SAP_APPL 602 13


Planning

http://help.sap.com/mii

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com%2Fnwce

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com%2Fnwce

http://help.sap.com/disclaimer?site=https://launchpad.support.sap.com/#/notes/504134

http://help.sap.com/disclaimer?site=https://launchpad.support.sap.com/#/notes/1804140

3 Preparation

SAP NetWeaver Java Application Server

Install and configure SAP NetWeaver Java Application Server with a Usage Selection of Application Server Java.

JRE

Confirm that you have JRE 1.6 or higher installed on your client machines.

For SAP NetWeaver 7.5, in Java System Properties, on the System VM Parameters tab add the java system property javax.xml.transform.TransformerFactory and set the value as com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl.

Checking Hardware and Software Requirements

The SAP MII 15.4 host machine must meet the requirements for SAP NetWeaver Java Application Server:

● SAP NetWeaver 7.5

NoteEnsure that you install the latest SAPUI5 component available with SAP NW 7.5.

Download SAP MII and OEE Software Components

1. Logon to SAP Support Portal (http://support.sap.com).

2. Choose Download Software Support Packages and Patches A-Z Index X SAP XMII.3. Select the option SAP MII.

4. Select SAP MII 15.4 Comprised Software Component Versions.The MII components, XMII 15.4 and MII_ADMIN and OEE component MFG_MII_CONTENT_15.4 are available.

5. Download the latest SP and patch for both these components.6. Follow the steps as mentioned in the section Installing SAP MII Using Software Update Manager.

SAP MII - Installation GuidePreparation PUBLIC 5

Setting-Up Plant Connectivity (PCo) for OEE Functionality

PCo connects the shop floor to SAP MII. It enables automatic data collection.

The following set up is required for data collection using PCo:

1. Create a transaction for reporting events in SAP MII as follows:

1. On the SAP MII main menu screen, choose Content Development Workbench . Create a new project File New Project .

2. Create a new transaction in the project you created. To do this, choose File New Transaction .

3. Create a transaction property of type xml. To do this, choose Transaction Properties .This is the xml that will be used from PCo.

4. Select the Actions tab and choose SAP_OEE_Integration.5. Select the SAPOEE Service Interface action from the list. Drag and drop the action into the empty

sequence of the newly created transaction.6. Right click on the added action and select Configure.7. Enter the following in the configuration dialog box:

1. Select a Credential Alias. This alias should have required roles to perform reporting.2. Choose Search3. Select the Service and Method name based on the type of reporting to be done. For example,

select ShopFloorDataCollectionService - reportProduction for reporting good quantity.4. Choose OK. In the dialog box that appears asking if you want to generate request/response xml,

choose Yes.8. Right click on the added action and select Links.9. Expand the SAPOEE_Service_Interface_0 and the Request object. For example, expand the

ReportProduction object.10. For example, the following input values will be filled from the PCo xml for ReportProduction:

○ nodeID○ orderNumber○ operationNumber○ dataCollectionElement○ material○ reportingQuantity○ reportingUOM○ rc1 to rc8○ comments○ eventTime

You link the xml input values to the ReportProduction object values.Save the transaction

2. In the PCo server, configure the following:1. Configure the source server.

For more information, see the topics in the Source System section of the application help for PCo at http://help.sap.com .

2. Configure the destination server.For more information, see the topics in the Destination System section of the application help for PCo.

3. Configure the agent instance.For more information, see the topics in the Agent Instance section of the application help for PCo.


Preparation

http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com

4. Configure notification. When creating notification, ensure that you select the SAP MII transaction that corresponds to the event you are notifying.For more information, see the topics in the Notification section of the application help for PCo.

SAP MII - Installation GuidePreparation PUBLIC 7

4 Installation

Prerequisites

You have installed SAP NetWeaver Java Application Server with a Usage Selection of Application Server Java.

To install OEE, ensure that SAP MII is up and running.

Procedure

Installing SAP MII using the Software Update Manager

1. Logon to the SAP Support Portal at Software Logistics Toolset .2. Choose Software Logistics Toolset 1.0.3. Navigate to SUM under documentation tools and choose Updating SAP Systems Using Software Update

Manager 1.0 SP04.4. Choose Update of SAP Systems Using Software Update Manager (Java Systems).5. Follow the instructions as in section Applying Single Component Updates and Patches Using a Manually

Prepared Directory.

Installing OEE using the Software Update Manager

Prerequisites

1. Ensure that SAP MII is up and running:

1. Go to SAP NetWeaver Administration Operations Start & Stop Java Applications . Filter for xapps~xmii~ear.

2. Ensure that the status is Started for the application xapps~xmii~ear.2. To deploy OEEMII sca, the user should have the SAP MII role SAP_XMII_Administrator. Assign this role

to the Administrator user before the deployment of OEEMII sca.

To install OEE, follow steps 1-5 mentioned in the section Installing SAP MII using the Software Update Manager.

After deploying a new .sca file, you must restart your system.

CTC Templates for OEE Management

OEE functionality runs only after the default configuration settings are done. After the .sca file is deployed, user has to run the OEE-specific CTC Templates to perform necessary configurations.

Prerequisites

You have configured SAP ERP to communicate with SAP MII. This involves the following:

● Setting up ALE user● ALE configuration● Other customizing activities


Installation

http://help.sap.com/disclaimer?site=https%3A%2F%2Fsupport.sap.com%2Fen%2Ftools%2Fsoftware-logistics-tools.html

For more information, see ERP-Shop Floor Configuration topic in the SAP OEE application help on the SAP help portal.

The three CTC templates that you must run to setup the system are as follows:

1. SAP OEE NetWeaver Configuration CTC for configuring SAP NetWeaver2. SAP OEE Integration Configuration CTC for configuring OEE Integration Interfaces3. SAP OEE Configuration CTC for OEE configurations

Configuring SAP NetWeaver

This CTC configures SAP NetWeaver with an OEE user who has the required roles to perform all OEE related actions.

You can access this CTC through NetWeaver Administrator Configuration Scenarios Configuration Wizard: SAP OEE NetWeaver Configurations

This CTC performs the following actions:

1. Creates or updates OEE_ADMIN user.2. Assigns the following roles to the OEE_ADMIN user:

○ OEE_SUPERADMIN○ OEE_INTEGRATOR○ SAP_XMII_User○ SAP_XMII_Administrator○ SAP_XMII_Developer○ SAP_XMII_DynamicQuery○ SAP_XMII_Read_Only○ SAP_XMII_Super_Administrator○ SAP_XMII_ProjectManagement○ NWA_SUPERADMIN

The OEE_ADMIN user has the superset of all possible roles to perform all the actions in SAP OEE Management.

3. Collects the following information required to configure the integration between SAP OEE and SAP ERP:

Page / Field Example Value / Comment

Page 1 of 3: Password for OEE_ADMIN user

Page 2 of 3: SAP NetWeaver Instance for SAP MII

SAP NetWeaver Information

SAP MII - Installation GuideInstallation PUBLIC 9


Protocol:

○ http○ https

http

CautionTo use SSL (HTTPS) communication channel, the SAP_XMII_Developer role with the Destination_Service_Write_Permission action must be assigned. Proceed as follows:

1. Log on to SAP NetWeaver Administration and

choose Configuration Security Identity

Management Search Criteria: Role and search for SAP_XMII_Developer.

2. Modify the SAP_XMII_Developer role.

3. Move Destination_Service_Write_Permission to Assigned Actions.

Host miiserver

Port 50000

SSL Port 50001

Page 3 of 3: Confirmation Page

The Last Configuration Step

Configuring SAP OEE Integration Interfaces

The SAP OEE Integration CTC wizard configures SAP MII, and integration-related SAP OEE elements for SAP OEE and ERP integration.

This CTC configures the ERP-Shop floor integration with the following:

● SAP MII schedulers● Workflow configuration● Global configuration● Supported plants

You can access this CTC through NetWeaver Administrator Configuration Scenarios Configuration Wizard: SAP OEE Integration

SAP ERP must be configured manually according to the SAP OEE documentation. For more information, see ERP-Shop Floor Integration Configuration in the SAP OEE application help.


Installation

This CTC collects the following information required to configure the ERP-Shop Floor integration:


Page 1 of 6: JRA Adapter Information

Connection Factory name Enter the connection factory name

Server Enter the ERP server name associated with your OEE plant(s)

Client Enter the ERP client

System Number Enter the ERP system number

Language Enter the ERP logon language

Select to configure EWM Select the checkbox if you want to connect to SAP EWM. Enter the SAP EWM JRA information.

This is required if you want to use Goods Issue and Goods Receipt apps in integration with SAP EWM.

Page 2 of 6: Supported SAP OEE Plant

ERP Plant 2010 – the name of an existing SAP ERP plant to be integrated with SAP OEE Management

SAP OEE_ADMIN Password <SITE_ADMIN's password>

SAP ERP JRA Connector Name JRA Connector Name

SAP ERP Time Zone America/Los_Angeles

SAP OEE Time Zone America/New_York

Page 3 of 6: SAP NetWeaver Instance for SAP MII

SAP NetWeaver Information



Protocol:

● http● https

http

CautionTo use SSL (HTTPS) communication channel, the SAP_XMII_Developer role with the Destination_Service_Write_Permission action must be assigned. Proceed as follows:

1. Log on to SAP NetWeaver Administration and

choose Configuration Security Identity

Management Search Criteria: Role and search for SAP_XMII_Developer.

2. Modify the SAP_XMII_Developer role.

3. Move Destination_Service_Write_Permission to Assigned Actions.

Host miiserver

Port 50000

SSL Port 50001

XMIIIDOC Listener:

● XMIIIDOC01● XMIIIDOC02● ......● XMIIIDOC10

XMIIIDOC01

SAP ERP Connection Information

XMIIIDOC01 Listener

Program ID XMII_ERP3

Server erp3.sap.corp

User VERPSFI_ALE

Password <The user's password>

Client 200

System Number 62

Language EN

Page 4 of 6: SAP MII Schedulers


Installation


Message Dispatcher

Number of Messages (qty) 50

Pattern 0 * * * * * (every minute)

Message Enquequer



Queue Message Cleaner

Message Retention Period (hours) 24


IDOC Inbound Enqueuer



Page 5 of 6: Update Configuration

SAP OEE Integration Workflow Configuration

Pre XSLT Transaction Parameter Specify the SAP OEE relevant operations within a production or process order. You can do this by entering the control key of the operations that are OEE relevant.

An example string is defaulted. You can refer to it to write your own string containing the control keys for the OEE relevant operations.



Post CTC Execution Procedures

Updating the SAP MII Message Listener

1. Log on to SAP MII with the OEE_ADMIN user using the following URL: http://<SAP_MII_host>:<SAP_MII_port>/XMII.

2. In the SAP ERP OEE Integration menu, choose SAP MII Configuration Message Listeners .3. Select the XMIIIDOCnn that has been recently configured with the CTC wizard.

4. On the Details Configuration tab page, if the SAP Server name and SAP Client numberare blank, choose Update.


5. On the Details Status tab page, verify the connection status.If SAP MII Listener XMIIIDOCnn status is Not Connected, check if SAP ERP system is accessible and correct credentials are defined in SAP NetWeaver XMIIIDOCnn resource adapter properties. If you cannot access the ERP system, resolve connection issues and then update the Message Listener in SAP MII.

NoteIf you notice any incorrect configurations in SAP NetWeaver XMIIIDOCnn resource adapter properties, we recommend that you re-execute the SAPOEE INTCTC wizard with correct values.

SAP OEE Configurations

This CTC can be run with the user OEE_ADMIN that was created when you run SAP OEE NetWeaver Configuration CTC or a user who has the role OEE_SUPERADMIN assigned.

This CTC configures the system defaults for OEE such as activities, production operator dashboard (POD) and so on.

You can access this CTC through NetWeaver Administrator Configuration Scenarios Configuration Wizard: SAP OEE Configurations .

This CTC performs the following actions:

1. Creates default loading statuses along with descriptions in the languages supported by SAP.2. Creates default activities along with descriptions in the languages supported by SAP.3. Creates default dashboards along with default buttons, their associated activities and their descriptions in

the languages supported by SAP.4. Creates default Customization names along with their allowed values (if applicable) and their descriptions

in the languages supported by SAP.5. Collects the following information required to configure the system defaults for OEE:


Page 1 of 2: ERP Client and Plant Information

ERP Plant 2010 – the name of an existing SAP ERP plant to be integrated with SAP OEE Management

ERP Client The ERP Client where the above Plant is configured



NoteIn a clustered environment, access SAP OEE CTC via the Webdispatcher URL for this SAP NetWeaver system.

Re-Executing CTC templates

If any of the SAP OEE CTC wizard was interrupted for any reason, resolve the root cause issue and re-execute the SAP OEE CTC wizard.


Installation

In Configuration Tasks view, choose Show Category All Configuration Tasks . Select appropriate SAPOEE Integration task, and choose Re-execute.

Do not use the Resume or Takeover Session buttons to continue with any of the SAP OEE CTC templates. If any template is in the Currently Executing status, choose Show Category Running Configuration Tasks . Select appropriate task and choose Cancel Process.

After SAP OEE CTC templates are executed, one SAP OEE plant is configured. To configure multiple SAP OEE plants, execute CTC templates SAP OEE Integration and SAP OEE Configurations for each plant.

To make minor corrections or modifications in the current configurations manually, see Configuration of SAP OEE Integration Interfaces athttp://help.sap.com SAP Manufacturing Integration and Intelligence SAP OEE Management ERP-Shop Floor Integration .


http://help.sap.com/disclaimer?site=http%3A%2F%2Fhelp.sap.com

5 Post Installation Activities

1. Log on to the SAP User Management Engine in SAP NetWeaver as an administrator.The following are the default SAP MII roles and their permissions:○ SAP_XMII_User

Users assigned to this role have read access but no access to administration screens or the SAP MII Workbench.SAP_XMII_DeveloperUsers assigned to this role have access to the SAP MII Workbench and some administration screens, such as Time Periods, Connection Store Editor, and Credential Store Editor.

○ SAP_XMII_AdministratorUsers assigned to this role have the same permissions as users assigned to the SAP_XMII_User and SAP_XMII_Developer roles, plus administration access except for the following: NWDI integration configuration, encryption configuration, and import and export of configuration data.

○ SAP_XMII_Super_AdministratorUsers assigned to this role have access to all SAP MII functions with no limitations.

○ SAP_XMII_Read_OnlyUsers assigned to this role have read permission for administration screens and access to the SAP MII Workbench without save permission.

○ SAP_XMII_DynamicQueryUsers assigned to this role have permission to run dynamic queries (queries without a query template). By default, this permission is granted to users assigned to the SAP_XMII_Developer role but not the SAP_XMII_User role. You can assign this role to specific or all users.

○ SAP_XMII_PIM_Super_AdministratorUsers assigned with this role have full access to the entire plant hierarchy and can perform all operations. Super Administrators can assign Node Admins in PIM Node Admin tab.

○ SAP_XMII_PIM_AdministratorUsers assigned with this role can be added as Node Admins for PIC Node. Only Super Administrators have access to assign Node Admins. Node Admins have full access to perform all operations for that node. Node Admins can assign other User Groups and give relevant authorizations to perform operations on that node.

NoteYou can update role mappings by changing the actions assigned to the role. You can create new roles that have access to a particular screen.

1. Assign your users to a role.

NoteYou must assign all users to the SAP_XMII_User role.

2. Close the SAP user management engine.


Post Installation Activities

6 Follow-Up Activities

To check your SAP MII 15.4 installation, complete the following steps:

1. Enter http://<server>:<port>/XMII in your browser window.The Welcome screen appears.

2. Enter your user ID and password.3. Choose Log on.

The SAP MII administration menu appears.

SAP MII - Installation GuideFollow-Up Activities PUBLIC 17

Important Disclaimers and Legal Information

HyperlinksSome links are classified by an icon and/or a mouseover text. These links provide additional information.About the icons:

● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your agreements with SAP) to this:

● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any

damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this information.

Videos Hosted on External PlatformsSome videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within the control or responsibility of SAP.

Beta and Other Experimental FeaturesExperimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use the experimental features in a live operating environment or with data that has not been sufficiently backed up.The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example CodeAny software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of example code unless damages have been caused by SAP's gross negligence or willful misconduct.

Gender-Related LanguageWe try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.


Important Disclaimers and Legal Information

SAP MII - Installation GuideImportant Disclaimers and Legal Information PUBLIC 19

www.sap.com/contactsap

© 2020 SAP SE 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 SE or an SAP affiliate company. The information contained herein may be changed without prior notice.

Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP or SAP affiliate company 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 SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies.

Please see https://www.sap.com/about/legal/trademark.html for additional trademark information and notices.

THE BEST RUN

https://www.sap.com/about/legal/trademark.html

SAP MII - Installation Guide

Documents

Transcript of SAP MII - Installation Guide