Documente Academic
Documente Profesional
Documente Cultură
Installation Guide
Version 1.1
Important Notices
The material contained in this publication (including any supplementary information) constitutes and contains confidential and proprietary information of Infor. By gaining access to the attached, you acknowledge and agree that the material (including any modification, translation or adaptation of the material) and all copyright, trade secrets and all other right, title and interest therein, are the sole property of Infor and that you shall not gain right, title or interest in the material (including any modification, translation or adaptation of the material) by virtue of your review thereof other than the non-exclusive right to use the material solely in connection with and the furtherance of your license and use of software made available to your company from Infor pursuant to a separate agreement (Purpose). In addition, by accessing the enclosed material, you acknowledge and agree that you are required to maintain such material in strict confidence and that your use of such material is limited to the Purpose described above. Although Infor has taken due care to ensure that the material included in this publication is accurate and complete, Infor cannot warrant that the information contained in this publication is complete, does not contain typographical or other errors, or will meet your specific requirements. As such, Infor does not assume and hereby disclaims all liability, consequential or otherwise, for any loss or damage to any person or entity which is caused by or relates to errors or omissions in this publication (including any supplementary information), whether such errors or omissions result from negligence, accident or any other cause. Revision History
Date
March 5, 2009
Change Description
Added step for CSI user in Infor Security setup; removed InforPublicMDM from restored databases; added CSI audit step under Creating the ERP component; added section on verifying codes and code list synchronization, added appendix for upgrading MyDay content database Revised section on verifying codes and codelists Removed references to accounting entities in App. F Added section on clearing PublicMDM information Changed uninstall folder name in App. D. Modified web page references. Added step to App. C. Added step in Installing MyDay section; added App G, moved sections in post-installation steps Miscellaneous edits Removed step in Post-restoration tasks in App. F
March 11, 2009 March 16, 2009 March 18, 2009 March 23,2009 April 1, 2009 April 2, 2009 April 13, 2009 May 20, 2009 June 8, 2009
Publication Information
Release: MyDay version 1.1.1 Publication Date: 8 June 2009
Contents | 3
Contents
About this guide................................................................................................................................ 5 Intended audience......................................................................................................................... 5 Organization.................................................................................................................................. 6 Contacting Infor............................................................................................................................. 7 System requirements........................................................................................................................ 8 Database server............................................................................................................................ 8 Application server.......................................................................................................................... 9 Client........................................................................................................................................... 11 Infor MyDay port requirements.................................................................................................... 12 Preparing for the installation ......................................................................................................... 13 Installation of specific applications .............................................................................................. 15 Customizing component installation (optional) ........................................................................... 19 Changing component properties ................................................................................................. 19 Changing component database users......................................................................................... 21 Installing MyDay.............................................................................................................................. 22 Clearing PublicMDM information................................................................................................... 23 Importing security permissions..................................................................................................... 24 Creating security hierarchies accounting entities .................................................................... 25 Creating administrative users for MyDay...................................................................................... 26 Configuring file permissions for Infor On-Ramp .......................................................................... 27 Restoring database contents ......................................................................................................... 28 Modifying BIS data inbox properties ............................................................................................. 30 Processing Public MDM tenant codes........................................................................................... 31 Starting MyDay routing applications ............................................................................................. 32 Starting Infor On-Ramp................................................................................................................... 33 Starting Infor On-Ramp in detached mode.................................................................................. 33 Starting Infor On-Ramp in interactive mode (optional) ................................................................ 33 Logs ............................................................................................................................................ 33
4 | Contents
Creating and deploying a routing definition ................................................................................. 34 Importing the enterprise template................................................................................................ 34 Building and deploying the enterprise components..................................................................... 34 Creating a routing and activating the solution ............................................................................. 44 Restarting Infor On-Ramp ........................................................................................................... 46 Starting MyDay applications .......................................................................................................... 47 Synchronizing Public MDM tenant codes ..................................................................................... 48 Restoring BIS data inbox properties ............................................................................................. 49 Verifying codes and codelist synchronization ............................................................................. 50 Specifying an accounting entity in PublicMDM............................................................................ 52 Installing reports ............................................................................................................................. 53 Installing the Infor Reporting report designer .............................................................................. 53 Configuring the auditing feature for Infor Reporting .................................................................... 54 Importing MyDay reports (optional) ............................................................................................. 55 Configuring the system for drillbacks........................................................................................... 56 Creating business users for MyDay .............................................................................................. 57 Verifying the installation................................................................................................................. 58 Appendix A: Accessing Infor applications ................................................................................... 59 Appendix B: Password restrictions............................................................................................... 60 Appendix C: Applying patches ...................................................................................................... 61 Appendix D: Uninstalling MyDay ................................................................................................... 62 Appendix E: Upgrading MyDay...................................................................................................... 63 Appendix F: Upgrading MyDay content ........................................................................................ 66 Appendix G: Exporting security users and permissions............................................................. 70
Intended audience
This guide is for professional services or system administrators who install and configure the system.
Prerequisite knowledge
To fully understand the information presented in this guide, you should first read the Infor Open SOA Overview Guide. The Infor Open SOA Overview Guide discusses the major concepts of Infor Open Service Oriented Architecture (SOA) and defines common terminology. That guide also includes a list of related documents. Before attempting to install and configure the components needed for Infor MyDay, you should have some knowledge and abilities in the following areas: Knowledge of Tomcat configuration For Windows-based installations, administrative level skills and knowledge for Windows and Microsoft SQL Server, including: Troubleshooting performance and measuring resource demand Installing and configuring Microsoft SQL Server Configuring a database for local and/or network access Creating and dropping SQL Server databases manually Using monitoring techniques to assess the performance of SQL databases
Organization
The installation guide contains these sections. Section
System requirements Preparing for the installation
Description
Requirements for the database server, application server, and clients, as well as reserved port numbers Describes the databases and users to create, a script to run, and a properties file to edit. Has a matrix showing, if you choose to install only some parts of MyDay, which applications require which parts Steps to customize the installation process Steps for the installation. Steps to clear PublicMDM information from several databases. Steps to import the initial security permissions into Infor Security. Steps to define an accounting entity for the ERP in Infor Security. Required responsibilities and roles for the various applications, and steps to create them in Infor Security. On-Ramp configuration files to which you must restrict access. Databases to restore - that is, load content into - using backups. Steps to modify inbox properties Steps to process tenant codes Steps to start the services Steps to start On-Ramp in either detached or interactive mode. Gives the steps to create a MyDay configuration on On-Ramp using Infor DCA and DEM: import the enterprise template, build and deploy components, create a routing and activate the solution. Lists the services that need to be started. Steps to synchronize tenant codes Steps to restore inbox properties Tells how to synchronize and verify the codes and code lists. Steps to define an accounting entity for the ERP in Infor PublicMDM. Tells how to install the report designer, configure auditing, and (optionally) import the MyDay reports. Tells how to use the MyDay Administration application to set up the ability to drill back from MyDay into the ERP source data. Sets MyDay user roles and responsibilities in Infor Security. Tells how to make sure MyDay is working properly after setup. Appendixes for post-installation information
Customizing component installation Installing MyDay Clearing PublicMDM information Importing security permissions Creating security hierarchies Creating administrative users Configuring file permissions Restoring database contents Modifying BIS data inbox properties Processing Public MDM tenant codes Starting MyDay routing applications Starting Infor On-Ramp Creating and deploying a routing definition Starting MyDay applications Synchronizing PublicMDM tenant codes Restoring BIS data inbox properties Verifying codes and codelist synchronization Specifying an accounting entity Installing reports Configuring the system for drillbacks Creating business users for MyDay Verifying the installation Appendixes
Contacting Infor
If you have questions about Infor products, go to Infor365 Online Support at http://www.infor365.com. If you do not have an Infor365 account, click Register now and complete the registration. You will receive a log-on ID and password within 24 hours. When you access Infor365, you have these options: To access Infor knowledge bases, incidents, documentation, software downloads, and community discussion forums, click one of the links on the top menu of the home page. To add an incident, select one of these options from the Incidents menu: Add Product Incident - Specify your product, version, and other details, so that your incident report is sent directly to the support group. Add General Information Request - Use this option for all other requests.
To find the Customer Support telephone number for your region, click Contact Infor in the top right corner of the home page, specify a product name, and click Search. If we update this document after the product release, we will post the new version on Infor365. We recommend that you check this Web site periodically for updated documentation. If you have comments about Infor documentation, contact documentation@infor.com.
8 | System requirements
System requirements
Before beginning the Infor MyDay installation, be sure that the servers and clients are set up as described here.
Database server
We recommend that you use a dedicated database server for the databases associated with Infor MyDay (Infor BIS database, Infor On-Ramp database, Infor CSI database, and so on). In most cases, this should be separate from the database server used by the applications such as ERP that feed into MyDay, so that the performance of those applications is not impacted. The database server must have Microsoft SQL Server 2005 installed. SQL Server should be installed with Mixed Mode authentication, which allows both Windows authentication and SQL Server authentication. The database server must be running a minimum of either Windows 2003 Server Enterprise Edition, or Windows 2003 64-bit Standard Edition. The user who will install MyDay must have Administrator rights on this server. The hardware specifications for the database server depend on the volume of transactions in the ERP system.
System requirements | 9
Application server
We recommend that you use a dedicated application server, separate from the database server(s), on which you will install and run these components as described in this guide: Infor Security Infor Dynamic Enterprise Management (DEM) Infor Deployment, Configuration, and Administration (DCA) Infor On-Ramp Infor Common Services Infrastructure (CSI) Infor Metadata Infor Financials Currency Infor Financials Calendar Infor Business Information Systems (BIS) Infor Public Master Data Management (MDM) Infor Proxy Master Data Management (MDM) Infor Reporting Infor MyDay The user who will install MyDay must have Administrator rights on this server. The application server must meet these requirements: 1 Ensure that the server has at least: 2 6 GB of RAM available for these applications. 2 processors (preferably dual core). 30 GB of hard disk space.
Ensure that the application server is running a minimum of either Windows 2003 Server Enterprise Edition, or Windows 2003 64-bit Standard Edition. If the server is also to be used as a client (see page 11), then ensure that a browser is available with the options listed in the Client section. Install Java Development Kit 1.5.x. When you install Java Development Kit (JDK), select Custom Setup and change the Installation Location. Verify the following: For installation on a 64-bit server, make sure that you install a 64-bit version of JDK 1.5.x
10 | System requirements
Make sure that you install JDK, not a Java Runtime Environment (JRE). Do not install JDK in any folder whose name contains spaces. Note the installation folder name, since you will refer to it later. Under Browser Registration, make sure Microsoft Internet Explorer and Mozilla Firefox is selected.
Tip: To download JDK from the Sun Microsystems Java Web site (http:// java.sun.com), go to the downloads section and look for Java SE, previous editions, Java2SE 5.0 downloads. Download JDK 5.0. (JDK 1.5 and 5.0 are the same thing.) Ensure that, if you are using a 64-bit computer, you download the 64-bit version. 5 Set environment variables for the application server. To do this, go to the System Properties dialogs Advanced pane and click Environment Variables. a Create a new system variable called JAVA_HOME that points to the Java Development Kit installation folder.
System requirements | 11
Validate the installation of JDK by running the batch programs listed in the commands window.
Client
A client is any computer that accesses Infor MyDay or the other Infor Open SOA components through a browser. Thus, if you access the component applications through a browser on the application server, the server is also considered a client. Clients must meet the following requirements: Clients should use either the Windows XP Professional or the Windows Vista Business Edition operating system. (Clients installed on a server can use Windows 2003 Server.) For the browser on the client, use Mozilla Firefox version 3.x or Internet Explorer 7.x. The following options must be set up in the browser: SSL Cookies JavaScript
Java must be installed on every computer where the Infor Reporting report designer is installed (see page 53). To verify that Java is set up correctly, you can use a Java test. For an example test page, see the Test your jvm information on the Java Web site (http//java.com). NOTE: This test page tells you that you are using an older version of JRE. However, you must not update your Java version, since at this time we support only JDK 1.5.
12 | System requirements
Used by
LDAP MyDay databases
Note: Do not delete this folder after the installation, because it contains all the necessary configuration and structure and can be used to install future version upgrades and software patches. 3 4 Extract the contents of the Installer.zip file into the [MyDayPackage]\Installer folder. On the database server, in SQL Server Management Studio, create a database user named inforuser. (Optionally, you can edit the database script [MyDayPackage]\Installer\etc\CreateUsers.sql to change the default password in it. Then run the script to create this user.) For this user account, the following should be set up: sa privileges Enforce Password Policy should not be selected The password for this user should observe the restrictions set up in Appendix B: Password restrictions.
On the database server, create the following databases. (Optionally, you can use the database script [MyDayPackage]\Installer\etc\CreateRBHPDatabases.sql to create these databases.) InforBISConfig InforBISData InforBISDataConsumer InforCSI InforCSIAudit
InforCurrency InforDCA InforDEM InforESBIOBox InforFinancialCalendar InforIR InforMetadata InforProxyMDM InforPublicMDM InforRBHP InforSecurityMDM
Run the script [MyDayPackage]\Installer\etc\SetIsolations.sql against the master database on the database server. Make sure there are no connections to databases whose names begin with Infor when you run this script. On the application server, edit the following properties in the file [MyDayPackage]\Installer\master.properties where [MyDayPackage] is the root drive and folder containing the files used in the MyDay installation: Property
installer.path installation.path
Description
Location of MyDay installer package Location where MyDay will be installed. This folder should already be created. In the rest of this document, this folder is referred to as [MyDayHome]. Complete hostname Password for the user "manager" which is used to sign into Infor Security to import user privileges and create all other users Name of the database server, if different than the application server The port on the database server configured to listen for connections Name of the database user Password for the inforuser user
Example
C:/MyDay/Installer
(see note below)
C:/Infor
server.1.name ldap.1.server.password
[appserver].infor.com any password that follows Appendix B: Password restrictions [dbserver].infor.com 1433 inforuser [password]
Property
database.1.admin.id database.1.admin.password components containers os.64bit
Description
Name of the database administrator Password for the inforuser user Comma-separated list of component names to install List of tomcat containers to be installed Property should be set to true if the server used for the installation is a 64-bit computer AND a 64-bit JDK is installed. Any value other than true is treated as false.
Example
inforuser [password] See table below 1,2,3,4,5 os.64bit = false
Notes: When setting the path properties above, use a forward slash (/) instead of a back slash (\). Using a back slash causes the installation process to fail. Ensure that there are no forward slashes at the end of the installer.path or installation.path properties. To verify whether the application server is a 64-bit computer: a b c d On the server console, select Start > Run and enter dxdiag. If a prompt displays, asking if you want to verify your drivers, click No. When the program finishes, if this is a 64-bit computer, the Operating System line will look similar to this: Windows [version] x64 or 64-bit edition. Click Exit.
Entries in the Component Name group (orange) must be listed, separated by commas, in the components property line of the [MyDayPackage]\Installer\master.properties file. The configuration described below is the standard MyDay configuration. Some ERP systems may require additional or different components, databases, or containers. See the ERPs Integration Guide for details. Entries in the Container group (green) must be listed, separated by commas, in the container property line of the [MyDayPackage]\Installer\master.properties file. These are the tomcat containers that must be running in order for the application (in the column marked with an X) to run. Entries in the Database group (blue) are databases that must be created prior to the installation. The databases are associated with the applications in the columns marked with an X.
Component Name Currency FinancialCalendars InforBISConfig InforBISConfigServer InforBISData InforBISDataConsumer InforBISDataServer InforCalendarServer InforCAS InforCSI InforCSI_Audit InforCSI_Server InforCurrencyServer InforDCA X X X X X X X X X X X X X X X X X X X X X X X X X X X X
FinancialCalendars
Infor Reporting
Infor On-Ramp
PublicMDM
ProxyMDM
DEM/DCA
Currency
Security
MyDay
RBHP
CSI
BIS
InforDCA_Server InforDEM InforDEM_Server InforESB InforLDAP InforMetadata InforPublicMDM InforPublicMDMServer InforProxyMDM InforRBHP InforRBHP_Server InforReporting InforSecurity InforSecurityMDM Container Number 1 2 3 4 5 Database InforBISConfig InforBISData InforBISDataConsumer
X X X X X X X X X X X X X X X X
X X X X X X X X X
X X X
X X X X X X X X X
X X X
X X X
FinancialCalendars
Infor Reporting
Infor On-Ramp
PublicMDM
ProxyMDM
DEM/DCA
Currency
Security
MyDay
RBHP
CSI
BIS
InforCSI InforCSIAudit InforCurrency InforDCA InforDEM InforESBIOBox InforFinancialCalendar InforIR InforMetaData InforProxyMDM InforPublicMDM InforRBHP InforSecurityMDM
X X X X X X X X X X X X X X X X X
N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A N/A X
X X X
X X X
X X
FinancialCalendars
Infor Reporting
Infor On-Ramp
PublicMDM
ProxyMDM
DEM/DCA
Currency
Security
MyDay
RBHP
CSI
BIS
Property
database.base
Description
The database defined in the master.properties file where the database for the component will be installed The database schema name used by the current component The user name that the component uses to connect to the database The user password to connect to the database The user name that is used to connect to the InforBISData database. The user password to connect to the InforBISData database.
Example
database.1
database.ods.server.user.password
(see note below)
Note: Because the following components each require database connections, you may add these properties (if they do not exist) or remove the # comment notation from the beginning of the line (if the property is commented out) so they can be used by the installer. The database.ods.server.user.id and database.ods.server.user.password properties are required by only four of these components, as described below: InforBISConfigServer also requires database.ods.server.user.id and database.ods.server.user.password properties InforBISDataConsumer also requires database.ods.server.user.id and database.ods.server.user.password properties InforBISDataServer InforCalendarServer InforCSI_Audit InforCSI_Server InforCurrencyServer InforDCA_Server InforDEM_Server InforESB InforMetadata InforProxyMDM InforPublicMDMServer
InforRBHP_Server also requires database.ods.server.user.id and database.ods.server.user.password properties InforReporting also requires database.ods.server.user.id and database.ods.server.user.password properties InforSecurityMDM
22 | Installing MyDay
Installing MyDay
1 From a command prompt on the application server, navigate to the [MyDayPackage]\Installer folder and run the install.bat batch file. After the installation begins, the control for the command prompt is suspended and returns when the installation completes. The batch file installs all of the components required to use MyDay. 2 When the command prompt returns, review the [MyDayPackage]\Installer\logs\install.log file and search for any errors. If the installation was successful, the message BUILD SUCCESSFUL appears at the end of the file. During the installation, the installer creates a keystore file in the [MyDayHome] folder. This file is unique for each system and is used to establish secure connections between the server and the clients. Back up this file to a safe location outside the installation directory, so it can be restored if needed. From the command prompt, run the [MyDayPackage]\Installer\patch.bat file to apply all available patches that are included with the release. For instructions on how to apply additional patches that may become available, see Appendix C: Applying patches. When the command prompt returns, review the [MyDayPackage]\Installer\logs\patch.log file and search for any errors. If the installation was successful, the message BUILD SUCCESSFUL appears at the end of the file Configure the system as described in the rest of this guide. If you encounter errors during any step, consult the troubleshooting information in the guide associated with the component (Infor Security, Infor DEM, and so on) where you are currently working.
If necessary, you can set the startup mode of these Windows Services to "Manual" instead of Automatic. If this installation has been made on a server, keep the startup mode as "Automatic. Sign in to the Infor Security application using the URL shown in Appendix A: Accessing Infor applications, with the user ID manager and the password that you defined in the master.properties file. (See ldap.1.server.password in the table on page 14.) Note: During the first access to each application/port, the browser displays a warning message that a secure connection failed. To correct this, add an exception. If you need assistance, consult the browsers online help. To avoid receiving these error messages, you must obtain a certificate signed by an authority such as Verisign, and then update all clients to add Infors default certificate as a trusted certificate.
Import the security permissions file into the Infor Security application: a b c d Click SECURITY. From the menu, select Advanced > Tools. In the Import section, browse to [MyDayPackage]\Installer\etc\MyDayFullExport.xml. Click Import. A message confirms the successful import of the security permissions file.
Do not sign out of Infor Security, since it is used again for the next task.
Responsibility
MyDay Administrator BIS Administrator PublicMDM Administrator CSI User Reporting Administrator Business Analyst Business Process Analyst
Role Assignment
InformationTechnology.DataAdmin (primary) InformationTechnology.DataAdmin (primary) InformationTechnology.DataAdmin (primary) InformationTechnology.SystemsAdmin (primary) InformationTechnology.DataAdmin (primary) InformationTechnology.DataAdmin (primary) InformationTechnology.SystemsAdmin InformationTechnology.BusinessProcessAdmin (primary)
Note: The Financial Calendars and Currency applications do not require users to have any special roles; therefore, any of the users created above automatically have access to the Financial Calendars and Currency applications. To create users through the Infor Security application: 1 2 Click Users. Click New (in the upper right corner) and fill in the information for the new user, including the details and password. User passwords should observe the restrictions specified in Appendix B: Password restrictions. In the Security Hierarchies tab, click the Details icon next to Roles. Then use the arrow buttons to assign the appropriate roles to the user and click Submit. You can also assign locations and accounting entities to the user. If this user requires access to CSI, in the Security Hierarchies tab click the Details icon next to Accounting Entities. Assign all the entities defined in the previous section that will be used by the ERP. Doing so allows this user to audit messages generated by the ERP. Click Submit to save the new user.
For more information about creating users, roles, and passwords, see the Infor MyDay System Administration Guide. To export and back up the information you just entered, see Appendix G: Exporting security users and permissions.
Overview
After a new installation, the databases do not yet contain the configuration that is required to make the MyDay application fully operational. Infor provides this configuration in the form of database backups. Restoring the database content from the backups completes the configuration so that the application includes metrics and reports, as well as the import and export services that retrieve data and render it into the metrics and reports. NOTE: This section applies only to new installations. If you have previously restored content databases and have run the script processTenantCodes.sql, use the steps in Appendix F: Upgrading MyDay content to upgrade your existing installation with new content, instead of this section. Contact Infor for the latest content databases. Do not use the content databases distributed with the software located in the [MyDayPackage]\Content folder. The steps in this section assume you have an up-to-date version of the content databases. The content backups consist of 4 database backups and a set of SQL scripts. The database backups are: InforBISConfig InforBISData InforIR InforRBHP The SQL scripts, which are used in later steps of the installation, are: processTenantCode.sql counterMyDay.sql processedMessageCounter.sql deleteFromInforOnRamp.sql deleteFromProxyMDM.sql
Steps
1 Stop the following Windows services (note that Tomcat2, 3, and 4 may not be running at this point): Infor Tomcat1 Infor Tomcat2
To load the contents from the backup files, perform these steps on the database server: a b c d Restore the database InforBISConfig with the downloaded backup file InforBISConfig.bak. Restore the database InforBISData with the downloaded backup file InforBISData.bak. Restore the database InforIR with the downloaded backup file InforIR.bak. Restore the database InforRBHP with the downloaded backup file InforRBHP.bak.
When restoring these content backups, always select Overwrite the existing database on the Options page of the Restore Database task screen in Microsoft SQL Server Management Studio.
For computers running UNIX or Linux: 1 2 To go to the Infor On-Ramp installation folder enter cd [MyDayHome]/esb. Enter esb to start the Infor On-Ramp.
Logs
Infor On-Ramp log files are stored in the folder [MyDayHome]/esb/logs.
2 3
4 5
Notes
Template for Windows 2003 Server Name of the server where On-Ramp is installed
4 5 6 7 8
Click Submit to save the changes. On the Properties tab, click Modify addresses. Click on the existing entry for localhost to select it, and click on Delete to remove it. Click New. Specify this required information: Field
value
Notes
Host name or IP address of the server where OnRamp is installed
Notes
Hostname used in the URL to connect to the MyDay database Port used in the URL to connect to the MyDay database Schema name. Default is dbname User name for the resource instance. Default is an empty string Password for the resource instance. Default is an empty string
Notes: If you use the default values as shown in this table, then during the Component Instance creation, DCA will insert the standard values provided by the enterprise template. For example, if you leave the schemaname set to dbname, then when creating the CSI component instance, DCA automatically inserts InforCSI in the Schema Name field. The default values used by DCA can be overwritten at the container or component level. Resources can be reused in containers and components when they reuse the same hostname and port. When this is not the case, you must create additional resources. Later, you will be asked to specify a database username and password for a container instance. Since you have specified the username and password here, you can leave these fields blank on the container instance, and DEM uses the values you entered here in the database resource instance as defaults.
4 5
Notes
Hostname used in the URL to connect to the ERP database Port used in the URL to connect to the ERP database ERP database name SQL user name used to access the ERP database Password used to access the ERP database
Expected Value
OSGi
Notes
Name of the template.
Field
ID
Expected Value
1
Notes
Container ID. This ID must match the ESB (On-Ramp) container ID used during the installation. The installer uses the default value infor.container.1. DCA automatically fills out the first two nodes of the name (infor.container), so enter only 1 here. Name of the server configured earlier in this section Component that will handle error logging on the container. Note: No components have been created yet. After completing the next section, you will update the container with this information (see page 42).
server.windows.[appserver] infor.csi.local
4 5
Click Submit to save the container information. Specify this required information on the PROPERTIES tab: Field
database schemaname username password broker port
Expected Value
infor.resource.myday InforESBIOBox inforuser [password] Infor.resource.broker 61617
Notes
MARS database resource created in the previous section Database schema name for On-Ramp Database user name for On-Ramp Password for the inforuser database account Broker resource created in the previous section Port provided by default
Note: The schemaname for Infor On-Ramp is provided by default. Do not modify it unless the database is configured differently. If the username and password fields are left blank, the values entered on the database resource (infor.resource.myday) are used by default in DEM during the deployment (see Creating a routing and activating the solution on page 44). The other fields on this tab are used for tuning the performance of message processing by Infor OnRamp. Make changes to the default values listed here only after performing an overall analysis of the installation and hardware. Field
mars.localrouter.maxConcurrentConsumers
Default value
50
Description
The maximum number of threads that can be created to route messages to the components inboxes. The minimum number of threads that can be created to route messages to the components inboxes.
mars.localrouter.concurrentConsumers
20
Click Submit.
e f g
Template
schemaname
username
password
infor.resource. myday infor.resource. myday infor.resource. myday infor.resource. myday infor.resource. myday Infor.resource. myday infor.resource. myday
inforuser
(see notes)
[password]
(see notes)
Template
database resource
(see notes)
schemaname
username
password
Notes: The value for schemaname is provided by default in the Enterprise Template. If you leave the username and password blank here, the username and password values that were entered during creation of the MyDay database resource (see page 35) will be used automatically during deployment. If more than one MyDay database resource was defined because MyDay component databases are on different servers, specify the appropriate resource in the database resource field. h On the Properties tab for each component, the property poller.deleteProcessedMessages indicates whether the messages to (Inbox) and from (Outbox) the selected component should be deleted from the database after they are processed by the Infor On-Ramp. The default value is false, meaning that messages will not be deleted. Not deleting the messages after processing is helpful when debugging message routing; however, be aware that the false setting will increase the size of the inbox and outbox tables on the database considerably over time. This can potentially impact performance. To prevent performance issues, Infor On-Ramp automatically deletes all messages that were processed more than 36 hours ago. The other fields on this tab are used to tune the performance of message processing by Infor OnRamp. Make changes to the default values listed here only after performing an overall analysis of the installation and hardware. Field
listener.concurrentConsumers
Default Value
5*
Description
The minimum number of threads that can be created to consume messages delivered by Infor On-Ramp and place them in the components inbox for processing. * Although this default value is best for most components, it may vary for components that must process a larger number of messages.
Field
listener.maxConcurrentConsumers
Default Value
15 *
Description
The maximum number of threads that can be created to consume messages delivered by Infor On-Ramp and place them on the components inbox for processing * Although this default value is best for most components, it may vary for components that must process a larger number of messages. The number of messages that the polling daemons can retrieve from the components outbox at one time and can make available for routing to Infor On-Ramp The maximum number of threads that can be created to retrieve messages from the components outbox and make them available for routing to Infor On-Ramp The minimum number of threads that can be created to retrieve messages from the components outbox and make them available for routing to Infor On-Ramp The interval, in milliseconds, at which the polling daemons check the components outbox for more messages after all messages have been delivered for routing
poller.rowsLimit
20
pollingDaemon.maxPoolSize
10
pollingDaemon.minPoolSize
10
pollingDaemon.sleepTime
5000
i 3
For the CSIAudit component only, you must also enable it to audit other components: a b c Click Edit. Click the Audits tab. Click New. A new row is added. Select a component from the table above. Repeat this step until all the components in the table, except the CSI and CSIAudit components, are added. NOTE: Auditing is helpful for debugging and for performing message tracking. However, please consider the performance trade-off. When auditing is enabled, the volume of messages handled by On-Ramp is at least double its normal amount. Thus, unless you have concerns or special needs, we recommend that you do not enable auditing during this installation process. Later, if necessary, you can enable auditing of messages going into specific components only by modifying the CSIAudit component and then sending an updated deployment to Infor On-Ramp. We also strongly recommend that you do not enable auditing during initial data loads, when the volume of messages is likely to be higher than the day-to-day transactions that the system will handle later. d Click Submit to save this information.
Review the details for all the components and approve them.
When you finish, verify the status of all the components in the list they should all be Approved. If not, go back and approve them.
Template
[ERP]
database resource
(see note)
schemaname
[ERP database name]
username
[user name to access ERP database]
password
[password to access ERP database]
infor.resource.[ERP]
Note: In the database resource field, specify the ERP database resource that you defined earlier. h On the Properties tab, the property poller.deleteProcessedMessages indicates whether the messages to (Inbox) and from (Outbox) the ERP should be deleted from the database after they are processed by the Infor On-Ramp. The default value is false, meaning that messages will not be deleted. Not deleting the messages after processing is helpful when debugging message routing; however, be aware that the false setting will increase the size of the inbox and outbox tables on the database considerably over time. This can potentially impact performance. To prevent performance issues, Infor On-Ramp automatically deletes all messages that were processed more than 36 hours ago. Click Submit to save the properties. Return to the CSIAudit component and edit it to add the ERP component to its list of audited components:
i j
Click Edit. Click the Audits tab. Click New. A new row is added. Select the ERP component you added above. NOTE: Auditing is helpful for debugging and for performing message tracking. However, please consider the performance trade-off. When auditing is enabled, the volume of messages handled by On-Ramp is at least double its normal amount. Thus, unless you have concerns or special needs, we recommend that you do not enable auditing during this installation process. Later, if necessary, you can enable auditing of messages going into specific components only by modifying the CSIAudit component and then sending an updated deployment to Infor On-Ramp. We also strongly recommend that you do not enable auditing during initial data loads, when the volume of messages is likely to be higher than the day-to-day transactions that the system will handle later.
Executing deployment
Note: Make sure that the Infor On-Ramp service (infor.container.1) is running before performing these steps. To deploy all the components to the On-Ramp: 1 2 3 4 5 Click Deployments. In the list of deployments, click the Details icon next to the <<DRAFT>> deployment. On the DEPLOYMENT <<Draft>> page, click Deploy (in the upper right corner). In the dialog that displays, specify the Name and Description of the deployment and click OK. Sign out of the DCA application.
2 3
Creating a routing
To create a routing: 1 2 3 Click Routings in the left pane. Click New. On the ROUTING (NEW) page: a b c d Select the Routing Template to use (for example, MyDay SyteLine Routing Template). Specify a Name for the routing (for example, MyDay SyteLine Routing). Click Submit. The lower pane displays all the routes that were included as part of the new routing. Click Approve (in the upper right corner).
If you started Infor On-Ramp as a service, restart it on the Windows Service Manager application.
Do not start the Infor Tomcat5 Windows service Note: Under the current MyDay configuration, the service Infor Tomcat5 is only used by the DEM and DCA applications. To preserve CPU and memory resources, we recommend that you keep it stopped. Start it only if changes are made on the resources or routing definitions, as described in Creating and deploying a routing definition on page 34. To prevent this service from starting automatically whenever the applications server is restarted, its Startup Type should be set to Manual in the Windows Services Manager.
3 4
Outbox of Component
PublicMDM Currency Calendar BISConfig BISData IR InforRBHP
After all messages are processed, run this script (also included in the content ZIP file) in SQL Server Management Studio: counterMyDay.sql The number of codes, dimensions, and hierarchies and codelists in each component should match the number in PublicMDM, as shown in the following example. Currently, some components, such as
InforCurrency, might have more codelists and codes than PublicMDM; however, this is a temporary situation. The numbers in the example below (2385 and 110) are for illustration only and may change depending on the version of the database contents that is imported. Component
PublicMDM Currency Calendar BISConfig BISData IR InforRBHP
Number of codes
2385 2385 2385 2385 2385 2385 2385
Number of dimensions
110 110 110 110 110 110 110
Number of hierarchies
110 110 110 110 110 110 110
2 3 4 5 6
Installing reports | 53
Installing reports
Value
MyDay application server name 8090 [username]
Notes
Name of the application server where MyDay is installed HTTP port number of the Apache tomcat instance where the Infor Reporting application was installed Name of the user that you created for the Infor Reporting application, belonging to the DataAdmin role, during Creating administrative users for MyDay on page 26 Password for the database user
IR Services Password
[password]
Click Next.
54 | Installing reports
8 9
3 4
5 6 7
Value
jdbc:jtds:sqlserver://[database_server]:[dat abase_port]/InforIR
Notes
[database_server] and [database_port] iin the URL refer to the database server and port number of the InforIR database schema Name of the database account (usually inforuser) that was created in Preparing for the installation on page 13 Password for the Infor Reporting database user
User Name
Password
[password]
8 9
Click Test Connection to verify that the connection can be established with the new information. Click OK to close the dialog box.
10 If the IR Report Manager pane is not visible, open it: select Window > Show View > Other> Infor Reporting > IR Report Manager. 11 Right-click the Infor Reporting Audit Styles library node and click Save. 12 Right-click Infor Reporting Audit Styles again and click Unlock.
Installing reports | 55
3 4
5 6 7
Refer to the Infor Reporting documentation for information about creating reports.
2 3
Description
application name infor.[appname] lid://infor.[appname].[instance] This value must match the ID defined in Creating the ERP component instance on page 42
Example
SyteLine infor.syteline lid://infor.syteline.oh
ERP host server name or IP address ERP port Indicates whether the drillback to the ERP system is secured (SSL based) or unsecured
slutil1 8080 No
Click Submit.
2 3 4
For more information about creating users, roles, and passwords, see the Infor MyDay System Administration Guide. To export and back up the information you just entered, see Appendix G: Exporting security users and permissions.
Infor Business Information Services Configuration Infor Business Information Services Data Infor Business Information Services Data Consumer Infor Common Services Infrastructure (CSI) Infor Currency Master Data Management Infor DCA Infor DEM Infor Financial Calendars Master Data Management Infor MyDay Administration Infor Public Master Data Management Infor Security Administration
http://[hostname]:8050/BISConfig http://[hostname]:8050/BISData http://[hostname]:8050/BISDataConsumer http://[hostname]:8070/csi http://[hostname]:8030/Currency http://[hostname]:8010/dca http://[hostname]:8010/dem http://[hostname]:8030/FinancialCalendars http://[hostname]:8090/homePageAdmin http://[hostname]:8030/InforPublicMDM http://[hostname]:8070/Security
Character
& * @ ^ ) : , = ! > [ < ( % . | + ? ] ; ~ _
2 3 4
Run the batch script [MyDayPackage]\Installer\uninstall.bat. Note: Like the install process, the uninstall process uses the values set on the components and containers properties of the master.properties file to determine which components to uninstall. If you leave the default values, all containers and components are uninstalled. For details on how to uninstall specific components or containers, refer to the table in Installation of specific applications starting on page 15.
The uninstaller will not drop or modify the existing databases. If necessary, to drop the database schemas related to Infor MyDay, run the sql script [MyDayPackage]\etc\DropRBHPDatabases.sql as a system administrator.
Overview
This section provides the steps to upgrade the application side of MyDay (tomcat services, containers, web components, LDAP and Infor On-Ramp). No changes are made to the currently loaded data content and data configuration. This process can be done independently from the process described in Appendix F: Upgrading MyDay content.
Steps
To upgrade from a previous version of MyDay, use these steps: 1 Sign in to the Infor Security application using the URL shown in Appendix A: Accessing Infor applications, with the user ID manager and the password that you defined in the master.properties file. (See ldap.1.server.password in the table on page 14.) Export the security permissions file into the Infor Security application: a b c Click SECURITY. From the menu, select Advanced > Tools. In the Export section, leave the value on the Data to Export field set to All, and click Export.
d When prompted, click Save and select a location to save the file fullExport.xml.
Save the exported file to a safe location outside the MyDay home folder [MyDayHome] or the installer folder [MyDayPackage]. 3 Stop all InforTomcat services, the InforSecurity LDAP service, and the On-Ramp service (infor.container.1). Run the batch script [MyDayPackage]\installer\uninstall.bat. Note: Like the install process, the uninstall process uses the values set on the components and containers properties of the master.properties file to determine which components to uninstall. During the upgrade you must uninstall all components and containers, so make sure the original values provided in the file are still listed. Refer to the table in Installation of specific applications starting on page 15 for the list of components and containers. The uninstaller does not drop or modify the existing databases. During an upgrade this is not necessary, so do not run any of the database scripts used in the installation steps. 5 Run the batch script [MyDayPackage]\etc\removeservices.bat.
Delete or rename the current [MyDayPackage] created in Step 2 of Preparing for the installation on page 13. Replace it with the installation package provided for the new release. Edit the master.properties file provided in the new [MyDayPackage] as described on page 14. Make sure you use the properties file provided for this new release; do not copy or reuse the one from the old installation. Run the script [MyDayPackage]\Installer\etc\UpdateSchemaVersions.sql against the master database on the database server. From a command prompt on the application server, navigate to the [MyDayPackage]\Installer folder and run the install.bat batch file. After the installation begins, the control for the command prompt is suspended and returns when the installation completes. The batch file installs all of the components required to use MyDay.
10 When the command prompt returns, review the [MyDayPackage]\Installer\logs\install.log file and search for any errors. If the installation was successful, the message BUILD SUCCESSFUL appears at the end of the file. 11 Install any patches: a b c Check the [MyDayPackage]\Installer\Patches directory to see if there are any patches included in the release. If no patches are available, skip to Step 12. From the command prompt, run the [MyDayPackage]\Installer\patch.bat file to apply all patches that are included with the release. When the command prompt returns, review the [MyDayPackage]\Installer\logs\patch.log file and search for any errors. If the installation was successful, the message BUILD SUCCESSFUL appears at the end of the file.
13 Sign in to the Infor Security application again and import the users/permissions file that was exported in Step 2: a b c d Click SECURITY. From the menu, select Advanced > Tools. In the Import section, browse to the file exported in Step 2. Click Import. A message confirms the successful import of the security permissions file.
14 Set the file permissions for Infor On-Ramp, as described on page 27. 15 Start the remaining Windows services:
16 Start Infor On-Ramp either in detached mode or in interactive mode, as described on page 27. 17 Sign into DCA and deploy the configuration that was created during the original installation process see Executing deployment on page 44. 18 Sign into DEM and activate the solution that was created during the original installation process see Activating the solution on page 45. 19 In the Windows service manager, restart the Infor On-Ramp service (infor.container.1). The broker then loads the components and routings.
Overview
This section provides the steps to upgrade the MyDay content used by some of the MyDay components. The data being upgraded in these steps deals with the configuration of the import and export services responsible for retrieving data and rendering it in metrics and reports that are made available to the user through the MyDay Admin pages. Before starting this process, all available patches must be applied to the system. For further details, see Appendix C: Applying patches. Also review the Readme.doc file included with the downloaded content update for additional information and requirements associated with this upgrade process. This process can be done independently from the process described in Appendix E: Upgrading MyDay.
Infor Tomcat5
To load the contents from the backup files, perform these steps on the database server: a b c d Restore the database InforBISConfig with the downloaded backup file InforBISConfig.bak. Restore the database InforBISData with the downloaded backup file InforBISData.bak. Restore the database InforIR with the downloaded backup file InforIR.bak. Restore the database InforRBHP with the downloaded backup file InforRBHP.bak.
When restoring these content backups, always select Overwrite the existing database on the Options page of the Restore Database task screen in Microsoft SQL Server Management Studio.
During initial processing, you must temporarily change the inbox.threads property. You will restore it later. a b c Open the file fortress.properties located in [MyDayHome]\tomcat2\webapps\com.infor.bis.data.server\WEB-INF. Find the inbox.threads property and record its current value on paper or in another file, so it can be restored later. Change the inbox.threads value to 1 and save the file.
Restart Infor On-Ramp. To restart Infor On-Ramp in interactive mode, use a command prompt to go to the Infor On-Ramp folder [MyDayHome]\esb and then enter esb. To restart Infor On-Ramp as a service, start it from the Windows Service Manager application.
Start the Windows services: Infor Tomcat1 Infor Tomcat2 Infor Tomcat3 Infor Tomcat4
Do not start the Infor Tomcat5 Windows service. (Under the current MyDay configuration, the service Infor Tomcat5 is only used by the DEM and DCA applications.) 6 After the services restart, messages begin flowing through the system. Wait for all messages to complete. To see if this has finished, run processedMessageCounter.sql (included in the content ZIP file) from SQL Server Management Studio. Continue running this script occasionally and check the results. This script automatically connects to and runs against the appropriate databases. For each component, the number of unprocessed messages should stop changing but will not be zero. Also, the number of unprocessed messages should be the same across all 6 components. If the numbers are still changing or are not the same across the 6 components then the system is still processing messages and you must wait. When it appears that no more messages are changing, wait a few more minutes to be sure it is done. (Sometimes it can take a minute for a single message to be processed.) After waiting a few minutes, check one more time and verify that none of the numbers have changed. All messages must be complete before continuing, or the databases will not be synchronized properly. 7 When no more messages are flowing, restart the following Windows services again. This starts a new set of messages flowing through the system. 8 Infor Tomcat2 Infor Tomcat3 Infor Tomcat4
To check if these new messages are complete, run processedMessageCounter.sql (included in the content ZIP file) from SQL Server Management Studio. Continue running this script occasionally and check the results. When the number of unprocessed messages is zero for each component, the script is complete; otherwise the system is still processing messages. In SQL Server Management Studio, run counterMyDay.sql (included in the content .ZIP file) and verify that each of the components has the same number of codes, dimensions and hierarchies.
10 Open the embassy.properties files (located in the folders listed below) and reset the publicmdm.embassy.fortressInitializer.autoStart property to 'false'. Save each file after you change it. (This step prevents unnecessary messages from flowing through the system.) [MyDayHome]\tomcat2\webapps\com.infor.bis.config.server\WEB-INF
11 Restore the BIS data inbox properties: a b c Open the file fortress.properties located in [MyDayHome]\tomcat2\webapps\com.infor.bis.data.server\WEB-INF. Find the inbox.threads property and change the value back to its original value, as recorded earlier in these steps. Save the fortress.properties file.
Post-restoration tasks
Using the information you saved earlier, perform these configuration tasks: 1 2 3 Reset to 'Disabled' any Import Services you turned off. Redefine the settings for your metrics. Re-establish the deployment configuration for the drillbacks.
Sign in to the Infor Security application using the URL shown in Appendix A: Accessing Infor applications, with the user ID manager and the password that you defined in the master.properties file. (See ldap.1.server.password in the table on page 14.) Export the security permissions and users file from the Infor Security application: a b c Click SECURITY. From the menu, select Advanced > Tools. Click Export. A popup window prompts for the location where the file should be saved.
Copy the exported file to a safe location so it can be imported when necessary.
Note: Unless you are instructed otherwise by Infor, do not import this file across installations using different versions of MyDay.