Infor ION Installation Guide

110
Infor ION Installation Guide Release 11.1.14

Transcript of Infor ION Installation Guide

Page 1: Infor ION Installation Guide

Infor ION Installation GuideRelease 11.1.14

Page 2: Infor ION Installation Guide

Copyright © 2015 Infor

Important NoticesThe material contained in this publication (including any supplementary information) constitutes andcontains confidential and proprietary information of Infor.

By gaining access to the attached, you acknowledge and agree that the material (including anymodification, translation or adaptation of the material) and all copyright, trade secrets and all otherright, title and interest therein, are the sole property of Infor and that you shall not gain right, title orinterest in the material (including any modification, translation or adaptation of the material) by virtueof your review thereof other than the non-exclusive right to use the material solely in connection withand the furtherance of your license and use of software made available to your company from Inforpursuant to a separate agreement, the terms of which separate agreement shall govern your use ofthis material and all supplemental related materials ("Purpose").

In addition, by accessing the enclosed material, you acknowledge and agree that you are required tomaintain such material in strict confidence and that your use of such material is limited to the Purposedescribed above. Although Infor has taken due care to ensure that the material included in this publicationis accurate and complete, Infor cannot warrant that the information contained in this publication iscomplete, does not contain typographical or other errors, or will meet your specific requirements. Assuch, Infor does not assume and hereby disclaims all liability, consequential or otherwise, for any lossor 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 youruse of this material and you will neither export or re-export, directly or indirectly, this material nor anyrelated materials or supplemental information in violation of such laws, or use such materials for anypurpose prohibited by such laws.

Trademark AcknowledgementsThe word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/orrelated affiliates and subsidiaries. All rights reserved. All other company, product, trade or servicenames referenced may be registered trademarks or trademarks of their respective owners.

Publication information

Release: Infor ION 11.1.14

Publication Date: October 8, 2015

Document code: U9830G US

Page 3: Infor ION Installation Guide

Contents

About this guide..............................................................................................................7Contacting Infor...........................................................................................................................9

Chapter 1: Infor ION introduction................................................................................11ION SKU's................................................................................................................................................12

Chapter 2: Deployment editions..................................................................................19Foundation edition...................................................................................................................................19

Deployment scenarios Foundation......................................................................................................19Grid edition..............................................................................................................................................22

Deployment scenarios Grid..................................................................................................................22

Chapter 3: Installation requirements...........................................................................25ION installation checklist..........................................................................................................................25Platform requirements.............................................................................................................................26Software requirements.............................................................................................................................28Microsoft SQL Server settings.................................................................................................................29

Verifying the remote connection and port settings...............................................................................30SQL Server Express............................................................................................................................30Activating mixed mode authentication.................................................................................................31

Oracle settings.........................................................................................................................................31Database collations..............................................................................................................................31Oracle Client preparation.....................................................................................................................32Database password specification........................................................................................................33Creating the ION tablespaces manually in advance............................................................................33

Configuring the Microsoft Internet Information Services (IIS) instance...................................................34Installing the IIS components and services with the command line.....................................................34Installing IIS components and services with the Server Manager tool.................................................35Configuring your IIS instance for Windows 2012 and Windows 2012 R2............................................35CA certified SSL certificate..................................................................................................................36

Microsoft .Net framework.........................................................................................................................38Verifying Java requirements....................................................................................................................38Infor Federation Services.........................................................................................................................39Client-side requirements..........................................................................................................................40Authentication method for the clients......................................................................................................40Integrated Windows authentication (IWA)...............................................................................................41SAML Token............................................................................................................................................41

Infor ION Installation Guide | 3

Contents

Page 4: Infor ION Installation Guide

TCP/IP ports............................................................................................................................................41Minimal hardware requirements..............................................................................................................42ION Service Account...............................................................................................................................43

Chapter 4: Installing ION..............................................................................................45ION Connect 3P/ION installation.............................................................................................................46

Installing ION on Oracle.......................................................................................................................49Installation completed dialog box.........................................................................................................51Failing installation.................................................................................................................................51Results in SQL Server..........................................................................................................................51

Chapter 5: General post-installation...........................................................................53Installing latest ION 11.1 Patch...............................................................................................................53Version details.........................................................................................................................................53Installer completed with warnings............................................................................................................54Activating ION in IFS when SAMLToken is used....................................................................................54ION Desk user authorizations..................................................................................................................55How to start ION Desk.............................................................................................................................55Log on to ION Desk.................................................................................................................................55Configuring the ION Service for ActivityDeck Attachments.....................................................................56ION Bootstrap Service depending on Oracle service..............................................................................56Installing latest ION Registry content......................................................................................................56

Chapter 6: Installing ION Service on a secondary host............................................59Prerequisites for dual host deployment...................................................................................................60Adding the secondary host......................................................................................................................60Installing the deployment package on the secondary host (Windows)....................................................61Installing the deployment package on the secondary host (Linux)..........................................................62Activate dual host deployment.................................................................................................................63Removing a secondary host....................................................................................................................63

Deactivating dual host deployment......................................................................................................63Removing the second host..................................................................................................................64

Chapter 7: Features in an ION installation..................................................................65Adding features to an ION installation.....................................................................................................66

Chapter 8: Installing an ActivityDeck client...............................................................67Installation issues....................................................................................................................................67

IFS error...............................................................................................................................................68ActivityDeck in SAML token authentication mode................................................................................68HTTP error...........................................................................................................................................68Silverlight plug-in..................................................................................................................................69

4 | Infor ION Installation Guide

Contents

Page 5: Infor ION Installation Guide

Chapter 9: Upgrade process........................................................................................71Configuration backup...............................................................................................................................72

LN content packs.................................................................................................................................72Business Vault.....................................................................................................................................72

Regular backup for recovery....................................................................................................................72Mandatory steps to backup for recovery..............................................................................................73Optional steps to backup for recovery.................................................................................................73

Planning for the upgrade.........................................................................................................................75IFS Authentication Mode......................................................................................................................76ION Desk authorizations......................................................................................................................76Using Oracle Service name.................................................................................................................76Updating the Oracle client....................................................................................................................76Infor ION Grid Bootstrap service..........................................................................................................77Manually creating databases...............................................................................................................77ION 10.0 specific ION ActivityDeck databases....................................................................................78ION Service on a remote host, dual host deployment.........................................................................79Grid edition and machine name...........................................................................................................79Prevent use of TCP/IP ports above 50000..........................................................................................80Statistics of active connection points...................................................................................................80ION downtime......................................................................................................................................80

Upgrade prerequisites.............................................................................................................................80Specific ION 11.1 upgrade installer steps...............................................................................................81Running the upgrade installation.............................................................................................................81

Upgrade completes with errors............................................................................................................86Updating bootstrap service on secondary hosts......................................................................................87Reissuing Grid Certificates......................................................................................................................87Updating log settings...............................................................................................................................87Custom e-mail templates.........................................................................................................................88

Migration of events in message trace..................................................................................................88Redirection of ION Desk points to incorrect URL....................................................................................89

Chapter 10: Upgrading JDK version...........................................................................91

Chapter 11: Remove ION..............................................................................................93Uninstalling ActivityDeck for Desktop application....................................................................................94

Chapter 12: Troubleshooting.......................................................................................95ION installation user with special characters in the name.......................................................................95Chrome browser issue.............................................................................................................................96HTTP Error 500.21 - Internal Server Error..............................................................................................96httpwebrequest_webexception_remoteserver arguments not found.......................................................97

Infor ION Installation Guide | 5

Contents

Page 6: Infor ION Installation Guide

User has not enough provisioning service privileges..............................................................................97Repeated browser sign-in dialog and/or HTTP error 401........................................................................97ION Desk is not loading pages................................................................................................................98Security Error when starting ActivityDeck for the first time......................................................................98Safari browser issues..............................................................................................................................98

Appendix A: Offline utility for message trace migration.........................................101Planning the migration...........................................................................................................................101Installation of the migration utility..........................................................................................................102Running the migration utility..................................................................................................................102Logging of migration utility actions........................................................................................................102

Appendix B: SQL statements for manual creation of databases...........................105

6 | Infor ION Installation Guide

Contents

Page 7: Infor ION Installation Guide

About this guide

This installation guide describes how to install the Infor ION suite.

Intended AudienceThe document is intended for database administrators, and application and system administratorsfamiliar with the system administration of Windows systems.

Related documents:You can find the documents in the product documentation section of Infor Xtreme Support portal athttp://www.infor.com/inforxtreme

• Infor ION Connect Administration Guide• Infor ION Process Administration Guide• Infor ION ActivityDeck User Guide• Infor ION Technical Reference Guide• Infor ION Grid Administration Guide• Infor ION Grid Security Administration Guide• Infor Ming.le Installation Guide for Standalone IFS• Infor Federation Services Administration Guide

Infor ION Installation Guide | 7

Page 8: Infor ION Installation Guide

8 | About this guide

About this guide

Page 9: Infor ION Installation Guide

Contacting Infor

If you have questions about Infor products, go to the Infor Xtreme Support portal.

If we update this document after the product release, we will post the new version on this website. Werecommend that you check this website periodically for updated documentation.

If you have comments about Infor documentation, contact [email protected].

Infor ION Installation Guide | 9

Page 10: Infor ION Installation Guide

10 | Infor ION Installation Guide

Contacting Infor

Page 11: Infor ION Installation Guide

1Infor ION introduction

Infor ION is an interoperability and business process management platform designed to integrateapplications, people, and processes to run your business. Infor ION enables Infor and customer activitiesto configure a routed infrastructure, setup workflows, design and activate business event monitors andmanage the tasks and alerts.

Infor ION has these components:

• ION Desk• ION Connect• IONEvent Management• ION Workflow• ION Activities and ION ActivityDeck

Infor ION Installation Guide | 11

Page 12: Infor ION Installation Guide

The Infor ION suite is a set of services built by Infor that simplifies connectivity and data sharing acrossall applications.

ION SKUsThe term SKU refers to Stock Keeping Unit. In this context it applies to the unique sellable productvariant of ION which you can purchase.

ION is available in:

• ION Connect3P Foundation (otherwise referred to as ION 3P Foundation)• ION Process Foundation• ION Connect3P Grid• ION Process Grid

Additional business adapters:

• ION Connect4SAP• ION Connect4ORAEBS

ION Connect3P FoundationThis installer variant contains all standard connectors to connect Infor applications to one another, andto customer's non-Infor applications. These connectors are available:

• Infor Application Connector (formerly known as JDBC Connector)• ERP Enterprise (LN)/Baan Connector• DB Connector• JMS Connector• File Connector• Webservices Connector• Infor Cloud Connectors• SalesForce.com Connector• Microsoft CRM Connector

In addition to this, the ION ActivityDeck is part of standard ION Connect SKU.

This diagram shows the installer variant ION Connect 3P foundation:

12 | Infor ION Installation Guide

Infor ION introduction

Page 13: Infor ION Installation Guide

ION Process FoundationThis installer variant includes:

• All components of ION Connect 3P Foundation• IONEvent Management• ION Workflow

This diagram shows the installer variant ION Process foundation:

Infor ION Installation Guide | 13

Infor ION introduction

Page 14: Infor ION Installation Guide

ION Connect 3P GridThis installer variant is the same as that of ION Connect 3P Foundation. In addition, it provides scalabilityand availability.

This diagram shows the installer variant ION Connect3P Grid:

14 | Infor ION Installation Guide

Infor ION introduction

Page 15: Infor ION Installation Guide

ION Process GridThis installer variant is the same as the ION Process Foundation. In addition, it provides scalability andavailability.

This diagram shows the installer variant ION Process Grid:

Infor ION Installation Guide | 15

Infor ION introduction

Page 16: Infor ION Installation Guide

ION Connect4SAPThis installer variant includes:

• All components of ION-Connect3P (either Foundation or Grid)• SAP Connector

This diagram shows the installer variant ION Connect4SAP:

16 | Infor ION Installation Guide

Infor ION introduction

Page 17: Infor ION Installation Guide

ION Connect 4 ORAEBSThis installer variant includes:

• All components of ION-Connect3P (either Foundation or Grid)• ORAEBS Connector

This diagram shows the installer variant ION Connect4ORAEBS:

Infor ION Installation Guide | 17

Infor ION introduction

Page 18: Infor ION Installation Guide

18 | Infor ION Installation Guide

Infor ION introduction

Page 19: Infor ION Installation Guide

2Deployment editions

Foundation editionBefore you choose your ION deployment consider these building blocks:

1 ION Desk and ION ActivityDeck; consisting of a part deployed in Microsoft IIS and a part in InforION Grid (the ION Desk and MECMapping nodes) Always deployed on a Windows host. ION Deskalways needs a SQL Server database, this can be SQL Server Express.

2 ION Service; Dependent on the chosen features can contain ION Connect, Event Management andION Workflow. Running as an Infor ION Grid node. Can be deployed on a Windows or Linux host.ION Service can either use a SQL Server (Standard or Enterprise) or an Oracle database.

3 Infor Federation Services (IFS), optionally including ADFS. Deployed in Microsoft IIS. Alwaysdeployed on a Windows host, can be deployed on an ION host or a 3rd host. IFS requires a SQLServer database.

4 A SQL Server database for ION Desk, MEC Mapper and IFS. A SQL Server or Oracle database forION Service

For an explanation of the ION features, consult the ION Release Notes.

Deployment scenarios FoundationThe ION Connect, IONEvent Management, and ION Workflow modules are always installed on thesame server. ION Desk can either be installed on the same server or on a different server.

Installing ION Pulse, IONEvent Management and ION Workflow is optional.

Deployment scenario 1: installing ION and IFS on a single serverFor a full, automated installation and database management of ION, we recommend that you use thisdeployment scenario:

• Install all ION modules and IFS on the same Windows (Standard or Enterprise Edition) server.AD FS is only required if SAML token authentication is used.

• Use MS SQL Server as the database. This database server can be installed on the same server asthe ION installation or on a different server.

Infor ION Installation Guide | 19

Page 20: Infor ION Installation Guide

Deployment scenario 2: installing ION Service and ION Desk using two hostsThis scenario is required when you deploy ION Service on a Linux server or on a different Windowsserver than ION Desk. First install ION on the primary host that will continue to contain ION Desk, thenuse the dual host deployment procedure to move ION service to the secondary host. See 'InstallingION Service on a secondary host'.

Deployment scenario 3: installing IFS and ION on different serversThis scenario is the same as deployment scenario 1, except that IFS is installed on a separate Windowsserver than ION. This option offers a full, automated installation and database management of ION.

AD FS is only required if SAML token authentication is used.

Alternatively, ION and IFS can share the same SQL Server instance.

20 | Infor ION Installation Guide

Deployment editions

Page 21: Infor ION Installation Guide

Deployment scenario 4: ION Desk, ION ActivityDeck and IFS on the same serverand ION Service on a different serverIn this scenario, all Microsoft-technology-dependent modules of ION are installed on the same serverand the Platform independent modules of ION are installed on a different server.

To complete the installation, manual installation steps are required. See "InstallingION on Linux."

AD FS is only required if SAML token authentication is used.

Infor ION Installation Guide | 21

Deployment editions

Page 22: Infor ION Installation Guide

Grid editionThe Infor ION Grid edition or ION3P Grid edition will be used by customers that demand better availabilityfor ION and/or need to use the scalability feature of ION.

Before you choose your ION deployment you must consider these building blocks:

1 ION IIS components: ION Desk and ION ActivityDeck; Deployed in Microsoft IIS Always deployedon a Windows host. ION Desk always needs a SQL Server database, this can be SQL ServerExpress.

2 Infor ION Grid applications. ION contains these Grid applications, which in turn contain one or moregrid node types;

• ION Desk; Always a single node; DeskNode Contains the functionality for the ION Desk menu,One View and Desk security pages

• MECApplication: Always a single node: MappingEngineBinding Contains the functionality foradvanced mapping.

• ION Service; Contains these nodes:

• Coordinator• Connect (1 or more instances)• Queue

Additionally, dependent on selected features and configuration:

• Process• ActivitiesUI• ActivitiesEngine• JMSQueue (1 or more instances) dependent on the installed features and configuration

3 IFS, optionally including ADFS. Deployed in Microsoft IIS. Always deployed on a Windows host,can be deployed on an ION host or a third host. IFS requires a SQL Server database.

4 A SQL Server database for ION Desk and IFS. A SQL Server or Oracle database for ION Service

For an explanation of the ION features, consult the ION release notes.

Deployment scenarios GridThe deployment scenario for customers that use the Infor ION Grid or ION3P Grid edition, typicallyincludes multiple hosts to facilitate fail-over and scalability.

22 | Infor ION Installation Guide

Deployment editions

Page 23: Infor ION Installation Guide

See this diagram:

The primary host contains the ION IIS components.

The primary and additional hosts (in this example secondary and third hosts) are configured as InforION Grid hosts and deploy the Infor ION Grid application nodes. The grid decides where each node isstarted. Therefore the actual deployment situation may vary based on dynamically allocated nodes.

We recommend that you deploy the database on a separate set of hosts and consider setting up thedatabase in fail-over mode.

Instead of deploying IFS (and ADFS) separately, you can consider deploying IFS (and ADFS) on theprimary host.

As IIS is not set up in fail-over mode, it is a single point of failure for ION ActivityDeck and ION Desk.

As IFS is not set up in fail-over mode, it is a single point of failure for ION ActivityDeckand ION Desk.

To implement this deployment model:

1 Install ION.2 Add a host to the ION deployment, for both the secondary and third host. See the Infor ION Connect

Administration Guide.

Infor ION Installation Guide | 23

