M3coretech 13.4.0 M3coreig Windows En-Us
M3coretech 13.4.0 M3coreig Windows En-Us
M3coretech 13.4.0 M3coreig Windows En-Us
Windows
Release 13.4.0
Copyright © 2023 Infor
Important Notices
The material contained in this publication (including any supplementary information) constitutes and contains
confidential and proprietary information of Infor.
By gaining access to the attached, you acknowledge and agree that the material (including any modification,
translation or adaptation of the material) and all copyright, trade secrets and all other right, title and interest
therein, are the sole property of Infor and that you shall not gain right, title or interest in the material (including
any modification, translation or adaptation of the material) by virtue of your review thereof other than the
non-exclusive right to use the material solely in connection with and the furtherance of your license and use
of software made available to your company from Infor pursuant to a separate agreement, the terms of which
separate agreement shall govern your use of this material and all supplemental related materials ("Purpose").
In addition, by accessing the enclosed material, you acknowledge and agree that you are required to maintain
such material in strict confidence and that your use of such material is limited to the Purpose described above.
Although Infor has taken due care to ensure that the material included in this publication is accurate and
complete, Infor cannot warrant that the information contained in this publication is complete, does not
contain typographical or other errors, or will meet your specific requirements. As such, Infor does not assume
and hereby disclaims all liability, consequential or otherwise, for any loss or damage to any person or entity
which is caused by or relates to errors or omissions in this publication (including any supplementary
information), whether such errors or omissions result from negligence, accident or any other cause.
Without limitation, U.S. export control laws and other applicable export and import laws govern your use of
this material and you will neither export or re-export, directly or indirectly, this material nor any related
materials or supplemental information in violation of such laws, or use such materials for any purpose
prohibited by such laws.
Trademark Acknowledgements
The word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/or
related affiliates and subsidiaries. All rights reserved. All other company, product, trade or service names
referenced may be registered trademarks or trademarks of their respective owners.
Publication Information
Release: Infor M3 Core Technology 13.4.0
Publication Date: November 27, 2023
Document code: m3coretech_13.4.0_m3coreig_windows_en-us
Contents
Contents
Apply Fixes....................................................................................................................................................80
Update Environment with Delta Languages...............................................................................................82
Applying MI metadata..................................................................................................................................83
Run Fix Programs..........................................................................................................................................84
Install M3 Foundation Information Reader.....................................................................................................85
Install M3 Web Services....................................................................................................................................85
Install the M3 Web Services application......................................................................................................85
Verify that the MWS Grid application is running.........................................................................................86
Install Infor Enterprise Collaborator...............................................................................................................86
Setting the Central File folder......................................................................................................................86
Installing IEC Database................................................................................................................................87
Attaching IEC Database................................................................................................................................88
Installing IEC in Infor ION Grid.....................................................................................................................88
Verifying IEC Server installation..................................................................................................................91
Adding full control access to the Central File folder...................................................................................92
Installing IEC Client tools.................................................................................................................................92
Installing Partner Admin tool.......................................................................................................................93
Verifying Partner Admin tool installation....................................................................................................93
Troubleshooting...........................................................................................................................................94
Installing Business Document Mapper........................................................................................................94
Starting and verifying Business Document Mapper installation...............................................................96
Installing Flat File Definition tool................................................................................................................96
Verifying Flat File Definition tool installation.............................................................................................96
Install M3 Financial Business Messages..........................................................................................................97
Installing Financial Business Messages.......................................................................................................97
Install M3 BOD Processor.................................................................................................................................98
Installing M3 BOD Processor........................................................................................................................98
Install Workflow Executor................................................................................................................................98
Installing Workflow Executor.......................................................................................................................98
Install M3 Adaptation Kit..................................................................................................................................99
Installing M3 Adaptation Kit through LifeCycle Manager...........................................................................99
Install M3 Metadata Publisher.......................................................................................................................100
Installing M3 Metadata Publisher..............................................................................................................100
Selecting a database for MDP installation................................................................................................101
Chapter 6: Post M3 SW Component installation...........................................................................103
Version Log
The version log describes the changes between versions of this document.
Contacting Infor
If you have questions about Infor products, go to Infor Concierge at https://
mingle-portal.us2.prd3.inforcloudsuite.com/v2/CONCIERGE_PRD and create a support incident.
For the latest documentation, go to Documentation Central at docs.infor.com. We recommend that you check
this website periodically for updated documentation. If you have comments about Infor documentation,
contact documentation@infor.com.
What is M3 Core?
For companies in the business to Make, Move and Maintain products, Infor M3 provides the tools they need
to manage their operations. With the full system, they can monitor transactions throughout their organization,
including manufacturing operations, supply chain activities, customer and supplier relationships, warehouse
and distribution processes and, of course, financial management. Infor M3 consolidates these into one
coherent view of operations.
While the complete M3 Solution is made up of several different Software Components, where some are unique
for just a certain industry or micro vertical, there are a number of components that will be common for all
M3 installations no matter for what industry. These components are gathered under the Product Family
named M3 Core.
This guide will be covering the necessary steps to install these components, M3 Core.
M3 Core
M3 Business Engine
M3 Financial Business Messages
M3 Core Infrastructure and Technology
LifeCycle Manager
ION Grid
Session Providers
M3 Core Technology
Grid Database Connectivity (GDBC)
Event Hub
Event Analytics
M3 UI Adapter
H5 Enterprise
M3 Foundation
Web Services Runtime
Infor Enterprise Collaborator (IEC)
BOD Processor
Workflow Executor
M3 Adaptation Kit
M3 Metadata Publisher
These guides cover all necessary aspects and steps to establish the installation of the components above and
can be found on docs.infor.com.
Knowledge Prerequisites
To install M3 Core, you must have:
• Experience installing and administering operating systems.
• Experience installing and administering databases.
• Experience working with user authentication management.
• Experience installing and administering networks.
• Experience installing and configuring applications
Prerequisites
M3 Core requires certain hardware and software components to run properly.
• Ensure that all necessary preparatory steps that are outlined in the M3 Core Installation Planning Guide
have been carried out.
Use the handover document to install M3 Core using this M3 Core Installation Guide.
This chapter contains information on installing LifeCycle Manager and its components.
7 Select the destination folder or browse to another location. Ensure that the selected destination folder
does not contain any folder named LCM-Server.
8 Click Next.
9 Select the path or browse to another location for the Java JDK installation to use for the LifeCycle Manager
Server.
10 Click Next.
11 Specify this information:
Server host:
Select the server IP address or hostname.
If you select to install the LifeCycle Manager Server using the server's hostname instead of IP address,
ensure that name resolution is working on your network. The server hosting LifeCycle Manager Server
must be accessible from both the hosts where LCM Services will be installed and from the LifeCycle
Manager Client computers using the LifeCycle Manager Server hostname or FQDN.
Base port:
Accept the default value (4060) if not in use, or specify a base port number for a range of four ports that
will be used for LifeCycle Manager Server communication.
12 Click Next.
13 Specify this information to set up the backup strategy for the LifeCycle Manager Server:
Note: Ensure that a backup of the LifeCycle Manager Server installation directory is frequently created
and verified in case of a crash of the server where LifeCycle Manager Server is installed.
Configure backup routines
If you select No, all the backup routine parameters are disabled. If you select to configure backup routines
later, you must configure the backup routines directly in the lcm.properties file located in the folder of
the LifeCycle Manager Server installation. For more information about the backup settings in lcm.prop
erties, see LifeCycle Manager Administration Guide.
Backup path
Specify the destination where the backup should be placed. Specify the IP address or name of the remote
server and folder name. The folder name must already exist because it will not be automatically created.
Note: Ensure that the server used for backup of LifeCycle Manager Server is frequently backed up. We
recommend that you use a server that is frequently backed up, for example the M3 Home server or the
M3 Database server if applicable.
Backup user
Specify the user who has necessary privileges to access and create files on the server where the backup
will be created.
If the backup server is a member of a domain, specify Domain\User. If the backup server is not a member
of a domain, then specify Server\User.
14 Click Next to display the LDAP Configuration window and select whether to use Manual configure for a
central LDAP server or a pre-configured AD LDS instance.
15 Consider these options:
• If you plan to install LifeCycle Manager using your existing LDAP server, perform the task Completing
the installation using a manual LDAP. For more information, see LifeCycle Manager LDAP
considerations in the M3 Core Installation Planning Guide.
• If you want to install a pre-configured AD LDS instance, perform the task Completing the installation
using a pre-configured AD LDS instance. For more information, see AD LDS in LifeCycle Manager.
LDAP port
Specify the host port of the LDAP server.
SSL enabled
Optionally, select Yes or No depending on whether a secure socket communication is enabled in the
LDAP server.
3 Click Next.
4 Specify this information:
User prefix
Specify the attribute that LifeCycle Manager will use to display the user name of users in the directory
service.
Group prefix
Specify the attribute that LifeCycle Manager will use to display the group name of groups in the directory
service.
User suffix
Specify the base distinguished name which indicates the starting point for LDAP searches of users in the
directory service.
Group suffix
Specify the base distinguished name which indicates the starting point for LDAP searches of groups in
the directory service.
These values are written in the LCMInstallDir\LCM-Server\lcm.properties file. You can use a text editor
to change values if you make a mistake during the installation, or want to change values later. The server
must be restarted after the values in the lcm.properties file have been changed.
5 Click Next. The Service Account window is displayed prompting you to select whether to create a new
service account user or to use an already existing user.
6 Perform one of these options:
• Click Yes to create a new service account user, go to step a.
• Click No to select an existing user, go to step b.
a Specify this information:
Service account user
Specify the name of the user.
Retype password
Specify the password.
Retype password
Specify the password.
We recommend that you use the host name of the application server.
LCM Service IP
Specify the computer IP address where the LifeCycle Manager Service must be installed. If the computer
is set up to use Dynamic Host Configuration Protocol (DHCP), specify the FQDN instead. Ensure that you
specify an external IP number.
8 Press Enter to finish the installation and start the LifeCycle Manager Service.
9 Check the Windows Services to ensure that the LifeCycle Manager Service you installed is started.
Note: Perform these actions to start and stop the LifeCycle Manager Service:
Start: Start the Windows Service LCM-Service:service_name.
Stop: Stop the Windows Service LCM-Service:service_name.
7 Click Next.
8 Select to Install a new client.
9 Specify a name for the new client. This name will be the name of the shortcut created and the name of
the folder where this client will be installed.
10 Click Next.
11 Select the destination folder or browse to another location. Ensure that the selected destination folder
does not contain any folder with the same name as your LCM Client (for example, LCM-Client).
12 Consider these scenarios before selecting the Installation Directory:
• If you install the LifeCycle Manager Client in the Program Files directory and UAC is enabled, it is
required that you start the LifeCycle Manager Client using an Administrator account. We recommend
that you change the compatibility level first before starting the application. For more information,
see Changing the Compatibility Level in the M3 Core Administration Guide.
• If you install the LifeCycle Manager Client in the Program Files directory and UAC is enabled, but you
do not want to change the compatibility level, you must start the LifeCycle Manager Client by selecting
the Run as administrator option. For more information, see Logging on to the LifeCycle Manager
Client on page 20.
• If you install the LifeCycle Manager Client in a folder that does not require administrative rights, no
further steps are needed to start and run the LifeCycle Manager Client.
LifeCycle Manager Client shortcut (for example, LCM-Client) and select Run as administrator from the
menu.
2 Specify this information:
User
Specify your LifeCycle Manager user name.
Note: The next steps required that the user is a member of the LCMAdmins group.
Password
Specify the corresponding password for the user.
Server
Specify the IP address or domain name of the LifeCycle Manager Server.
Port
Specify the LifeCycle Server port number. The default value is 4060.
Workspace
Accept default path to the workspace, or click Browse to select a different workspace location.
3 Click Log On. The server certification information window is displayed when the LifeCycle Manager Client
connects to a server for the first time.
4 Click Yes to accept the certificate.
5 Click Yes to update the client then click OK to restart LifeCycle Manager.
6 Specify the required information and click Log On. LifeCycle Manager is now started. A dialog box is
displayed if a new Java configuration file for Grid applications is available on the CCSS server.
7 Click Yes to review the changes. A compare window is displayed.
8 Click Apply New Version to apply the new configuration file.
For more information regarding Retrieving Grid Java Configuration, see LifeCycle Manager Administration
Guide.
Note: If you attempt to log on to a version of LifeCycle Manager Server earlier than 10.1.2.0 using your
newly installed client, a message is displayed informing you that an earlier version of LifeCycle Manager
Client is required to connect to that server.
Description
Specify a description.
Installation Path
Select the path to your JDK installation. For example, E:\jdk1.8.0_202_32.
5 Click Next.
6 On the Summary screen, verify the property values and click Finish to start the task.
7 Click OK.
To view the log file, either click View log or go to the Logs view.
Description
Specify a description for your middleware.
Note: This field is optional and is only applicable if installing M3 Business Engine database on this server.
If you have selected to attach the middleware on an external host, then this field will be disabled.
5 Click Next.
6 On the Summary screen, verify the property values, and click Finish to start the task.
7 Click OK.
To view the log file, either click View log or go to the Logs view.
Note: To change the default folders for the database files for a M3 BE environment before you install the
environment: Right-click the SQL Server instance and select Change default root directory for database
files.
Setting up a space
The ION Grid installation must be installed into a LifeCycle Manager space.
Verify that an appropriate space is displayed in the Applications tab of the LifeCycle Manager.
The LifeCycle Manager installation has three pre-defined spaces:
• Production
• Test
• Development
These spaces correspond to a default set of environments in a M3 Core installation. If your M3 Core installation
requires additional environments, you must create a corresponding space in the LifeCycle Manager Client
before you create the new environment.
To create a new space, go to the Applications tab in LifeCycle Manager Client and click the Manage Spaces
icon. Note that the space abbreviation name is used in both the Infor ION Grid and the M3 Business Engine
environment installation.
For more information, see Managing spaces in the LifeCycle Manager Administration Guide.
All installation files for M3 Core must be downloaded before installation can start.
Applying update
1 Download the installation files for M3 Business Engine, M3 Financial Business Messages, Infor ION Grid,
Session Providers, and M3 Core Technology from the Infor Download Center.
We recommend that you store all the downloads on the M3 Home Server where LifeCycle Manager Server
is installed.
2 Log on to LifeCycle Manager with a user that is a member of the LifeCycle Manager administrator's group.
3 In LifeCycle Manager Client, click Admin > Upload Products.
4 On the Manage Products page, click Upload and select these packages to upload:
• Grid_Installer_11.1.13.x.x.lcm
• Session_Providers_11.1.13.x.lcm
• SAML Session Provider 1.14.x.zip
• M3Core_Technology_13.x.x.lcm
• M3BusinessEngine_x.x.zip
• help_m3beud_E361_15.1.x.x.zip
Replace x.x with the available version to be installed.
5 Click Open.
6 In the Verifying package window, click Yes to accept to register the packages on the LifeCycle Manager
Server.
7 Click OK.
8 When the dialog appears asking you if you want to update your client, click Yes.
9 When the update is done, a dialog that shows the need to restart the client is displayed. Click OK.
10 Log on again.
Retrieving fixes
Use this procedure to retrieve and install available fixes handled by LifeCycle Manager from a Customer
Correction Self Service (CCSS) channel.
For more information about the types of fixes, see Types of fixes in the LifeCycle Manager User Guide available
in the LCM Client (Help > Help Contents) and in the M3 Core Infrastructure and Technology online
documentation available at docs.infor.com.
You may need to set up access to the CCSS server before you can retrieve fixes.
For example, if your organization uses a proxy server to access the internet, you must first set up LifeCycle
Manager to recognize the proxy. Review the guidelines and procedures in Managing access to the CCSS server
in the LifeCycle Manager User Guide.
1 Log on to LifeCycle Manager.
2 Select Actions > Retrieve Fixes. The Retrieve Fixes tab is displayed.
3 Click Retrieve and apply all available fixes.
4 Click Yes to confirm.
5 Specify a valid user name and password. Use your Infor Support Portal credentials.
6 Click OK.
7 A notification will be displayed informing that the LCM Client needs to be updated. Select to update and
restart the LCM Client.
3 On the Documentation page, click the link to launch the M3 BE User Documentation infocenter.
4 Save the URL.
5 Provide the URL to the Infocenter when prompted during the installation of M3 UI Adapter, or when
configuring the Infocenter in Smart Office.
Description
Specify a description for the grid.
Database server
Specify the hostname for the database.
Schema
The name of the database schema to create (optional)
- or -
6 On the Create schema in existing database window, specify this information:
Existing database
The database, previously created through Lifecycle Manager, that the new schema should reside in
Schema
The name of the database schema to create
JDBC user
Existing user that will run the grid database
JDBC password
The JDBC user's password
- or -
7 On the Use existing database window, specify this information:
Existing database
The name of the database instance
Schema
The name of the database schema, if used
JDBC user
The JDBC user name
JDBC password
The JDBC user's password
JDBC URL
Enter the URL to connect to the database.
Examples:
• SQL Server – jdbc:sqlserver:// host_fqdn:port; databaseName= yourDBname,instance= instanceName
Oracle – jdbc:oracle:thin:@// host_fqdn:port/ service
DB2 on IBM i - jdbc:as400:// host_fqdn/ relationalDatabaseName;errors=full;prompt=false For
example: jdbc:as400://abc008.
8 On the Initial Host window, specify the values for these fields and click Next:
Host
Select the initial host in your grid. This is the name the grid will use to identify this host.
Host Description
Type a description for this host.
Internal Address
Select the IP address of the host. This address will be used by the grid to connect this host to the rest of
the grid.
External Address
Select the FQDN of the host.
JDK
Initial installation of a host on the Windows platform require two JVMs to be installed; One 32 bit and
one 64 bit. The other platforms only require a 64 bit JVM.
Select the JDK to be used to run this grid. Java 8 is required when SAML Session Provider 1.14.x is used.
When installing the Grid Host on the M3 Business Engine Application Server, this Grid Host must be
installed with a 32-bit JVM.
9 On the Assign Ports window, specify or accept values for the following and click Next:
Assign ports manually
Select this check box if you want to enter the port numbers manually rather than going with the
pre-assigned values. You will not be able to edit the other port fields unless you select this check box.
Starting Port
Select the base for a range of ports to be used by the grid.
Address
This read-only field shows the internal IP address for the grid.
Registry Port
Accept the default port number or type another port number for the registry. It needs to be accessible
from all hosts in the grid.
Address
This read-only field shows the FQDN for the grid host.
Router Port
Accept the default port number or enter another port number for the administrative router. The
administrative router is the default way to access the grid from the outside, and so this port must be
accessible from outside the grid.
HTTPS Port
The HTTPS port to use for the administrative router.
Address
This read-only field shows the external IP address for the grid. It is the default router address, which is
the main entry point for external clients. It is used for external HTTP/HTTPS traffic, and the default SSL
certificate for this host is based on this.
HTTP Port
The HTTP port to use.
HTTPS Port
The HTTPS port to use.
If you chose to select the ports manually, a check will verify that the ports are available and you will be
notified if a port conflict is detected.
10 On the Summary window, verify the properties provided.
Click Finish.
Preparing users
To provide a seamless user handling, IFS, AD FS and SAML Session Provider must be configured consistently.
See "Users in M3" in M3 Core Installation Planning Guide.
When ION is installed, the user property IFS Person ID is added to IFS. This property must be populated with
a unique value for each user, corresponding to the M3 user.
Important: A user that has the Person property set to MVXSECOFR must be configured and able to log on, in
order to configure M3 BE.
On a high level, these steps must be completed for users to get the correct names for accessing M3 BE. Detailed
instructions for each step are found in subsequent chapters.
Preparing users
1 The property IFS Person ID must be configured in IFS for each user. This value must correspond to the
field User in 'User.Open' (MNS150) in M3 BE, and can have a maximum length of 10 characters. See User
management in Infor Ming.le on page 34.
2 Configure AD FS to forward Person as a claim as described in Install the SAML Session Provider using
LifeCycle Manager on page 36.
3 Configure the SAML Session Provider to use Person claim: http://schemas.infor.com/claims/Person as
identity, as described in Install the SAML Session Provider using LifeCycle Manager on page 36.
To add users manually or to import users, see section "Manage Users" in the Infor Operating Service
Administration Guide. For importing users, also consider Importing M3 users in Infor Ming.le 12 on page 35.
To configure synchronization of users from the AD, see section "AD Parameters" in the Infor Operating Service
Administration Guide.
When considering how to add users, you must take into account how to set up the IFS Person ID. The IFS
Person ID property must be set for each user that should access M3. This can be done in three different ways:
• Manually during user import, as described in Importing M3 users in Infor Ming.le 12 on page 35
• Manually as described in Manual configuration of the property IFS Person ID on page 35
• Automatically as described in Automatic configuration of the property IFS Person ID on page 35
Note: The IFS Person ID property must be set with a unique value for each user. There is no functionality in
IFS that guarantees uniqueness. This must be validated before setting the property values.
If there is an AD attribute that is suitable for the IFS Person ID values, but needs to be overridden with
the value MVXSECOFR for a user, that is possible. If this scenario applies, you must configure this user
before configuring the custom AD attribute and synchronizing the other users.
a Enable editing of the IFS Person ID field.
b Add the user manually as described in Manual configuration of the property IFS Person ID on page
35.
2 Map the property IFS Person ID to a custom AD attribute
a Access Infor Ming.le as a user with the IFSApplicationAdmin role.
b Click the user icon, and select User Management.
c Click Security Administration> IFS Person ID.
d Click No Automatic Setting to enable configuration of the AD attribute to use.
e In External Name, select the AD attribute to use for the M3 user name.
f Click the save icon to save the configuration.
Note:
The configuration will only take effect for users that are added after this procedure.
Note: Before you start the installation, retrieve the latest version of the SAML Session Provider 1.14 from
CCSS. The JDK on the hosts where SAML Session Provider should run must be Java 8 for integration with Infor
OS to work properly.
Router IP Address
The external IP address of the router.
5 On the Session Provider Properties window, specify the information and click Next:
IdP FQDN
The fully qualified domain name of the AD FS server.
Metadata URI
Provide the URI to the federation metadata. The default AD FS value is /FederationMetadata/2007-06/
FederationMetadata.xml. The URI can found in the AD FS management console:expand
"Service">"Endpoints". In the Metadata section, find the URL Path for the FederationMetadata.
The Secondary Identity Provider properties are only applicable in cloud scenarios.
After you click Next, the installer will get the SSL certificates from the AD FS server and you will have to
confirm them before continuing. The installer will retrieve the AD FS metadata and parse it for suggested
values for a later installation step.
6 On the IFS Properties window, specify the information and click Next:
IFS FQDN
Specify the FQDN for IFS.
Farm name
The name of the farm for the used InforOS installation.
Platform ID
The platform ID of the farm for the used InforOS installation.
Purpose
A very short (4-10 characters) description of the purpose of the setup. This will be part of the application
name in IFS and the Relaying Party Trust in AD FS for easier identification.
After you click Next, the connection to IFS web services is validated and the credentials tested.
7 In the SAML Properties window, configure Identity Claim name, and click Next.
Identity Claim name
Change the value to http://schemas.infor.com/claims/Person
8 Review the values on the Summary window and click Finish to start the installation.
9 The application must now be activated manually in the Infor OS Manager. To do this, follow these steps.
For more information, see Completing claims-based authentication configuration in Infor Operating
Service Installation Guide.
a Open Infor OS Manager for the correct farm.
b Select Applications.
c Identify the application corresponding to your SAML Session Provider installation, in the format
Grid-<Purpose> where <Purpose> is the value provided for the Purpose field in the IFS properties
window.
d Click the download link for this application to save a powershell script.
e Run the script on the AD FS server.
See AD FS server configuration in Infor Operating Service Installation Guide.
10 Continue with the procedure Adding Assertion Consumer Service endpoint to AD FS on page 39.
Initial Configuration
By default, the installation will set up one or two assertion consumer service endpoints in the configuration:
one for the FQDN of the SAML router for the HTTP-POST binding and optionally one for the IP address of the
SAML router if an IP address was provided during installation. Unfortunately, only one of these can be
automatically set up in the IdP. The installation must therefore be completed with a manual step, as described
in the installation procedure for the SAML Session Provider. See Adding Assertion Consumer Service endpoint
to AD FS on page 39.
3 On the Install window, select the location for the Grid Database Connectivity:
Name
Select the grid on which the grid extension should be installed.
Click Next.
4 On the Install Grid Database Connectivity window, enter values for the following:
Host
The host for the grid extension.
H2 port
The port for the H2 database used by GDBC.
Click Next.
5 On the Summary window, verify the properties provided.
Click Finish.
a Click on the Value link for the broker.driverDirName property and click Add New Entry.
b Enter the Grid application name into the Application column, for example, EventHub, CLM or
MangoServer (Smart Office server).
c Enter the driver directory name. This is the Driver Name and can be retrieved from the Drivers page
in the GDBC management pages.
d Select the Merge radio button.
e Click Save.
10 When you have entered values for the properties, click Save at the top of the Application Properties page
and then click Save again on the confirmation dialog box.
11 Restart the application to put the changes into effect.
Recorder host
Select a host where to start the event recorder.
The event recorder is started on demand when a recoding session is created.
SSL Port
Accept the default or specify a unique port.
Host
Select the host where to install Event Analytics.
Install M3 UI Adapter
Ensure that your Infor ION Grid is started.
Installing M3 UI Adapter
Use this procedure to install M3 UI Adapter. To use the installation wizards, the user must be a member of
the LifeCycle Manager administrator group.
Note: See Installation considerations for M3 UI Adapter in M3 Core Administration Guide. There is no upgrade
path from the previous 10.2.x versions of M3 UI Adapter to versions 10.3.x. The only possible upgrade is from
version 10.3.0.0 to version 10.3.1.0.
1 In LifeCycle Manager, locate the Grid instance where you want to install M3 UI Adapter.
2 Right-click the Grid instance > Install Product.
3 On the Install window, select M3 UI Adapter <version> and click Next.
4 Specify a description for the M3 UI Adapter installation and click Next.
5 Select the host(s) where M3 UI Adapter will be installed and click Next.
6 Specify this information:
Database server
Select MS SQL.
7 Click Next.
8 Specify this information:
Database Location
Select the location where the MUA database files will be created.
Note:
This field is disabled when Attach database is selected.
9 Click Next.
10 Specify this information:
M3 BE User Documentation URL
Specify the URL of the M3 Business Engine User Documentation Infocenter.
Note: The URL to the Infocenter must be in https. Make sure that the Infocenter has a valid SSL certificate,
or that the certificate is added properly to the Trusted Root Certification Authorities of the browser.
See Verify the M3 BE User Documentation Infocenter on page 26.
Entities URL
Specify the entire URL.
This URL is used to retrieve the list of IDM entities and must have this format
https://hostname:port/ca/api/datamodel/entities.
For example, https://172.30.162.87:10080/ca/api/datamodel/entities
Note: H5 Mashups and SDK Applications need to use a proxy to connect to IDM. For more information
about the installation of IDM proxy, see instructions in the M3 Core Administration Guide.
11 Click Next.
12 On the Summary page, review information and click Finish. When a notification appears stating that
installation has finished successfully, click OK or click View log.
When the installation is completed, M3 UI Adapter appears in the list of Grid applications. The M3 UI
Adapter and the M3 BE environment installations will be automatically connected after they are installed
in the same Grid.
Refresh the client and verify that the application is already started.
Note: After the installation, you must configure the role first in order to log in to M3 UI Adapter. See
instructions in Setting M3 UI Adapter users in the M3 Core Administration Guide.
Database
Select the required database, and then click Next.
5 Specify user and password for the database user. Click Next.
6 On the Summary page, review information and click Finish.
Install M3 H5
Ensure that your Infor ION Grid is started.
Installing M3 H5 Enterprise
Use this procedure to install M3 H5 Enterprise.
1 In LifeCycle Manager, locate the Grid instance where the latest version of M3 UI Adapter is installed.
2 Right-click the Grid instance > Install Product.
3 On the Install window, select M3 H5 Client Enterprise <version> and click Next.
4 Select the host(s) where M3 H5 will be installed and click Next.
5 On the Summary page, review information and click Finish. When a dialog box is displayed, click OK or
click View log.
After the installation is completed, M3 H5 appears in the list of Grid applications. Refresh the client and
verify if the application is already started.
Click Next.
5 Select one of these options:
• Select Existing Share:
Share Name
Select an existing share.
Share Name
Specify a name for your share, for example: M3BEShare.
Installation Path
Specify a local path on the remote host for your M3 BE installation. For example: D:\M3BE.
Click Next.
6 Enter the values for the installation of M3 BE Release: M3BE_15.1:
Installation Path
Click Select ... and then choose the location where to install M3 Business Engine. Make sure that the
selected folder has appropriate permissions. See Securing M3 BE Installation Folder on page 110 for
details.
Note:
If you installed on a SMB share, the installation path is already defined, and the Select option is disabled.
Description
Enter a description for the installation.
Click Next.
7 Select the check box and specify your search criteria if you want to use a filter when searching for groups
in LDAP.
Click Next.
8 Select an Admin Group for the M3 Business Engine installation. If no Admin Group is selected, only users
that belong to the LifeCycle Manager administrators group (LCMAdmins) are allowed to administer the
M3 Business Engine installation. Click Next.
9 On the Summary screen, verify the property values, and click Finish to start the installation.
Note:
The installation of M3 Business Engine files may take several minutes to complete.
10 The Install M3 Business Engine task is displayed in the Progress view. When the installation is completed,
a dialog appears. Click OK. To view the log file, either click View log or go to the Logs view.
The M3 Business Engine installation M3BE_15.1 can now be found in the Hosts tab in the LifeCycle Manager
Client under the Host where you did the installation.
Note:
An M3 Business Engine installation can have one environment, or be shared by many M3 Business Engine
environments.
be run on this node. This method can be useful when upgrading from an older M3 Business Engine version,
or if you want to attach a backup of a database to your environment.
Attach database
1 Right-click your M3 Business Engine application middleware database instance node, and select Attach
M3 BE Database.
2 Enter user and password for the database administrator. Click Next.
3 Select an existing database to attach. Click Next.
4 On the Summary screen, verify the property values, and click Finish.
5 When the task is finished a dialog appears. Click OK. To view the log file, either click View log or go to the
Logs view.
Installing an environment
1 In the LifeCycle Manager, navigate to your space, right-click your Grid and select Install Product to start
the installation wizard.
2 Select the product M3 BE 15.1 - Environment <10.x.x>, and click Next.
Note: Ensure to select the correct M3 Foundation version. This is reflected by the <10.x.x> version.
3 Select the M3 Business Engine installation to install the M3 BE environment in. An M3 Business Engine
installation can have one environment, or be shared by many M3 Business Engine environments. Click
Next.
4 If your Grid is set up to run on multiple hosts, the Additional Grid Hosts window is displayed.
Select the additional Grid Hosts to run M3 BE on.
Click Next.
5 Verify and specify the environment information:
Name
The environment name is the abbreviation set for your space.
Type
This is the type set for your space.
Description
Specify a description for your environment.
M3 Foundation
Select the latest M3 Foundation version available.
M3 Router
Accept the default base port number, or enter a unique base port for a range of ports to be used by the
environment.
Note: Firewalls and some Antivirus programs may block access to ports that M3 Business Engine requires
to successfully start up and run. The install environment wizard will create firewall inbound rules for the
M3 BE application server ports to allow client applications to connect to M3 BE.
For more information, see Security issues.
Click Next.
6 Select the check box and specify your search criteria if you want to use a filter when searching for groups
in LDAP.
Click Next.
7 Select an Admin Group for the M3 Business Engine environment installation.
The default value displayed here is the group used for the M3 Business Engine installation. If no Admin
Group is selected, only users that belong to the LifeCycle Manager administrators group (LCMAdmins)
are allowed to administer the M3 Business Engine environment installation.
Click Next.
8 Specify the values needed for the M3 Business Engine database.
Database server
Select the database server for M3 Business Engine.
Create database
Accept the default name or specify a new name for the M3 Business Engine database.
Note: Required length is 8 characters or less.
Attach database
Select an M3 Business Engine database if you want to attach an existing database to your environment.
Click Next.
9 Enter the following MS SQL Server information:
User
Specify the database system administrator login sa
Password
Enter the database system administrator password
Transaction log
Accept the default path or specify a new path for the system logs.
Note: If using an SQL Server attached to an external host it is not possible to specify the path by using
the Select button. You must manually enter the path to the already existing folders in the edit field. For
example: X:\SQLLogs\M3FDB<Space abbreviation name>
Tables
Accept the default path or specify a new path for the tables.
Note: If using an SQL Server attached to an external host it is not possible to specify the path by using
the Select button. You must manually enter the path to the already existing folders in the edit field. For
example: X:\SQLTables\M3FDB<Space abbreviation name>
Indexes
Accept the default path or specify a new path for the indexes.
Note: If using an SQL Server attached to an external host it is not possible to specify the path by using
the Select button. You must manually enter the path to the already existing folders in the edit field. For
example: X:\SQLIndexes\M3FDB<Space abbreviation name>
Initial size
Specify the initial size of the database (large or small)
Table
Select the compression type for tables.
Note: If you have selected to attach a database then you should select the same compression type as
the database you attach is using.
Index
Select the compression type for indexes.
Note: If you have selected to attach a database then you should select the same compression type as
the database you attach is using.
Click Next.
Note: Support for compression is only available for SQL Server Enterprise Edition and SQL Server Developer
Edition.
Row level compression dramatically reduces the metadata needed for variable length columns. Page
level compression reduces the data size by sharing common data across rows. When Page level
compression occurs, there are three operations that happen in the following order: row compression,
prefix compression, and dictionary compression.
Data compression can improve query performance, but there are performance trade-offs for using row
and page compression. CPU utilization will go up, but I/O utilization and memory utilization will go down.
Data compression is a CPU intensive operation and if your environment is already facing CPU crunch
then this is not the best solution.
For more information about logs, tables, indexes and compression, see M3 Business Engine and Microsoft
SQL Server - Best Practices" (SQL Server BPG) on KB 2212202.
10 Enter database and license information.
M3 BE admin
MDBADM
M3 BE admin password
The user is created with the password supplied here. Retype the password.
If the user already exists, the valid password for this user must be entered.
Note: The password must contain a minimum of 8 characters. Also, it must be a combination of
alphanumeric and special characters.
M3 BE user
MDBUSR
M3 BE user password
The user is created with the password supplied here. Retype the password.
If the user already exists, the valid password for this user must be entered.
Note: The password must contain a minimum of 8 characters. Also, it must be a combination of
alphanumeric and special characters.
License key
Specify license key for M3 Business Engine.
Note: If you require a License Key, send an email to APAC.Keys@Infor.com, EMEA.Keys@Infor.com or
AMER.Keys@Infor.com with the following information:
• Requested Product and Version
• Client Name and Client ID #
• Client Contact Name and Email address
The default key is valid for ten users and has no limit date, but a new license key should be ordered as
soon as possible.
For information on how to set up the license key, see M3 Business Engine Foundation Administration
Guide available in the M3 Core Infrastructure and Technology online documentation on docs.infor.com.
The database logins and users MDBADM and MDBUSR are created while running this wizard. For more
information, see M3 Business Engine and Microsoft SQL Server - Best Practices" (SQL Server BPG) on KB
2212202.
Click Next.
11 A page with information that the Grid Agent will be restarted when installing the environment is displayed.
Click Next.
12 On the Summary screen, verify the property values and click Finish.
13 The Install Environment task is displayed in the Progress view. When the step is completed, a message
box is displayed. Click OK. To view the log file, either click View log or go to the Logs view.
You can manage the new environment from LifeCycle Manager, either in the Applications view for the
Space used for your environment, or in the Hosts view under the Host where your M3 Business Engine
was installed.
Note: If the Grid is running on a private network, you need to add an external address to the M3Router
in Grid after installing the M3 BE Environment. Go to Grid Configuration Manager > Communications >
Routers > M3Router to enable the communication. For more information about managing external
addresses of routers, refer to the Infor ION Grid Security Administration Guide available in the M3 Core
Infrastructure and Technology online documentation on docs.infor.com.
The M3RemoteClassProvider enables reading and writing files that reside on the base M3 BE host only.
To increase performance for individual hosts, you can override the M3RemoteClassProvider and let the
M3 nodes access the filesystem directly, see M3 Core Administration Guide, chapter Overriding the use of
the M3 RemoteClassProvider node.
Note: The M3 BE database is set in recovery model simple during installation. Before a production
environment goes live, it is recommended to use recovery model full. For more information, see KB
2212202:
• M3 Business Engine and Microsoft SQL Server - Best Practices, version for M3 BE 15.1 and Microsoft
SQL Server 2016, topic # 51422, or
• M3 Business Engine and Microsoft SQL Server - Best Practices, version for M3 BE 15.1 and Microsoft
SQL Server 2014, topic # 44834, or
• M3 Business Engine and Microsoft SQL Server - Best Practices, version for M3 BE 15.1 and Microsoft
SQL Server 2012, topic #37304
Description
Specify a description for your server.
Installation path
Select the path to where the layouts are to be installed.
Click Next.
5 On the Summary screen, verify the property values and click Finish.
6 When the task is finished, a dialog is displayed. Click OK. To view the log file, either click View log or go
to the Logs view.
Connect to environment
1 Right-click your OpenText StreamServe/Exstream middleware, and select M3 BE Integration Tasks >
Connect OpenText StreamServe/Exstream to M3 BE Environment.
2 Select your M3 Business Engine environment in the list. Click Next.
3 On the Summary screen, verify the property values, and click Finish.
4 When the task is finished a dialog is displayed. Click OK. To view the log file, either click View log or go
to the Logs view.
Overview
For Exstream 16.x (Streamserve v5), Infor delivers the following:
• Main projects to create runtime environment for all standard programs and market modifications in M3
Business Engine
• All projects, source files, for the layouts, test data and example reports to be used for customer
modifications.
The StreamServe/Exstream Layout Files are included in the base package for M3 Business Engine.
After uploading the base package for M3 Business Engine and configuring the StreamServe/Exstream location
in LifeCycle Manager, all layout files are available on the StreamServe/Exstream server.
5 If you plan to install fixes for the component, remember to also tick the fix check boxes.
The fixes and service pack information will be added to the server's classpath in order of priority, that is
in the order they are defined in the Component Details, the highest priority being hot fix at the top.
6 Click the save icon in the upper right hand part of the Environment Configurator window.
7 Depending on the environment status:
• If the environment is running, the message "Set M3 BE in maintenance mode" is displayed. Click OK
to save the new component.
• If the environment is stopped, the environment is started in maintenance mode and the new
component is saved.
Note:
The environment is in maintenance mode until the application is started, or set online.
Create database
1 Right-click your environment and select Database > Create Database.
2 Depending on the environment status:
• If the environment is running, the message "Set M3 BE in maintenance mode" is displayed. Click
Next.
• If the environment is stopped, the environment is started in maintenance mode.
Note
The environment is in maintenance mode until the application is stopped, started, or set online.
Password
Enter a password for the user.
Click Next.
4 Select component and system configuration.
Component
The component specified in the Environment Configurator Components pane (or in MNS104).
System configuration
The system configuration specified in the Environment Configurator Configurations pane (or in MNS102)
Note
The database schemas for the new component will be created automatically according to the specification
in Environment Configurator Components pane (MNS104).
Click Next.
5 On the Summary screen, verify the property values, and click Finish.
6 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Password
Enter the password for user.
Click Next.
3 Select Create language tables for uploaded languages, and click Next.
4 Select the component specified in the Environment Configurator (MNS104) for which to create language
tables, and click Next.
5 Select the component and language code, and click Next.
Note:
An additional component can contain several languages. Note that only the uploaded languages are
displayed in this list.
6 On the Summary screen, verify the property values, and click Finish.
7 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Password
Enter the password for the user.
Click Next.
4 Select the default mode Import Database Data.
The different configuration options works as follows:
Import Database Data
Select this option to import specific data.
Delete configuration
Select this option to remove a saved configuration.
When the second and third options are selected, the Load Configuration field is enabled. It allows you
to use or delete a saved configuration. The configuration is stored in the LCM client workspace that you
selected when you logged in. If you can not find your saved configuration, consider if you saved the
configuration in another workspace, or in a workspace for another LCM Client.
5 Select data zip files to import.
Source zip files uploaded to LCM server
Select the zip files to be added by selecting the check box to the left of the zip file name. It is possible to
select several files at a time.
Click Next.
6 Select tables to import to database.
Component
Select the component specified in the Environment Configurator Components pane (MNS104).
Database schema
Depending on your selection of component, the correct schema is presented.
Select tables
A selection of tables are presented in the box at the bottom of the dialog.
Click Next.
8 Select the import strategy "Copy tables without checking for duplicate keys".
The different strategies work as follows:
Replace existing records
The records in target that have a duplicate in the source are replaced by the ones imported.
9 Click Next.
10 To save this configuration, specify a unique name, and click Next.
11 On the Summary screen, verify the property values, and click Finish.
12 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Upload M3 BE Packages
This procedure describes how to upload additional packages to install on M3 Business Engine.
Uploading M3 BE Packages
This procedure describes how to upload additional packages to install on M3 Business Engine.
1 Right-click M3BE_15.1, and select Upload M3BE packages.
2 Click Select… and choose the directory that contains the M3 Business Engine packages. You can select
several packages at a time.
Note:
To select all packages, right-click in the list and select the option Select all.
Select your packages and click Next.
3 On the Summary screen, verify the property values, and click Finish
4 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Install M3 BE packages
Installing M3 BE packages
1 Right-click M3BE_15.1, and select Install M3BE Packages.
2 Select the M3 Business Engine packages to install in the list. You can select several packages at a time.
Note:
To select all packages, right-click in the list and select the option Select all.
Click Next.
The appropriate Viewdefinitions, language files and help files and OUT layouts are installed at the same
time.
3 On the Summary screen, verify the property values, and click Finish.
4 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Uploading M3 BE Packages
This procedure describes how to upload additional packages to install on M3 Business Engine.
1 Right-click M3BE_15.1, and select Upload M3BE packages.
2 Click Select… and choose the directory that contains the M3 Business Engine packages. You can select
several packages at a time.
Note:
To select all packages, right-click in the list and select the option Select all.
Select your packages and click Next.
3 On the Summary screen, verify the property values, and click Finish
4 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Installing M3 BE packages
1 Right-click M3BE_15.1, and select Install M3BE Packages.
2 Select the M3 Business Engine packages to install in the list. You can select several packages at a time.
Note:
To select all packages, right-click in the list and select the option Select all.
Click Next.
The appropriate Viewdefinitions, language files and help files and OUT layouts are installed at the same
time.
3 On the Summary screen, verify the property values, and click Finish.
4 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
Create tables
1 Right-click your environment, and select Database > Create Database Language Tables.
2 Enter database user login information:
User
MDBADM
Password
Enter the password for the user.
Click Next.
3 Select Create language tables for uploaded languages, and click Next.
4 For an additional component, select the component specified in the Environment Configurator (MNS104).
For standard, select the MVX component and click Next.
5 Select the component and language code, and click Next.
Note:
Note that only the uploaded languages are displayed in this list.
6 On the Summary screen, verify the property values, and click Finish.
7 When the task is finished, a dialog appears. Click OK. To view the log file, either click View log or go to
the Logs view.
User
MDBADM
Password
Enter the password for user.
Click Next.
4 Select the default mode Import Database Data.
The different configuration options works as follows:
Import Database Data
Select this option to import specific data.
Delete configuration
Select this option to remove a saved configuration.
When the second and third options are selected, the Load Configuration field is enabled. It allows you
to use or delete a saved configuration. The configuration is stored in the LCM client workspace that you
selected when you logged in. If you can not find your saved configuration, consider if you saved the
configuration in another workspace, or in a workspace for another LCM Client.
5 Select the source data zip files to import.
Source zip files uploaded to LCM Server
Select the zip files to be added by selecting the checkbox to the left of the zip file name. It is possible to
select several files at a time
Click Next.
6 Select tables to import to database.
Component
For an additional component select the component specified in the Environment Configurator. For
standard select the MVX component.
Database schema
Depending on your selection of component, the correct schema is presented.
Table name
One specific table will be imported, enter the name in the text field
Click Next.
8 Select the default import strategy Replace existing records.
The different strategies work as follows:
Replace existing records
The records in target that have a duplicate in the source are replaced by the ones imported.
9 Click Next.
10 To save this configuration, type a unique name, and click Next.
11 On the Summary screen, verify the property values and click Finish.
12 When the task is finished a dialog appears. Click OK. To view the log file, either click View log or go to the
Logs view.
Note:
If you already have applied a feature pack or an MCP that contains a delta delivery of the languages, you
must repeat this task from step 1 for the delta delivery zip files to complete the installation. For a feature
pack or MCP, you will find the data ZIP files in the following folder:
M3BE\_db_data\[component]\15.1\[H][T][V]Fix_deltalanguages\
A document language delivery contains only the .lng files to be installed on the OpenText
StreamServe/Exstream server. If you have already installed an Additional Language all necessary language
files are already available on the connected OpenText StreamServe/Exstream server.
For information on how to upload and install additional M3 BE Packages, see Uploading M3 BE Packages on
page 64 and Installing M3 BE packages on page 64.
Upgrade to
All feature pack versions for standard M3 Business Engine that are uploaded to the LifeCycle Manager
Server are displayed here.
Click Next.
3 A list of the installed standard or market modification fixes that are in conflict with the feature pack is
displayed. Select to remove all these conflicting files.
Click Next.
4 A list of the installed standard or market modification fixes that do not conflict with the feature pack is
displayed. These files might be affected by the files to be installed. Select the files to be removed by
selecting the check box in front of the file name.
Click Next.
5 A list of the installed customer modifications on this environment is displayed. These files might be
affected by the files to be installed. Select the files to be removed by selecting the check box in front of
the file name.
Click Next.
6 Select if you want to save the information provided in the previous steps, and information about all MCEs
that will be removed to a spread sheet.
7 On the Summary screen, verify the property values and click Finish.
8 When the task is finished, a dialog is displayed. Click OK. To view the log file, either click View log, or go
to the Logs view.
9 If the feature pack you applied contains database interface changes, changes to database delivery data,
MI transactions or fix programs, a new window informs you to perform one or more of the following tasks:
• If the feature pack contains DB Interface: run the Upgrade Database with Fix/Feature Pack task.
Note: If archiving is used on your installation, run the Upgrade Archiving Schema task. See M3 BE
LifeCycle Manager User Guide.
• If the feature pack contains a DB data zip file: run the Import Database Data task.
• If the feature pack contains MI transactions: run the Apply MI metadata task.
• If the feature pack contains fix programs: run the Run Fix Programs task.
Click Details. A Notepad window with information about for which fix(es) the different tasks must be run
is displayed.
Note:
For more information regarding fix programs to run for this feature pack, read the applicable net change
report (NCR). The NCR is available on Infor Support Portal.
Note:
The appropriate Viewdefinitions, language files, help files, and OUT layouts are installed at the same
time.
You can also go to the Select data zip files page, select the Sort and filter source zip files check box to filter
the list of available files depending on installed fixes.
Primarily , the sort order will be:
1 Data zip files that are uploaded through Upload M3BE Packages, for example, IA_DIS_1512_XML.zip
2 Data zip files that are exported, for example, exported_data/cpm900.zip
3 Components in alphabetical order
Then, the sort order of source zip files per component will be:
• Base delivery data, for example, MVX/15.1/delivery_data.zip
• Base language data for all languages, for example, MVX/15.1/languageS/delivery_data_SE_1.zip, sorted
by language in alphabetical order.
• FP delivery data, for example, MVX/15.1/VFix/delivery_data_FP1.zip, sorted by FP order such as FP1,
FP2, FP3, and so on.
• FP language data for all languages, for example, MVX/15.1/VFix_deltalanguages/delivery_data_FP1_GB.zip,
sorted by FP order and language in alphabetical order.
• MCE and MCP language data for all languages, for example, MVX/15.1/TFix_deltalanguages/TFix_MVXCON
GB_JT-826579.zip, sorted by the order in which the MCEs were applied. When filtering is enabled, the
view shows only the applied MCEs data.
Applying MI metadata
Use this procedure to apply MI metadata to your M3 BE environment.
To apply MI metadata
1 Right-click the environment and select Fixes > Apply MI metadata. The window Apply MI metadata is
displayed.
Note:
You can also open the task by clicking Apply MI metadata on the Dashboard tab Fixes.
2 The Start Environment in restricted mode information dialog is displayed. This means that the environment
will be shutdown and when re-started in restricted mode, only the LCM Client can run M3 Business Engine
jobs. An M3 BE user cannot login to an M3 UI or run M3 BE programs during the time it takes to run this
task.
Note:
Do not perform any other tasks that affect this M3 Business Engine environment while running Apply MI
metadata.
When the task is finished the environment status is changed to running mode. Click Next.
3 Provide information in these fields:
Select program
Select MI programs to apply. Right-click in the list and select all.
View All
• Select View All to display all available MI programs, or,
• Clear View All to display only the MI programs that can be applied.
M3 user
Specify a M3 BE user
M3 user password
Specify the password
Click Next.
4 On the Summary screen, verify the property values and click Finish.
5 When the task is finished, a dialog is displayed. Click OK. To view the log file, either click View log, or go
to the Logs view.
M3 user password:
Specify the password.
Click Next.
4 On the Summary screen, verify the property values and click Finish.
5 When the task is finished, a dialog is displayed. Click OK. To view the log file, either click View log, or go
to the Logs view.
Status of fix programs can be viewed in the M3 BE program CMS950.
Note:
Some fix programs are delivered in status 03 (=optional) and will not be run when running the task 'Run
Fix Programs' from LifeCycle Manager. These fix programs are delivered in status optional since they are
not required to be run immediately after an upgrade. They can be scheduled to be run during a weekend
or in a nightly run. More information regarding the new fix program handling can be found in the NCR
for M3 BE 15.1.3.
Install fixes
A fix can be a single or a bundle of individual corrections to M3 Business Engine. It is delivered in a zip file.
The different types of fixes are as follows:
• HFix – Hot fix
A hot fix applied for an Additional Component need to have its corresponding fix level activated in the
Environment Configurator to become active.
An MCE applied for a market modification need to have its corresponding fix level activated in the Environment
Configurator to become active.
Description
Specify a description of the solution.
Component
Select the component to which the solution belongs, or select ALL to show all components.
Show
Select to view all solutions or view only those that have been retrieved or not retrieved already.
View
Select to view 100, 500 or ALL MCEs
4 Click Search. The search results are displayed. The following table lists the status that might be displayed
in the Retrieved column of the results list:
Status Description
The solution is retrieved and is available on the LifeCycle Manager Server.
5 Select one solution in the list. The details and possible dependencies of the selected MCE solution are
displayed.
6 Select the check box of one or more solutions, or right-click and select Select All MCE's. Click Retrieve.
7 Click OK. The MCE solution and all dependencies that are not yet retrieved are retrieved and uploaded
to the LifeCycle Manager Server.
Apply Fixes
Use this procedure to install a fix, or one or more MCEs, to any environment using the Apply Fix function.
Apply Fixes
1 Right-click your environment and select Fixes > Manage Fixes.
2 In the Fix(es) overview pane, search for a fix using the following filter options:
Name
Type the name of the fix.
Solution
Type the ID number of the solution.
Description
Type a description of the fix.
Component
Select the component to which the solution belongs or select ALL to show all solutions.
Show
Select to view all solutions or view only those that have been applied or not applied already.
Applied By
Type the name or ID of the user who installed the fix.
Applied Date
Type the date when the fix was applied.
3 Click Search. The search results are displayed. The following table lists the different statuses that might
be displayed in the results list:
Partially Applied One or more of the files included in the fix is ap-
plied, but not all of them (only valid for fixes that
are not MCEs)
4 Select a fix in the list. Complete information about the fix and each file that is included in the fix is
displayed. For MCEs, possible dependencies are also shown.
Depending on the filter you use, a list with search results is displayed. Note that the search results include
only all MCEs and fixes that were found based on the filter criteria. In the results window, you can right-click
to select or deselect all the MCEs found by the search.
Note:
The selected fix will be displayed in bold font in Fix(es) Details. All fixes that also contain changes to the
database are displayed in blue. MCEs containing database changes cannot be removed once applied.
Click Apply.
5 If the fix to apply is an MCE package, LifeCycle Manager will scan the M3 Business Engine environment
for conflicts.
If no conflicts are found a message box appears, click OK to apply the fix.
If conflicts are found, the Apply Fix wizard is started, continue below.
• If the fix contains fix programs: run the Run Fix Programs task.
Note:
The run fix programs task is only applicable for environments running M3 Foundation 10.1.3.0 or
newer versions and when applying a fix on the M3 BE 15.1.3 or newer versions.
Click Details. A Notepad window with information about for which fix(es) the different tasks must be run
is displayed.
You can also go to the Select data zip file page, select the Sort and filter source zip files check box to filter the
list of available files depending on installed fixes.
Primarily , the sort order will be:
1 Data zip files that are uploaded via Upload M3BE Packages, for example, IA_DIS_1512_XML.zip
2 Data zip files that are exported, for example, exported_data/cmp900.zip
3 Components in alphabetical order.
Then, the sort order of source zip files per component will be:
• Base delivery data, for example, MVX/15.1/delivery_data.zip
• Base language data for all languages for example, MVX/15.1/languageS/delivery_data_SE_1.zip, sorted
by language in alphabetical order.
• FP delivery data, for example MVX/15.1/VFix/delivery_data_FP1.zip, sorted by FP order such as FP1,
FP2, FP3 and so on.
• FP language data for all languages, for example, MVX/15.1/VFix_deltalanguages/delivery_data_FP1_GB.zip,
sorted by FP order and language in alphabetical order.
• MCE and MCP language data for all languages, for example, MVX/15.1/TFix_deltalanguages/TFix_MVXCON
GB_JT-826579.zip, sorted by the order in which the MCEs were applied. When filtering is enabled, the
view shows only the applied MCEs data.
Applying MI metadata
Use this procedure to apply MI metadata to your M3 BE environment.
To apply MI metadata
1 Right-click the environment and select Fixes > Apply MI metadata. The window Apply MI metadata is
displayed.
Note:
You can also open the task by clicking Apply MI metadata on the Dashboard tab Fixes.
2 The Start Environment in restricted mode information dialog is displayed. This means that the environment
will be shutdown and when re-started in restricted mode, only a the LCM Client can run M3 Business
Engine jobs. An M3 BE user cannot login to an M3 UI or run M3 BE programs during the time it takes to
run this task.
3 Provide information in these fields:
Select program
Select MI programs to apply. Right-click in the list and select all.
View All
• Select View All to display all available MI programs, or,
• Clear View All to display only the MI programs that can be applied.
M3 user
Specify a M3 BE user
M3 user password
Specify the password
Click Next.
4 On the Summary screen, verify the property values and click Finish.
5 When the task is finished, a dialog is displayed. Click OK. To view the log file, either click View log, or go
to the Logs view.
M3 user password:
Specify the password.
Click Next.
4 On the Summary screen, verify the property values and click Finish.
5 When the task is finished, a dialog is displayed. Click OK. To view the log file, either click View log, or go
to the Logs view.
Click Next.
4 On the Summary screen, verify the property values and click Finish.
5 The Install task is displayed in the Progress view. When the step is completed, a message box is displayed.
Click OK. To view the log file, either click View log or go to the Logs view.
2 Access the host machine and create the central file folder.
For example, create e:/EC_Central_Folder
3 Set the user access rights to the Central File folder. Allow user read/write access.
Note:
• Save the EC DB user information. Use the information when you install EC in Grid, upgrade EC
database, and to access this database.
• Do not use an already existing user account, you must create a new user account.
8 Click Next.
The Summary window is displayed. Review and verify the completeness of the information.
9 Click Finish to complete the installation.
When the task is finished, a message is displayed.
10 Click OK.
11 Optionally, access the log view to show the installation details.
Before you can install EC in a grid, you must complete these prerequisites:
• Set up Central File folder
• Install EC Database
• Provide the LCM service and Grid Agent users full access to the Central File folder.
• Select the latest version release of Infor ION Grid.
• Select a grid instance that contains the host to run MapGen and CentralFileSystem.
To verify, see the (Registry) list underneath Grid Host.
• Start and run the Grid. If not already started, EC deployment will wait for until Grid is started.
Description
Specify an optional brief description for this installation.
6 Click Next.
The Grid Host window is displayed. The grid default hosts are selected by default based on your installation
set up.
Note:
By default, EC_Process node will run on all Grid hosts.
7 On Grid Host window, specify this information:
MapGen Host
Select a host machine for the EC_MapGen Node.
By default, this hosts is automatically derived from your EC Server Host selection earlier.
EC_UI Host
Select a host machine for the EC_UI Host Node.
By default, this hosts is automatically derived from your EC Server Host selection earlier.
8 Click Next.
The Database information window is displayed.
Note:
Refer to your EC database set-up details.
9 On the Server information group, select the Database server that you defined earlier.
10 On the Database User Information group, type the database user and password that you defined earlier.
11 Click Next.
The M3 API Information window is displayed.
12 On Select M3 BE Environment, specify this information:
You can select to install the BE now or configure to use BE later.
BE Installation
Select the BE installation to use.
- Or -
Select Manual Configuration to perform BE configuration later.
BE Environment
Select the BE environment to use.
API Port
By default, this field is auto-filled based on your selected BE Installation.
Host Name
Specify the host name of the BE Environment.
Note:
If you selected a BE Environment to use, this field will be auto-filled with a value corresponding to your
selected BE Environment.
User
Specify the username to access the BE Environment.
Password
Specify the password to access the BE Environment.
Encoding IANA
This is auto-filled.
Use Proxy
Select this to specify the proxy connection to use. You may need to use a proxy connection because of
firewalls and NATed networks settings.
Note:
This information specified in this API is the same as with the information in the Partner Admin M3 API
Communication fields. If changed, the values specified here will replace the values in the Partner Admin
M3 API Communication fields. The corresponding <APIMapper.mi.*properties>(application) is also
populated.
14 Click Next.
The Summary page is displayed.
15 Review the information and click Finish to complete the installation.
After you click Finish, LCM copies the EC Config files to the Central File Folder.
16 When the task is finished, successful installation dialog appears. Click OK or View log.
EC application is now installed in your selected grid node.
Adding full control access to the Central File folder - SQL Server
1 Check that the LCM Service user on the Central File Location Host has read/write access to the Central
File folder.
2 Check the GridAgent logon where EC_Central Node must run.
Note:
To find the GridAgent Services, run services.msc from the command prompt.
GridAgent uses the format: Infor ION Grid Bootstrap - <Grid Name>
Access rights to "Infor ION Grid Bootstrap - <Grid Name> " enable full control.
Infor Enterprise Collaborator tools include a design studio where the mapping of business messages from
and to the M3 system is defined and maintained. The mapping of the business is a description of how an
arbitrary input XML schema is transformed into an output target XML schema, but with the graphical mapping
tool, developers can connect inbound with outbound messages and make integration simple.
6 Click OK.
If the Database settings window is displayed, PA tool is properly installed. You can now proceed to set
up a database connection. You find the jdbc url in EC administration in EC Application properties page.
Troubleshooting
You can experience issues and errors during the installation and setup of IEC client and server tools. Consult
these topics to solve these common issues.
MSMQ Error
The MSMQ error is an issue that develops if you do not have the correct MSMQ version installed. This error
will stop a channel from working and shows an error message:
An error occurred when opening queue: nlbavwm3e238\pubtqueuerec Channel will stop.
The stack text will show: com.intential.ec.communication.msmq.MSMQException: Make sure that a MSMQ is
installed in the host it will execute.
To address this issue, you must install the MSMQ Windows component. You can find the installation steps in
the MSMQIn topic under Polling type channel properties in the Infor Enterprise Collaborator Partner
Administration Tool User Guide.
Location
Specify the Eclipse plugin site location obtained from step 2.
7 Click OK.
8 Select Infor Business Document Mapper and click Next.
The Install Details window is displayed.
9 Review the items to install and click Next.
10 On the Review License window, accept the license agreement and click Finish.
A progress window is displayed.
11 On the Software Update window, click Yes.
The Mapper files are now uploaded to Eclipse and the workbench is restarted. You can now proceed to
verify the installation.
When you specify a username and password for the first time, a message shows that no key store file
exists for <username>.
Click OK to continue. The Flat File Definition Tool Security Login window is displayed.
5 Specify a password for this username. Confirm your password.
A key store file is created for this username and password.
6 Click OK.
7 Select Flat File Repository Manager.
The Flat File Repository Manager window is displayed.
The user interface of the Flat File Repository Manager has three panes providing three different views.
These panes are the Definitions in repository, Definitions from repository being edited, and the Local
definitions. The icon displayed in each pane indicates the status of the environment in which the user is
currently working.
Note:
After FBM installation is completed, you must Deploy the mapping to the Mapper Server runtime environment.
Deployment is the process of publishing a mapping to a Mapper Server. The mappings are loaded into the
Mapper Sever and are ready to run after they have been activated or reactivated. Then, connect the published
mapping to its corresponding Partner agreement using the Partner Agreement Tool.
For more information, see these topics:
"Importing mappings", see Infor Document Mapper User Guide.
"Publishing mappings", see Infor Enterprise Collaborator Administration Guide.
After installation, verify that the product is displayed in "Started" status in the list of Grid applications.
After installation, verify that the product is displayed in status Started in the list of Grid applications.
Location
Type the Eclipse plugin site location obtained from step 2
Click OK.
6 On the Available Software window, do either of the following:
If you are doing a first-time installation: If you are updating an existing MAK installation:
a Select MAK Feature, MAK Help, and MAK SVN a Click the link to "What is already installed".
Team Support. Click Next. The Installed Software tab appears by default.
b On the Install Details window, review the b Select MAK Feature, MAK Help, and MAK SVN
items to be installed. Click Next. Team Support. Click Update.
c On the Update Details window, review and
confirm the updates. Click Next.
7 On the Review Licenses window, accept the license agreement and click Finish. A progress window
appears.
8 On the Certificate Selection window, select the Infor software certificate. Click OK.
9 On the Software Update window, click Yes.
The MAK files are now uploaded to Eclipse and the workbench is restarted. You can now proceed to verify
the installation.
10 Click Next.
11 On the MDP database information window, confirm the MDP database information and specify login
credentials for the database admin.
12 In the Summary page, review and verify the completeness of the information. Click Finish to complete
the installation.
13 When the task is finished, a window indicating the successful installation is displayed. Click OK or click
View log.
The MDP application is now installed in grid. You can find it under the Space > Grid Applications node in the
Applications tab.
Creating a database
Use this procedure to create a new database on your selected database server.
1 Select Create new database and click Next.
2 Specify this information:
Database
Specify the name of the database to create.
Schema
Optionally, specify the name of the database schema to create.
Database location
Optionally, specify the path for the database.
Note: This field is available only if you selected an SQL Server, and if the database location for the API
setting is available in LCM, for example, latest LCM version. If left blank, the database is created in the
default path.
Schema
Specify the name of the database schema to create.
JDBC user
Specify the JBDC user that will run the grid database.
JDBC password
Specify the password for the JDBC user.
Schema
Specify the name of the database schema, if used.
JDBC user
Specify the JDBC user.
JDBC password
Specify the JDBC user's password.
JDBC URL
Specify the URL to connect to the database.
For example, for an SQL Server: jdbc:sqlserver:// host_fqdn:port; databaseName= yourDBname,instance=
instanceName.
This appendix contains information about AD LDS users and groups, user management permissions to the
LCMADAM instance, and configuration of the LCM server to use SSL.
Users
admin Has all permissions to administer the LCMADAM instance
binduser Use this account to bind to the LCMADAM instance
LCMAdmin Use this account to administer LifeCycle Manager
LCMProduser Use this account to administer a product in LifeCycle Manager (Product User)
LCMViewer Use this account to view status of products installed in LifeCycle Manager
Groups
LCMAdmins Consists of one user account - LCMAdmin
LCMProd Consists of one user account - LCMProduser
The users created during the AD LDS instance installation have the default password ChangeMe123. This
password should be reset.
Creating a new user and adding the user to an existing user group
in AD LDS
1 Start a command prompt console.
2 Navigate to the following directory: LCMInstallDir\LCM-Server\adam\manage.
3 Run the script new_lcmuser.cmd name_of_new_user name_of_LCMgroup.
# LDAP configurations
ldap.validation=true
ldap.server.0=seliw031.infor.com
ldap.port.0=636
ldap.bind.user.0=cn=binduser,ou=lcm,dc=lcmadam,dc=net
ldap.bind.password.0=##01WQ8/QAEA0iSnuVPKMIpkRQ==
ldap.ssl.enabled.0=true
ldap.trust.store=D:/Infor/LifeCycle Manager/LCM-Server/adam/ADAM_SSL/dc5
ldap.trust.store.password=
Appendix B: Security
This appendix presents some important security notes regarding hardware and operating environment
security. The appendix does not, by far, provide a full coverage of all security issues that might be considered.
Caution:
It is highly recommended to disable the Windows Guest account, if this has not already been done.
Securing Access to M3 BE
M3 BE can be accessed and managed by a variety of applications. Some of them like Infor Smart Office provide
user authentication but some like MI or BCI (Business Component Interface) do not include this functionality.
M3BE is installed as a Grid-enabled application, which means that the application uses Grid Session Providers
to authenticate users.
2 If applicable, ensure that M3 Adaptation Kit users are included in the group M3_MAK_Group.
Security issues
Backup
Backup means not only backing up data on disks. Backup also means verifying that backup media contains
valid data that can be used to restore the system, as well as providing replacement parts for disks, power
supplies, software disk media etc.
Note: Do not schedule any batch jobs in M3 Business Engine during the backup of the entire database!
Recommendations:
Backup of disk data is utterly important. Make sure you have understood the backup needs of SQL Server
databases, for more information, see M3 Business Engine and Microsoft SQL Server - Best Practices (SQL Server
BPG) on KB 2212202. You must also define a backup and recovery plan, and practice recovery from backed
up files.
Also ensure that you have fast access to spare parts like disks.
Passwords
All passwords in Windows and SQL Server must be hard to crack.
Suggestions for stronger passwords in Windows and SQL Server:
• Do not use known words or user names in your password
• Include special characters (!@#$%*) and numbers in your password
• To really increase password strength, use a non-printable ASCII character. I.e. within the password,
'secret' embed an alt character secret where you hold down the ALT key while pressing the 1,2 and 9 keys
on the numeric keypad.
Note:
For laptop users, you will have to activate NUMLOCK and use the j, k, l, u, i, o keys that correspond to the
numeric keypad.
Note:
If you have an account called 'test' and it is an administrator level account, do not use the password 'test'.
For more details read: http://technet.microsoft.com/en-us/library/cc783860.aspx
Perimeter defense
Recommendations
Place the M3 Business Engine Application server and SQL Server machine behind a firewall to reduce security
vulnerability.
Windows firewall
The latest MS Windows OS versions are delivered with enabled Firewall. There are two ways to handle this
situation; either disable Windows Firewall or create Inbound Rules that allow client applications to connect
to M3BE. When Windows built-in firewall is enabled on your M3 Business Engine application server, you must
create exceptions that allow access to ports listed above.
Firewall rules can be created in two ways, by allowing access to ports opened by a process or by opening
explicit network ports. To create a firewall rule that allows network access to explicit ports use the following
command (this example is valid for Windows 2008 R2):
For considerations about firewall installed on SQL Server, see M3 Business Engine and Microsoft SQL Server -
Best Practices" (SQL Server BPG) on KB 2212202.