Deployment editions

Page 24: Infor ION Installation Guide

24 | Infor ION Installation Guide

Deployment editions

Page 25: Infor ION Installation Guide

3Installation requirements

Use these installation requirements when you are installing ION for the first time. If you are upgradingyour existing ION installation, you can proceed directly to "Upgrade process" on page 71.

Before you install the ION suite, certain requirements must be met.

ION installation checklistThere are some installation prerequisites you must meet. The prerequisites are described in moredetail later.

The ION installation prerequisites checklist:

1 Choose your deployment scenario.See "Deployment scenarios Foundation" on page 19.If both ION Connect 3P and ION Process are required, install ION Process to get all functionalityavailable.

2 Check your platform and software requirements.3 Database settings are configured.

• Database administrator credentials are required during installation.• Optional: create the required ION database schemas before installing ION.

4 IIS settings are configured.5 Microsoft .NET framework is installed.6 Java JDK 7 update 55 or later or Java JDK 8 update 45 or later is installed.

Note: Do not use JDK 7 updates 72 to 78 due to an issue in these java versions.

7 The Infor Federation Services (IFS) software is installed and running.The minimal required IFS version is 11.1:Credentials of an IFS user are required, which will be used by ION Desk and the ION ActivityDeckapplication (the ION Service Account).Credentials of the IFS administrator are required

Infor ION Installation Guide | 25

Page 26: Infor ION Installation Guide

8 Have a domain account available that can serve as ION Service Account.This account must be registered in IFS with at least the AttributeServiceCaller role. You can usethe installer to arrange this.

9 Start the installation with a domain user with administrator privileges on the server.

10 The SMTP server details are required to receive the tasks, alerts and error notification in ION Servicethrough e-mail. You can also specify these details after the installation. Start ION Desk and selectConfigure > ION Service

11 If IFS is in SAMLTokenAllowingWindowsForWebServices mode, ensure a (CA certified) SSLcertificate is available in IIS.

Platform requirementsThe platform requirements of ION vary depending on the modules of ION that you select to install.

Virtualization platformsION runs on vSphere VMWare ESX 4.1 or later and Microsoft HyperV and Citrix XenServer 6.2.

Operating systemsIf you plan to distribute the ION installation over multiple hosts, for example by using the Grid Edition,Foundation dual host or remote databases, ensure that the used hosts are part of the same securityzone. They must be within the same network segment to prevent security and latency issues.

The required operating systems for:

• ION DeskWindows 2008 R2 x64 (Standard or Enterprise Edition).Windows 2012 x64 (Standard).Windows 2012 R2 (Standard or Data center Edition) - ION 11.1.9 or later is required.

• ION ServiceWindows 2008 R2 x64 (Standard or Enterprise Edition).Windows 2012 x64 (Standard).Windows 2012 R2 (Standard or Data center Edition) - ION 11.1.9 or later is required.SUSE Linux Enterprise Server 11 - x64.Red Hat Enterprise Linux Server x64 version 6.

Note: When your ION environment is running on a Windows 2012 or earlier version you can upgradethis OS to a Windows 2012R2 version. Before the OS upgrade ensure to update your ION environmentfirst to the patch level of ION 11.1.9 or later. After the ION update you can upgrade the OS to Windows2012 R2. Follow the standard procedure suggested by Microsoft.

26 | Infor ION Installation Guide

Installation requirements

Page 27: Infor ION Installation Guide

ION Service on Windows systemsWe recommend that you install ION on operating systems with the English locale. If your operatingsystem uses another locale language, ensure that the user accounts under which the ION softwarecomponents are running are configured to use the English language (US English). On a Windowssystem this applies to these accounts:

• The user account under which the ION IIS applications are running. This is usually the systemaccount.

• The user account under which the ION Bootstrap service is running. This is the ION Service account.

To set the English language for the system accounts in Windows 2008:

1 To open Regional and Language Options, click Start > Control Panel > Clock, Language, andRegion > Regional and Language Options

2 In the Administrative tab, click Change system locale. Change the system locale to English(United States) and click Apply.

To set the English language for the system accounts in Windows 2012:

1 To open Regional and Language Options, click Start > Control Panel > Clock, Language, andRegion > Region.

2 In the Administrative tab, click Change system locale. Change the system locale to English(United States) and click Apply.

See also: http://windows.microsoft.com/en-us/windows-vista/Change-the-system-locale.

To set the English language for a domain user:

1 Log on to the ION system with the domain user.2 To open Regional and Language Options, click Start and select Control Panel. Then select Clock,

Language, and Region and select Regional and Language Options.3 In the Formats tab, change the Format to English (United States) and click Apply.

If you run the ION Service on Linux, we recommend that you use English as the system language.

ION requires NTFS 8dot3 short names to be enabled. You can verify if these are enabled by runningthe windows command: fsutil behavior query Disable8dot3 <volume>, for example,fsutil behavior query Disable8dot3 c:

Ensure a short name exists for the folders where to install ION, typically c:\program files\infor\ION. Check if a short name exists for program files, by running dir <volume> /x, for example dir c:/x For program files you must see a short name such as PROGRA~1 .

Ensure your Windows host has a name that applies to the standards, for example, regarding the hostname http://support.microsoft.com/kb/101785

The Windows volume where ION is installed must have at least 2GB of disk space available.

The Windows volume containing the TEMP folder must have at least 2GB of disk space available.

Database management systemThe required databases:

• ION Desk

Infor ION Installation Guide | 27

Installation requirements

Page 28: Infor ION Installation Guide

Microsoft SQL Server 2008 R2 64-bit Express, Standard or Enterprise Edition.Microsoft SQL Server 2012 Express, Standard or Enterprise Edition.Microsoft SQL Server 2014, Standard or Enterprise Edition.

• ION ServiceMicrosoft SQL Server 2008 R2 Standard / Enterprise Edition.Microsoft SQL Server 2012 Standard/Enterprise Edition.Microsoft SQL Server 2014 Standard or Enterprise Edition.Oracle 11.2 Standard or Enterprise.Oracle 12C Standard or Enterprise. Note that when using Oracle 12C, it is mandatory to manuallycreate the databases upfront. The scripts are available in "SQL statements for manual creation ofdatabases" on page 105.

If you plan to use the Infor ION Mapper (Runtime) which is used for XML and Data translation; thisAdvanced Mapper uses the SQL Server database. For performance reasons use SQL Server Standardor Enterprise edition. We do not recommend that you use SQL Server Express.

Software requirementsEnsure that these requirements are met on the server(s) where you plan to install ION.

Infor Federation Services 11.1 and Microsoft AD FSBefore installing ION, Infor Federation Services (IFS) version 11.1 or later must be installed, configured,and running.

If you plan to use IFS without Infor Ming.leTM, see Infor Ming.le Installation Guide for Standalone IFSversion 11.1

If you plan to use IFS with Infor Ming.le, see these documents:

• Infor Ming.le Installation Guide for Standalone IFS Installation and Configuration Guide, Version11.1 for Active Directory Federation Services.

• Infor Ming.le Installation Guide for Standalone IFS Installation and Configuration Guide, Version11.1 for Active Directory.

If you plan to use SAML Token authentication, Microsoft AD FS 2.0 or 2.1 is required.

During the ION installation, you must specify an existing user in Active Directory. The user ID for thisuser must be added in IFS and linked to the AttributeServiceCaller security role. You can alsoadd the user when installing ION and it requires existing user linked to the IFSApplicationAdminsecurity role.

During the ION installation this user is called the 'ION Service user'.

28 | Infor ION Installation Guide

Installation requirements

Page 29: Infor ION Installation Guide

Prerequisites notificationsTo send e-mails for Error notifications in ION service and to receive the tasks and alerts through e-mail,an SMTP e-mail server must be available.

Microsoft SQL Server settingsDatabase collations:

• For fresh installations the ION Installation Wizard automatically creates the necessary databaseswith the required collation.Note: The ION installer will instruct SQL Server to create the database files in the standard datafolder. The standard location is always used, even if you adjusted the default data folder location inSQL Server. A typical installation folder is:C:\Program Files\Microsoft SQL Server

If you want these database files in a different location, create the databases manually upfront. Thisprocedure is explained later.

• You can create the databases manually and use them later in the installation. Ensure to create thedatabases with the collation defined later in this section.

User Credentials:

To install ION, these SQL Server user credentials are required:

• A System Administrator ('sa' user) credentials, with default language English, is required during theION installation. If you create the ION databases before installing ION, this is not necessary.

• A normal user with default language English, and the server role of at least 'Public', for exampleionruntime. ION Service will use these credentials for its operational use. The installer makes thisuser the database owner for the ION databases. (dbo.owner role). If you create the databasesmanually before installingION, sql server user 'dbo' must be the owner for all ION databases.

To create ION databases manually:

• Create the databases required for ION, with collation SQL_Latin1_General_CP1_CI_AS, except forthe InforIONMapper which needs SQL_Latin1_General_CP1_CS_AS.You must create these databases in SQL:

• InforIONDesk• InforIONMapper, collation: SQL_Latin1_General_CP1_CS_AS

Note: If you plan to use Oracle you must create some databases in Oracle. However, if you do notplan to use Oracle you must create the databases in SQL.An example script to create these databases can be found in "SQL statements for manual creationof databases" on page 105.Create these databases:

• InforIONCBM• InforIONMonitorEngine

Infor ION Installation Guide | 29

Installation requirements

Page 30: Infor ION Installation Guide

• InforIONWorkflowEngine• InforIONPulseEngine• InforIONTools• InforIONGrid• InforIONQueues

• Enable remote connection.• Ensure the sql server user you created earlier, for example ionruntime, is dbo owner for these

databases.

Note: The SQL Server instance must have TCP/IP ports enabled. If you plan to use another port thanport 1433 or dynamic ports you must use a named instance. In that case ensure you have the SQLServer Browser service running.

Verifying the remote connection and port settingsTo verify the remote connection and port settings:

1 Click Start on the database server.2 Select Programs > Microsoft SQL Server 2008 R2 > Configuration Tools > SQL Server

Configuration Manager.3 In SQL Server Configuration Manager, expand SQL Server Network Configuration.4 Click Protocols for instancename.5 In the details pane, right-click one of the available protocols, usually TCP/IP.6 Select Properties.7 To enable a protocol for remote connections, select the Enabled check box.8 Click OK and restart the SQL Server service.

SQL Server ExpressBy default, SQL Server Express is configured to use dynamic TCP/IP ports. To configure SQL Serverexpress to use a fixed port such as 1433, you must change some settings.

To change the settings:

1 Complete steps 1–6 as described in "Verifying the remote connection and port settings" on page30.

2 In the TCP/IP Properties dialog box, click the IP ADDRESSES tab.3 Scroll down to the IP All section.4 If the TCP Dynamic Ports field has a value, remove the value and leave the field empty.5 Change the TCP Port to a port number to use. For example: 1433.6 Click OK and restart the SQL Server service.

30 | Infor ION Installation Guide

Installation requirements

Page 31: Infor ION Installation Guide

Activating mixed mode authenticationYou must activate the mixed mode authentication in the database server. The ION installer uses theSQL server authentication during installation.

To activate mixed mode authentication:

1 Start the SQL Server Management Studio.2 Select Connect > Database Engine > Server Name - Browse for more > Network Servers >

Database Engine > Your database instance (for example, SERVER\SQLEXPRESS)..3 Right-click the root entry in Object Explorer.4 Select Properties.5 Select the Security page6 Select SQL Server and Windows Authentication mode.7 Click OK. Return to the SQL Server Configuration Manager.8 Restart the SQL Server service.

Oracle settingsIf you are not installing ION on Oracle, skip this section.

Oracle Database preparationThese Oracle user credentials for an ION installation are required:

• A System Administrator (system user) credentials. This is not necessary when you create the IONdatabases before you install ION.

• A database schema user for each Oracle schema where ION is required. The required schemasare listed later.

Adjust Oracle session timeoutA default Oracle installation has a session timeout set to 0, which means no timeout. If the clientcommunication is ended abruptly, for example caused by a system crash, these sessions are notcleaned up in Oracle. Therefore it is recommended that you change the Oracle session timeout to 10minutes.

Database collationsIf you plan to use multi-byte languages, such as Chinese or Japanese, ensure the database characterset is AL32UTF8.

Ensure that an SID or a Service Name is available for the Oracle Database server. The ION installeruses the SID or Service Name during installation.

Infor ION Installation Guide | 31

Installation requirements

Page 32: Infor ION Installation Guide

Oracle Client preparationTo install Oracle Client on the ION server:

1 Go to http://www.oracle.com/technetwork/topics/dotnet/utilsoft-086879.html and download the 32-bitsversion of the Instant Client 11.2.0.3.0.The download file is ODTwithODAC112030.zip.

2 Unzip the file and run setup.exe to start the Oracle client installer.a Click Next at the Welcome dialog box.b Select Oracle Data Access Components for Oracle Client 11.2.0.3.0 at the Select a Product

to Install dialog, and .c Click Next, the Install Location dialog box is displayed.d Specify this information:

• Oracle Base location: for example c:\oraclient Select a folder with no spaces.• Software location Name: for example OraClient11g_home1• Software location Path: for example c:\oraclient\product\11.2.0\client_1

e Click Next the Available Product Components dialog is displayed.f Specify this information:

• Oracle provider for OLE DB 11.2.0.3.0.

• Oracle Objects for OLE 11. 2.0.3.0

• Oracle Instant Client 11. 2.0.3.0

g Click Next, the Summary dialog is displayed.h Click Install.

When the installation has finished, exit the Oracle client installer.

3 Add the Software location Path to the system path variable TNS_ADMIN:a On the System Properties dialog box, click Advanced and then click Environment Variables.b Add a user environment variable, TNS_ADMIN with the value of this folder.

For example: c:\oraclient\product\11.2.0\client_1

c Change the Path system variable to include this folder and the bin folder, for example by adding%TNS_ADMIN%\and %TNS_ADMIN%\bin\ to the path.

d Create a file named tnsnames.ora, with the details of the Oracle SID or Service Name thatyou plan to install for ION installation. Place the file in the same folder, for example; c:\oraclient\product\11.2.0\client_1\tnsnames.ora

4 In this example tnsnames.ora file, replace the texts specified between '[ ]' with the details of youroracle database.

# Example tnsnames.ora.

[Connect Descriptor] =

32 | Infor ION Installation Guide

Installation requirements

Page 33: Infor ION Installation Guide

(DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = [ORACLE_SERVER])(PORT = [PORT]))

(CONNECT_DATA = (SERVER = DEDICATED) (ORACLE_SID = [SID]) or (SERVICE_NAME = [SERVICE_NAME]) ) )

5 On the Oracle server, create a folder where the ION database files must be stored.Ensure your Oracle service has full access to that folder. During the installation this folder is referredas Oracle Database Location.This is not required if you create the ION tablespaces manually before the ION installation.

Database password specificationThe ION installer and the patch installer allow these characters in the database password:

• Alpha-numeric characters:a to z , A to Z , and 0 to 9

• Special characters:<>?/.,][{}:;|+=-~_`!#$%^&*()'

The " (double quote) character is not allowed in the password.

Creating the ION tablespaces manually in advanceIf you plan to manually create the tablespaces, create the tablespaces and their related users. Ensureeach user has full authorization for its tablespace.

This table lists the users and tablespaces:

TablespaceUser

CBM_TSINFORIONCBM

BEM_TSINFORIONMONITORENGINE

WLM_TSINFORIONWORKFLOWENGINE

IPE_TSINFORIONPULSEENGINE

ITS_TSINFORIONTOOLS

GRID_TSINFORIONGRID

QUE_TSINFORIONQUEUES

Infor ION Installation Guide | 33

Installation requirements

Page 34: Infor ION Installation Guide

Configuring the Microsoft Internet Information Services(IIS) instanceInternet Information Server (IIS) is the only Web server supported by ION Desk.

On the server where you plan to install ION, certain IIS Server Role services must be installed.

You can add the roles from command line option or you can use the server manager tool of Microsoft

Installing the IIS components and services with the command lineTo install the IIS components and services:

1 On the Windows server where you plan to install ION, open the command prompt as an administrator.2 Copy this text. Paste it in the command prompt and run it.

Note that, the command must be treated as one line. If you notice carriage returns included in thecommand prompt while pasting the text, remove them before running.For Windows 2008 R2START /WAIT Dism.exe /Online /Enable-Feature /FeatureName:IIS-WebServer/FeatureName:IIS-WebServerRole /FeatureName:IIS-CommonHttpFeatures /FeatureName:IIS-HttpCompressionStatic /FeatureName:IIS-HttpErrors /FeatureName:IIS-HttpLogging /FeatureName:IIS-HttpRedirect /FeatureName:IIS-ApplicationDevelopment /FeatureName:IIS-ASP /FeatureName:IIS-ASPNET /FeatureName:IIS-BasicAuthentication /FeatureName:IIS-NetFxExtensibility /FeatureName:IIS-HealthAndDiagnostics /FeatureName:IIS-RequestMonitor /FeatureName:IIS-Security /FeatureName:IIS-URLAuthorization /FeatureName:IIS-Performance/FeatureName:IIS-WebServerManagementTools /FeatureName:IIS-ManagementScriptingTools /FeatureName:IIS-StaticContent /FeatureName:IIS-DefaultDocument /FeatureName:IIS-DirectoryBrowsing /FeatureName:IIS-ISAPIExtensions /FeatureName:IIS-ISAPIFilter /FeatureName:IIS-ManagementConsole /FeatureName:IIS-WindowsAuthentication /FeatureName:IIS-ClientCertificateMappingAuthentication /LogPath:c:\iislog.log /LogLevel:1

For Windows 2012 and Windows 2012 R2Start /w pkgmgr /iu:IIS-WebServerRole;IIS-WebServer;IIS-CommonHttpFeatures;IIS-StaticContent;IIS-DefaultDocument;IIS-DirectoryBrowsing;IIS-HttpErrors;IIS-HttpRedirect;IIS-ApplicationDevelopment;IIS-ISAPIExtensions;IIS-ISAPIFilter;IIS-ASP;IIS-ASPNET45;IIS-NetFxExtensibility45;NetFx4Extended-ASPNET45;IIS-HealthAndDiagnostics;IIS-HttpLogging;IIS-RequestMonitor;IIS-Security;IIS-BasicAuthentication;IIS-WindowsAuthentication;IIS-URLAuthorization;IIS-RequestFiltering;IIS-Performance;IIS-HttpCompressionStatic;IIS-ManagementConsole;IIS-WebServerManagementTools;IIS-ManagementScriptingTools

After running the command check the return value by using echo %ERRORLEVEL%. This must be 0(zero). In case of failure, check the logfile: %WINDIR%\logs\cbs\cbs.log

34 | Infor ION Installation Guide

Installation requirements

Page 35: Infor ION Installation Guide

Reference:http://technet.microsoft.com/en-us/library/hh825549.aspxhttp://technet.microsoft.com/en-us/library/cc749465%28v=ws.10%29.aspx

Installing IIS components and services with the Server ManagertoolAlternatively you can also use the following manual procedure to configure IIS.

On a Windows Server 2008 R2 or Windows Server 2012, use the Server Manager tool to install theIIS components and services.

Configuring your IIS instance for Windows 2008-R2:

1 Select Start > Administrative Tools > Server Manager..2 In the navigation page, expand Roles.3 Right-click Web Server (IIS).4 Click Add Role Services.5 At the Select Role Services page, scroll down and select the options as listed in the configuring

procedure of Windows 2012.

Configuring your IIS instance for Windows 2012 and Windows 2012R2To configure your IIS instance:

1 Click Start Administrative Tools > Server Manager..2 Select Manage > Add Roles and Features.3 Skip the Before you begin dialog box.4 At the Select installation type page, select Role-based or feature-based installation and click

Next.5 At the Select destination server page, select Select a server from the server pool, your server is

preselected, and click Next.6 At the Select server roles page, select Web Server (IIS).7 At the popup Add features that are required for Web Server (IIS), select Add Features and click

Next.8 At the Select Features pane click Next.9 At the Web Server Role (IIS), in the left pane select the Role Services.

When making the following selections, accept adding subsequent features where needed. Scrolldown and select these options:

Infor ION Installation Guide | 35

Installation requirements

Page 36: Infor ION Installation Guide

From the Common HTTP Features:

• Static Content• Default Document• Directory Browsing• HTTP Error• HTTP Redirection

From Application Development Features:

• ASP.Net (4.5 for Windows 2012 and Windows 2012 R2)• .Net Extensibility (4.5 for Windows 2012 and Windows 2012 R2)• ASP

From Health and Diagnostics:

• HTTP Logging• Request Monitor

From Security

• Basic Authentication• Windows Authentication• URL Authorization• Request Filtering

From the Performance Features:

• Static Content Compression

From Management Tools:

• IIS Management Console• IIS Management Scripts and Tools

10 Click Next.11 At the Confirm Installations Selections page, click Install.

CA certified SSL certificateThis step is mandatory if you are installing Event Management, ION Workflow, or ION Pulse and if yourIFS is configured to use SAML token authentication or if you plan to use http over SSL. For thiscombination, you must have a CA certified SSL certificate available in your IIS before installing ION.

36 | Infor ION Installation Guide

Installation requirements

Page 37: Infor ION Installation Guide

If you already have an SSL certificate in IIS, you can reuse it for the ION installation. If no SSL certificateis available yet on IIS, create a self-signed certificate for now. Later you can replace this certificate witha CA-signed certificate.

To create a CA-signed certificate:

1 In the IIS Manager snap-in, select the root node.2 In the Features view, double-click Server Certificates.3 From the Actions menu click Create Certificate Request.4 In the Distinguished Name Properties dialog box, specify this information:

Common NameSpecify the Full Qualified Host Name of the ION server. Specify the name in this format:server.domain.

The information specified in the following fields is important from an organizational perspective, butdoes not affect a proper functioning of the software.

OrganizationSpecify the name of your organization.

Organization unitThe name of your department within the organization (for example "IT," "Web Security," or leavethis field blank).

City/LocationSpecify the name of the city in which your organization is located.

State/provinceSpecify the name of the state in which your organization is located.

Country/regionSpecify the SSL Certificate Country Code. For example

• NL Netherlands• US United States

5 Click Next.6 In the Cryptographic Service Provider Properties dialog box, specify this information:

• Microsoft RSA Channel Cryptographic Provider• 2048

7 Click Next.In the File Name dialog box, specify a file name to save the request to a txt-file.

8 Submit the certificate request at the chosen authority and save the response to a file.9 Click Finish.

Provide the certificate request to the certificate authority of your choice.

10 On the Server Certificates dialog box in the IIS Manager snap-in, complete these steps:

Infor ION Installation Guide | 37

Installation requirements

Page 38: Infor ION Installation Guide

Click Complete Certificate Request to display the Specify Certificate Authority Response page.ab Click Browse and select the file that contains the certification authority's response.c Specify the friendly name of the response file. For example, ION SSL Certificate server.d For IIS 8 only: For the certificate store select either Personal or Web Hosting, based on your

deployment profile. Either will work.e Click OK. Write down the certificate's friendly name, you may need this name in the future. Specify

a unique name.After some time a new certificate in the Server Certificates table is shown.

Microsoft .Net frameworkConfigure IIS before you install Microsoft .NET framework.

Microsoft .NET Framework is required on the server where ION is installed.

• For Windows 2008 R2 the supported .Net Framework versions are 4.0, 4.5.1 and 4.5.2.• For Windows 2012 and Windows 2012 R2 the supported .Net Framework versions are 4.5.1 and

4.5.2.

You can download this software from the Download section at http://www.microsoft.com/net/

Note that installing .NET Framework can require a reboot of the system.

Verifying Java requirementsInstall Java Platform, Standard Edition JDK 7 with at least update 55 or Java JDK 8 with at least update45.

Note: With Java JDK 8, Infor ION Oracle EBS and Infor ION Mapper (MEC Mapper) are not supported.If you must use either of these feature, choose Java JDK 7.Do not use JDK 7 update 72 to 78 due to an issue in these java versions.

To install JDK, download it from:

http://www.oracle.com/technetwork/java/index.html

Download and install the 64-bit version of JDK.

During the JDK installation, verify this information:

1 Note the installation folder name, because you will refer to it later.2 To validate the installation of JDK, run the commands from a command prompt listed in this table:

38 | Infor ION Installation Guide

Installation requirements

Page 39: Infor ION Installation Guide

Sample responseSample Command

java version "1.7.0_55" Java(TM) SE Runtime Environment (build1.7.0_55-b13) Java HotSpot(TM) 64-Bit Server VM (build 24.55-b03,mixed mode)

java -version

Ensure the system path has a reference to a java executable. (An installation of Java on Windowswill install a java.exe in c:\windows\SysWow64, which makes it automatically part of the path)Previous ION versions required to have the JAVA_HOME system variable point to the JDK folder.For ION 11.1 this is optional. The installer will ask for the JDK folder and defaults it with JAVA_HOME.

Infor Federation ServicesFor ION 11.1, the installation of Infor Federation Services 11.1 is a prerequisite.

Infor Federation Services (IFS) provides these services for ION:

• IFS is used for ION Desk authorizations.• If ION Pulse, Event Management, or Workflow is installed, IFS registers users and distribution groups

that are used for distribution of tasks and alerts.• The security mode of IFS is used to default the authentication method for ActivityDeck. If IFS is in

Windows mode, ActivityDeck is configured in Windows mode. If IFS is inSAMLTokenAllowingWindowsforWebServices mode, ActivityDeck is configured in SAMLTokenmode during the installation of ION. You can also use the ION Security Configuration tool.

There are two possible security modes for IFS:

• Integrated Windows authentication• SAML token based authentication (claims)

The ION installation detects the security mode of the IFS Server, and uses the same authenticationmethod. If the security mode of IFS is changed after ION installation, you can run the InforION SecurityConfiguration tool to reconfigure the security mode of ION after the installation. For details about thedifferences between the two authentication methods, see the IFS documentation.

ION Pulse is installed as an optional component during the installation of ION Connect. Pulse ismandatory when using Event Management or Workflow. To use Pulse in Infor Ming.le, no additionalinstallation is required. For details about the configuration of the ActivityDeck web part, see the InforION Connect Administration Guide.

If the ION installation uses Integrated Windows Authentication, users can also install ActivityDeck ontheir desktop using a web-based install.

All ActivityDeck users must be registered in IFS User Management.

Infor ION Installation Guide | 39

Installation requirements

Page 40: Infor ION Installation Guide

Client-side requirementsOperating systemsMicrosoft Windows 7, 8

For Windows 8, ensure the system has at least the Windows updates up until June 20, 2013.

Browsers• Microsoft Internet Explorer 9, 10, 11

If you use Internet Explorer 11, you must add the ION Desk URL to the list of trusted Web sites. Formore details, see KB 1581082 at Infor Xtreme Support.

• Mozilla Firefox, any version supported by Mozilla.• Google Chrome

Google Chrome has no lifecycle policy for previous releases. Fixing is only provided at the latestversion.

• When using ION Desk in a Chrome browser, other Chrome extensions that embed themselvesin the web page through a javascript may interfere with the regular functioning of ION Desk. Ifthis problem occurs, press F12 on the Chrome browser and look for error messages in theChrome console. If there are errors from other Chrome extensions, disable these extensions.

• Chrome offers the option to translate pages. Do not use this for ION Desk and ION ActivityDeck.In Chrome 25.0, you can disable this option via Chrome > Settings > Advanced settings; underlanguages disable Offer to translate pages that aren't in a language I read.

• Apple Safari 7

Microsoft SilverlightInstall Silverlight 5.0 framework on the client machines from which ION Desk and ION ActivityDeck areaccessed. Alternatively, if your browser security settings accept it, the Silverlight plug-in is automaticallydownloaded at the first instantiation.

Authentication method for the clientsION Desk uses windows authentication to authenticate. With a default installation only ntlm and Kerberosare supported. Each ION Desk user must be a known Windows domain user, registered in IFS withthe appropriate authorizations.

For details about the ION Desk security roles see the Infor ION Connect Administration Guide.

ION ActivityDeck supports Windows and SAMLToken authentication. During the installation the IONinstaller will detect the IFS security mode and based on that decide if ION ActivityDeck must beconfigured for Windows or SAMLToken authentication.

40 | Infor ION Installation Guide

Installation requirements

Page 41: Infor ION Installation Guide

If IFS is in Security Mode Windows, also ION ActivityDeck is configured for Windows authentication.

If IFS is in Security Mode SAMLTokenAllowingWindwsForWebServices, ION ActivityDeck isconfigured for SAMLToken authentication.

After the installation use the ION SecurityConfiguration tool to change the security mode.

Integrated Windows authentication (IWA)We recommend that you configure integrated windows authentication for your browsers.

To configure IWA for Firefox and Internet Explorer, see the Infor Ming.le Installation Guide for StandaloneIFS, section "Enabling Integrated Windows Authentication".

SAML TokenION ActivityDeck desktop application is not supported when you use SAMLToken (ADFS) asauthentication method for ION ActivityDeck. In that case only the browser application is supported.

For older Firefox versions and Chrome you can disable the extended protection on the ADFS site. See"Troubleshooting" in the Infor Ming.le Installation Guide for Standalone IFS.

TCP/IP portsThis table shows the default ports that ION uses during the installation:

SSLDefault port NonsecuredPort purposeION component

Not defined9580ION Desk web port (UI)IIS

Not defined9581ION Desk web port (UI)ION Grid

Not defined9543*

9580Not applicable

ION ActivityDeck web port (UI), Windows au-thenticationSAML token authentication

IIS

29081**Not applicablePort used for Intra ION communication be-tween ION Desk/ION ActivityDeck and IONService Bus.

IIS

29082 -29088***

Not applicableInternal communication. Secured through self-signed certificates that are generated by ION.

ION Grid

Infor ION Installation Guide | 41

Installation requirements

Page 42: Infor ION Installation Guide

SSLDefault port NonsecuredPort purposeION component

53125Not applicableEphemeral ports used for inter ION communi-cation. Range starts at ion.application.initialscanport

ION Grid

• * - Secured through a certificate defined in IIS.• ** - Secured through self-signed certificates that are generated by ION.• *** - Secured through self-signed certificates that are generated by ION.

During installation, ION checks if any of these ports is in use. To manually check if any of these portsis used by existing processes, run this command from the Windows command prompt:

o netstat -ano

You can check for a specific port use:

netstat -ano | findstr <portnumber>

The last column of the netstat -ano command provides the Process-ID of the process allocating theport.

Through the Windows Task Manager you can find which Application is related to the Process-ID.

Select View > Columns ensure the PID column is selected and search in the Processes list for thefound PID.

Minimal hardware requirementsThe ION requirements when installing ION Connect 3P Foundation Edition and the database serveron the same server:

• 2 * CPU Core• 4 GB RAM• 40 GB HDD

The ION requirements when installing ION Foundation Edition (all features selected) and the databaseserver on the same server:

• 4 * CPU Core• 6 GB RAM• 40 GB HDD free space

The ION requirements when installing ION Connect 3P Grid Edition and the database server on thesame server:

42 | Infor ION Installation Guide

Installation requirements

Page 43: Infor ION Installation Guide

• 4 * CPU Core• 8 GB RAM• 40 GB HDD free space

The ION requirements when installing Infor ION Grid Edition (all features selected) and the databaseserver on the same server:

• 4 * CPU Core• 12 GB RAM• 40 GB HDD free space

Be careful with the use of virus scanners as they can affect the ION performance.

The ION software, especially ION Mapper, creates temporarily files. When running the virus scansoftware, these temporary files are inspected by the scanner and can affect the ION performance.Consider excluding the ION installation folder for scanning.

See the Infor ION Sizing and Deployment Guide for more information on sizing. Contact Infor for acomprehensive hardware sizing and advice that includes detailed recommendations such as optimalIOPS (I/O per second).

ION Service accountAn ION service account is mandatory.

Create a user account with these properties:

• A valid Windows Domain Account.The account also requires the 'Logon as a Service' policy, the ION installer takes care of this.

• Registered inIFS with the role Attribute Service Caller (The registration of this user in IFS can beperformed by the ION installer. In that case you must have the credentials *userid & passwordavailable for a user in IFS that has the IFSApplicationAdmin security role).

This account is used for:

• Starting the InforION Grid Bootstrap service.The ION Grid Bootstrap Service will manage the ION Service, ION Desk and MEC application inthe Grid.

• ION to IFS communication• ION ActivityDeck to ION Pulse engine communication

Infor ION Installation Guide | 43

Installation requirements

Page 44: Infor ION Installation Guide

44 | Infor ION Installation Guide

Installation requirements

Page 45: Infor ION Installation Guide

4Installing ION

The ION installation is run on the server where ION must be installed. The ION installer is aWindows-only installer and supports fresh installation, maintenance installation upgrade installationand uninstallation of ION.

With the maintenance installation you can add features to an existing installation.

See "Features in an ION installation" on page 65 and "Adding features to an ION installation" on page66.

To upgrade ION from an existing 10.x or 11.0 environment.

See "Upgrade process" on page 71.

In all cases, you must apply the latest ION patch level with a version of at least 11.1.9 to complete theinstallation.

For the Foundation Edition, if you plan to deploy ION on two hosts, dual host deployment, you mustrun the procedure Installing ION Service on a secondary host after you have installed ION.

Running ION installer with existing or pre-created databasesION Installer can run an installation on existing databases. During the installation you must select ifdatabases were created in advance.

When an existing database is selected, note these points:

• You can reuse databases with ION content. For example in case of restoring an ION installation ona host where ION was running. Use the same ION installer version as formerly was used during theinstallation. Only than you can reuse the existing databases. For example, you cannot select anexisting database from ION 11.0 version while running an ION 11.1 installation.

• You can install ION on manually created, empty databases. For example when:

• You want to create the databases with specific parameters, such as the file location. ,• When you want to use a database account with limited rights during the ION installation.

• The installer creates the tables in the database.

Infor ION Installation Guide | 45

Page 46: Infor ION Installation Guide

ION Connect 3P/ION installationThe installation procedure for ION Connect 3P Foundation, ION Connect 3P Grid, ION Foundation andInfor ION Grid is the same except for the features you choose to install. Start the installation with adomain user with administrator privileges on the server.

To install ION Connect 3P or ION:

1 Navigate to the folder where the ION installation setup program is located.2 Double-click the setup program.3 Click Next in the Welcome dialog box.4 The Choose Destination Location dialog box is displayed. The default path is set to c:\Program

Files\Infor\ION.Accept the default installation location or click Browse to specify your own folder.

5 Click Next, the JDK Path dialog box is displayed.If the JAVA_HOME environment variable is set, the JDK path is filled accordingly, otherwise the pathis blank. Ensure the JDK path is pointing to the installation folder of your JDK installation.

Note: You can select a JDK 6 version. Nonetheless the patch installation of ION 11.1.12 (FP4) orlater will require at least JDK 7 update 55 or JDK 8 update 45, ensure to select the proper version.If you make a mistake here, you can correct the JDK version when running the patch installation ofION 11.1.12 (FP4) or later.Do not use JDK 7 update 72 to 78 due to an issue in these java versions.

6 Click Next, the Infor ION 11 Edition dialog box is displayed.7 Select the ION features to install:

Mandatory featuresION Desk, ION Connect and ION Service Bus.

Optional featureION Pulse.

IONEvent ManagementThis feature is displayed only during an ION installation.

ION WorkflowThis feature is displayed only during an ION installation.

8 Click Next, the Infor Federation Services dialog box is displayed.9 Specify the connection information for the Infor Federation Server that is used by this ION installation.

Server Name and HTTP portThe IFS Server name. Click Browse to find the IFS servers from the network. Specify a server fromthe list and click OK. (Note the disclaimer).

ION Service AccountSpecify the IFS user without the domain name. This user ID must exist in Active Directory and mustbe added in IFS linked to the AttributeServiceCaller security role.

46 | Infor ION Installation Guide

Installing ION

Page 47: Infor ION Installation Guide

See the Infor Federation Services Administration Guide. Note that if the user does not exist in IFS,it is added in the next step.

PasswordThe password of the ION Service Account user that you just specified.

• Click Next. One of these messages can display:

• Combination of IFS Server and HTTP Port is invalid. Verify the detailsand try again

• User is not a domain user. Enter a valid Username/Password

• No message is displayed.The ION Service Account User is verified.

When IFS is configured in SAML Token Authentication mode, the installer cannot proceed. Youmust switch to the security of IFS to either Windows Authentication mode or to theSAMLTokenAllowingWindowsForWebServices mode.See the Infor Federation Services Administration Guide to switch the IFSsecurity mode.

10 If the ION Service Account user is not an IFS Administrator the IFS Administrator Credentials dialogbox is displayed. Specify the credentials of the IFS Administrator user id and password and clickOKIf the user is not attached to the security role of IFSApplicationAdmin, this message is displayed:"User requires the IFS Application Administrator security role in IFS".Ensure the provided user exists in IFS and has the role IFS Application Administrator.

11 There are two possibilities.

• When IFS is configured in Windows Mode the External Access Configuration dialog box isdisplayed.

• When IFS is configured in SAMLtokenAllowingWindowsforWebServices mode ExternalAccess Configuration(IFS using SAMLToken) dialog box is displayed.

Specify this information for the Windows mode:

• Provide URL related information in the External Access Configuration dialog box. The URLs areused by the ION clients (ActivityDeck and Desk) to connect to their server.

• The Desk and Pulse http port(IIS). The default value is 9580.• The Desk http port . The default value is 9581.

Specify this information for the SAMLtokenAllowingWindowsforWebServices mode:Information related to the URLs that is used by the ION clients (ActivityDeck and Desk) to connectto their server. Because IFS is in SAMLToken mode, Pulse (ActivityDeck) is also configured inSAMLToken mode. This requires an https binding in IIS for Pulse.To configure this, the Desk and Pulse dialog box is displayed. Specify this information:

• A Pulse https port with the default value 9543

Infor ION Installation Guide | 47

Installing ION

Page 48: Infor ION Installation Guide

• Select an existing certificate from the SSL Certificate combo box. This list is filled with thefriendly name of the SSL certificates available in IIS. If no SSL certificate is available.See "CA certified SSL certificate" on page 36.

• A Desk http port(IIS) with the default value 9580. Keep the default port if it is available.• A Desk http port with the default value 9581. Keep the default port if it is available.

12 Click Next. The Port Configuration dialog box is displayed.All ports specified in this dialog box must be unique. No other applications can use these ports.Select the default port numbers if they are available, or specify other port numbers.

13 Click Next to continue with the Email Notifications dialog box.14 Select the Send check box in order to send e-mail notifications during errors in ION Service or to

send notifications to ION ActivityDeck users.

• Specify the SMTP Server Name, for example format: mail.customer name.com.• Specify the From Address which appears as the sender on all auto generated e-mails. For

example: noreply@customer name.com

Note: You can also specify these details after the installation. Start ION Desk and click Configure> ION Service.

15 Click Next On the DB Selection Type dialog box specify your database.Select ION databases/database schemas are already created. if you manually created thedatabases in advance.If you install on SQL Server, click Next and proceed with step 16.If you install on Oracle select Oracle. The dialog box will show you the Oracle client location, asidentified by the TNS_NAMES environment variable. Proceed the installation with the steps describedin "Installing ION on Oracle" on page 49

16 Click Next. On the Database Server dialog box, specify these SQL database server details.

• Database server that you are installing to: the correct SQL Server instance name. Use Browseto select the correct database.

• When you selected ION databases/database schemas are already created do not specify thisinformation and thus are these fields disabled:

• Login ID: a user with system administrator privileges, for example sa.This user id will only be used during the installation, to prepare the ION databases in thedatabase instance.

• Password: Password of the specified user.

17 Click Next. If the database server is not reachable, or if the username and password of the sa useris incorrect, an error message is displayed.When you created the databases before starting the installer, the installer will display a messagewith the identified databases to be available. The installer asks to proceed the installation by reusingthese databases. Click Yes to continue.

18 The Please provide the user credentials for ION database access dialog box is displayed.

48 | Infor ION Installation Guide

Installing ION

Page 49: Infor ION Installation Guide

Provide the user credentials for the ION SQL Server database access that are used by ION duringruntime execution. Specify this information:

Login IDA user with at least the server role of Public.It is expected that this user ID exists in SQL Server. The ION installer will configure the requiredauthorizations for the ION related databases for this user ID in SQL Server.When you selected ION databases/database schemas are already created, ensure this LoginID is dbo owner for all ION databases.

PasswordPassword of the specified user.

19 Click Next. The Ready to install the program dialog box is displayed. Review and correct yoursettings. Click Install to start the installation.

20 When the Installation is complete proceed with "Installation completed dialog box" on page 51 tosee the results.

Installing ION on OracleThis procedure describes the second part of the ION installation. You must have completed the proceduresteps in "ION Connect 3P/ION installation" on page 46 first.

To install ION on Oracle:

1 Click Next. Specify the absolute path in Oracle Database Location, where on the Oracle serveryou expect the databases to be created.

2 Click Next. In the ION Runtime Database dialog box specify these Oracle database server details:

• Select the oracle connect descriptor where you want to install ION from the Database serveryou are installing to drop-down box. Connect descriptors are read from tnsnames.ora.

• When you did not select the ION databases/database schemas are already created checkbox,you must specify this information:

Oracle database files locationThe location at the Oracle server where the data files for the ION tablespaces must be created.

Login IDA user with system administrator privileges, typically System.

PasswordPassword of the specified user.

3 Click Next When the connection is successful, the installation proceeds. Otherwise, one of thesemessages are displayed:

• " ORA-12154 TNS: could not resolve the connect identifier specified"The database server is not reachable. Supply the connection URL manually with this format: //[ORACLE_SERVER]:[PORT]/[SID].

Infor ION Installation Guide | 49

Installing ION

Page 50: Infor ION Installation Guide

For example, //oracle_server:1521/SID. If the problem persists, verify if the entries in thetnsnames.ora file are correct. See "Oracle Settings". You will remain in the current dialog box.

• "ORA-01017: Invalid Username/Password. Logon Denied(1017)"The username and password of the user is incorrect. Verify the credentials and try again. Youwill remain in the current dialog box.

When you solve the issues, you can continue with the next step.

4 The Oracle Database users for ION service busION dialog box is displayed.When you selected ION databases/database schemas are already created, specify the passwordsyou used to create the database users, otherwise the required user accounts are createdautomatically by the installer. In that case the default value of the password is the username; forexample, for InforIONCBM, the default password is InforIONCBM. If required according to your localpassword policy, change the password.

• If required, change the passwords for the database users.In total there are three dialog boxes to define passwords for the Oracle databases that are created.

5 Click Next. The IONDesk Database dialog box is displayed.6 Specify these SQL Server details for ION Desk:

• The correct server name. On the DB server selection page, specify the server name or localhost instead.When you have not selected ION databases/database schemas are already created you mustspecify a database system administrator account, typically sa

• Specify sa as the Login ID.• Password for sa logon.

7 Click Next. The Please provide the user credentials for ION database access dialog box is displayed.Specify the user credentials ION uses to access the SQL Server database:

Login IDA user with at least the server role of Public. If databases were created in advance, ensure thesedatabases are owned by this user.

PasswordPassword of the specified user.

8 Click Next. The Ready to install the program dialog box is displayed. Review and correct yoursettings. before you start the installation.

9 Click Install to start the installation.When the installation has finished, the Installation summary dialog box is displayed. Here you canfind the result of the installer steps. Step 7 indicates the collective status of all ION Grid applicationsthat are installed by the installer. When the installation is successful, their status is displayed asOffline. Click Next to end the installation.

50 | Infor ION Installation Guide

Installing ION

Page 51: Infor ION Installation Guide

Installation completed dialog boxAt the installation completed dialog box, the message that the installation is complete and applicationsare kept offline is displayed. Apply the latest ION patch to start ION. You can select the check boxesto view the readme file, or the Install log file.

The read-me file is displayed and shows information about the location to launch ION Desk. Shortcutsfor ION Desk and ION ActivityDeck are generated in the desktop.

ION Desk and ION ActivityDeck are only available after applying the ION patch 11.1.9 or later.

A log file called Infor_ION_Install.log is generated by the installer. Use this log file to troubleshootif the installation fails. This log file is stored in this location: C:\ProgramData\Infor\Infor_ION_Install_M_D_YYYY_hh_MM_SS.log

Click Finish to close the installer.

Failing installationIf the installation fails, the ION installer rolls back most of the changes which are already performed.Databases or database schemas created by the installer are not deleted.

Results in SQL ServerThe results:

• ION databases are created.• If SQL Server resided on the same system as ION Desk:

• A virtual user IIS AppPool\IONDeskAppPool is added to the DBServer and permissions fordb read and write are given for the InforIONDesk database.

• A virtual user NT AUTHORITY\NETWORK SERVICE is added to the DBServer and permissionfor db read is given for the InforIONDesk database.

• If SQL Server resided on another system than ION Desk: A virtual user windows domain\hostname$is added to the DBServer and permissions for db read and write are given for the InforIONDeskdatabase.

Infor ION Installation Guide | 51

Installing ION

Page 52: Infor ION Installation Guide

52 | Infor ION Installation Guide

Installing ION

Page 53: Infor ION Installation Guide

5General post-installation

After ION is installed, note the following.

Installing latest ION 11.1 PatchWe recommend that you install the latest patch for the ION 11.1 installation.

To install the patch:

1 Go to the InforXtreme Download center.2 Download the latest Infor10_ION_11.1.x_PatchInstall.zip.

Select the patch level of version ION 11.1.9 or a later version.ION patches are cumulative, applying the latest patch includes all previous patches.

3 Continue with the installation of the patch as explained in the release notes of the patch.4 After a successful patch installation, the status of all standard ION Grid applications will change to

online.

Version detailsYou can verify the installed ION version through Windows Control Panel > Program and Features.

The version must match the patch level you installed. Ensure that it is at least 11.1.9 or later.

For more detailed information about the installed components click the Version details, on the IONDesk home page.

An explanation of this page is described in theInfor ION Connect Administration Guide.

Infor ION Installation Guide | 53

Page 54: Infor ION Installation Guide

Installer completed with warningsIf the installer completed with warnings, ensure to check the installation log file for recommendationson post installation steps. Search in the log file for log statements of severity ERROR and WARN.

These are the typical reasons:

• Logged as a warning: ION installation was run under a local administrator account, which could notbe added as a user to IFS.

• Logged as a warning: During an upgrade: several local users were defined as ION Deskadministrators, these accounts could not be registered in IFS as ION Desk administrators as IFSonly supports domain accounts.

• Logged as a warning: Databases were created in advance and ION installation performed withdatabase users having limited database authorizations. As a post installation step additionalauthorizations must be configured in SQL Server. The log file will provide a sql statement that mustbe run in SQL Server.

Activating ION in IFS when SAMLToken is usedTo activate ION in IFS.

When IFS is in SAMLTokenAllowingWindowsForWebServices mode, you must register ION as anapplication in IFS and activate this application in IFS.

Note: This step is not required if IFS is configured with Windows authentication.When you activate ION in IFS, the person ID is added to the user object in IFS.

1 Launch the IFS application by specifying the URL as: https://servername:portno/IFS orhtps://servname:portno/IFS.For example:

• http://computername:9680/IFS

• https://computername:9643/IFS/

2 Log on using IFS administrator's credentials.3 Select Configure > Applications4 Select the installed ION ActivityDeckPulse On machinename:httpsPort available in status is

Pending.5 Click Activate and add to ADFS.

The Administrator credentials dialog box is displayed. Only the Administrator on the ADFS serverhas permissions to activate. Provide the credentials and click OK.

6 After the application is active, a user property called Person is available for every user in IFS.Ensure that this property is filled for all the users who want to use ION ActivityDeck or ION Desk.There are two options:

54 | Infor ION Installation Guide

General post-installation

Page 55: Infor ION Installation Guide

• For each user, you can manually specify a value for each user based on their logon to an LNapplication. For example, based on the user's logon credentials in an LN application.

• IFS provides the option to automatically fill the Person property with the user's UPN value.See the Infor Federation Services Administration Guide.

ION Desk user authorizationsION Desk is a Microsoft application that relies upon the NTLM credentials of the user for authentication.For authorization, it relies upon the roles of the user as defined in the IFS application.

Points of attention on the role based access to ION Desk:

• ION Desk is an administrative application.• IFS application contains these standard security roles:

• Users with the role IONDeskAdmin will have full access to all ION Desk pages except the securityadmin pages.

• Users with the role IONDeskSecurityAdmin will have full access to the security admin pages ofION Desk.

• Further access control to ION Desk can be achieved by defining business security roles in IFS andby linking the users with security roles. Further the security roles are linked with ION Desk Profiles.For more information see Infor ION Connect Administration Guide.

• The user who installed ION has access to ION by default.

How to start ION DeskYou can start ION Desk in these ways:

• Launch ION Desk through the installer at the end of the installation.• Use the desktop shortcut for ION Desk which the installer created.

The URL location information to access the ION Desk is noted in the ReadMe.txt file. The ReadMe.txt file is in the Install Location Home folder.

Log on to ION DeskYou can log on to ION Desk with your Windows account. Ensure that your user ID has the security roleIONDeskAdmin in IFS.

Infor ION Installation Guide | 55

General post-installation

Page 56: Infor ION Installation Guide

Note: In ION Desk you can open the Grid Management UI as an embedded UI. In this Grid managementUI you are asked to authenticate if you try to perform actions for which you are not authorized. It isexpected that you always use the same identity within both ION Desk and Grid simultaneously.

Configuring ION Service for ION ActivityDeckattachmentsION ActivityDeck users can link attachments to tasks, alerts and notifications. By default, this featureis not enabled. To enable this feature, switch the Allow File Attachments setting on and specify theFile Storage Settings.

Go to ION Desk and click Configure > ION Service.

For more information, see theInfor ION Connect Administration Guide.

ION Bootstrap Service depending on Oracle serviceWhen using Oracle and the Oracle instance is running at the same system as ION, arrange that startingthe ION Bootstrap Service depends on the starting of the Oracle Instance and Oracle TNS Listener.

Run this command on the system where ION and Oracle are installed:

sc config [Infor ION Bootstrap service name] depend=[Oracle SID servicename]/Oracle TNSListener service name

Copy and paste the service names from the Windows services details.

Example:

sc config "Infor ION Grid Bootstrap - ION - " depend= OracleServiceSID1/OracleOraDb11g_home1TnsListener

Installing latest ION Registry contentNew releases of Infor ION Registry content are independent of the release schedule of ION version.You can update your ION registry with the latest content using the patch installer of ION Registrycontent.

This is the list of KB numbers with the latest ION Registry content:

• ION Registry 2.12.x – KB 1619540• ION Registry 2.11.x – KB 1597072

56 | Infor ION Installation Guide

General post-installation

Page 57: Infor ION Installation Guide

• ION Registry 2.10.x – KB 1590895

To upgrade to the latest content within your current base version, run the highest patch solution of thebase version. If you want to upgrade to a different higher base version, upgrade to the 2.x.0 versionof the new base first. Then upgrade to its highest patch solution. For example, if you want to upgradeyour registry content from 2.10.5 to 2.12.1, you must first move to 2.12.0 and then to 2.12.1.

Note that ION 11.1 is delivered with the base version of ION Registry content 2.10.0.

Infor ION Installation Guide | 57

General post-installation

Page 58: Infor ION Installation Guide

58 | Infor ION Installation Guide

General post-installation

Page 59: Infor ION Installation Guide

6Installing ION Service on a secondary host

Note: The procedures are only applicable for the ION Foundation and ION3P Foundation edition andif the ION security is in Windows or WindowsOverSSL.If your security is in SAMLToken, you must first switch the security mode to Windows using theSecuritySwitch tool. Then use this procedure to include a secondary host. After completing the procedureyou can switch back to SAMLToken security.

To set up an ION Foundation or ION3P Foundation edition installation using two hosts:

• ION Desk and ION ActivityDeck are deployed on the primary host• ION Service is deployed on the secondary host.

Some notes on the deployment options:

• IFS and if applicable ADFS, can be deployed on the primary host, secondary host (if not Linux) oranother host.

• The database instance can be deployed on the primary host, secondary host or another host. Note:SQL Server cannot be deployed on Linux.

A prerequisite for this procedure is that ION Foundation or ION3P Foundation is already installed onthe primary host. This can be the result of a fresh ION installation or of the upgrade from a previousION release to this release.

Infor ION Installation Guide | 59

Page 60: Infor ION Installation Guide

Prerequisites for dual host deploymentMeet these prerequisites:

• ION is installed.On the primary host, ION Foundation or ION3P Foundation is installed and functional.

• Java on the secondary host:

• On the secondary host, install a supported Java Platform, Standard Edition (JDK) version. .For more information, see "Verifying Java requirements" on page 38

• Note the installation folder name, you will refer to it later.• To validate the installation of JDK, run the commands from a command prompt listed in this table:

Sample responseSample Command

java version "1.7.0_55" Java(TM) SE Runtime Environment (build1.7.0_55-b13) Java HotSpot(TM) 64-Bit Server VM (build 24.55-b03,mixed mode)

java -version

• Administrator on primary and secondary host.You must have an administrative account for both the primary and secondary host that entitles youto install the software.

Adding the secondary hostThis procedure describes how to change your ION single host deployment to a dual host deployment.

Caution: Do not change hosts or bindings through the Grid management UI as they can leadan improper functioning of ION.

Note: during this procedure ION will temporarily be unavailable.

To add a secondary host to ION contains these main steps:

1 Generate a deployment package for the secondary host2 Install the deployment package on the secondary host3 Activate dual host deploy

Generate a deployment package for the secondary host:

1 Log on to the primary host with an administrative account, for example by using remote desktop.2 In administrative mode, open the SecurityConfiguration.exe application, located in: ION

installation folder/SwitchableSecurity

For a default installation:

60 | Infor ION Installation Guide

Installing ION Service on a secondary host

Page 61: Infor ION Installation Guide

c:\program files\Infor\ION\SwitchableSecurity\SecurityConfiguration.exe

The Infor ION Configuration Utility opens on the Infor ION Security Configuration tab.

3 Click the Dual Host Setup tab.Before continuing, ensure ION Desk and ION Service have the application status OK. The statusof the MECApplication is not relevant.

4 Click Generate deployment package.5 Specify this information:

• The Remote Host(FQDN) full qualified host name (so including the domain name)• The Agent Port number, or accept the default which is the same as the port number of the

primary host.

6 Click OK, the Save deployment package for <remote host> dialog box is displayed.7 Select the location to store the file bootstrap-installer-remotehost.jar8 Click Save.

The file is saved and a message is displayed to copy and run the file. Read the instructions andclick OK.You can leave the Infor ION Configuration Utility window open while you continue with the nextprocedure. In the procedure "Activate dual host deployment" on page 63 you will return to this dialogbox.

Installing the deployment package on the secondaryhost (Windows)1 Transfer the file bootstrap-installer-[remotehost].jar to the secondary host.2 Log on to the secondary host.3 Double-click the bootstrap-installer-[remotehost].jar4 Accept the User Account Control question.5 Select the installation path in the Installation of Infor ION Grid Bootstrap dialog box. You can use

the provided default path c:\Program Files\Infor ION Grid Bootstrap6 Click Next and confirm the creation of the target directory.7 In the JDK Path dialog box select the path of the JDK installation, usually c:\program files\

java\jdk1.[version]

8 Click Next.9 In the Installation dialog box, click Next.10 Specify the userid and password of the userid on which the Infor ION Grid bootstrap service must

run.

Infor ION Installation Guide | 61

Installing ION Service on a secondary host

Page 62: Infor ION Installation Guide

Ensure to provide the same user as where the bootstrap service on the primary host is running on.The so called ION Service user. Do not forget to include the domain of that user, for example acme\ionservice.

11 Click Next, the Perform External Processes dialog box is displayed12 Click Next, the Installation Finished dialog box is displayed.13 Click Done

The ION Bootstrap service is installed as a Windows service on the secondary host, running on theION Service user account.

Installing the deployment package on the secondaryhost (Linux)1 Transfer the file bootstrap-installer-remotehost.jar to the secondary host.

Preferably to the /opt folder.

2 Log on to the secondary host.3 Install the Infor ION Grid bootstrap service (daemon) by running this command:

java -jar bootstrap-installer-remotehost.jar

The installer will prompt a few questions.

4 For the Select target path select the installation path, for example /opt/ion or use the provideddefault.

5 Press Enter and press 1 to continue.6 For the JDK Path provide the path of the JDK version.7 Press Enter and press 1 to continue.8 Specify the Service user for the Linux system account under which the Service must run, for example

root9 Press Enter and press 1 to continue.10 Specify the Service group for the Linux group name under which the Service must run, for example

root.11 Press Enter and press 1 to continue.

The ION Bootstrap service is registered as a Linux daemon under rc3.d.You can find the script to start and stop the daemon in: /etc/init.d/infor_ion_grid_bootstrap_ION_<fqhn>.

62 | Infor ION Installation Guide

Installing ION Service on a secondary host

Page 63: Infor ION Installation Guide

Activate dual host deploymentTo activate:

1 Return to the Infor ION Configuration Utility dialog box.2 Click Refresh. The status of the secondary host in the Hosts list, changes to Up.

Refresh a couple of times, as it can take some time before the secondary host service is fully startedand recognized by the primary host.

3 Select the Dual host deployment checkbox, which status is Inactive.4 Click the Activate. The status of Dual host deployment changes to Active.

The deployment for the second host will show IONService. It can take some time before thesechanges are reflected.

Removing a secondary hostThis procedure describes how to change your ION dual host deployment to a single host deployment.

Note that during this procedure ION will temporarily be unavailable.

The procedure to remove a secondary host to ION consists of these main steps:

1 Deactivating dual host deployment.2 Removing the secondary host.3 Uninstalling the Infor ION Grid Bootstrap service from the secondary host.

Deactivating dual host deploymentTo deactivate dual host:

1 Log on to the primary host with an administrative account, for example by using remote desktop.2 In administrative mode, open the application SecurityConfiguration.exe

You can find this application in: ION installation folder/SecurityConfigurationFor a default installation:c:\program files\Infor\ION\SwitchableSecurity\SecurityConfiguration.exe

The Infor ION Configuration Utility is displayed on the Infor ION Security Configuration tab.

3 Click the Dual Host Setup tab.The dual host deployment status is Active.

4 Specify the Grid administratorUser Id and Password.5 Select Single host deployment. Which status is Inactive.6 Click Activate.

Infor ION Installation Guide | 63

Installing ION Service on a secondary host

Page 64: Infor ION Installation Guide

The IONService is transferred to the primary host again. When you receive the message"IONService' application has been started successfully" the transfer is finished.At this point ION is available again and you can remove the second host from the registration.

Removing the second hostBy uninstalling the bootstrap service from the secondary host, the host will also be unregistered fromthe Grid environment.

Before uninstalling, ensure to have moved all applications to the primary host.

To uninstall the ION Grid Bootstrap service:

1 Log on to the secondary host.2 For Windows; open a command prompt, which you run as Administrator.3 Change directory to the ION Grid Bootstrap installation folder. For example:

On Windows: cd c:\program files\Infor ION Grid BootstrapOn Linux :cd /opt/ion

4 Uninstall the ION Grid Bootstrap service by running the command: java -jar uninstall\uninstall.jar

5 Change directory to root of the installation folder:On Windows: cd c:\program filesOn Linux :cd /opt

6 Delete the grid installation folderOn Windows: del "Infor ION Grid BootstrapOn Linux :rm -r ionIf you had an active ION Desk connection to the ION installation, you must refresh your browser torefresh the connection.

64 | Infor ION Installation Guide

Installing ION Service on a secondary host

Page 65: Infor ION Installation Guide

7Features in an ION installation

You can add features to an existing ION installation in these ways:

• Reuse the same installer and add features that were not added during the initial installation.• Use another installer that will install more features than before.• Run the latest ION patch.

For example:

• ION Foundation is installed, but during the initial installation workflow was not installed. An updatewith the workflow feature is required.

• ION Foundation is installed and an update to ION Grid Edition is required.

You cannot remove already installed features from an ION installation.

When adding features to the existing ION 11.1 installation, ensure to perform this task at the Windowssystem with:

• A user that has administrative rights.• The user is part of the local Windows domain group ION_full.

If during the installation of ION, you have chosen to have databases created manually in advance,ensure you also have created these databases before adding the related feature.

If your ION installation originates from ION 11.0, later upgraded to ION 11.1, ensure that during theadding of features, temporarily, the ION database user has administrative rights for the database. Theinstaller, using that user, must be able to create the databases. Alternatively, create the databasesmanually in advance and make the ION database user the owner of these databases.

If you use Oracle, create the users and tablespaces required for Oracle, otherwise create the databasesrequired for SQL Server.

For SQL Server, the databases must be created with collation SQL_Latin1_General_CP1_CI_AS.Ensure the database user used to access these databases during runtime is owner of these databases.

This table shows the database(s), user(s) and tablespace(s) that must be created:

OracleOracleSQL ServerFeature

TablespaceUserDatabase

Infor ION Installation Guide | 65

Page 66: Infor ION Installation Guide

OracleOracleSQL ServerFeature

BEM_TS andWLM_TS

INFORIONMONI-TORENGINE and IN-FORIONWORK-FLOWEGINE

InforIONMonitorEngine and In-forIONWorkflowEngine

Event Managementand/or Workflow

IPE_TSINFORION-PULSEENGINE

InforIONPulseEnginePulse

Adding features to an ION installationTo add features to an ION installation:

1 Start the ION Installer on a system where ION is already partially installed. The installer providesthese options:

• Modify: Add or Remove the feature.• Remove: Completely uninstall InforION.

2 Select Modify and click Next to continue.3 Select the ION features to install.

• ION Desk and ION ConnectION Service Bus are mandatory components.• ION Pulse, Event Management and ION Workflow are optional.

4 Click Next. If the database password is changed between the installations, a message is displayed.Complete these steps:

• Click OK. The Database dialog box (SQL Server, Oracle) is displayed• Supply the correct logon credentials of the database.• After a successful logon to the databases, the installer proceeds with the installation.

5 At the end of the installation the grid application remain Offline. Before using ION, you must installthe latest ION patch.For more information, see "Installing latest ION 11.1 Patch" on page 53.

66 | Infor ION Installation Guide

Features in an ION installation

Page 67: Infor ION Installation Guide

8Installing an ION ActivityDeck client

Skip this chapter if you installed only ION Desk and ION Connect, or if ION is configured with SAMLTokenbased authentication.

You can install the ION ActivityDeck client application after you have performed the ION installation.

Note: You require the computer name where the ION server is installed. The URL for the IONActivityDeck installation is in the Readme.txt file from the ION server installation. This URL containsthe computer name of the ION server side installation, for example, http://computername/Pulse.

To start the installation:

1 Navigate to the ION ActivityDeck installation URL mentioned in the Readme.txt file from the IONserver installation. For example, http://computername:9580/Pulse/

2 Click Install on the HTML page.3 Click Install on the Security Warning.

After the installation is complete, the ION ActivityDeck application opens automatically. The view isempty. The computer name of your ION server installation is in the top of the window.You can install several ION ActivityDeck applications for different ION Servers. Each ION ActivityDeckcan display Tasks and Alerts from its own server.To restart the ION ActivityDeck application, click the shortcut on the desktop.If IFS is in SAML authentication mode, ION ActivityDeck can be accessed only in a browser.To access the single column ION ActivityDeck, use this URL format:https://[computername]:[port]/Pulse/ActivityList

To access the multi column ION ActivityDeck, use this URL format:https://[computername]:[port]/Pulse/ActivityDeck

Installation issuesIssues can occur during the installation.

Infor ION Installation Guide | 67

Page 68: Infor ION Installation Guide

IFS errorDuring the ION ActivityDeckinstallation, a message can inform you that there was a failure to subscribeto the server. Your user account is unknown or incorrectly configured in IFS User Management. Contactyour system administrator.

ION ActivityDeck in SAMLTokenAllowingWindowsForWebServicestoken authentication modeIf ION ActivityDeck is configured to use SAML token authentication, ION ActivityDeck can fail to startin the browser; this generic message is displayed: Browser cannot start this page.

In such cases, check the event viewer for this message: The following fatal alert wasgenerated: "20. The internal error state is 960. This message is caused by a corruptedSSL certificate.

For details, see http://social.technet.microsoft.com/Forums/en-US/windowsserver2008r2webtechnologies/thread/091a3222-641b-43a3-ae19-6cc238828950/

HTTP errorLogging into ION ActivityDeck can result in a generic error message "Browser cannot start this page",without additional information in the Event viewer. Verify if the HTTPS binding for the InforION Websitespecified during the installation (default port: 9585) is successfully added.

Do not modify the HTTPS binding used for internal ION communication (default port: 9583). This isabout the second HTTPS binding on the InforION website, which is added only if IFS is configured withSAML token authentication mode.

Verifying this HTTPS binding:

1 In the IIS Manager snap-in, select the server node that represents the ION server..2 Navigate to Sites > InforION3 Select the InforION website.4 Under the Actions pane on the right hand side, click Bindings….

The Site bindings dialog box is displayed.

5 Look for an HTTPS binding with the port number specified during installation (default 9585). Checkwhether a certificate is attached to it.

6 If the binding was not created during the installation, complete these steps:a Manually add a binding for 'https', with IP address "All Unassigned" and the Port number that

was specified for the https port during installation.b Select the certificate you want to use in this binding. If you do not have a certificate, see "CA

certified SSL certificate" in chapter 2.

68 | Infor ION Installation Guide

Installing an ION ActivityDeck client

Page 69: Infor ION Installation Guide

7 If the binding is created, but the certificate is not attached, select the binding and edit it by attachingthe certificate.

8 Click OK and close the Site bindings dialog box.

Silverlight plug-inTo install and use ION ActivityDeck, the Silverlight 5.0 browser add-on is required.

Install Silverlight 5.0 if the browser requests for installation. Follow the instructions to download andrun the Microsoft Silverlight installer. When the installation is complete, you can install ION ActivityDeck.

Infor ION Installation Guide | 69

Installing an ION ActivityDeck client

Page 70: Infor ION Installation Guide

70 | Infor ION Installation Guide

Installing an ION ActivityDeck client

Page 71: Infor ION Installation Guide

9Upgrade process

The upgrade process with the ION installation wizard on an existing ION 10.x.x or 11.0 environmentis described here.

To run this installation wizard to install a new ION environment, see "Installing ION" on page 45.

The ION upgrade installation wizard will upgrade your ION 10.x.x or ION 11.0.x deployment to ION11.1.0, while the feature selection will remain the same. For example if you did not install ION Workflow,the upgrade will not offer you the option to install ION Workflow now. To add features you must run theinstallation again.

You can upgrade from an ION version before ION 10.3 while your ION databases are set with a collationor character set that is case-sensitive, please contact Infor Xtreme Support to discuss the best approachfor your upgrade. For proper functioning, the SQL Server ION databases must be set with acase-insensitive collation. This is enforced by the installer.

ION 11.1 provides an automatic upgrade of existing ION 10.x or ION 11.0 environment to the new ION11.0 environment. This means:

• It is not required to uninstall the existing 10.x or ION11.0 setup. The ION 11.1 setup can run directlyon top of your existing ION setup.

• ION Process is upgraded automatically. This means all your active Event Monitors, ActivationPolicies, and Workflows continue to be active at the end of ION 11.1 installation.

• ION Connect is upgraded automatically. This means all your Document flows and Connection Pointscontinue to be active at the end of the ION 11.1 installation. However, for ION 10.2 or previousrelease customers, if any of the Infor Application or Database connection points uses a MySQLdatabase, you must deactivate the concerned document flows before the upgrade process.

During the upgrade process the ION application is offline.

Overview upgrade procedureComplete these tasks:

1 Backup Existing Configurations.2 Plan the upgrade.3 Ensure all prerequisites are met.4 Start the upgrade installation.5 Run the latest patch installation.

Infor ION Installation Guide | 71

Page 72: Infor ION Installation Guide

Configuration backupNote: This section is not applicable for ION 11.0.x upgrades.

Before you start the upgrade, you must back up some configuration files that you must restore afterthe upgrade. Back up the Logging configurations of all Infrastructure components.

1 Go to Configure > Logging > Infrastructure tab.2 If you have customized the log settings, these will be reset to default after the installation. Therefore

make a note of the values, such as the log levels. You can reconfigure them manually after theupgrade.

LN content packsNote: This section is not applicable for ION11.0.x upgrades.

This note is applicable only if you use LN content packs. LN content pack v4 and lower do not workwith ION 11.0 and ION 11.1.

For details on available LN content pack versions and how to upgrade, see solution KB 1026816 inInfor Xtreme.

Business VaultNote: This section is not applicable for ION 11.0.x.

If your current ION 10.x installation includes Business Vault, check solution KB 1390660 at Infor Xtremesupport for instructions to upgrade Business Vault.

Host name more than 15 charactersUsing a Windows host name with more than 15 characters is against Microsoft standards and notsupported by the ION 11.1 installer.

If you have questions about an upgrade from a system with a more than 15 character name and youwant to discuss the best approach for upgrading contact the Infor Xtreme Support portal at http://www.infor.com/inforxtreme.

Regular backup for recoveryTo be prepared for recovery, you must back up your existing configuration.

72 | Infor ION Installation Guide

Upgrade process

Page 73: Infor ION Installation Guide

Mandatory steps to backup for recoveryThe mandatory steps are:

1 Backup these ION databases:

• InforIONCBM• InforIONDesk• InforIONMonitorEngine• InforIONTasklist (if you upgrade from ION 10.0, this not used with ION 10.1 and later).• InforIONWorkflowEngine• InforIONPulseEngine (if you migrate from ION 10.1 or later).• InforIONTools (if you migrate from ION 10.1 or later).• InforIONGrid (if you migrate from ION 11.0).• InforIONMapper (if you migrate from ION 11.0).• InforIONQueues (if you migrate from ION 11.0).

2 Backup the host where ION is installed.

Optional steps to backup for recoveryOptionally you can consider to backup the individual configurations for a partial recovery.

1 Log on to your existing ION Desk application.2 Export the current Document Flows. Select Model > Connect > Document Flows..

a By default the first row is selected. To select all document flows hold down Shift and click thelast row.

b Click Export.The message Do you also want to export the properties is displayed.

c Click Yes. Browse to a convenient location and specify a file name for the export.

3 Export all Mappings.a Select Model > Connect > Mappings.b By default the first row is selected. To select all mappings hold down Shift and click the last row.c Click Export.d Browse to a convenient location and specify a file name for the export.

4 Export all Connection Points.a Select Model > Connect > Connection Points.b By default the first row is selected. To select all mappings hold down Shift and click the last row.c Click Export.d Browse to a convenient location and specify a file name for the export.

5 Export all Monitors.

Infor ION Installation Guide | 73

Upgrade process

Page 74: Infor ION Installation Guide

Select Model > Connect > Event Management > Monitors.ab By default the first row is selected. To select all monitors hold down Shift and click the last row.

Ensure that you have explicitly selected all monitors before you export them.c Click Export.d Browse to a convenient location and specify a file name for the export.

6 Export all Activation Policies.a Select Model > Workflow > Activation Policies.b By default the first row is selected. To select all workflows hold down Shift and click the last row.

Ensure that you have explicitly selected all activation policies before you export them.c Click Export.d Browse to a convenient location and specify a file name for the export.

7 Export all Workflow definitions.a Select Model > Workflow > Workflows.b By default the first row is selected. To select all Activation Policies hold down SHIFT and click

the last row. Ensure that you have explicitly selected all workflows before you export them.c Click Export.d Browse to a convenient location and specify a file name for the export.

8 Export all Codes.a Select Configure > Codesb By default the first row is selected. To select all codes hold down Shift and click the last row.

Ensure that you have explicitly selected all codes before you export them.c Click Export.d Browse to a convenient location and specify a file name for the export.

9 Backup the Logging configurations of all Infrastructure components.a Select Configure > Logging > Infrastructureb If you have customized the log settings, these will be reset to default after the installation. Make

a note of the values such as the Log levels to reconfigure them manually after the upgrade.

10 Backup the custom BODs.a Navigate to ION Install home\Desk\bin\RegistryData\BodMetaData\. For example

navigate to: C:\Program Files\Infor\ION\Desk\bin\RegistryData\BodMetaData\.

b Backup the Custom folder from this location.

11 Backup the Workflow drill back view definitions.This step is only applicable if you created custom Workflow drill back view definitions.a Navigate to ION Install home\Desk\bin\RegistryData\ViewMetaData\. For example

navigate to: C:\Program Files\Infor\ION\Desk\bin\RegistryData\ViewMetaData\.

b Backup the Custom folder from this location.

12 If the SAP Connector is installed.

74 | Infor ION Installation Guide

Upgrade process

Page 75: Infor ION Installation Guide

Navigate to ION Install home\Desk\bin\RegistryData\ThirdPartyMetaData\SAP\MetaData\Custom. For example navigate to: C:\Program Files\Infor\ION\Desk\bin\RegistryData\ThirdPartyMetaData\SAP\MetaData\Custom.

a

b Backup the Custom folder from this location.c Navigate to ION Install home\Desk\bin\RegistryData\ ThirdPartyMetaData\

SAP\XSLT\Custom. For example navigate to: C:\Program Files\Infor\ION\Desk\bin\RegistryData\ ThirdPartyMetaData\SAP\XSLT\Custom.

d Backup the Custom folder from this location.

13 Backup the ION ActivityDeck hyperlink configuration.This step is only applicable if you configured views for alert drill backs.a Backup the file ION Install home\Pulse\hyperlinks.xml. For example navigate to: C:

\Program Files\Infor\ION\Pulse\hyperlinks.xml.b Only applicable for ION 10.3 or earlier:

If you customized the layout for e-mail notifications sent by Pulse. Backup the folder: IONInstall home\IONRuntime\ServiceBus\config\pulse_email. For example navigateto: C:\Program Files\Infor\ION\IONRuntime\ServiceBus\config\pulse_email.

14 Backup all users in the IONDeskAdministrators Windows user group.a Select Server Manager > Configuration > Local Users and Groups > Groups >

IONDeskAdministrators.b Contact your Windows administrator to make a backup of this list or write down the list of users

who are currently part of this group.

15 This step is applicable for iSeries customers only.a Identify all Infor JDBC and Database Connection Points with Database Type as DB2_400.b Ensure that the connection URL property is suffixed with the parameter: prompt=false. A

correct URL configuration has format: jdbc:as400://HostName;naming=system;libraries=SchemaName;prompt=false.

c Return to the connection point list view. Note all active document flows where this connectionpoint is used. To show the list select the Connection point from the list and click Usage

Planning for the upgradeFor ION 11.1, IFS 11.1 is a prerequisite for any deployment model, even if you have ION 10.x withConnect only, you need to install IFS 11.1 before upgrading to ION 11.1. If IFS is already installed,upgrade it toIFS 11.1.

Note that IFS 11.1 is not supported with previous ION versions, plan the upgrade to IFS 11.1 and ION11.1 simultaneously.

Infor ION Installation Guide | 75

Upgrade process

Page 76: Infor ION Installation Guide

IFS Authentication ModeIf the IFS security mode is SAML Token, the installer cannot proceed. You must switch the security ofIFS to either Windows Authentication mode or to the SAMLTokenAllowingWindowsForWebServicesmode. To switch the IFS security mode, see the Infor Federation Services Administration Guide

ION Desk authorizationsNote: This section is not applicable for ION 11.0.x upgrades

Until ION 10.3, access control to ION Desk was based on the Windows NT user group IONDeskAdministrator. From ION 11.0 onwards, access control to ION Desk is based on the security roleslinked with an user in IFS. All users of ION Desk from ION 11.0 onwards must be Microsoft ActiveDirectory domain users and registered in IFS. Consequently, Local windows users who are not domainusers and part of IONDeskAdministrator windows group cannot access ION Desk.

During the upgrade, the installer will automatically migrate the existing domain users of the windowsNTIONDeskAdministrator group to the IFS and assigns the role of IONDeskSecurityAdmin tothose users. They will continue to use the same level of access to ION Desk.

Using Oracle Service nameWhen you upgrade from ION 10.3 to ION 11.1 and for ION 10.3 you already configured the use of anOracle Service Name instead of an Oracle SID.

Before you start the upgrade, in the ion.persist properties in the config directory ensure the propertyion.persist.database.oracle.servicename is set with the correct value.

The ION 11.1 installer will use this ion.persist.database.oracle.servicename parameter toconstruct jdbc urls for the grid application and new ion databases and will remain to use the ion.persist.<databaseschema>.database.url parameter for the existing databases.

Post installation: you can consider to empty the ion.persist.<databaseschema>.database.url in which case the ION Service runtime will construct the urls based on the servicename parameter.

Updating the Oracle clientThe ION 11.1 installer needs an updated Oracle client for the installation.

Before starting the upgrade, ensure you made the preparations as described in "Oracle client preparation"on page 32. Ensure to copy the tnsnames.ora file you used with the previous client as the upgradeinstaller will expect the same.

76 | Infor ION Installation Guide

Upgrade process

Page 77: Infor ION Installation Guide

Infor ION Grid Bootstrap serviceNote: This section is not applicable for ION 11.0.x upgrades

Perform this task when you upgrade from ION 10.3 or earlier.

During the upgrade the InforION Service is replaced with the Infor ION Grid Bootstrap Service.

If you upgrade from an ION version where you did not use IFS, you must consider these prerequisites.The Infor ION Grid Bootstrap service account must always meet these conditions.

Create a user account with these properties:

• A valid Windows Domain Account• Local Admin on ION server.• Run as a Service policy• Eventually registered inIFS with the role Attribute Service Caller (The registration of this user in IFS

can be performed by the ION installer. In that case you must have the credentials *userid & passwordavailable for a user in IFS that has the IFSApplicationAdmin security role).

This account is used for:

• ION ActivityDeck to ION Service communication.• Starting the Infor ION Grid Bootstrap service.• ION to IFS communication

Manually creating databasesNote: Not applicable for ION 11.0.x upgrades

ION 11.0 introduced new database schemas.

You can create the databases manually and before starting the upgrade.

• These databases are new:

• When upgrading ION version 10.0:

Infor ION Installation Guide | 77

Upgrade process

Page 78: Infor ION Installation Guide

InforIONPulseEngine, Create this database with collation SQL_Latin1_General_CP1_CI_AS.Do not create this database in SQL Server if you use Oracle.

• When upgrading ION version 10.0:InforIONTools, Create this database with collation SQL_Latin1_General_CP1_CI_AS. Do notcreate this database in SQL Server if you use Oracle.

• InforIONGrid, SQL_Latin1_General_CP1_CI_AS.Do not create this database in SQL Server if you use Oracle.

• InforIONQueues, SQL_Latin1_General_CP1_CI_AS.Do not create this database in SQL Server if you use Oracle.

• InforIONMappe

Create this database with collation SQL_Latin1_General_CP1_CS_AS.

Note: this is the only database with a case sensitive collation.

• This table shows which tablespaces to create in Oracle and otherwise in SQL Server:

TablespaceUser

IPE_TS when upgrading from ION version 10.0INFORIONPULSEENGINE

ITS_TS when upgrading from ION version 10.0INFORIONTOOLS

GRID_TSINFORIONGRID

QUE_TSINFORIONQUEUES

If you use Oracle as the database for ION, ensure to set the maximum open cursors to at least 600.To adjust the OPEN_CURSORS parameter, use this statement:

ALTER SYSTEM SET OPEN_CURSORS=600 SID='*' SCOPE=both;

ION 10.0 specific ION ActivityDeck databasesThis section is only relevant if you upgrade from ION 10.0

When using IONEvent Management or ION Workflow and you want to upgrade ION 10.0 you musttake note of the following.

• If you selected a sql server in a previous installation, the new databases InforIONPulseEngineand InforIONTools are created with the sql credentials of the previous installation.

• After upgrading ION to 10.1 and later on an Oracle or SQL Server the previous database InforIONTasklist is no longer required.

• If you selected an Oracle server, a new dialog box prompts you for new ActivityDeck Schemapasswords. The default password on the dialog box has the same value as the username.

78 | Infor ION Installation Guide

Upgrade process

Page 79: Infor ION Installation Guide

ION Service on a remote host, dual host deploymentWhen using ION 11.0 you can upgrade your dual host deployment to ION 11.1 by running the ION11.1 installer. After the installation you must update the bootstrap service on the secondary host.

For instructions see "General post-installation" on page 53.

For ION 10.0, 10.1, 10.2, 10.3 customers:

To upgrade an ION deployment which is distributed over two hosts. For example, the ION Service runson another host than the ION Desk.

Note: The ION upgrade installer does not take the ION Service host into account and will result in asingle host installation.

The impact for the upgrade procedure:

• Ensure the ION Desk system is in sync with the configuration at the ION Service system. Previouslyyou have copied the installation from the ION Desk system to the ION Service system. If you madeconfiguration changes directly on the ION Service system copy the ION Service configuration backto the ION Desk host before the upgrade. For example for a Linux host, zip the current ION Runtimefolder on the ION Service environment:

• Go to /opt/infor/ion• Zip the ION folder using this command: $ sudo Zip -r ion.zip• Transfer the zip file back to the windows environment where ION Desk is running.• Extract the zip file on the existing IONRuntime\ServiceBus folder on the windows machine.

For example: C:\Program Files\Infor\ION\IONRuntime\ServiceBusAt Windows 2008 R2 systems, a message can display informing you that the path to the file istoo long. In that case zip all files and folders from the ServiceBus folder except the folder work.

• The upgrade migrates the existing internal queues to database queues, however only for the queuesthat are stored on the ION Desk host. After shutting down ION and before the upgrade, copy backthe ION Service configuration to the ION Desk host. The upgrade will then migrate the queues tothe ION database queues.

• For ION or ION 3P Foundation customers:After the installation you can change the ION installation to a dual host deployment again.See the procedure "Installing ION Service on a secondary host" on page 59For ION or ION3P Grid customers:Use the procedures to add hosts to extent the ION deployment to multiple hosts.See the "Add hosts" procedure in the Infor ION Connect Administration Guide.

Grid edition and machine nameGrid edition: localhost as machine name is not supported.

Infor ION Installation Guide | 79

Upgrade process

Page 80: Infor ION Installation Guide

If you upgrade to an ION 11 Grid edition, verify that your connection points do not use localhost intheir connection parameters. If the connection points use localhost, adjust them before the upgradeor immediately after the upgrade.

Prevent use of TCP/IP ports above 50000The ION installation uses ephemeral ports above 50000. Do not use fixed ports above 50000 for anyother application running on the ION hosts, because ION might interfere with these. The same goesfor existing message queue connection points configured as JMS provider.

Statistics of active connection pointsNote: This section is not applicable for ION11.0.x.

When you upgrade, all the statistics visible in ION Desk, for the counters of the Active ConnectionPoints page in the Manage section of ION Connect, are reset to zero.

ION DowntimeUpgrade of ION is a planned downtime activity.

Note that during the upgrade ION will not be available, including ION ActivityDeck. Notify IONActivityDeck users on time.

During the upgrade from ION 10.x to ION 11.1 the messages that exist in the internal ION queues, willbe migrated to the ION 11.1 database queues

Upgrade prerequisitesEnsure your installation applies to these prerequisites:

• IFS 11.1 is the minimal version for ION 11.1. See the Infor Ming.le Installation Guide for StandaloneIFS.

• A supported JDK version.For more information see "Verifying Java requirements" on page 38

• Note that if you are upgrading an ION Connect Only Install, you will be allowed to optionally addION ActivityDeck during the upgrade. Other than this, you will not be allowed to add more componentsthan already installed. To add other eligible components such as IONEvent Management or ION

80 | Infor ION Installation Guide

Upgrade process

Page 81: Infor ION Installation Guide

Workflow, first you have to upgrade the setup as is. Once the upgrade is complete you can run theION 11.1 installation again in the "Modify" mode and add new features.For more details see "Adding features to an ION installation" on page 66

• If you upgrade from ION 10.2 or earlier; during the upgrade the by Infor provided MySQL JDBCdrivers are removed. If you have document flows that involved active Infor Application or Databaseconnection points configured with a MySQL database, you must deactivate these flows before theupgrade process. After the upgrade process is complete, you can register the MySQL JDBC drivermanually and reactivate your document flows again. For details, see the "Using customer-specificJDBC drivers" chapter in the Infor ION Technical Reference Guide.

• If you have configured https (SSL) for ION Desk and ION ActivityDeck, be prepared to configurethis security configuration again after the upgrade.

Specific ION 11.1 upgrade installer stepsThe software paradigm for ION 11.1 is changed compared to ION 10.3 and earlier versions. The IONsoftware and configuration is now managed in the database.

If you upgrade ION 10.3 or earlier, the ION 11.0 installer takes these specific actions:

• Domain users registered as in the ION host windows group IONDeskAdministrators areregistered as ION Desk Administrators in IFS. If local users are registered as IONDeskAdministrator the installer will result in 'Completed with errors' where the installation logfile warns you which users were not migrated to IFS.

• Custom JDBC and JMS drivers and SAP drivers will be migrated to the ION database.• Existing internal ION Queues are migrated from file system to database.

Note: also existing queues for connection points that do not exist anymore will be migrated.

The installer will furthermore run the general task of upgrading your ION installation and adjusting thedatabase schemas and data where needed.

Running the upgrade installationWhen starting the ION upgrade installation, ensure to run the installation with a user that hasadministrative rights at the Windows system.

To upgrade ION Connect 3P 11.1 or ION 11.1:

1 Navigate to the folder where the IONInstallation setup program is located.2 Double-click the setup program.3 Because an existing version of ION is detected, a message is displayed This setup will

perform an upgrade of 'Infor ION'. Do you want to continue?

Infor ION Installation Guide | 81

Upgrade process

Page 82: Infor ION Installation Guide

• Click Yes to proceed.• Click No to abort the installation.

4 Click Next in the Welcome dialog box.The JDK Path dialog box is displayed.

Note: If you select a JDK 8 version, Infor Oracle EBS and Infor ION Mapper (MEC Mapper) are notsupported. If you must use either of them, select a JDK 7 version.

If the JAVA_HOME environment variable is set, the JDK path will be filled, otherwise the path isblank. Ensure the JDK path is pointing to the installation folder of your JDK installation. The JDKPath is defaulted with the value of the JAVA_HOME environment variable.

5 The Infor ION 11 page shows the features that are currently installed and will be upgraded. Leavethe selection as is. If you are an ION Connect customer, you can select "ION Pulse" as an additionalfeature. Click Next.

6 When upgrading from ION Connect 10.0If you have not configured the SMTP Server name you can specify this information here. Specifythe SMTP Server Name for example: mail.[customer name].com.In order to send e-mail notifications during errors in ION Service, click Send in the Email Notificationsdialog box, and specify the From Address which will be shown as the sender on all auto generatede-mails. For example: noreply@[customer name].com.You can also specify these details after the installation.a Start ION Deskb Select Configure > ION Service

7 The Infor Federation Services dialog box is displayed.If your previous ION version used IFS, you can re-apply the password for the ION Service Accountand continue with step 11. Otherwise, you must specify this information:

Server Name:Specify an existing IFS Server name. Click Browse to find the IFSservers from the network. Selecta server from the list and click OK. (Note the disclaimer).If no servers are found, the messageNo IFS servers found is displayed. Click Cancel andspecify the IFS Server [IFS_Server].

ION Service AccountSpecify the IFS user without the domain name. This user ID must exist in Active Directory and mustbe added in IFS linked to the AttributeServiceCaller security role. See the Infor FederationServices Administration Guide. This user must be an administrator on the system.

Password:The password of the ION Service Account user that you just specified. Provide the password forthe ION Service Account.

8 Click Next. One of these messages can display:

• Combination of IFS Server and HTTP Port is invalid. Verify the detailsand try again.

• User is not a domain user. Provide valid Username/Password.

82 | Infor ION Installation Guide

Upgrade process

Page 83: Infor ION Installation Guide

9 If the ION Service Account user is not an IFS Administrator specify the credentials for the IFSAdministrator user id and password in the IFS Administrator Credentials dialog box.

10 Click Next. One of these messages can appear:

• Combination of IFS Server and HTTP Port is invalid. Verify the detailsand try again. If the IFS Admin User/Password specified earlier isincorrect, this message is displayed:"IFS admin Username/Password isinvalid. Please reenter".You will remain in the current dialog box.

• If the user is not having the security role of IFSApplicationAdmin, then this message isdisplayed: User requires the IFS Application Administrator security rolein IFS.

11 (Not applicable for an ION 11.0 upgrade). There are two possibilities.

• If IFS is configured in Windows Mode the External Access Configuration dialog box is displayed.• If IFS is configured in SAMLtokenAllowingWindowsforWebServices mode the External

Access Configuration (IFS using SAMLToken) dialog box is displayed.

For Windows:Specify URL related information in the External Access Configuration dialog box. The URLs areused by the ION clients (ActivityDeck and Desk) to connect to their server.

• Displayed is the Desk and Pulse http port(IIS). The default value is 9580.• Specify the Desk http port. The default value is 9581.

For the SAMLtokenAllowingWindowsforWebServices mode:Specify information related to the URLs that are used by the ION clients (ActivityDeck and Desk)to connect to their server. Because IFS is in SAMLToken mode, ActivityDeck will also be configuredin SAMLToken mode. This requires an https binding in IIS for ActivityDeck.To configure this, the Desk and Pulse dialog box is displayed. Specify this information:

Pulse https portThe default value is 9543.

SSL CertificateInfo SSL Certificate

Desk http port(IIS)The default value is 9580

Desk http portThe default value is 9581.

12 (Not applicable for an ION 11.0 upgrade). On the External Access Configuration dialog box specifythe additional http port needed for ION Desk.

13 For an ION 11.0 upgrade, go to step 27. Click Next.The Port Configuration dialog box is displayed.All ports specified in this dialog box must be unique. No other applications can use these ports.Choose the default ports if they are available, or specify desired port numbers.

14 Click Next.

Infor ION Installation Guide | 83

Upgrade process

Page 84: Infor ION Installation Guide

The DB Selection Type dialog box is displayed. The Database Type is preselected and cannot bechanged. For an ION 10.3 and earlier upgrade, you can select a database if you have created thedatabases manually in advance. For an ION 11.0 upgrade, this dialog box is skipped.

15 Click Next. If you are installing on Oracle. the ION Runtime Database dialog box is displayed.Specify the Oracle database server details.

• The oracle connect descriptor is displayed.• When you did not select the ION databases/database schemas are already created checkbox,

you must specify this information:

• Oracle database files location: The location at the Oracle server where the data files for theION tablespaces must be created.

• Login ID: Specify a user with system administrator privileges, typically System• Password of the specified user.

16 Click NextIf the connection is successful, the installation proceeds. Otherwise, one of these messages isdisplayed:

• ORA-12154 TNS: could not resolve the connect identifier specified

The database server is not reachable. Supply the connection URL manually with this format://[ORACLE_SERVER]:[PORT]/[SID]For example, //oracle_server:1521/SID. If the problem persists, verify if the entries in thetnsnames.ora file are correct. See "Oracle settings" on page 31.You will remain in the current dialog box.

• ORA-01017: Invalid Username/Password. Logon Denied(1017)

The username and password of the user is incorrect. Verify the credentials and try again. Youwill remain in the current dialog box.When you solve the issues, you can continue.

17 The Oracle Database users for ION Service Bus dialog box is displayed.When you selected ION databases/database schemas are already created you must specify thepasswords you used to create the database users otherwise the required user accounts are createdautomatically by the installer. In that case the default value of the password is the username; forexample, for InforIONCBM, the default password will be InforIONCBM. If required change thepasswords for the database users. Several dialog boxes display to define passwords for the Oracledatabases that will be created.

18 Click Next. The Database Server or IONDesk Database dialog box is displayed.The current SQL server is pre-selected and cannot be changed. If databases must be created bythe installer, you must specify this information:

Login IDA user with system administrator privileges already used in the previous installation is filled, forexample sa.

84 | Infor ION Installation Guide

Upgrade process

Page 85: Infor ION Installation Guide

PasswordRe-enter the Password of the specified user for confirmation.

19 Click Next.If the database server is not reachable, or if the username and password of the sa user is incorrect,an error message is displayed. If the installation is not based on Oracle, skip to step 27.

20 Click Next to start the installation.If the ION Service is still running, the installer will prompt you to ask if the current ION Service canbe stopped. Click Yes.When the Installation completes successfully, proceed to step 28 to see the results.

21 Click Next. For an Oracle installation, the ORACLE_HOME field already used in the previousinstallation is filled. Specify these Oracle database server details:

• Select the oracle service where you want to install ION Connect from the "Database server youare installing to" drop-down box.

• Login ID: a user with system administrator privileges, for example System.• Password of the specified user.

22 Click Next. If the connection is successful, the installation will proceed. Otherwise, one of thesemessages is displayed:

• ORA-12154 TNS: could not resolve the connect identifier specified

The database server is not reachable. Supply the connection URL manually with this format: //[ORACLE_SERVER]:[PORT]/[SID]. For example, //oracle_server:1521/SID. Ifthe problem persists, verify if the entries in the tnsnames.ora file are correct. See "Oracle Settings."You will remain in the current dialog box.

• ORA-01017: Invalid Username/Password. Logon Denied(1017)

The username and password of the user is incorrect. Verify the credentials and try again. Youwill remain in the current dialog box.When you solve the issues, you can continue with the next step.

23 If the passwords of Oracle database users of previous installation have changed a dialog box promptsfor new passwords. Specify the correct passwords and click Next

24 The Oracle Database users for ION ActivityDeck dialog box is displayed. By default the values ofthe password are the same as the username.

25 Specify the SQL Server details for ION Desk:

• A user with system administrator privileges for example sa. Note that the field is already filledwith a user which was already used in the previous installation.

• Specify the Password of the specified user for confirmation.• The current SQL server is pre-selected and cannot be changed.

26 Specify User Credentials for ION Desk database access dialog box is displayed when passwordshave changed.Supply the current password of the specified user.

Infor ION Installation Guide | 85

Upgrade process

Page 86: Infor ION Installation Guide

27 Click Yes to start the installation.If the ION Service is still running, the installer prompts you asking if the current ION Service can bestopped. Click Yes.When the installation has finished, the Installation summary dialog box is displayed. Here you canfind the result of the installer steps. Step 7 indicates the collective status of all ION Grid applicationsthat are installed by the installer. If the installation is successful, their status is displayed as Offline.Click Next to end the installation.The installation completed dialog box shows the message that the installation is complete andapplications are kept offline.

28 You must apply the latest ION patch to start ION. Select the check boxes to view the readme file orthe Install log file.The read-me file shows information about the location to launch ION Desk. Shortcuts for ION Deskand ION ActivityDeck are generated in the desktop. ION Desk and ION ActivityDeck are only availableafter you have installed the ION patch 11.1.9 or later.A log file called Infor_ION_Install.log is generated by the installer. Use this log file totroubleshoot if the installation fails. This log file is stored in:C:\ProgramData\Infor\ION_Install.log

29 Click Finish to close the installer.If you upgrade ION 11.0.x while ION is installed over multiple hosts, a post installation step is requiredfor the secondary hosts. Complete the upgrade in each of the secondary hosts.See "Updating bootstrap service on secondary hosts" on page 87

30 Install the latest ION patch.See "Install latest ION 11.1 Patch" on page 53.For an ION 10.3 or earlier upgrade if applicable, adjust the log settings.

Upgrade completes with errorsNote: Not applicable for ION 11.0.x upgrades.

The upgrade completes with a Detected a dead queue error. Check the upgrade log file on thiswarning:

Warning: Couldn't find a connection point with logical ID<logical-id> for queue <queue name> in the deskConnectionPoints table.Warning: Detected a dead queue.

Do not take action. This issue will not influence your ION installation from functioning properly.

In your previous ION installation, the referred connection point was deactivated and removed, whilethe internal ION queues still contained messages for that connection point. The ION 11 upgrade installeridentified this queue with messages and cannot relate it to an existing connection point.

86 | Infor ION Installation Guide

Upgrade process

Page 87: Infor ION Installation Guide

Updating bootstrap service on secondary hostsNote: This section is only applicable for ION 11.0.x upgrade where ION is distributed over multiplehosts.

After the installation the grid is not running on the secondary hosts. Applications have the statusPre-deploy in Progress and are offline. The Grid Management UI webpage is accessible, nonethelessauthentication cannot take place because the Windows Session Provider is down as well.

To update the bootstrap service, for each host:

1 Go to the primary host.2 Start the command AdminUI.cmd.

You can find this command in the default installation folder C:\Program Files\Infor\ION\IONGrid\grids\ION.

3 Select Grid Management Pages > Configuration Manager > Grid Configuration > Hosts.4 Download the bootstrap installer for the current secondary host. This regenerates the package with

the new upgraded components.5 At the secondary host, run the bootstrap installer and provide the installation folder and JDK path.

For Windows you must also specify the ION service account under which the installer must run.When all secondary hosts are updated the applications automatically get deployed and receive thestatus Offline.

Reissuing Grid CertificatesOnly applicable for ION 11.0.x upgrades

With ION 11.0 grid certificates were generated that were not always unique per ION Grid installation.That can lead to issues if two ION environments, for example a production and test environment, areaccessed from the same browser. If you must resolve this issue, you must use the procedure"Renewing/Reissuing Grid Certificates" as described in the Infor ION Grid Security Administration Guide

Updating log settingsNote: This section is not applicable for ION 11.0.x upgrades.

For an ION 10.2 or earlier upgrade: If you had active Infor Application or Database connection pointsconfigured with a MySQL database, you must activate the concerned flows again.

After the upgrade of ION, if you encounter unclear errors in ION Desk, clear your browser cache firstbefore further investigating the issues. Possibly cached information of the previous ION Desk versionis used.

Infor ION Installation Guide | 87

Upgrade process

Page 88: Infor ION Installation Guide

Custom e-mail templatesNote: This section is not applicable for ION 11.0.x upgrades.

This section is applicable if you customized the e-mail template for ION Pulse. There is no automaticmigration of customized e-mail templates. The upgrade installer will erase the existing e-mail templatesand will overwrite them with the new standard templates.

To redeploy your customized e-mail templates:

1 The upgrade installation creates a backup of the customized e-mail template in the folder: C:\ProgramData\Infor\ION\Backup\<<InstalledIONProductVersion>>\IONRuntime\ServiceBus\config\pulse_email

We recommend that you also backup the customized e-mail templates manually as discussed in"Regular backup for recovery". It is important that the customized e-mail templates are recoverablewhen something goes wrong during the automatic backup by the installer.

2 Log on to ION Desk.3 Click Configure > ION Service > Configuration Files .4 Click Download in the E-mail templates section.5 Select a location of your choice and click Save.

New standard e-mail templates are downloaded to the specified location.

6 Extract the zip file to a local folder.7 Merge the changes from the customized templates that were backed up at step 1 with the new

e-mail templates.8 Zip the templates folder. Ensure that the new zip file does not contain a folder structure.9 In ION Desk click Configure > ION Service > Configuration Files10 Click Upload Updated Set of Templates to upload the updated zip file.

Migration of events in message traceNote: This section is not applicable for ION 11.0.x upgrades.

If you used the message trace functionality in ION for debugging purposes, note that this functionalityis now replaced by ION OneView.

The events that are logged in ION message trace are not automatically migrated. A separate utility isprovided to migrate this information. You can run this utility after the upgrade installation is complete.

See "Offline utility for message trace migration" on page 101.

88 | Infor ION Installation Guide

Upgrade process

Page 89: Infor ION Installation Guide

Redirection of ION Desk points to incorrect URLNote: This section is not applicable for ION 11.0.x upgrades.

If you try to openION Desk with your former ION 10.x URL:

http://ionhost.domain:9580/IONDesk/ShellPage.aspx

you are redirected to an incorrect link. A default ION installation must use this URL:

http://ionhost.domain:9581/iondesk/

Infor ION Installation Guide | 89

Upgrade process

Page 90: Infor ION Installation Guide

90 | Infor ION Installation Guide

Upgrade process

Page 91: Infor ION Installation Guide

10Upgrading JDK version

To update JDK:

1 Install the new JDK version.

Note: With Java JDK 8, Infor ION Oracle EBS and Infor ION Mapper (MEC Mapper) are notsupported. If you must use either of them, select a JDK 7 version.

2 Stop the ION Grid. Set the Grid to the offline status.For more specific information about stopping and starting ION, see Infor ION Connect AdministrationGuide

3 For each Grid host, follow the procedure "Change the JDK for a grid host, as described in Infor IONGrid Administration Guide .

4 Restart the ION Grid, when all ION Grid hosts are updated with the new JDK version.For more specific information about stopping and starting ION, see Infor ION Connect AdministrationGuide.

5 Update the file ION Installation folder/config.properties to point to the new JDKversion.A format example of this file:ION_JDK_PATH=C:\PROGRA~1\Java\JDK17~2.0_5

Infor ION Installation Guide | 91

Page 92: Infor ION Installation Guide

92 | Infor ION Installation Guide

Upgrading JDK version

Page 93: Infor ION Installation Guide

11Remove ION

When uninstalling ION 11.1, ensure to perform this task at the Windows system. The user must havethese requirements:

• Administrative rights.• Is part of the local Windows domain group "ION_full".

To uninstall ION:

1 Click Start > Control Panel.The All control panel items window is displayed.

2 Select Programs and Features.3 Select the entry Infor ION/Infor ION Connect4 Click Uninstall

The Backup Options dialog box is displayed.

5 The checkbox Backup ION Customizations is selected by default.This creates a backup of these configuration information:

• Custom BODs,• SAP custom data.• Views and the Hyperlinks.

Select the default backup location or browse to a location of your choice.

6 Click Next.The uninstallation proceeds.

7 Click Finish to complete the uninstallation.8 The ION installer does not remove the ION databases. For a complete removal of ION, remove

these ION databases manually:

• InforIONGrid• InforIONCBM• InforIONDesk• InforIONMonitorEngine• InforIONTasklist• InforIONWorkFlowEngine

Infor ION Installation Guide | 93

Page 94: Infor ION Installation Guide

• InforIONPulseEngine• InforIONTools• InforIONMapper• InforIONQueues

Uninstalling ActivityDeck for Desktop applicationTo uninstall the ActivityDeck application:

1 Click Start > Control Panel.The All control panel items window is displayed.

2 Select Programs and Features.3 Select the entry ION Pulse for the server for which to uninstall.4 Click Uninstall

94 | Infor ION Installation Guide

Remove ION

Page 95: Infor ION Installation Guide

12Troubleshooting

This section describes some issues you can encounter during the installation of ION.

ION installation user with special characters in thenameIf you run the ION installation with a Windows user who has special characters in the user name, forexample a ~ or !, the ION installation can fail during the Grid installation.

Resolution: During the ION installation do not use a Windows user with special characters in the name.

ION installation fails at the point where the ION Grid is created. The log files show:

INFO : ---------------------------------------------------------------------------INFO : ION Grid install - startsFile C:\Users!ZINF0~2\AppData\Local\Temp\installiongrid.log is not found.INFO : CMDLine arugmts: "INSTALL_GRID" "C:\Users!ZINF0~2\AppData\Local\Temp{02430600-4C30-46A8-B6EB-857FB940C1FD}\grid-installer.jar" "C:\Users!ZINF0~2\AppData\Local\Temp{02430600-4C30-46A8-B6EB-857FB940C1FD}\gridinstallation.xml" C:\Users!ZINF0~2\AppData\Local\Temp\installiongrid.log[8-7-2013:17:18:17] INFO : 'installgrid.bat' file launched successfully.[8-7-2013:17:18:17] INFO : Logfile Content...[8-7-2013:17:18:17] INFO : File Contents: "C:\Program Files\Java\jdk1.7.0_55\bin\java.exe" [ Starting automated installation ][ Starting to unpack ][ Processing package: Bootstrap (1/1) ][ Unpacking finished ]Unable to connect to databasefailed to run liquibase update: liquibase.exception.ServiceNotFoundException: java.lang.NullPointerException

Infor ION Installation Guide | 95

Page 96: Infor ION Installation Guide

Chrome browser issueAn empty ION Desk or browser opens with the message Arg_NullReferenceException.

This issue occurs when Chrome (or an ION Desk tab in Chrome) is closed while the Silverlight part ofDesk is loading.

Resolution: Refresh the browser window.

HTTP Error 500.21 - Internal Server ErrorNote: This section is only applicable for Windows 2008 R2 deployments.

The order in which you configure .NET framework and IIS can corrupt the .NET Framework 4 version.When you log on to ION Desk after the installation an error occurs. This error can look like:

HTTP Error 500.21 - Internal Server Error

Handler "PageHandlerFactory-Integrated" has a bad module"ManagedPipelineHandler" in its module list.

This table shows information about the error:

DescriptionFields

IIS Web CoreModule

ExecuteRequestHandlerNotification

PageHandlerFactory-IntegratedHandler

0x8007000dError Code

http://ioncomp1.prideindustries.com:9580/ION-Desk/ShellPage.aspx

Requested URL

C:\Program Files\Infor\ION\Desk\ShellPage.aspxPhysical Path

NegotiateLogon Method

ACME\JohnDoeLogon User

To repair the .NET framework:

1 Start a Windows command prompt as an administrator.2 Run the command cd C:\Windows\Microsoft.NET\Framework64\v4.0.303193 Type .\aspnet_regiis.exe -i

This command repairs the 64-bit version of .NET framework.

If your system is referring by default to the 32-bit version of .NET framework, repeat the previous steps.

96 | Infor ION Installation Guide

Troubleshooting

Page 97: Infor ION Installation Guide

httpwebrequest_webexception_remoteserverarguments not foundThe installation succeeded, but when opening ION Desk or ION ActivityDeck, this message is reported:

"httpwebrequest_webexception_remoteserver arguments not found"

The .Net 4.0 framework can cause this problem. To repair the issue, run this command:

%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis -iru

If the problem persists, verify whether these Microsoft KB hot-fixes are installed at your system:

• KB2539636• KB2518870• KB2473228• KB2487367• KB2416472

User has not enough provisioning service privilegesIf the message User has not enough provisioning service privileges is displayed, youmust perform these steps:

1 For the Windows servers, verify whether the provided ION Bootstrap service contains a valid domainuser ID, which exists in the Active Directory path used by IFS.Go to IFS > Configure > Parameters, Active Directory Path

2 Verify whether the provided User Name in the IFS Administrator Credentials has the'IFSApplicationAdmin' security role in IFS.

Repeated browser sign-in dialog and/or HTTP error401Unauthorized on sign-in, using correct credentials.

This error message is displayed in the IONService grid nodes:

GetUserFromWindowsAccountId call failed. Reason: null. Reason: Attempted to perform an unauthorized operation.

Infor ION Installation Guide | 97

Troubleshooting

Page 98: Infor ION Installation Guide

When navigating to ION Pulse for sign-in, the browser shows a sign-in dialog. A sign-in with the correctcredentials fails. A fresh browser sign-in dialog is displayed.

Verify the troubleshooting section in the Infor Ming.le Installation Guide for Standalone IFS for possiblecauses and resolutions.

ION Desk is not loading pagesIf your ION Desk pages do not load, with Load operation failed message, check if themachine.config file has two entries of the XML element <DbProviderFactories>.

You can find the file in:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config\

One of the <DbProviderFactories/>. elements are empty. Remove the empty entry.

Windows updates or installation of other products that use the .NET 4 framework. can cause thissituation.

Security Error when starting ActivityDeck for the firsttimeWhen installing ION ActivityDeck on a Windows 2008 Server, a security error can occur when IONActivityDeck is started for the first time. To resolve this, use the Internet Options in Internet Explorerto add the "about:internet" site to the Trusted Sites.

Safari browser issuesNot able to upload/download files in ION Desk and ION ActivityDeck.When using Safari as browser for ION Desk.

If you are not able to up- or download ION Desk files, for example import or exporting models ordownloading reports, check the Safari Silverlight plug-in settings.

For example for Safari 7: menu > preferences popup > Security tab > Internet plug-ins > ManageWebsite Settings.

98 | Infor ION Installation Guide

Troubleshooting

Page 99: Infor ION Installation Guide

Unexpected scrollbars in ION DeskWhen using Safari as browser for ION Desk.

If you notice scrollbars at places where you do not expect them, ensure you did not set the propertyshow scrollbars when scrolling.

For example for Safari 7: System Preferences > General > Show scrollbars > when scrolling.

Infor ION Installation Guide | 99

Troubleshooting

Page 100: Infor ION Installation Guide

100 | Infor ION Installation Guide

Troubleshooting

Page 101: Infor ION Installation Guide

AOffline utility for message trace migration

Note: This section is not applicable for ION 11.0.x upgrades.

In ION 10.3 and earlier versions, an event log for all BOD messages that flowed through ION was keptby the message trace module in the Manage section of ION Connect in the ION Desk. In ION 11.0, anew module called ION OneView replaces this functionality. For details on ION OneView, see the InforION Connect Administration Guide.

When you upgrade from an ION 10.x version to ION 11.1, the message trace data is not automaticallymigrated. An offline utility is provided for the migration of the historic message trace data to the newION OneView. The migration of message trace data to ION OneView is optional. If you prefer to viewthe old message trace data in ION OneView, you can perform this migration as a manual post-installationstep. Alternatively, you can archive, or remove, your message trace data.

This appendix explains the planning of the migration and the installation and execution of this migrationutility.

Planning the migrationRun this utility only after the successful upgrade to Infor ION 11.1 Connect3P or ION 11.1 Process.You can run it simultaneously if ION is functioning normally. You may note some impact on theperformance of ION when this utility is running.

The time taken by the tool to complete the migration depends on the amount of message trace dataleft to migrate. If there is a large number of data to be migrated, the migration can take some time. Themigration utility can be stopped at any time during the execution and can be resumed later. On thesubsequent execution the utility continues the migration from where it was stopped.

It is possible that a large number of transactions must be run during migration of the message tracedata. Therefore, ensure that there is sufficient space in the database and for the database transactionlog files.

Infor ION Installation Guide | 101

Page 102: Infor ION Installation Guide

Installation of the migration utilityWhen an upgrade installation is performed, the ION installer places the migration utility package in the<ION_Home>\Migration folder. For example: C:\Program Files\Infor\ION\Migration

The <ION_Home>\migration folder is only found on the ION server in case of an upgrade installation.

Running the migration utilityTo migrate the message trace data to ION OneView:

1 Navigate to the ION_Home\Migration folder. For example: C:\Program Files\Infor\ION\Migration.

2 Click MessageTraceMigration.exe. The migration utility starts.The utility already detects the database connection details of the ION server.

3 Specify the password of the ION database user.4 Verify the details and modify the connection properties if required.5 Click Test Connection to validate the connection properties. The results of the test are displayed

in the Output console.If a successful connection is made, the utility is ready to perform the migration.

6 When you are ready to perform the migration, click Migrate.The migration of message trace data starts now. The output console shows the live status of themigration. It shows the count of the records that are being migrated and the average amount ofrecords migrated per second.

7 To stop the migration, you can click Stop. The migration can be resumed later from where it isstopped.

When the Migration is complete, the final results are displayed in the output console. Now all themessage trace data is migrated and can be viewed in ION OneView. For details, see the Infor IONConnect Administration Guide.

Logging of migration utility actionsIn addition to showing the status of the migration in the output console, the migration utility also logsall its actions in a log file. A separate log file is created each time the utility is performed at the regularlocation where all installer logs are found:

C:\ProgramData\Infor

The name of the log file has this format:

MessageTraceMigration_<timestamp>.log.

102 | Infor ION Installation Guide

Offline utility for message trace migration

Page 103: Infor ION Installation Guide

For example, a sample log file name with its location:

C:\ProgramData\Infor\MessageTraceMigration_2013-Feb-15_11.36.44.log

Infor ION Installation Guide | 103

Offline utility for message trace migration

Page 104: Infor ION Installation Guide

104 | Infor ION Installation Guide

Offline utility for message trace migration

Page 105: Infor ION Installation Guide

BSQL statements for manual creation ofdatabases

SQL Server

Provided here is a sample script to create an ION runtime user and the ION databases. In the script,ensure to replace the values for the variables @RunttimeUser and @RunttimeUserPassword withthe values of your choice.

Use [master];GO

DECLARE @RunttimeUser nvarchar(30), @RunttimeUserPassword nvarchar(30), @sqlstatement varchar(100); -- DEFINE HERE THE VALUES FOR THE ACTUAL RUNTIME USER AND PASSWORD YOU EXPECTSET @RunttimeUser = 'ionruntime';SET @RunttimeUserPassword = 'ionruntimePassword';

-- Create ION Runtime userSET @sqlstatement='CREATE LOGIN '+@RunttimeUser+' WITH PASSWORD = '''+@RunttimeUserPassword+'''' Print @sqlstatement;Exec (@sqlstatement);

-- Create ION databasescreate database InforIONMapper collate SQL_Latin1_General_CP1_CS_AS;create database InforIONDesk collate SQL_Latin1_General_CP1_CI_AS;create database InforIONCBM collate SQL_Latin1_General_CP1_CI_AS;create database InforIONMonitorEngine collate SQL_Latin1_General_CP1_CI_AS;create database InforIONWorkflowEngine collate SQL_Latin1_General_CP1_CI_AS;create database InforIONPulseEngine collate SQL_Latin1_General_CP1_CI_AS;create database InforIONTools collate SQL_Latin1_General_CP1_CI_AS;create database InforIONGrid collate SQL_Latin1_General_CP1_CI_AS;create database InforIONQueues collate SQL_Latin1_General_CP1_CI_AS;

Infor ION Installation Guide | 105

Page 106: Infor ION Installation Guide

-- Authorize @IONRuntimeUser for ION databasesSET @sqlstatement='alter authorization on DATABASE::InforIONMapper to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONDesk to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONCBM to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONMonitorEngine to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONWorkflowEngine to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONPulseEngine to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONTools to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONGrid to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

SET @sqlstatement='alter authorization on DATABASE::InforIONQueues to '+@RunttimeUser print @sqlstatement; Exec (@sqlstatement);

Oracle

This is a sample script to create the ION users and databases while using the Oracle database.

CREATE TABLESPACE GRID_TS LOGGING DATAFILE '<oracle install location>/InforIONGrid.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONGrid identified by "InforIONGrid" DEFAULT TABLESPACE GRID_TS QUOTA UNLIMITED on GRID_TS;alter user InforIONGrid set container_data=all container=current;

106 | Infor ION Installation Guide

SQL statements for manual creation of databases

Page 107: Infor ION Installation Guide

grant UPDATE ANY TABLE to InforIONGrid container=ALL;grant SELECT ANY TABLE to InforIONGrid container=ALL;grant UNLIMITED TABLESPACE to InforIONGrid container=ALL;grant CREATE SESSION to InforIONGrid container=ALL;grant INSERT ANY TABLE to InforIONGrid container=ALL;grant CREATE ANY TABLE to InforIONGrid with admin option container=ALL;grant CREATE ANY VIEW to InforIONGrid with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONGrid with admin option container=ALL;grant "CONNECT" to InforIONGrid with admin option container=ALL;grant "RESOURCE" to InforIONGrid container=ALL;

CREATE TABLESPACE CBM_TS LOGGING DATAFILE '<oracle install location>/InforIONCBM.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONCBM identified by "InforIONCBM" DEFAULT TABLESPACE CBM_TS QUOTA UNLIMITED on CBM_TS;alter user InforIONCBM set container_data=all container=current; grant UPDATE ANY TABLE to InforIONCBM container=ALL;grant SELECT ANY TABLE to InforIONCBM container=ALL;grant UNLIMITED TABLESPACE to InforIONCBM container=ALL;grant CREATE SESSION to InforIONCBM container=ALL;grant INSERT ANY TABLE to InforIONCBM container=ALL;grant CREATE ANY TABLE to InforIONCBM with admin option container=ALL;grant CREATE ANY VIEW to InforIONCBM with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONCBM with admin option container=ALL;grant "CONNECT" to InforIONCBM with admin option container=ALL;grant "RESOURCE" to InforIONCBM container=ALL;

CREATE TABLESPACE ITS_TS LOGGING DATAFILE '<oracle install location>/InforIONTools.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONTools identified by "InforIONTools" DEFAULT TABLESPACE ITS_TS QUOTA UNLIMITED on ITS_TS;alter user InforIONTools set container_data=all container=current; grant UPDATE ANY TABLE to InforIONTools container=ALL;grant SELECT ANY TABLE to InforIONTools container=ALL;grant UNLIMITED TABLESPACE to InforIONTools container=ALL;grant CREATE SESSION to InforIONTools container=ALL;grant INSERT ANY TABLE to InforIONTools container=ALL;grant CREATE ANY TABLE to InforIONTools with admin option container=ALL;grant CREATE ANY VIEW to InforIONTools with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONTools with admin option container=ALL;grant "CONNECT" to InforIONTools with admin option container=ALL;grant "RESOURCE" to InforIONTools container=ALL;

CREATE TABLESPACE QUE_TS LOGGING DATAFILE '<oracle install location>/InforIONQueues.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE

Infor ION Installation Guide | 107

SQL statements for manual creation of databases

Page 108: Infor ION Installation Guide

UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONQueues identified by "InforIONQueues" DEFAULT TABLESPACE QUE_TS QUOTA UNLIMITED on QUE_TS;alter user InforIONQueues set container_data=all container=current; grant UPDATE ANY TABLE to InforIONQueues container=ALL;grant SELECT ANY TABLE to InforIONQueues container=ALL;grant UNLIMITED TABLESPACE to InforIONQueues container=ALL;grant CREATE SESSION to InforIONQueues container=ALL;grant INSERT ANY TABLE to InforIONQueues container=ALL;grant CREATE ANY TABLE to InforIONQueues with admin option container=ALL;grant CREATE ANY VIEW to InforIONQueues with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONQueues with admin option container=ALL;grant "CONNECT" to InforIONQueues with admin option container=ALL;grant "RESOURCE" to InforIONQueues container=ALL;

CREATE TABLESPACE IPE_TS LOGGING DATAFILE '<oracle install location>/InforIONPulseEngine.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONPulseEngine identified by "InforIONPulseEngine" DEFAULT TABLESPACE IPE_TS QUOTA UNLIMITED on IPE_TS;alter user InforIONPulseEngine set container_data=all container=current; grant UPDATE ANY TABLE to InforIONPulseEngine container=ALL;grant SELECT ANY TABLE to InforIONPulseEngine container=ALL;grant UNLIMITED TABLESPACE to InforIONPulseEngine container=ALL;grant CREATE SESSION to InforIONPulseEngine container=ALL;grant INSERT ANY TABLE to InforIONPulseEngine container=ALL;grant CREATE ANY TABLE to InforIONPulseEngine with admin option container=ALL;grant CREATE ANY VIEW to InforIONPulseEngine with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONPulseEngine with admin option container=ALL;grant "CONNECT" to InforIONPulseEngine with admin option container=ALL;grant "RESOURCE" to InforIONPulseEngine container=ALL;

CREATE TABLESPACE BEM_TS LOGGING DATAFILE '<oracle install location>/InforIONMonitorEngine.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONMonitorEngine identified by "InforIONMonitorEngine" DEFAULT TABLESPACE BEM_TS QUOTA UNLIMITED on BEM_TS;alter user InforIONMonitorEngine set container_data=all container=current; grant UPDATE ANY TABLE to InforIONMonitorEngine container=ALL;grant SELECT ANY TABLE to InforIONMonitorEngine container=ALL;grant UNLIMITED TABLESPACE to InforIONMonitorEngine container=ALL;

108 | Infor ION Installation Guide

SQL statements for manual creation of databases

Page 109: Infor ION Installation Guide

grant CREATE SESSION to InforIONMonitorEngine container=ALL;grant INSERT ANY TABLE to InforIONMonitorEngine container=ALL;grant CREATE ANY TABLE to InforIONMonitorEngine with admin option container=ALL;grant CREATE ANY VIEW to InforIONMonitorEngine with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONMonitorEngine with admin option container=ALL;grant "CONNECT" to InforIONMonitorEngine with admin option container=ALL;grant "RESOURCE" to InforIONMonitorEngine container=ALL;

CREATE TABLESPACE WLM_TS LOGGING DATAFILE '<oracle install location>/InforIONWorkflowEngine.DBF' SIZE 1M AUTOEXTEND ON NEXT 2M MAXSIZE UNLIMITED;alter session set "_ORACLE_SCRIPT"=true;create user InforIONWorkflowEngine identified by "InforIONWorkflowEngine" DEFAULT TABLESPACE WLM_TS QUOTA UNLIMITED on WLM_TS;alter user InforIONWorkflowEngine set container_data=all container=current; grant UPDATE ANY TABLE to InforIONWorkflowEngine container=ALL;grant SELECT ANY TABLE to InforIONWorkflowEngine container=ALL;grant UNLIMITED TABLESPACE to InforIONWorkflowEngine container=ALL;grant CREATE SESSION to InforIONWorkflowEngine container=ALL;grant INSERT ANY TABLE to InforIONWorkflowEngine container=ALL;grant CREATE ANY TABLE to InforIONWorkflowEngine with admin option container=ALL;grant CREATE ANY VIEW to InforIONWorkflowEngine with admin option container=ALL;grant EXECUTE ANY TYPE to InforIONWorkflowEngine with admin option container=ALL;grant "CONNECT" to InforIONWorkflowEngine with admin option container=ALL;grant "RESOURCE" to InforIONWorkflowEngine container=ALL;

Infor ION Installation Guide | 109

SQL statements for manual creation of databases

Page 110: Infor ION Installation Guide

110 | Infor ION Installation Guide

SQL statements for manual creation of databases