Epicor10_NewInstallGuide_101500.pdf
Short Description
Download Epicor10_NewInstallGuide_101500.pdf...
Description
Epicor ERP 10.1.500 Installation Guide New Installation of Epicor 10.1.500
Disclaimer This document is for informational purposes only and is subject to change without notice. This document and its contents, including the viewpoints, dates and functional content expressed herein are believed to be accurate as of its date of publication. However, Epicor Software Corporation makes no guarantee, representations or warranties with regard to the enclosed information and specifically disclaims any applicable implied warranties, such as fitness for a particular purpose, merchantability, satisfactory quality or reasonable skill and care. As each user of Epicor software is likely to be unique in their requirements in the use of such software and their business processes, users of this document are always advised to discuss the content of this document with their Epicor account manager. All information contained herein is subject to change without notice and changes to this document since printing and other important information about the software product are made or published in release notes, and you are urged to obtain the current release notes for the software product. We welcome user comments and reserve the right to revise this publication and/or make improvements or changes to the products or programs described in this publication at any time, without notice. The usage of any Epicor software shall be pursuant to an Epicor end user license agreement and the performance of any consulting services by Epicor personnel shall be pursuant to Epicor's standard services terms and conditions. Usage of the solution(s) described in this document with other Epicor software or third party products may require the purchase of licenses for such other products. Where any software is expressed to be compliant with local laws or requirements in this document, such compliance is not a warranty and is based solely on Epicor's current understanding of such laws and requirements. All laws and requirements are subject to varying interpretations as well as to change and accordingly Epicor cannot guarantee that the software will be compliant and up to date with such changes. All statements of platform and product compatibility in this document shall be considered individually in relation to the products referred to in the relevant statement, i.e., where any Epicor software is stated to be compatible with one product and also stated to be compatible with another product, it should not be interpreted that such Epicor software is compatible with both of the products running at the same time on the same platform or environment. Additionally platform or product compatibility may require the application of Epicor or third-party updates, patches and/or service packs and Epicor has no responsibility for compatibility issues which may be caused by updates, patches and/or service packs released by third parties after the date of publication of this document. Epicor® is a registered trademark and/or trademark of Epicor Software Corporation in the United States, certain other countries and/or the EU. All other trademarks mentioned are the property of their respective owners. Copyright © Epicor Software Corporation 2017. All rights reserved. No part of this publication may be reproduced in any form without the prior written consent of Epicor Software Corporation.
New Installation of Epicor 10.1.500 Revision: May 03, 2017 4:14 p.m. Total pages: 145 install_New.ditaval
Epicor ERP 10.1.500 Installation Guide
Contents
Contents Part I: Getting Started......................................................................................9 Chapter 1: Review Epicor ERP Flows..........................................................9 1.1 Review Installation Flow....................................................................................................................10
Chapter 2: Verify Prerequisites.................................................................12 2.1 Verify Access to EPICweb..................................................................................................................12 2.2 Review Release Documents...............................................................................................................12 2.3 Verify Windows Operating System Requirements..............................................................................13 2.4 Verify SQL Server Install and Features................................................................................................15 2.5 Configure Server Roles (Windows Server 2012 and 2008/R2)............................................................17 2.6 Configure Server Roles (Windows Server 2016).................................................................................19 2.7 Verify SQL Server Reporting Services (SSRS) Prerequisites...................................................................22 2.8 Set Up Test Environment...................................................................................................................23
Part II: Installation and Configuration..........................................................25 Chapter 3: Install the Epicor ERP 10.1 Application..................................25 3.1 Prepare SQL Server Login Account....................................................................................................25 3.2 Install Epicor ERP 10.1 Server............................................................................................................26 3.3 Install Epicor ERP 10.1.500.x Latest Update.......................................................................................30
Chapter 4: Configure Epicor Database.....................................................31 4.1 Add Epicor Database Server..............................................................................................................31 4.2 Add Epicor Database........................................................................................................................32 4.3 Configure Epicor ERP SQL Server Login Account................................................................................37
Chapter 5: Configure Epicor Server and Application Server..................38 5.1 Determine Authentication Option (Endpoint Binding)........................................................................38 5.1.1 Generate Self-Signed SSL Security Certificate (If Using UserNameSSLChannel and HttpBinaryUsernameSslChannel).................................................................................................38 5.2 Add Epicor Server.............................................................................................................................39 5.3 Add Epicor Application Server (New or Upgrading from 10.0)...........................................................40 5.4 Import License File and Enable Modules............................................................................................51 5.5 Add Company..................................................................................................................................53
New Installation of Epicor 10.1.500
3
Contents
Epicor ERP 10.1.500 Installation Guide
Part III: Post-Installation.................................................................................55 Chapter 6: Log In the First Time...............................................................55 6.1 Set Up System Agent........................................................................................................................55 6.1.1 Create System Agent User Account........................................................................................55 6.1.2 Create System Agent..............................................................................................................56 6.2 Install and Configure Task Agent......................................................................................................57 6.3 Verify SQL Search Services for Full-Text Search..................................................................................61 6.4 Test System and Repeat Installation..................................................................................................61
Chapter 7: Install Epicor ERP Extension Applications.............................63 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8
Install Epicor Web Access..................................................................................................................64 Install Epicor Mobile Access..............................................................................................................66 Install Epicor Enterprise Search..........................................................................................................68 Install Epicor Social Enterprise...........................................................................................................70 Install Embedded Education Courses.................................................................................................71 Install Epicor Information Worker......................................................................................................73 Install Epicor Online Help System......................................................................................................74 Install Epicor SharePoint Publisher.....................................................................................................77
Chapter 8: Configure Epicor ERP Extension Applications.......................78 8.1 Deploy and Configure Epicor Web Access.........................................................................................78 8.1.1 Assign EpicorWebAccess Folder Properties and Sharing...........................................................78 8.1.2 Assign Resources Folder Properties and Sharing......................................................................79 8.1.3 Deploy Epicor Web Access Forms............................................................................................79 8.1.4 Set Up Initial Configuration of Epicor Web Access...................................................................80 8.1.5 Install Epicor Lightweight Client..............................................................................................81 8.1.6 Configure EWA Reporting URL Display Features......................................................................81 Configure PDF: Windows Server 2008 R2 Web Server...............................................................81 Configure XLS: Windows Server 2008 R2 Web Server...............................................................82 8.1.7 Generate Web Forms for User Dashboards..............................................................................82 8.1.8 Generate Web Forms for Customized and Localized Application Forms...................................83 8.1.9 Review Supported Browsers and Configuration......................................................................84 8.1.10 Set Up EWA Compression (Windows Server 2008 R2 only)...................................................84 8.1.11 Install Crystal Reports Embedded Server 2013 (optional).......................................................85 8.2 Configure Epicor Mobile Access........................................................................................................86 8.2.1 Configure Epicor Mobile Access User......................................................................................86 8.2.2 Assign Data Folder Properties and Sharing..............................................................................86 8.3 Configure Epicor Enterprise Search...................................................................................................87 8.3.1 Register Enterprise Search Server............................................................................................87 8.3.2 Rebuild Search Index..............................................................................................................88
4
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Contents
8.3.3 Scheduled Tasks.....................................................................................................................89 Use Pre-defined Schedule to Rebuild All Indexes.......................................................................89 Schedule Search Index Rebuild Manually...................................................................................89 8.3.4 Enable Search Index................................................................................................................90 8.3.5 Enable Epicor Search Anywhere for Users...............................................................................91 8.3.6 Re-create Search Index Definition (If Needed)..........................................................................92 8.4 Configure Epicor Social Enterprise.....................................................................................................94 8.4.1 Log In to Epicor Social Enterprise............................................................................................94 8.4.2 Create Notification Source......................................................................................................94 8.4.3 Configure Email Server...........................................................................................................97 8.4.4 Configure Web Site URL.........................................................................................................97 8.4.5 Configure Twitter Credentials (Optional).................................................................................98 8.4.6 Configure Message Editing (Optional).....................................................................................98 8.4.7 Invite Users.............................................................................................................................99 8.5 Configure Epicor Education Module..................................................................................................99 8.5.1 Enable Education Module.......................................................................................................99 8.6 Configure Epicor Information Worker.............................................................................................100 8.6.1 Generate Server Components for BAQs................................................................................100 8.6.2 Deploy Alternate Contact Data Source..................................................................................101 8.6.3 Set Up Information Worker Clients.......................................................................................101 8.6.4 Troubleshooting Installation Errors........................................................................................102 8.7 Configure Epicor Sharepoint Publisher............................................................................................102
Chapter 9: Install Epicor ERP 10.1 Client on a Workstation..................104 9.1 Install .NET Framework 4.6.1 or Later (Client)..................................................................................104 9.2 Install Crystal .NET SDK Runtime (EWA Client optional)...................................................................104 9.3 Install Epicor ERP 10.1 Client Software............................................................................................105
Part IV: Supplemental Installations.............................................................108 Chapter 10: Install Microsoft Service Bus 1.1........................................108 10.1 Install Service Bus in a Test Environment........................................................................................108 10.2 Install Service Bus in a Production Environment.............................................................................111
Chapter 11: Install Languages................................................................112 11.1 Install Language File......................................................................................................................112 11.2 Change Language Settings...........................................................................................................112
Chapter 12: Configure Country Specific Functionality (CSF)................114 12.1 Review CSFs in Epicor ERP 10.1.....................................................................................................114 12.2 Additional Post-Migration Steps for CSFs......................................................................................114 12.3 Install CSF Language File...............................................................................................................115
New Installation of Epicor 10.1.500
5
Contents
Epicor ERP 10.1.500 Installation Guide
Chapter 13: Install Performance and Diagnostic Tool..........................116 Chapter 14: Configure Application Request Routing...........................118 14.1 Install and Configure Application Request Routing........................................................................118 14.2 Create Certificates........................................................................................................................120 14.3 Set Up HttpsOffloadBinaryUserNameChannel Server.....................................................................121 14.4 Set Up HttpsBinaryUserNameChannel Server.................................................................................122 14.5 Configure Application Servers.......................................................................................................123 14.6 Add Certificates............................................................................................................................124 14.6.1 Add Certificate for Default Website....................................................................................124 14.6.2 Add Self-Signed Certificates (Test Environment)..................................................................124 14.7 Manage Load Balance...................................................................................................................127 14.7.1 Route Specific Calls to Server Farm.....................................................................................127 14.7.2 Test Load Balance...............................................................................................................128
Part V: Appendices.......................................................................................130 Chapter 15: Manual Installation and Conversion Issues......................130 15.1 Verify Temporary Files Do Not Exist...............................................................................................130 15.2 Manually Install Epicor Administration Console.............................................................................130 15.3 Manually Set Up Information Worker Configuration......................................................................131
Chapter 16: Implement Single Sign On..................................................133 16.1 Set Up Automatic Sign On (Epicor Account)..................................................................................133 16.2 Set Up Single Sign On (Windows Account)....................................................................................133 16.2.1 Set Up User Account..........................................................................................................134 16.2.2 Configure the Server..........................................................................................................134 16.2.3 Configure the Application Server........................................................................................135 16.2.4 Configure the Client...........................................................................................................136
Chapter 17: Changing or Uninstalling Epicor ERP 10.1 Application....137 17.1 Add or Remove Program Features.................................................................................................137 17.2 Uninstall Epicor ERP 10.1 Application............................................................................................137 17.3 Uninstall Epicor ERP 10.1 Client....................................................................................................138 17.4 Uninstall Epicor ERP Application Extensions...................................................................................138
Chapter 18: Troubleshooting..................................................................139 18.1 Review Error Message Resolutions................................................................................................139 18.2 Restore Demonstration Database..................................................................................................140 18.3 Increase Number of Threads Available to SQL Server.....................................................................141
6
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Contents
18.4 Change Free Memory Requirement...............................................................................................141 18.5 Manage LOB Data Replication.......................................................................................................142
New Installation of Epicor 10.1.500
7
Contents
8
Epicor ERP 10.1.500 Installation Guide
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Getting Started
Part I: Getting Started Welcome to the Epicor ERP 10.1 Installation Guide. This part of the guide explains how to verify the prerequisites and perform pre-installation steps prior to installing Epicor ERP 10.1.
Chapter 1: Review Epicor ERP Flows Use this chapter to review the installation and documentation flows.
New Installation of Epicor 10.1.500
9
Getting Started
Epicor ERP 10.1.500 Installation Guide
1.1 Review Installation Flow Use the following flow to review the process a new customer follows to install Epicor ERP 10.1 as the first Epicor ERP application installation.
10
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
New Installation of Epicor 10.1.500
Getting Started
11
Getting Started
Epicor ERP 10.1.500 Installation Guide
Chapter 2: Verify Prerequisites Use this chapter to verify the prerequisites prior to installing or upgrading your Epicor ERP 10.1 application.
2.1 Verify Access to EPICweb Use these steps to verify you have appropriate permissions to access the EPICweb site. 1. Verify you have Internet access at your workstation. 2. Verify you have a valid User ID and Password for Epicor's Customer Portal (EPICweb). To create an account go to: http://support.epicor.com
2.2 Review Release Documents Use these steps to download and review the release documents that are available with this Epicor ERP 10.1 version. Each document has been updated specifically for this release. 1. Log on to EPICweb and go to the customer portal website. Navigate to Products > Epicor ERP version 10 > Downloads > Epicor ERP > Version 10.1. You can use this link: https://epicweb.epicor.com/products/epicor-erp/downloads. 2. In the Available Downloads list, locate and download the following release documents. Note that the installation guide is available in three versions and you only need to download one version. Release Documentation
Description
Epicor ERP 10.1 Release Notes
Includes detailed list of changes (fixes and enhancements) sorted by functional area. Also includes any late-breaking installation updates.
Epicor ERP 10.1 Architecture Guide Includes overview topics and conceptual information regarding the Epicor ERP 10.1 architecture and framework technology strategies. Note It is highly recommended that you read this guide and understand the Epicor ERP 10.1 architecture prior to installing. Epicor ERP 10.1 Installation Guide
New customers should use this guide to install a new Epicor ERP 10.1 application for the first time. Guide includes instructions to install Epicor ERP 10.1, and then configure the database, servers, and application severs, before logging in the first time. Guide also includes steps for installing the extension applications such as Enterprise Search, Education Module, Mobile Access, Social Enterprise, Web Access, and Information Worker. The guides also include steps for installing supplemental components.
12
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Release Documentation Epicor ERP 10.1 Migration Guide
Getting Started
Description Existing customers on Epicor 9.05 should use this guide to migrate their existing Epicor 9.05 version to ERP 10.1. Migration Guides are available based on your platform type: • Migration from SQL. Existing SQL customers should use this guide to migrate from an existing Epicor 9.05.702A - SQL application to Epicor ERP 10.1. • Migration from Progress. Existing Progress customers should use this guide to migrate from an existing Epicor 9.05.702A Progress application to Epicor ERP 10.1. Guide includes instructions to backup your existing Epicor 9.05 application, install a new Epicor ERP 10.1 application, configure the database, migrate your existing database into an Epicor ERP 10.1 database, configure the servers, and then log in the first time. The guide also includes steps for installing the extension applications and supplemental components.
Epicor ERP 10.1 Release Upgrade Guide
Existing customers on Epicor ERP 10.0 or 10.1.400 should use this guide to upgrade their existing Epicor ERP 10.0 or 10.1.400 to version to ERP 10.1. 500.
3. If you previously downloaded any of the above release documents prior to following the steps in this section, you must verify that you are using the latest version of the document. To do this: a. On your release document locate the Disclaimer page, which is before the Table of Contents. b. Verify that the Revision date on that page is the same as the Revision date on the file that is currently available from the EPICweb customer portal site. c. If the Revision date is not the same, follow the above steps to download the release document from the EPICweb customer portal site.
2.3 Verify Windows Operating System Requirements Use the steps to verify your operating system requirements for installing the Epicor ERP 10.1 application. These steps must be performed on the Epicor Application Server, and not on the machine where you will be running the Epicor Administration Console. 1. For your workstation, verify you have one of the following installed: • Windows 7 (SP1) x86 / x64 • Windows 8 x86 / x64 Intel Architecture • Windows 8.1 x86 / x64 Intel Architecture • Windows 10 x86 / x64 Intel Architecture 2. For your server, verify that you have one of the following Microsoft Technology Stacks installed. Note that the stack must be the exact combination of Windows Operating System and Microsoft SQL Server. • Windows Server 2008 R2 with SQL Server 2008 R2 • Windows Server 2012 with SQL Server 2012
New Installation of Epicor 10.1.500
13
Getting Started
Epicor ERP 10.1.500 Installation Guide
• Windows Server 2012 R2 with SQL Server 2014 • Windows Server 2012 R2 with SQL Server 2016 Important For your SQL Server, Epicor supports either the runtime, Standard or Enterprise versions. The SQL Server Express editions are not supported due to constraints on the memory, CPU, and database size. Note Certifying a platform for Epicor ERP 10.1 is an involved task due to the amount of environment testing required. Therefore, not every combination of hardware, Windows operating system, and SQL Server version is formally certified to successfully run Epicor ERP 10.1. For example, Epicor ERP 10.1 is certified with SQL Server 2016 only if it is matched with Windows Server 2012 R2; but Epicor ERP 10.1 is not certified with SQL Server 2008 R2 when it is matched with Windows 2012 R2.
3. If you want to use the Epicor Administration Console to remotely administer machines, you need to enable the IIS Management Service. To do this, in the Search field, enter "Windows Features" and select the Turn Windows features on or off option to run the Windows Features program. In the Windows Features window, navigate to Internet Information Services > Web Management Tools and select the IIS Management Service check box. Click OK. Click Close. Important If you install the .NET Framework 4.6 or later before you enable IIS, you must run the ASP.NET IIS Registration tool in order to register the .NET Framework with IIS and create application pools that use the .NET Framework 4.x. The registration tool may be located in the following folder: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis -i. For more information, refer to Microsoft Development Network website.
4. For the Epicor Administration Console, verify that port 8172 is open in the firewall. To do this, if you are using the built-in Windows firewall, navigate to Start > Control Panel > Administrative Tools > Windows Firewall with Advanced Security. 5. For the Epicor Administration Console, verify that in the Windows Firewall, the inbound rule "Web Management Server (HTTP Traffic-In)" is enabled. To do this, open your Windows Firewall. Locate the inbound rule named "Web Management Service (HTTP Traffic-in)". Right-click on the rule and select Properties. Enter the following: a. In the General tab, select Allow the connection in the Action group box. b. In the Advanced tab, in the profiles section, clear the Public check box. This option should not be selected. c. Keep the Domain and the Private options enabled. Note The inbound rule "Web Management Server (HTTP Traffic-In)" should be enabled, if it exists. If that rule is not present, then create your own inbound rule that opens port 8172 for TCP traffic.
6. With Windows Server, a firewall is installed. The firewall must be disabled in order for connectivity from other machines to allow for administering of the Epicor ERP 10.1 Application Servers. Based on your company practices, you can enable your firewall after the installation process is complete. 7. It is recommended that Windows Updates are not set to install automatically on your production server. Based on your company practices, your system administrator should review the Windows Updates and install when necessary.
14
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Getting Started
2.4 Verify SQL Server Install and Features Use these steps to verify that a supported version of Microsoft SQL Server is installed on your database server and that the required Full-Text Search feature is installed on your SQL Server instance. Note It is recommended that you review the SQL Books Online information in order to become familiar with the SQL Server administration functionality. The documentation is typically installed with the SQL Server application. To access it, navigate to Start > All Programs > Microsoft SQL Server > Documentation and Tutorials > SQL Server Books Online. 1. On your database server, verify that one of the following Microsoft Technology Stacks is installed. Note the stack must be the exact combination of Windows Operating System and Microsoft SQL Server. • Windows Server 2008 R2 with SQL Server 2008 R2 • Windows Server 2012 with SQL Server 2012 • Windows Server 2012 R2 with SQL Server 2014 • Windows Server 2012 R2 with SQL Server 2016 Important If necessary, install SQL Server on your database server using the instructions that came with your SQL installation. Be sure to install any Microsoft service pack and patch updates related to your SQL version. For your SQL Server, Epicor supports either the runtime, Standard or Enterprise versions. The SQL Server Express editions are not supported due to constraints on the memory, CPU, and database size. Note Certifying a platform for Epicor ERP 10.1 is an involved task due to the amount of environment testing required. Therefore, not every combination of hardware, Windows operating system, and SQL Server version is formally certified to successfully run Epicor ERP 10.1. For example, Epicor ERP 10.1 is certified with SQL Server 2016 only if it is matched with Windows Server 2012 R2; but Epicor ERP 10.1 is not certified with SQL Server 2008 R2 when it is matched with Windows 2012 R2.
2. If your SQL Server is hosted on a different machine than the Epicor ERP 10.1 Application Server, verify that network connectivity exists between the servers. To do this, complete these steps on the two machines: a. For the Application Server, do the following: • Add a domain account with Administrator permissions. • Log into the Application Server using the domain account with Administrator permissions. b. For the SQL Server, do the following: • Add the domain account login (with Administrator permissions) to the Administrators group. • Verify the SQL Server service properties specifies "Log On As" that specific domain account. • In SQL Server Management Studio, create the domain account as a SQL login account with sysadmin rights.
3. Verify that the Full-Text Search feature is installed on your SQL Server instance. Full-Text Search is required in order to create databases using the Epicor ERP 10 application. To verify if the feature is installed: a. Open SQL Server Management Studio. Right-click on your server/instance and select New Query. Enter the following query: SELECT fulltextserviceproperty('IsFulltextInstalled')
New Installation of Epicor 10.1.500
15
Getting Started
Epicor ERP 10.1.500 Installation Guide
IF (1 = FULLTEXTSERVICEPROPERTY('IsFullTextInstalled')) print 'INSTALLED' else print 'NOT INSTALLED' b. Click Execute. If the query returns 1 or INSTALLED it means that Full-Text Search is installed. Your query results may look similar to the following:
c. If the query returns 0 or NOT INSTALLED, you must install the Full-Text Search component. To do this: • Select Start > Control Panel > Programs and Features. In the list of programs, right-click MS SQL Server installation and select Uninstall/Change. Click Add. • Use you MS SQL Server installation media to run SQL setup wizard. • In the Installation Type window, select the option to Add features to an existing instance of SQL Server and specify the SQL Server instance you want to modify. • In the Feature Selection window, select the Full-Text Search check box. Click Next several times, then click Complete to finish the component installation. Note As an alternate method to verify if the Full-Text Search feature is enabled on your SQL Server, you can review the list of services. To do this, on your SQL Server select Start > Control Panel > Administrative Tools > Services. Verify that SQL Full-text Filter Daemon Launcher (SQL Server Instance Name) service is listed, for example (MSSQLSERVER). Note that if your SQL Server has multiple instances, you must verify that the service is available for the specific SQL Server instance.
4. If you are using Enterprise Search, verify the following SQL Server requirements: a. Verify that one of the following SQL Server versions is installed and running locally: • SQL Server 2008, SQL Server 2008 R2, or SQL Server 2008 Express • SQL Server 2012 • SQL Server 2014 • SQL Server 2016 b. Verify that the SQL Server installation has SQL and Windows Authentication enabled. c. Verify that the server where Enterprise Search is installed also has SQL Server installed as the named or primary instance. For example, if your server is named Candy, then SQL Server must be made available as Candy, and not as a sub or separate installation. Note that the Epicor application SQL database can be located on a remote server. d. Verify that the account you use to log into the system is trusted by the SQL Server.
16
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Getting Started
e. Starting with SQL Server 2012, the default System account used by many Windows Services is no longer granted Administration Rights in SQL Server. If you configured your Enterprise Search Database connectivity with Windows Authentication, and you use SQL Server 2012, 2014 or 2016, you must use the following steps to verify that the account you select for the Service account has the necessary System Admin rights to access to create and manage a new database on your SQL Server instance. • Open SQL Server Management Studio and connect to your database. • Expand Security > Logins. Right-click on NT AUTHORITY\SYSTEM and select Properties. • In the Login Properties dialog, select Server Roles. In the server roles list, verify that sysadmin is selected. Click OK. • Close SQL Server Management Studio.
2.5 Configure Server Roles (Windows Server 2012 and 2008/R2) Use these steps to configure the required Server Roles, including both the Application Server and Web Server. If the roles already exist, you can still review the list of role features to verify that your roles are configured properly. Note If you do not configure the server roles, you may be prompted with the error "Assembly binding warning is turned OFF" when you are attempting to add an Epicor application server. To resolve the error, follow the steps in this section to configure your server roles. Note Note that the steps are different based on your operating system. For more information on roles, role services, and features on Windows Server 2012 and 2012 R2, use the following link: https://technet.microsoft.com/en-us/library/hh831809.aspx For more information on roles and features on Windows Server 2008, use the following link: https://tech net.microsoft.com/en-us/library/cc732263.aspx#BKMK_add 1. On the server, open Server Manager. From the Manage menu, select Add Roles and Features. Your dialog may look similar to the following:
2. The Add Roles and Features Wizard appears. In the Before You Begin section, review the information and click Next.
New Installation of Epicor 10.1.500
17
Getting Started
Epicor ERP 10.1.500 Installation Guide
3. In the Installation Type section, keep the default Role-Based or Feature-Based Installation option selected. Click Next. 4. In the Server Selection section, verify your server is selected in the Server Pool list. Click Next. 5. In the Server Roles section, select the following roles and then click Next. • Application Server • Web Server (IIS) Note If you selected to install a role, a confirmation window appears. Click Add Features to confirm the installation.
6. Verify that you selected the following Role Services to be installed for the Application Server role and the Web Server role: In the Application Server section:
In the Web Server Role (IIS) > Web Server section:
• COM+ Network Access
• Common HTTP Features:
• Distributed Transactions:
• Default Document
• Incoming Network Transactions
• Directory Browsing
• Outgoing Network Transactions
• HTTP Errors
• TCP Port Sharing • Web Server (IIS) Support and its features
• Static Content • HTTP Redirection (If you are installing Epicor Social Enterprise)
• Windows Process Activation Service Support: • HTTP Activation (not required for Windows Server 2008)
18
• Health and Diagnostics: • HTTP Logging
• Message Queuing Activation
• Tracing
• Named Pipes Activation
• Request Monitor (If you are installing ESE)
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
In the Application Server section: • TCP Activation
Getting Started
In the Web Server Role (IIS) > Web Server section: • Performance: • Static Content Compression • Security: • Request Filtering • Windows Authentication • Application Development: • .NET Extensibility 4.6.1 • ASP.NET 4.6.1 • ISAPI Extensions • ISAPI Filters • Server Side Includes (If you are installing ESE) • Management Tools (If you are installing Epicor Mobile Access): • IIS 6 Management Compatibility > IIS 6 Metabase Compatibility
7. In the Features section, select the following options and then click Next. • .NET Framework 4.6.1 • Windows Search Service (If you are installing Epicor ERP Online Help System). 8. In the Add Roles and Features Wizard, confirm installation of the selected services. Click Next. 9. In the Confirmation section, click Install. The server roles and features are installed. 10. Close the Server Manager.
2.6 Configure Server Roles (Windows Server 2016) Use these steps to configure the required Server Roles, including the File and Storage Services, and the Web Server (IIS). If the roles already exist, you can still review the list of role features to verify that your roles are configured properly. Note If you do not configure the server roles, you may be prompted with the error "Assembly binding warning is turned OFF" when you are attempting to add an Epicor application server. To resolve the error, follow the steps in this section to configure your server roles. Note Note that the steps are different based on your operating system. For more information on roles, role services, and features on Windows Server 2016 use the following link: http s://technet.microsoft.com/en-us/windows-server-docs/management/server-manager/install-or-uninstall-roles-role -services-or-features
New Installation of Epicor 10.1.500
19
Getting Started
Epicor ERP 10.1.500 Installation Guide
1. On the server, open Server Manager. From the Manage menu, select Add Roles and Features. Your dialog may look similar to the following:
2. The Add Roles and Features Wizard appears. In the Before You Begin section, review the information and click Next. 3. In the Installation Type section, keep the default Role-Based or Feature-Based Installation option selected. Click Next. 4. In the Server Selection section, verify your server is selected in the Server Pool list. Click Next. 5. In the Server Roles section, select the following roles and then click Next. • File and Storage Services • Web Server (IIS) Note If you selected to install a role, a confirmation window appears. Click Add Features to confirm the installation.
6. Verify that you selected the following Role Services to be installed for the File and Storage Services role: In the File and Storage Services section • File and iSCI Services > File Server • Storage Services
7. Verify that you selected the following Role Services to be installed for the Web Server (IIS) role: In the Web Server section:
In the Management Tools section:
• Common HTTP Features:
• IIS Management Console (If you are installing Epicor Mobile Access)
• Default Document
20
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
In the Web Server section: • Directory Browsing • HTTP Errors • Static Content
Getting Started
In the Management Tools section: • IIS 6 Management Compatibility (If you are installing Epicor Mobile Access) • > IIS 6 Metabase Compatibility
• HTTP Redirection (If you are installing Epicor Social Enterprise) • Health and Diagnostics: • HTTP Logging • Tracing • Request Monitor (If you are installing ESE) • Performance: • Static Content Compression • Security: • Request Filtering • Windows Authentication • Application Development: • .NET Extensibility 4.6 • ASP.NET 4.6 • ISAPI Extensions • ISAPI Filters • Server Side Includes (If you are installing ESE)
8. In the Features section, select the following options and then click Next. In the Features section • .NET Framework 4.6 Features • .NET Framework 4.6 • ASP.NET 4.6 • WCF Services (all) • Message Queuing • Message Queuing Services > Message Queuing Server • SMB 1.0/CIFS File Sharing Support • Windows Defender Features (all) • Windows Powershell • Windows Powershell 5.1 • Windows Powershell 2.0
New Installation of Epicor 10.1.500
21
Getting Started
Epicor ERP 10.1.500 Installation Guide
In the Features section • Windows Powershell ISE • Windows Process Activation Service (all) • Windows Search Service (If you are installing Epicor ERP Online Help System). • WoW64 Support
9. In the Add Roles and Features Wizard, confirm installation of the selected services. Click Next. 10. In the Confirmation section, click Install. The server roles and features are installed. 11. Close the Server Manager. 12. If you have selected to install the Windows Search Service feature, you must now set it to be automatic. To do this: a. Click Start > Run > services.msc. b. In the Services dialog, scroll to Windows Search. Double-click the item to open it. c. In the Windows Search Properties dialog, for the Startup Type, click the drop-down arrow and select Automatic. d. Click OK. e. Close the Windows Search dialog.
2.7 Verify SQL Server Reporting Services (SSRS) Prerequisites Use these steps to verify that you have the required components and features installed and configured properly for using SQL Server Reporting Services (SSRS). With Epicor ERP 10.1, you use SSRS for reporting functionality. 1. Verify that you are using SQL Server 2008 R2, SQL Server 2012, SQL Server 2014, or SQL Server 2016. 2. If you are using a SQL Server version prior to SQL Server 2014, in order to print reports using SSRS, you must download and install a Microsoft SQL Server update package from the Microsoft Support site. It is a known Microsoft issue that installing the update is required for the rendering of PDF reports to be successful. For more information, refer to this Microsoft Support page: http://support.microsoft.com/kb/26 45648. 3. Verify that IIS is installed on the server where Epicor SQL Server Reporting will be installed. 4. Verify that .NET Framework 4.6.1 or later is installed on the server where Epicor SQL Server Reporting will be installed. 5. Verify your Reporting Services configuration values using the Reporting Services Configuration Manager. To do this: a. Navigate to Start > All Programs > Microsoft SQL Server 20xx > Configurator Tools > Reporting Services Configuration Manager. b. Click Connect to connect to the report server/instance.
22
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Getting Started
c. In Current Report Server information displayed, verify that Report Server Mode is Native. Note For more information on installing Reporting Services Native Mode Report Server, review the Microsoft SQL Server Documentation Online. You can use this link: http://technet.microsoft.c om/en-us/library/ms143711.aspx d. Verify that Report Server Status is Started. e. On the left navigation pane, select Report Manager URL. In the Report Manager Site Identification section that displays, do the following: • In the URLs field, click the URL to verify that it is valid. Your browser should open the SQL Server Reporting Services home page. • Open a text editor, such as Notepad, and enter the URL exactly as it is displayed in the URLs field. For example, your URL may look similar to: http://ServerName:xx/Reports. Save the notepad file. Note that you will need to enter this URL later when you are adding an Epicor Application Server and configuring SSRS on the SSRS Configuration > SSRS Base URL field. f. Click Exit to close the Reporting Services Configuration Manager. 6. The RsReportServer.Config file defines the settings used by the Report Server Web Service, the Report Manager, and any report processes that run in the background. If you are encountering issues with SSRS reports timing out, you can adjust settings in this file to accommodate larger reports. a. On your server, navigate to C:\Program Files\Microsoft SQL Server\\Reporting Services\ReportServer\ and locate the rsreportserver.config file. You can modify the following settings in the file: • The CleanupCycleMinutes setting specifies how many minutes report sessions and report snapshots can exist before they are deleted from the report server database. You may want to increase this value, because it determines how long an intensive operation can run from SSRS. • The DatabaseQueryTimeout setting defines how many seconds can pass before a connection to the report server database times out. You may need to increase this value to handle larger database queries. The following table displays the recommended adjusted timeout values for these settings: Setting
Setting Attribute
Default Timeout
Adjusted Timeout
Value
180 (Minutes)
1440 (24 Hours)
Value
120 (Seconds)
300 (Seconds)
2.8 Set Up Test Environment Use this information to set up a test environment and test your system. It is strongly recommended that you set up a separate test environment prior to installing a new Epicor ERP 10.1 application or upgrading from an existing Epicor version. You can use this test environment to test the new application or to test your current system files, such as custom tools. Custom tools such as personalizations, customizations, global alerts, Business Activity Queries (BAQs), and Business Process Management (BPM) methods
New Installation of Epicor 10.1.500
23
Getting Started
Epicor ERP 10.1.500 Installation Guide
need to be tested and maintained prior to upgrading. By using a separate testing environment, you will know what changes you have to make to your live system after the upgrade, which helps ensure a successful upgrade. Note that while it is possible to install multiple versions of the Epicor application on the same server for testing purposes, it is not recommended. Important Do not upgrade to Epicor ERP 10.1 without first testing the installation in a separate test environment.
24
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
Part II: Installation and Configuration This part of the guide explains how to install and configure your Epicor ERP 10 application.
Chapter 3: Install the Epicor ERP 10.1 Application Use this chapter to install your Epicor ERP 10.1 application. Note The installation process creates the application directory on your server, so you only need to install once. You must install the application on the server before you install the client on any workstations. Note Do not reference mapped drive letters in these instructions. Only use physical drive letters or UNC paths. If you use mapped drive letters, the server installation will not work. For example, these instructions use C:\ drive but you can use any physical drive of your choice.
3.1 Prepare SQL Server Login Account Use these steps to setup the SQL Server login account. Prior to installing Epicor ERP, you must determine how you access the Epicor ERP SQL Server database, either SQL Server Authentication or Windows Authentication. Note that both methods allow access to the Epicor ERP database using a single SQL Server login account. Note After you have added your Epicor database, you will use the "Configure Epicor ERP SQL Server Login Account" steps to configure security options for the SQL Server login account that you create. Note If you choose SQL Server Authentication, within SQL you will need to grant the user account specified in the Application Pool Username field during creation of the Application Server (on the Application Server Settings tab of the Application Server - Create Site dialog) at least Datareader and Datawriter permissions to the Reporting database. If possible, it is recommended that Windows Authentication is used with a dedicated domain user account in the Application Pool Username and that dedicated account has DBO permissions to the Epicor transactional and Reporting databases. 1. Determine your authentication method for accessing the Epicor SQL Server database, either using SQL Server Authentication or Windows Authentication. If you need additional information to make your decision, refer to the "Authentication Options" information in the Epicor Architecture Guide. 2. Use SQL Server Management Studio to connect to the SQL Server instance where you will be installing the Epicor ERP database. 3. Under the Security folder, right-click the Logins folder and select New Login.
New Installation of Epicor 10.1.500
25
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
4. Based on whether you decided to use SQL Server Authentication or Windows Authentication, do one of the following: • SQL Server Authentication. Select SQL Server authentication. For Login Name, enter an appropriate login name. For example, EpicorERP. Enter a Password and confirm the password. Click OK. • Windows Authentication. Keep Windows authentication selected. For Login Name, click Search to select the Windows domain account to use for Epicor ERP access. If desired, create a Windows account just for Epicor ERP access. Click OK after you have selected the Windows account. 5. Click OK to close the dialog.
3.2 Install Epicor ERP 10.1 Server Use these steps to install or upgrade your Epicor ERP 10.1 server framework. During the installation you are prompted to select the Epicor ERP 10.1 program features that you want installed to the server. To perform these steps, you must be logged in as a user with Administrator rights. Note that as of Epicor ERP 10.1, the release file is delivered as a compressed ZIP file that contains an ISO image file that must be mounted to open it. 1. On the server where you intend to install Epicor ERP 10.1, verify you have at least 25 GB space in order to install the Epicor ERP application, extension applications, demonstration database, and one application server. 2. Verify you have virtual DVD drive functionality on your server. Based on your operating system, do one of the following: • Windows Server 2012 or 2012 R2. Virtual DVD drive functionality is already included in your operating system. You do not need to install additional software. • Windows Server 2008 R2. Download and install virtual DVD drive software that will be used to mount the ISO file. For example, you can download and install Virtual CloneDrive (Freeware) from SlySoft from this link: http://www.slysoft.com/en/download.html. In the Download section, select Virtual CloneDrive (Freeware). When prompted, select to Save the file to your local. Run the file and follow the install instructions. 3. Locate your Epicor ERP 10.1 release. It is available as a download from EPICweb or as a DVD. Use one of the following methods to access the release: • EPICweb Downloads. The Epicor ERP version 10.1 release is available from EPICweb Downloads if you have completed the Release Approval process. For more information on the Release Approval process, contact your Customer Account Manager. To access the download, log on to EPICweb Customer portal website. Navigate to Products > Epicor ERP > Downloads > Epicor ERP > Releases. You can use this link: https://epicweb.epicor.com/products/epicor-erp/downloads. • DVD. Locate your Epicor ERP version 10.1 DVD. Insert the DVD into your drive. 4. Locate the release file related to this installation. For example RL10.1.xxx.zip. Download the file to your local machine. For verification purposes, you will be prompted to re-enter your EPICweb credentials when you attempt to download the Epicor ERP version 10.1 file from EPICweb Downloads. 5. Extract the file. If prompted for a password, enter the password provided by the Epicor Product Group. Click OK. 6. Right-click on the extracted RL10.1.xxx.x.iso file and select Mount or Mount (Virtual CloneDrive). The Epicor ERP 10.1 installer is now available as an EXE file located in a virtual DVD drive.
26
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
7. Navigate to the mounted (virtual DVD) drive. Right-click on the *.exe file and select Run as administrator. The install wizard verifies that the install executable is compatible with your environment and then prepares for your installation. This verification may take several minutes. 8. The Welcome window appears for installing the Epicor ERP 10.1 server software. Click Next. 9. The Select Components window appears. Select the program features you want to install, such as the Application Server and Supplemental (Extension) Installs. In the Install Epicor ERP 10.1 to field accept the default location of C:\Epicor\ERP10 or click Change to browse and select a different location. Your dialog may look similar to the following:
Note If you want to install certain components later, you will need to re-run the Epicor installer.
10. After selecting the components to install and specifying the installation location, click Next.
New Installation of Epicor 10.1.500
27
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
11. The Completing the Epicor Install window appears. To begin the configuration of Epicor ERP 10.1, click Next. The installation begins. The process may take several minutes. Your dialog may look similar to the following:
12. After the Epicor ERP 10.1 Server is installed, the following installations are processed: • Expanding Epicor ERP 10.1 Client Installer • Expanding Epicor ERP 10.1 Administration Console Installer • Expanding Epicor ERP 10.1 Education Courses • Expanding Epicor ERP 10.1 Reporting Services • Expanding Epicor ERP 10.1 Supplemental (Extension) Installs (Mobile Access, Information Worker, Social Enterprise, Enterprise Search, Web Access, and Task Agent) • Installing Administration Console 13. The Install Complete window appears when the installation is complete. Based on the availability of an Update release, do one of the following: • If an Update release (10.1.500.x) is available, clear the Launch the Epicor Administration Console check box. You will need to install the Update release prior to launching the Epicor Administration Console. • If an Update release (10.1.500.x) is not available, keep the Launch the Epicor Administration Console check box selected. You will now use the instructions in the following sections to complete the configuration using the Epicor Administration Console.
28
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
Your dialog may look similar to the following:
14. Click Finish. Your Epicor ERP 10.1 server framework is installed. 15. If you want to verify that your installation completed successfully, navigate to the folder where you installed your Epicor ERP 10.1 application. For example, the default is C:\Epicor\ERP10 followed by the release version as a subfolder. Your folder structure may look similar to the following:
16. You can now unmount the DVD drive. To do this, in the left tree view, do one of the following based on your operating system: • Windows Server 2012 or 2012 R2. Right-click on the DVD drive and select Eject.
New Installation of Epicor 10.1.500
29
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
• Windows Server 2008 R2. Right-click on the DVD drive and select VCD (...) > Unmount.
3.3 Install Epicor ERP 10.1.500.x Latest Update Use these steps to install the latest Epicor ERP 10.1 Update to your Epicor ERP 10.1 application, if an update is available. Updates are identified by the sequential number added to the end of the release number, for example 10.1.500.x. 1. Verify your environment is ready to start the installation. To do this: • Verify the Epicor Administration Console is closed. • Verify that there are no active Epicor Administration Console sessions on the server. • Verify all users are logged off the Epicor ERP application. • Verify you have at least free 20 GB disk space available. 2. Log on to EPICweb Customer portal website to locate the latest Epicor ERP 10.1 update. Navigate to Products > Epicor ERP > Downloads > Epicor ERP > Version 10.1.500. You can use this link: https://epicweb.epi cor.com/products/epicor-erp/downloads. 3. Locate the latest release file related to this installation. For example UD10.1.xxx.x.zip. Download the file to your local machine. Go to the directory where you downloaded the file. Extract the file. 4. Right-click on the extracted UD10.1.xxx.x.exe file and select Run as administrator. The install wizard verifies that the install executable is compatible with your environment and then prepares for your installation. This verification may take several minutes. 5. The Welcome window appears for installing the Epicor ERP 10.1 Update. Click Next. 6. The Select Components window appears. Review the list of components that were installed with your base Epicor ERP 10.1 installation. Click Next. 7. The Completing Epicor ERP 10 Update dialog appears. To begin the install of the update, click Next. The install begins and status bars display the processing. The process may take a period of time. 8. The Epicor ERP 10.1 Update Complete window appears when the installation is complete. Keep the Launch the Epicor Administration Console check box selected to launch the console. Click Finish. Your Epicor ERP 10.1 update is installed. You will now use the instructions in the following sections to complete the configuration using the Epicor Administration Console.
30
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
Chapter 4: Configure Epicor Database Use this chapter to add an Epicor Database Server and Epicor database (new or demonstration) using the Epicor Administration Console. Note that your Epicor Database Server must be added prior to adding a new Epicor database.
4.1 Add Epicor Database Server Use these steps to add an Epicor Database Server. The Epicor Database Server must be added prior to adding an Epicor database. 1. On the server where your Epicor application is installed, open the Epicor Administration Console, if it is not already opened. On the server where your Epicor application is installed, navigate to Start > All Programs > Epicor Software > Epicor Administrative Tools > Epicor Administration Console. 2. In the left-hand Tree View, select the Database Server Management node. Your dialog may look similar to the following:
3. Right-click on the Database Server Management node and select Add Epicor Database Server. Your dialog may look similar to the following:
New Installation of Epicor 10.1.500
31
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
4. In the Server\Instance field, enter the SQL Server name and the SQL Instance ID. For example, enter your local server or the network server to which you will be connecting. 5. Select the Authentication mode to connect to the SQL Server. For example, select Windows Authentication or SQL Authentication. If you select SQL Authentication you must also enter your SQL User ID and Password. Note The SQL User ID and Password you specify will be passed to the configuration when you add a new Epicor database.
6. Click the Verify Server button to verify that your server name and connection details are valid. Click OK to the message. Click OK again. 7. After the server is added, the server/instance is displayed as a node under Database Server Management in the Tree View. Your dialog may look similar to the following:
After the Epicor Database Server is added, you are now ready to add your Epicor database. For example, you can add a new database (for production) or add the demo database (for training).
4.2 Add Epicor Database Use these steps to add an Epicor database (new or demonstration) using the Epicor Administration Console. When this database is created it is empty and scripts are run to populate it with initial data, including tables and fields for menus, security and reports. 1. Prior to adding a database, verify that the Full-Text Search feature is installed on your SQL Server instance. Full-Text Search is required in order to create databases using the Epicor ERP 10.1 application. Refer to the previous steps in the Getting Started > Verify Prerequisites > Verify SQL Server Install and Features section. 2. Open your Epicor Administration Console, if it is not already open. On the server where your Epicor application is installed, navigate to Start > All Programs > Epicor Software > Epicor Administrative Tools > Epicor Administration Console. 3. Expand Database Server Management. Right-click on your Server/Instance and select one of the options to add an Epicor database: • Add New Database - Use this option to launch the Database Migration tool to add a new database. The new database contains seed data only.
32
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
• Add Demo Database - Use this option to launch the Database Migration tool to add a new Demonstration Database which is used for educational purposes along with the Epicor Education Module. 4. For either a New or Demo database, the Add New Database dialog opens. Your dialog may look similar to the following:
Enter the following: a. Enter a Name for your database. Note Your database name cannot include a space. After the database is created you cannot change the database name. If the database name already exists on the server, you will be prompted to confirm the name when the database creation process starts. b. Enter the Deployment Server path to specify the deployment share location. This path is used by the Epicor Administration Console to verify that it has the required components to service the database. These components can then be downloaded from this location. • If you are on the deployment server, enter a fully qualified path such as C:\Epicor\ERP10\ERP10.1.xxx. c. Click OK.
New Installation of Epicor 10.1.500
33
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
5. The Create Database on Server dialog displays. If the database creation process does not start by default, click the Start button. A status bar displays the creation process. This may take a few minutes. Your dialog may look similar to the following:
6. If you selected Add New Database, the database is ready to be created using the default values. If you want to change the default values and configure the database properties before it is created, on the Create Database on Server dialog, from the Action menu , select Configuration. The Configuration dialog opens. Your dialog may look similar to the following:
7. If you want to use your default configuration settings, select the Use Existing Database check box. The MDF and LDF sections become read-only. 8. For the Target database, verify the Master Database File (MDF) Information. Note that for more information on MDF settings, refer to your Microsoft SQL Server user guides and online help. a. In the MDF Location field, verify the default path to the master database file. b. Review the Initial MDF File Size in GB value. Epicor recommends to set this value close to the size of the future master database file. c. Keep the Autogrowth check box selected if you want the file to increase automatically when new data is added. In the Autogrowth settings section, use the MDF File Growth fields to specify the file growth rate. Select the Restricted File Size Growth option and set the maximum size for the MDF file if you want to limit this value, or keep the Unrestricted File Size Growth option selected. If you use MDF
34
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
autogrowth and do not restrict the file size, the MDF file should be regularly monitored and managed by a database administrator. 9. For the Target database, verify the Log Database File (LDF) Information. Note that for more information on LDF settings, refer to your Microsoft SQL Server user guides and online help. a. In the LDF Location field, verify the path to the log database file. b. Specify the Initial LDF File Size in GB value. Epicor recommends to set this value close to the size of the future log database file. c. Keep the Autogrowth check box selected if you want the file to increase automatically when new data is added. Define Autogrowth settings. Use the LDF File Growth fields to specify the file growth rate. Select the Restricted File Size Growth option and set the maximum size for the LDF file if you want to limit this value, or keep the Unrestricted File Size Growth option selected. If you use LDF autogrowth and do not restrict the file size, the LDF file should be regularly monitored and managed by a database administrator. 10. Click Test Connection to verify. Click OK to the validation message. 11. Click OK to save the configuration values. The Configuration dialog closes. 12. Back on the Create Database on Server dialog, click Start. The processing begins. This may take a bit of time. If you want to view the processing messages, click the Show More button. If you want to hide the processing messages, click the Show Less button. Your dialog may look similar to the following:
Note If the database name already exists, you are prompted with a message to enter a password to confirm that the existing database should be deleted in order for the new database to be created. Enter the password specified in the message and click OK to confirm.
13. During the creation of the database, progress is displayed using green check marks next to the task. Note that if a task is not successful, a red X is displayed. After the database is created a green check mark is
New Installation of Epicor 10.1.500
35
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
displayed next to each task. Verify that your tasks have all completed. Your dialog may look similar to the following:
14. After completion, click the Show Log button to display the DB Migration log. Review the information. Your dialog may look similar to the following:
15. Click Close to close the log file. 16. Click Close to close the Create Database on Server dialog. 17. Verify that your new database displays under your Server in the tree node. Your dialog may look similar to the following:
Your new database has been successfully added.
36
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
18. If you selected the option to Add Demo Database for educational use with the Epicor Education Module, it is recommended that you create a back-up of this demonstration database. For example, create a backup and name it DEMO_ERP10. When you need to refresh (restore) the demonstration database, this backup database can be restored to the named demonstration database. Refer to the Appendices > Troubleshooting > Restore Demonstration Database section for more information.
4.3 Configure Epicor ERP SQL Server Login Account Use these steps to allow the Epicor ERP SQL Server login account to access the Epicor ERP database. During these steps, you will select the SQL Server login account that you created in a previous section called "Install the Epicor ERP 10 Application > Prepare SQL Server Login Account". 1. Use SQL Server Management Studio to connect to the SQL Server instance that now hosts the Epicor ERP database. 2. Navigate to Security > Logins. 3. Double-click the SQL Server login you previously created to access the Epicor ERP database. For example, EpicorERP. 4. In the left pane, click User Mapping. 5. In the Map column, select the check box next to the EpicorERP database. 6. In the database role memberships list, in addition to public (which is selected), select the db_owner check box. Important After the install is complete, you can change the security settings for this SQL Login account. For example, if you do not want the login user to have db_owner access, you can remove the ability by clearing (unselecting) that check box in the list of database role memberships. Note that if the db_owner access is removed, verify that both db_reader and db_writer access are granted.
7. Click OK.
New Installation of Epicor 10.1.500
37
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
Chapter 5: Configure Epicor Server and Application Server Use this chapter to add an Epicor Server and Epicor Application Server using the Epicor Administration Console.
5.1 Determine Authentication Option (Endpoint Binding) Use these steps to determine the authentication option (endpoint binding) you will select when you are adding your Epicor Application Server. The Epicor Application Server secures communication and authenticates users using different endpoint binding methods. 1. Locate the Epicor ERP 10 Architecture Guide. It is located on the EPICweb Customer portal under Products > Epicor ERP version 10 > Documentation. 2. In the Technology Strategies section, review the "Authentication Options" information. Options include: • UsernameWindowsChannel • UsernameSSLChannel • Windows • HttpBinaryUsernameSslChannel • HttpsBinaryUsernameChannel • HttpsBinaryWindowsChannel • HttpsOffloadbinaryUserNameChannel 3. Determine your authentication option based on your company's best practice method for security. Note If you select to use the UserNameSSLChannel and HttpBinaryUsernameSslChannel endpoint binding, you must use the steps in the next section to generate an SSL security certificate.
5.1.1 Generate Self-Signed SSL Security Certificate (If Using UserNameSSLChannel and HttpBinaryUsernameSslChannel) Use these steps to generate a Self-Signed SSL security certificate, if you have determined that you are going to use the UserNameSSLChannel or HttpBinaryUsernameSslChannel endpoint binding. If you have determined that you are going to use the UserNameSSLChannel or HttpBinaryUsernameSslChannel endpoint binding, you will need a SSL security certificate. You can use these steps as an example of how to generate a self-signed SSL Security Certificate. Review the Epicor ERP 10 Architecture Guide for information on using authentication options and security certificates, if needed. Note that you must complete these steps prior to adding an Epicor Application Server. 1. Create a Self-Signed SSL Security Certificate: a. Navigate to Start > Administrative Tools > Internet Information Services (IIS) Manager. Select your server name. b. Double-click the Server Certificates icon in the IIS section of the middle pane. c. In the Actions menu, click Create Self-Signed Certificate.
38
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
d. Enter a name for the new certificate, for example, enter the fully qualified domain name. Select Personal certificate store from the drop-down list and click OK. The certificate displays in the Server Certificates list. 2. Modify the certificate security properties: a. Navigate to the MachineKeys folder. By default the path is C:\ProgramData\Microsoft\Crypto\RSA\MachineKeys. b. In the MachineKeys folder, right-click the file with the latest Date modified and select Properties. c. In the Properties window, click the Security tab. Click the Edit button. d. In the Permissions for window, click the Add button. e. In the Enter the object names to select field, enter Everyone. Click OK. f. Click Everyone in the Group or user names list. In the Permissions for Everyone pane, select the Allow check box against the Full control permission. Click OK. g. Click OK in the Properties window and exit the MachineKeys folder. 3. Add the HTTPS protocol to the Self-Signed SSL Security Certificate: a. In IIS Manager tree view, expand the Sites node and select Default Web Site. b. In the Actions pane, click Bindings. c. In the Site Bindings dialog, click Add. d. Set Type value to HTTPS. The Port value defaults to 443. e. Click the Select button next to the SSL certificate field and select the certificate you have just created. Click OK. f. Click OK in the Add Site Binding window.
5.2 Add Epicor Server Use these steps to add your Epicor Server using the Epicor Administration Console. You must add the Epicor Server prior to adding the Epicor Application Server. 1. On the server where your Epicor application is installed, open the Epicor Administration Console.
New Installation of Epicor 10.1.500
39
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
2. In the left-hand Tree View, select the Server Management node. Right-click and select Add Epicor Server. Your dialog may look similar to the following:
3. The server Name defaults for you using its fully qualified domain name. Click Ping Server to verify the server name. A message displays that it is successful. Click OK. 4. Verify that your Epicor Server is added under the Server Management node. You can now add an Epicor Application Server to this Epicor Server.
5.3 Add Epicor Application Server (New or Upgrading from 10.0) Use these steps to add your Epicor Application Server using the Epicor Administration Console. Note that prior to adding an Epicor Application Server, you must add your Epicor Server. Note Use these steps if you are installing your Epicor ERP 10.1 application for the first time, or you are upgrading from a previous installation of Epicor ERP 10.0 (600 or 700). If you are upgrading from a previous installation of Epicor ERP 10.1.400 you use the "Upgrade Epicor Application Server" steps instead. 1. In the Epicor Administration Console tree view, expand the Server Management node. Verify that the Epicor server that will host the new application server is listed. Your dialog may look similar to the following:
40
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
2. Right-click on the Epicor server and select Add Application Server. If prompted to select a Snap-In Version, select the version of the application server you want to add and click OK. The Application Server - Create Site dialog opens. Your dialog may look similar to the following:
3. On the Application Server Settings tab, define the following: a. Review or enter the Application Name to identify the name that Internet Information Services (IIS) uses to create the application. This value is also added to the URL address which the client installation uses to connect to the application server. For example, the name ERP101500 means the application server URL will be net.tcp:///ERP101500. You can directly enter the name or click the Browse (...) button to find and select it. Note Several fields default based on the Application Name: Web Site Directory and Application Pool Name on this same tab, and Display Name on the Admin Console Settings tab. This feature prevents a site that already exists from being overwritten by the name change. b. Review or enter the Deployment Directory that contains the Epicor server installation. For example: \\EpicorServer\Epicor\ERP10\ERP10.1.500.0. You must be a member of the Administrators group on the server specified.
New Installation of Epicor 10.1.500
41
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
c. If available, use the Deployment Version drop-down to select your update version from the list of updates that are available on your server. If a release update is not available, select Base. If a release update is available, it is recommended that you select the update release. For example, select 10.1.500.x. Important If a release update is available, you would have installed it using the previous steps in the Install Epicor ERP 10 Update (10.1.500.x) section. It is recommended that you select that update version to update your Epicor ERP version to the latest version, for example 10.1.500.x. Note that when you click OK, the application server updates the Epicor ERP 10.1 application to the selected version. If prompted that all users will be disconnected while the system is being updated, verify that all users have logged out of the system and then click Yes to continue. d. The Web Site Directory identifies the server machine that will contain the application server. The application server is installed in this location. Verify that the path includes the Application Name that you just entered. For example: C:\Inetpub\wwwroot\EpicorERP101500. e. Use the drop-down menu to select your Endpoint Binding to define how this application server checks for authentication certificates through Internet Information Services (IIS). When a user logs into the application, the selected method verifies the communications are encrypted and checks whether the user can access the Epicor application. Options include: • UsernameWindowsChannel - This NET.TCP binding authenticates transactions through an Epicor Username and Password. Windows checks for existing Epicor user accounts to authenticate logins. • UsernameSSLChannel - This NET.TCP binding authenticates transactions using a Secure Sockets Layer (SSL) X509 certificate. Leverage this method for application servers that handle smart client installations when users reside in different domains. By using an SSL certificate, users from these different domains can log into the Epicor application. When you select this option, the following fields become available: • SSL Certificate Subject Name. Click the Browse (...) button to open the Windows Security list. Select your certificate. Click OK • DNS Endpoint Identity. Enter the Domain Name System (DNS) identity of the server. When the system runs X509 SSL Certificate authentication, it uses this identity value to validate the server. • Windows - This NET.TCP binding authenticates transactions using a Windows Username and Password. Any user with a Windows Username and Password within this domain can successfully log into the Epicor application. • HttpBinaryUsernameSslChannel - This HTTP binding protocol authenticates using a Secure Sockets Layer (SSL) X509 certificate. The data transfers between the client and server using Hypertext Transfer Protocol (HTTP). Instead of the transport, the message which contains the data transfer is encrypted. Because this binding does not use Hypertext Transfer Protocol Secure (HTTPS), it tends to be slower than bindings which use HTTPS. Use this method for application servers that handle smart client installations when users reside in different domains. By using an SSL certificate, users from these different domains can log into the Epicor ERP application. When you select this option, the following fields become available: • SSL Certificate Subject Name. Click the Browse (...) button to open the Windows Security list. Select your certificate. Click OK • DNS Endpoint Identity. Enter the Domain Name System (DNS) identity of the server. When the system runs X509 SSL Certificate authentication, it uses this identity value to validate the server. • HttpsBinaryUsernameChannel - This HTTPS binding authenticates transactions using an Epicor Username and Password. The data transfers between the client and server using Hypertext Transfer Protocol Secure (HTTPS). HTTPS encrypts the data transfer.
42
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
• HttpsBinaryWindowsChannel - This HTTPS binding authenticates transactions using a Windows Username and Password. The data transfers between the client and server using Hypertext Transfer Protocol Secure (HTTPS). You can select this method for application servers that handle smart client installations and Epicor Web Access (EWA) installations where users access the application through the same domain. Any user with a Windows Username and Password within this domain can successfully log into the Epicor application. • HttpsOffloadbinaryUserNameChannel - This HTTPS protocol binding is a configuration that offloads encryption handling to an intermediary Application Request Router such as an F5. The binding authenticates using an Epicor Username and Password token. The data transfers between the client and server using Hypertext Transfer Protocol Secure (HTTPS). This protocol is configured to move encryption handling to an intermediary Application Request Router like F5 or a similar router.
4. In the Server Information group box, use the fields to update your Epicor ERP 10.1 application to an updated version. Fields include: a. Custom Directory. If you have custom programs to incorporate with the Epicor application, browse and select the Custom Directory that contains these custom .dll files. After you click OK on this window, these custom .dll files are included in the Epicor application. Note As a best practice, you should always place custom programs in this separate Custom Directory. Then the next time the application version is updated, these custom programs are not overwritten. You can then modify these custom programs to work with the new version. When you finish creating or modifying the application server and click OK, the application server checks each of the following folders (in sequential order) to determine what version to install: • Base Directory. This directory contains the primary installation for the Epicor application. The update process always starts with this base version. • Updates Directory - If an update version is available, the application next updates the Epicor application to use this update. • Custom Directory. The application lastly checks if customizations are available. If custom programs are in this directory, the Epicor application applies these customizations over the base version. b. Shared Assembly Location. Select the Shared Assembly Location check box if you have a network load balanced (NLB) environment. For example, you may have the Epicor ERP application installed on multiple servers. You then must have a central directory that contains all the server assemblies and Business Process Management (BPM) folders. If your server environment is set up this way, activate this check box. You typically select this check box when you add your second and subsequent application servers. When you install the first application server, the install process creates a Server/Assemblies folder. You then create a Windows share for this folder. When you add more application servers, you select this check box and then enter or select this Shared Assembly Location in the next field. Note that you can move the Assemblies folder to some other disk location. However if you move this folder, you must manually update the web.config file for the first application server so it points to this new location. c. Shared Directory. Select the directory of the Shared Assembly Location. This directory can be a network shared location or a local file path. Note that if your appservers will be on separate machines you must select a network shared location. d. Select the Enable RESTful Services Preview check box to activate the Representational State Transfer (REST) services with the Epicor application.
New Installation of Epicor 10.1.500
43
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
Currently this feature is available as a technical preview in your test environment. REST is not yet supported by Epicor and features/functions may change in the official release. During this preview period, you can integrate third party or custom applications with Epicor by leveraging the REST services. For example, you can link a BAQ REST Service with Microsoft Excel to display real time views of your Epicor data. You can then use Excel features to further review and evaluate your data. Tip For more information on how REST integrates with the Epicor application, review the REST Implementation section in the application help. From the Table of Contents pane, this documentation is located under the System Management > Working With node. When you create or update an application server and select this option, it activates the REST nodes available within the web.config file. After you Deploy the application server, you can then integrate third party applications through REST services.
5. In the Application Pool group box, set the following fields: a. The Application Pool Name uses the value you entered in the Application Name field. You cannot change this value. This value defines the name of the application pool associated with the new application server. An application pool defines a group of related URLs that use the same process or set of processes. The new application server will be placed in an application pool. b. Use Custom Account. Select this check box when you need to enter a specific user account for the Internet Information Services (IIS) application pool this application server uses. If you select to use a custom account, you must also enter the following: • Application Pool Username. Enter the domain and the user account. For example, MyDomain\UserName. • Application Pool Password Enter the password associated with the user account for this application pool. Note If you do not select this check box, the application pool uses a default user account. This default account depends on whether you use an SSRS server: • If you use an SSRS server, the connection uses the LocalSystem account. This is the default user account available through the Windows operating system. • If you do not use an SSRS server, the connection uses the ApplicationPoolIdentity account. This is the default user account available through Internet Information Services (IIS). Do not click Deploy yet. You must complete the other tabs before submitting the information. If you click Deploy, you may receive a message that your data entry is not complete on the other tabs.
44
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
6. Select the Database Connection tab. Your dialog may look similar to the following:
Define database connection settings: a. For the Server Name enter the name of your database server that contains the database that you will use with the current application server. b. Click the Authentication drop-down list and select either the Windows Authentication or SQL Server Authentication option. • If you select Windows Authentication, the User and Password default to your current login values. • If you select SQL Server Authentication, enter the User and Password you use to log into SQL Server. c. From the Database Name drop-down list, select the name of the SQL database you want to link to this application server. All the databases available under the selected database server display on this list. d. To verify the application server can connect with this database, click Test Connection and click OK in the confirmation message. Do not click Deploy yet. You must complete the other tabs before submitting the information. If you click Deploy, you may receive a message that your data entry is not complete on the other tabs.
New Installation of Epicor 10.1.500
45
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
7. Navigate to the Admin Console Settings tab. Your dialog may look similar to the following:
Define Admin Console settings: a. Review or enter the Display Name to identify the application server in the administration console. The name helps you identify the purpose for the application server. b. Enter your Epicor User Name and Password. You must enter a valid Epicor User and Password for the user account who has access to the Epicor application directories. The credentials differ based on the database (new or Demo) to which you are adding an application server: • For a new database, enter manager / manager. • For the Demo database, enter epicor / epicor. Note The password is stored in an encrypted format.
c. Enter the Operation timeout value you want for the application server. This value determines the wait time until an incomplete operation is stopped by the application server. The default value is 300 seconds. d. Select or clear the Validate WCF Certificate check box. This indicates whether the client application and WCF service need to validate their connection through a certificate. If this check box is selected, a certificate is required for the client installation to communicate with the WCF service. e. For DNS Identity value, enter the expected DNS server name. There are two scenarios where you need to enter a value in this field: • UsernameSSLChannel Selected in Endpoint Binding. When authenticating using message-level or transport-level Secure Sockets Layer (SSL) with X.509 certificates, WCF ensures that the certificate provided during the SSL handshake contains a DNS or Common Name (CN) attribute equal to the value specified in this field.
46
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
• Windows Selected in Endpoint Binding. When the service authenticates using message-level or transport-level SSL with a Windows credential for authentication, and negotiates the credential, then the negotiation passes the service principal name (SPN) so that the DNS name can be checked. The SPN is in the form host/. f. Optionally in the Epicor Application Launcher section, indicate how you will connect the Epicor Administration Console to the Epicor application. If you activate this feature, you can launch User Account Security Maintenance from within the console. When you expand the Users node, select a user, and then select Properties from either the context menu or the Actions pane, User Account Security Maintenance displays with the selected user account. Select one of the following options: • Do not allow access to user details - The default option, select this radio button when you do not want to activate this feature. The Epicor Administration Console then cannot launch User Account Security Maintenance. • Use Epicor Smart Client - If you select this option, click the Browse (...) button to find and select the Epicor.exe file you will use to launch User Account Security Maintenance. • Use Epicor Web Access - If you use Epicor Web Access (EWA), select this option and click the drop-down list to define the URL for the web access. This drop-down list contains the web access values defined in the company configuration data for EWA (set within the client); you then launch the EWA version of User Account Security Maintenance. Do not click Deploy yet. You must complete the other tabs before submitting the information. If you click Deploy, you may receive a message that your data entry is not complete on the other tabs.
8. Navigate to the Reporting Services tab. Your dialog may look similar to the following:
Define your Reporting Services settings: a. If you plan to use SSRS reporting functionality, verify that the Configure SSRS check box is selected. The reporting services configuration fields open and you can then define how this application server interacts with SSRS.
New Installation of Epicor 10.1.500
47
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
Important Be sure that once you select this check box, you continue to keep it selected during future updates to this application server. When any SSRS reports are changed as part of an update, these modified reports are automatically included when you deploy this update. If you clear this check box during a future update, it indicates you no longer use SSRS reporting, causing the application server to reconfigure without the SSRS functions. Note If you are not ready to configure your SSRS functionality now, do not select the Configure SSRS check box. Later when you want to use SSRS reporting functionality, you can update your application server. To do this, expand Server Management > [server]. Right-click on your application server and select Application Server Configuration. You can select the Reporting Services tab to define your SSRS settings. b. Enter the SSRS Base URL for the SSRS Report Server. This value defines the Uniform Resource Locator (URL) for the server, so enter the web site location that contains it. When you install SQL Server, you set up this URL and this value is typically http:///ReportServer. Note To find the value you need to enter in this field, go to the server machine and launch Reporting Services Configuration Manager. From the tree view, click the Web Service URL icon. The value you need displays in the Report Server Web Service URLs section. Copy this value into Notepad or a text editor so you can later paste it into the Application Server window. For example: http://HVW12AS09:80/ReportServer c. Optionally, enter the SSRS Root Folder location. This directory defines the root folder location where you will deploy the reports. For example, enter Epicor if you want the reports to deploy to the Epicor/Reports folder. If you leave the field blank, this root folder will be the directory that contains the report server home page file, and the reports will deploy to the /Reports sub-folder in this directory. 9. In the SSRS Database Connection group box, enter the following: a. In the Server Name field enter the name of the server where the SSRS database will be located. b. Click the Authentication drop-down list and select either the Windows Authentication or SQL Server Authentication option. • If you select Windows Authentication, the User and Password default to your current login values. • If you select SQL Server Authentication, enter the User and Password you use to log into SQL Server. c. In the Report Database Name field select the SQL Server database that will hold the temporary data used by reporting. Click the Down Arrow next to this drop-down list; select the database you need from the list of options. d. If you are setting up SSRS for the first time, select the Create DB check box to create a database for SSRS. When you select this option and click OK, a new report database is generated using the name you entered in the Report Database Name field. e. If you selected an existing database, when you finish defining your SSRS options, click the Test Connection button. A message should display indicating that this application server is connected to SSRS. If you receive an error, check your values to make sure they are accurate and then test the connection again. 10. In the SSRS Deployment group box, enter the following: a. Select the Import Reports check box to indicate you are ready to deploy your SSRS reports. These reports are placed in the server directory for the version. This server directory is a relative directory created where
48
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
the software is installed. For example, if the install directory is D:\ERPSoftware\ERP10.1.500, then the reports install in this location: D:\ERPSoftware\ERP10.1.500\Server\reports.zip. This check box is clear (inactive) by default. You typically just select this check box when you install SSRS on the current application server for the first time. After the first installation, you can then clear this check box. When you later install an update that includes changes to SSRS reports, these updated report definitions install into the \Updates\[version] directory. For example: D:\Epicor\ERP10\ERP10.1.500\Updates\ERP10.1.500.1\Server\reports.zip. b. For the SSRS ReportServer Location, select the directory that contains the latest SQL Server SSRS ReportServer installation. If this directory path is on a remote machine, be sure this directory is shared; you can then both access and copy the report files to this folder. Depending on your SQL Server version, this location is similar to the following example directories. Your specific directory path will include the name your system administrator assigned to the SQL Server instance during installation. These reports are placed in the server directory for the version. This server directory is a relative directory created where the software is installed. For example, if the install directory is D:\ERPSoftware\ERP10.1.500, then the reports install in this location: D:\ERPSoftware\ERP10.1.500\Server\reports.zip • SQL Server 2016. C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer • SQL Server 2014. C:\Program Files\Microsoft SQL Server\MSRS12.MSSQLSERVER\Reporting Services\ReportServer • SQL Server 2012. C:\Program Files\Microsoft SQL Server\MSRS11.MSSQLSERVER\Reporting Services\ReportServer • SQL Server 2008 R2. C:\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer If the SSRS server is on a separate machine, enter the UNC path to the \\\ReportServer directory. The current user account must have permissions to write to this remote directory. For example, enter: \\\C$\Program Files\Microsoft SQL Server\MSRS10_50.MSSQLSERVER\ReportingServices\\ReportServer Note If you have multiple SQL Server versions installed, make sure you select the location that matches the version used by the Epicor ERP 10.1 application.
11. After completing all the tabs, click Deploy. The Deployment Status window displays a progress bar as it validates deployment data, extracts server and client files, and configures the site.
New Installation of Epicor 10.1.500
49
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
12. After the site is configured, the Setup Environment dialog appears. Review the progress as the setup tasks are completed and marked with green checkmarks. Your display may look similar to the following:
13. When setup server environment is complete, a message appears saying the setup is successful. Click Close. Click Close again to save your changes and exit the Setup Environment. If you receive an error message, resolve the issue and restart these steps to add an Epicor Application Server. Note If you click Cancel or the X in the upper corner to exit, you are prompted with a message to verify that you want to close the Setup Environment without registering your Application Server. If you click Yes, you will lose your changes, and your application server will not be registered. If you click No, you can then click Close which will save your changes and exit the Setup Environment.
50
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
14. Verify that your new Epicor Application Server is listed under the Server Management node in the Tree View. Click the application server. The Epicor Administration Console connects to the application server and the property details are displayed in the center pane. Your display may look similar to the following:
You have successfully added your Epicor Application Server. 15. You must now stop and restart your Internet Services on each Epicor server that has an application server pointing to the database. To do this: a. From the Action menu, select Stop Application Pool. Click Yes to confirm. Click OK when finished. b. Select Start Application Pool. Click OK to confirm. All the application servers on that Epicor server are restarted. c. Repeat this step on each Epicor server that has an application server pointing to the database.
5.4 Import License File and Enable Modules Use these steps to import your Epicor ERP 10.1 product license file and enable the modules. These steps should be used for importing license codes for any type of database (production or demonstration). 1. In the Epicor Administration Console, expand your Server Management > [server] > [application server].
New Installation of Epicor 10.1.500
51
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
2. Right-click the Licensing node and select Import License File. Your dialog may look similar to the following:
3. Browse to the location where you previously downloaded the license code file. Select the file and click Open to import the file. 4. In the middle pane, double-click on the licensing code file to open it. The Properties dialog opens. 5. Click the Modules tab. Select the check box for each module you want enabled. Click OK. Note It is recommended that you carefully review the modules that you have selected to enable. Failure to enable your modules may result in possible data corruption. Also, if you enable a new module at this time, you are committing to basic configuration and implementation steps within the application.
6. If you use Country Specific Functionality (CSF), click the Country Specific Functionality tab. Select the check box for each country you want enabled. Click OK. Note It is recommended that you carefully review the CSFs that you enabled. If you enable a new CSF, you must perform additional configuration steps. Review the Configure Country Specific Functionality steps in the Supplemental Installation section of this guide and also review the specific CSF Functionality Guides for additional instructions.
7. Repeat the above steps, if you are importing license files for multiple databases. 8. Exit the Properties dialog. You are now ready to add a company and assign the license file to that company.
52
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Installation and Configuration
5.5 Add Company Use these steps to add a company and assign the license file. New customers must create a new company. 1. Right-click the Companies node on select Add Company. Your option may look similar to the following:
2. In the Add New Company dialog, enter the following: a. Enter your Company ID for your company. b. Enter a Name for your company. It is recommended you use your legal entity name. c. For the Installation, click the browse button (...) to select your installation license. d. If you use Country Specific Functionality, for the Country Code, click the browse button (...) to select your country. e. Enter your Currency Code. f. Specify the Number of Decimals to use for Cost, Price, and General.
New Installation of Epicor 10.1.500
53
Installation and Configuration
Epicor ERP 10.1.500 Installation Guide
Your completed dialog may look similar to the following:
3. Click OK to save. Your new company is created. It may take a period of time to finish processing. 4. After the company is created, you can select the Companies node to view your company and properties. 5. Repeat these steps to add additional companies, if desired.
54
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
Part III: Post-Installation This part of the guide explains the steps you perform after installing or upgrading and configuring the Epicor 10.1 application, right up to logging into the application client.
Chapter 6: Log In the First Time Use this chapter to verify and test your Epicor ERP 10 application the first time you log into the application after your installation.
6.1 Set Up System Agent Use these steps to set up System Agent for your Epicor ERP 10.1 application. Note You only need to set up system agent for your New Epicor Database. If you have added the Demo Database, the system agent is ready for work.
6.1.1 Create System Agent User Account Use these steps to create a system agent user account and configure it with session impersonation rights to run the System Agent and Task Agent. 1. Log in to your Epicor ERP 10 application as a user with Security Manager rights. 2. Navigate to System Setup > Security Maintenance > User Account Security Maintenance. 3. From the New menu, select New User. 4. In the User ID field, enter a user ID you want to use for the system agent. Epicor recommends you to use the print ID for this purpose. 5. In the Description field, enter a name for the system agent user ID. For example, enter For Printing. 6. Select the Options tab. In the Background Task Permission section, select the Allow Session Impersonation check box. 7. From the New menu, select New Company. 8. In the Company field, select your company name. 9. Move the items in the List of Available Sites to the List of Authorized Sites using the right arrow button.
New Installation of Epicor 10.1.500
55
Post-Installation
Epicor ERP 10.1.500 Installation Guide
10. On the Detail sheet, clear the Account Disabled check box. 11. From the toolbar, click Save. 12. Set up password for the system agent user: a. From the Home screen, navigate to Settings > General Options and select the Change User option. b. On the Log In dialog, enter the system agent User name you created. For example, enter print. c. Enter the same Password as your user ID. d. When the system prompts to change your password, create a new password for your system agent user. You can also keep the old password which is the same as your user ID. Important Keep record of this data. You will need to reference it later.
13. When you finish, log back in as Security Manager.
6.1.2 Create System Agent Use these steps to create a System Agent that together with Task Agent will help to streamline and automate the flow of data throughout your company. 1. Prior to creating the System Agent, you must share the EpicorData folder. During the installation, the EpicorData folder was added to be used as the root directory for any common files created by tasks run by the system agent. The folder needs to be shared. To do this: a. Navigate to the server where you installed Epicor ERP 10.1. b. Right-click on the EpicorData directory and select Properties. c. Select the Sharing tab. Click the Share button. d. On the File Sharing dialog, select the IIS_IUSRS user group. Keep the security Read/Write. Click Share. e. Click Done. Click Close. 2. In your Epicor ERP application, navigate to System Setup > System Maintenance > System Agent. 3. From the New menu, select New Agent. 4. Enter an Agent ID for your system agent. For example, enter SystemAgent. 5. Enter a Description for your system agent. For example, enter System Task Agent. 6. In the System Appserver section, enter your system agent user ID as User Name and its Password. 7. Verify your directory paths are accurate. For example:
56
Directory
Description
Examples
Server Data
specifies the root directory for any common files created by tasks run by the system agent
C:\EpicorData
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
Directory
Description
Examples
Client Data
specifies the UNC path to the directory for any common files created by tasks run by the system agent
\\\EpicorData
Client Program
specifies the UNC path to the server deployment directory for the client installation
C:\inetpub\wwwroot\\Server
8. Select the Auto Start check box. 9. Click Save. 10. You must now configure the client program Server directory so that the IIS_IUSRS user has read and write permissions. Note The steps may be different based on your operating system. a. Navigate to the Client Program Directory location on your server. b. Right-click the Server folder and select Properties. c. On the Security tab, click Edit. d. On the Permissions dialog, select the IIS_IUSRS user group. e. In the Permissions for IIS_IUSRS list, select the Allow check box for the Write line. Note The selected group now has the Allow check box selected for Read & Execute, List folder contents, Read, and Write. f. Click OK to apply the changes. Click OK to close the Properties window.
6.2 Install and Configure Task Agent Use these steps to run the Task Agent Service installer and then add a Task Agent. A task agent handles all scheduled tasks within the Epicor application. You must use these steps if you are installing a new application of Epicor ERP 10.1. Note When adding a task agent, you must select the Endpoint Binding for the task agent. This binding must match what you previously defined in the Setup Environment screen when adding the Epicor Application Server. Task agents run against a specific database. To create a task agent, launch the Task Agent Service Configuration for 3.1.xxx program (Where 3.1.xxx is the ICE version installed with the service). Use this program to add task agents that run on either a local machine or a remote machine. Note that you can install multiple versions of the Task Agent Service Configuration on the same application server. Each version of the service has the ICE version number appended at the end of the program title. For example, you can have both Task Agent Service Configuration for 3.0.7.0 and Task Agent Service Configuration for 3.1.500 installed on the same machine. Through this feature, you can have multiple versions of the service running at the same time. In the control panel, each instance of the service displays as a separate icon identified by its version number.
New Installation of Epicor 10.1.500
57
Post-Installation
Epicor ERP 10.1.500 Installation Guide
1. In the Epicor Administration Console tree view, navigate to Server Management > [server] > [application server]. Your screen may look similar to the following:
2. Click the Task Agent Configuration button. You are prompted to install the Task Agent Service. Click OK to confirm the installation. The Task Agent Installer version is automatically selected based on the version of your Epicor application server. 3. On the Welcome dialog, click Next.
58
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
4. In the Choose Folder dialog, select the folder where the Task Agent should be installed. The default path is C:\Program Files (x86)\Epicor Software. Click Next. Your dialog may look similar to the following:
5. In the Program Group Name dialog, enter a Program Group Name. The default is Task Agent Service 3.1.xxx. 6. Select whether to create shortcuts for all users of this computer or only for yourself. Click Next. 7. In the Ready to Install dialog, click Next to proceed. The Epicor Task Agent Service is installed. 8. In the confirmation window, click Finish. 9. Verify that the Task Agent Service Configuration opens automatically. If it does not open, navigate to Start > All Programs > Epicor Software > Epicor Administration Tools > Task Agent Service Configuration for 3.1.xxx > Task Agent Service Configuration.
New Installation of Epicor 10.1.500
59
Post-Installation
Epicor ERP 10.1.500 Installation Guide
10. To add a task agent service, from File, select New Task Agent. Your dialog may look similar to the following:
11. In the Add Task Agent dialog, enter a unique Name for your Task Agent. For example, ERP101TaskAgent. 12. Enter the AppServer URL to define the URL that connects the task agent to the application server (AppServer). You can locate the AppServer URL in the URL field of the Application Server screen. Your AppServer URL may look similar to the following: net.tcp:///ERP10 13. Use the drop-down menu to select the Endpoint Binding for the task agent. This binding must match what you previously defined in the Setup Environment screen when adding the Epicor Application Server. 14. Enter the Epicor ERP 10.1 User ID and User Password that the Task Agent uses to access the Epicor application. Note In addition to the User ID being a valid user for accessing the Epicor application, it must also have rights to Allow Session Impersonation. Note that you set up your Task Agent User Id using the steps in the previous section.
15. Select the Operation Timeout value to define how long, in seconds, it takes a server call to generate an error and fail. 16. If an error occurs, the task agent will try to send the call back to the server. Select the Max Connection Attempts value to define how many times the task agent will attempt to send the call again. 17. Select the Max Concurrent Tasks value to define how many calls the task agent can send to the application server at the same time. Change the value to reflect the capacity of your application server. 18. If you selected UsernameSSLChannel for the Endpoint Binding, the following two check boxes become active: • Validate WCF Certificate. Select this check box to specify that the task agent service must verify that the Secure Sockets Layer (SSL) Certificate is valid. If you use a self-signed certificate, do not select this check box.
60
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
• DNS Endpoint Identity. Enter the expected Domain Name System (DNS) identity of the server. When the system runs X509 SSL Certificate authentication, it uses this identity value to validate the server. If the SSL certificate contains a DNS Endpoint Identity with the same value, the server is valid and can be accessed by the task agent. 19. When all the fields are complete, verify that the Enabled check box is selected. 20. Click Save. Your Task Agent is now added and enabled. A green icon indicates it is active. Your dialog may look similar to the following:
Note If a task agent already exists for this application server and you attempt to save, you will receive an error. To create a new task agent for this database, you must first delete the existing task agent. After the task agent is removed, repeat these steps.
6.3 Verify SQL Search Services for Full-Text Search Use these steps to verify that the Microsoft SQL Search Services are started (running) in order to use full-text search functionality. Microsoft Search Service uses Full-Text Catalogs to perform word searches on specific fields in the database. Full-Text Catalogs are separate files of proprietary data structures, established for the purpose of evaluating Contains and FreeText queries. These files are not automatically updated along with the rest of the database. 1. To verify that Microsoft SQL Search Service is running on the server, select Start > Control Panel > Administration Tools > Services. 2. Confirm that the following Services are set: • SQL Server > Started (or Running) > Automatic • SQL ServerAgent > Started (or Running) > Automatic • SQL Full-Text Filter Daemon Launcher > Started (or Running) > Automatic For any services that are not started (or running), start the service and change the startup configuration if needed.
6.4 Test System and Repeat Installation Use this section to define you next steps. Based on your installation process, you are at one of the following points: • If you completed the Epicor 10.1 installation in a test environment, you are now ready to test the installed Epicor 10.1 application in that environment. After your testing is complete, you must repeat the entire installation in your production environment.
New Installation of Epicor 10.1.500
61
Post-Installation
Epicor ERP 10.1.500 Installation Guide
• If you completed the Epicor 10.1 installation in your production environment, you are now ready to use the installed Epicor 10.1 application in that environment. Note that while it is possible to install multiple versions of the Epicor application on the same server for testing purposes, it is not recommended.
62
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
Chapter 7: Install Epicor ERP Extension Applications Use this chapter to install the Epicor ERP extension applications. You can install the Epicor ERP extension applications after you have configured your Epicor ERP application server. Extension applications include: Epicor Web Access, Epicor Mobile Access, Epicor Social Enterprise, Enterprise Search, Epicor Education, Epicor Information Worker, Epicor Online Help, and Epicor SharePoint Publisher. You select the extension features to install during the Epicor ERP 10.1 Server installation process. To deploy (install) the selected features, use the Epicor Administration Console. Note that Epicor SharePoint Publisher is an extension application but it is installed using a separate executable file instead of through the Epicor Administration Console. Note that you can also move, or publish, the installed extensions to a remote machine. To do this you use the Publish Extension Installers feature. For instructions, refer to the online help in the Epicor Administration Console under Epicor Application Server > Publish Extension Installers. Note that if you use Single Sign On functionality by specifying either binding type Windows or HttpsBinaryWindowsChannel, you cannot use the Publish Extensions Installers feature due to a Windows binding limitation. Instead, you must use the Epicor Administration Console to install the extensions on the same server where the Epicor Application Server is installed. 1.
On the server where your Epicor application is installed, open the Epicor Administration Console, if it is not already opened. To do this: • Windows Server 2012 / 2012 R2. On the server, press + F to display the Start > All Programs > Epicor Software > Epicor Administrative Tools > Epicor Administration Console Charms bar and select Apps. Alternatively, on the Start screen, right-click the background and in the lower right corner select all Apps. On the Apps screen, select Epicor Software > Epicor Administration Console. • Windows Server 2008 R2 On the server, navigate to .
2.
In the tree view, select your Server Management > [server] > [application server].
3.
In the Actions pane, click Application Server Configuration.
4.
Click the Extensions tab.
5.
Notice how the Current Deployment section on each extension application tab contains the details of each extension application installation. Review the information in these fields: • Status Indicator - This icon indicates whether the extension is Not Installed (red) or Installed (Green). • Installed On - Displays the date on which the current extension version was installed. • Server - Contains the name of the server on which the extension is installed. • Version - Displays the version number for the extension. Use this value to compare against the current version available from Epicor; if you have an older version, consider updating the extension. • Extension URL - Displays the internet website for the extension. You can click this link to launch your internet browser and display the website.
6.
Use the following sections to deploy the extension applications.
New Installation of Epicor 10.1.500
63
Post-Installation
Epicor ERP 10.1.500 Installation Guide
7.1 Install Epicor Web Access Use these steps to install Epicor Web Access for your Epicor ERP application. During the installation you specify the location of the Web Forms Package and Web Services Package. 1. Select the Web Access tab. Your display may look similar to the following:
2. To install a new instance of the Epicor Web Access or upgrade an existing Epicor Web Access instance, choose one of the following: a. To install a new extension, click the New button. Enter the Deployment Name for this Epicor Web Access instance. Be sure to enter a name that helps you identify each Web Access extension available on this application server. b. To update an existing extension, click the Existing Deployment drop-down list to select which Epicor Web Access extension you need to review or update. c. To add an existing extension, click the Browse (...) button. The Application Server Settings program locates existing Web Access extensions. Select the extension you wish to add. After you select the Web Access extension, the fields activate for data entry. 3. Enter the Install Path for the extension. You can use the Browse (...) button to the right to find and select the folder. The default is \inetpub\wwwroot. 4. In the Web Site, enter your site name. The default is Default Web Site.
64
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
5. Enter the Virtual Directory name for the Epicor Web Access application. The default is [AppServerName]-EWA. For example, if your AppServer name is ERP101 your virtual directory is named ERP101-EWA. The name can be changed to any name allowed in IIS. If the default is accepted, a virtual directory is created in IIS with a physical path and folder located under the \inetpub\wwwroot folder. 6. Define the Application Pool details: a. In the Application Pool Name field, select the Application Pool that will be used by the Epicor Web Access application. The drop-down list displays only the application pools that are set to use Integrated Pipeline mode. If the list is empty, click the New button to create a new application pool that uses an Integrated pipeline. b. If you want to use a custom account, select the Use Custom Account check box and enter Application Pool Username and Application Pool Password for the account. 7. Define the Report Settings: a. Enable Crystal Reporting: Select this check box only if you use custom Crystal reports. Leave it clear if you use SSRS reporting. b. Report AppServer. The Report AppServer defaults to the name of the web server. If Crystal Reports is installed on a different server, change this name to identify the name of the server where it is installed. c. NLB Report Repository: Specify the NLB (Network Load Balancing) report repository location. This location is a shared repository that can be accessed by other EWA installations. This is an optional field. 8. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. 9. To verify that the installation was successful, in Windows Explorer enter the Epicor Web Access URL. For example, enter http:////default.aspx where is the name you specified as your server and is the name you specified as your Epicor Web Access Site. 10. If your Epicor Web Access installed successfully, a window similar to the following displays:
Important If your application is configured to use Windows authentication, Single Sign-On is used for login, so this window does not display and you need to skip the next step. For more information on Single Sign-On, refer to the Security chapter in Epicor ERP 10.1 Implementation User Guide.
11. Enter a valid User ID and Password that you use to log into your Epicor application. Note that this sign-in consumes a user license. Click the Login button (arrow).
New Installation of Epicor 10.1.500
65
Post-Installation
Epicor ERP 10.1.500 Installation Guide
Note If you want to use a Time and Expense (TE) or Customer Relationship Management (CRM) license, go to the login page using the following URLs respectively: • http:////ice.ewa.shell.aspx?LicenseType=TE • http:////ice.ewa.shell.aspx?LicenseType=CRM During deployment of EWA, users of TE and CRM license types should set up browser Favorites using the appropriate style of URL.
12. Prior to using Epicor Web Access, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Deploy and Configure Epicor Web Access.
7.2 Install Epicor Mobile Access Use these steps to install Epicor Mobile Access. 1. Select the Mobile Access tab. Your dialog may look similar to the following:
2. To install a new instance of the Mobile Access or upgrade an existing Mobile Access instance, choose one of the following: a. To install a new extension, click the New button. Enter the Deployment Name for this Mobile Access instance. Be sure to enter a name that helps you identify each Mobile Access extension available on this application server. b. To update an existing extension, click the Existing Deployment drop-down list to select which Mobile Access extension you need to review or update.
66
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
c. To add an existing extension, click the Browse (...) button. The Application Server Settings program locates existing Mobile Access extensions. Select the extension you wish to add. After you select the Mobile Access extension, the fields activate for data entry. 3. Select the Install Version to identify the EMA version you are installing. For example, Modern (Epicor 10.1 and later) or Legacy (prior to Epicor 10.1). 4. Enter the Install Path for EMA. Click the Browse (...) button to search and select the folder. The default is \inetpub\wwwroot. 5. Enter your site name in the Web Site field. If you do not have a name you wish to use, accept the Default Web Site value. 6. Enter the Virtual Directory name for the Epicor Mobile Access application. The default is [AppServerName]-EMA. For example, if your AppServer name is ERP101 your virtual directory is named ERP101-EMA. The name can be changed to any name allowed in IIS. If the default is accepted, a virtual directory is created in IIS with a physical path and folder located under the \inetpub\wwwroot folder. 7. Define the Application Pool details: a. In the Application Pool Name field, select the Application Pool that will be used by the Epicor Mobile Access. The drop-down list displays only the application pools that are set to use Integrated Pipeline mode. If the list is empty, click the New button to create a new application pool that uses an Integrated pipeline. b. If you want to use a custom account, select the Use Custom Account check box and enter Application Pool Username and Application Pool Password for the account. 8. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. 9. Prior to using Epicor Mobile Access, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Configure Epicor Mobile Access.
New Installation of Epicor 10.1.500
67
Post-Installation
Epicor ERP 10.1.500 Installation Guide
7.3 Install Epicor Enterprise Search Use these steps to install Epicor Enterprise Search. 1. Select the Enterprise Search tab. Your dialog may look similar to the following:
2. Use this sheet to install a new Enterprise Search extension or select an existing extension. You can also update the current Enterprise Search extension. • To install a new Enterprise Search extension, click the New button. Enter the Deployment Name for this Enterprise Search extension. Be sure to enter a name that helps you identify each Enterprise Search extension available on your system. The fields on the Enterprise Search sheet activate for data entry. • To select an existing Enterprise Search extension, click the Browse (...) button. The Application Server Settings program locates existing Enterprise Search extensions; select the extension you wish to add or update. After you select the Enterprise Search extension, the fields activate for data entry. • To update the Enterprise Search extension, enter the new values in the fields on this sheet. 3. Enter the Database Connection details for Enterprise Search: a. Keep the default Server Name for the database server that will contain the Enterprise Search database. b. Select the type of Authentication to use for connection: • If you select Windows Authentication, the User and Password default to your current login values and these fields are disabled. • If you select SQL Server Authentication, enter the User and Password you use to log into SQL Server. c. Enter the Database Name to identify the Enterprise Search database.
68
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
d. If you are setting up Enterprise Search for the first time, select the Create DB check box. When you select this option and click OK, a new database generates using the name you entered in the Database Name field. If you update the Enterprise Search settings later, you can select this database again or if needed, create a new database. When you save, this database is validated. If the Application Server Setup program cannot find this database in the location you specified, an error message displays. e. To verify the application server can connect with this Enterprise Search database, click Test Connection and click OK in the confirmation message. 4. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. • If you receive error messages, update the fields with correct values and click Deploy again. • If the application server can connect to the extension, a confirmation dialog displays. Click OK. A green Installed icon displays on the sheet. The Enterprise Search extension is now added to your Epicor ERP environment. 5. If your Epicor Application Server is configured to use Windows authentication, you need to set up the Epicor Search Indexer service to use your Application Server Windows account for logon. To do this: a. In your server navigate to Control Panel > Administrative Tools > Services. b. Open the Epicor Search Indexer service and navigate to the Log On sheet. c. Select the This account option. d. Click the Browse button and select the Windows user set to run your Application Server. e. Click OK. 6. You now need to generate a search index of your database. Select which companies you want to index. To do this: a. Click the Create Search Index button. The Search Index Creation wizard opens. b. Select a Template. Click Next. c. Select a Company for the index. Click Next. d. Enter a Search Index Name. Click Next. e. Review proposed search index. Click Finish. 7. Prior to using Epicor Enterprise Search, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Configure Epicor Enterprise Search.
New Installation of Epicor 10.1.500
69
Post-Installation
Epicor ERP 10.1.500 Installation Guide
7.4 Install Epicor Social Enterprise Use these steps to install Epicor Social Enterprise. When your Epicor ERP application server is set up to use Windows authentication (Windows endpoint binding is selected in the application server configuration), you must also do the following to prepare for using Windows authorization in your Epicor Social Enterprise installation: • Create a Windows domain account that links back to a system User ID with Single Sign-On feature set up and Allow Session Impersonation option selected. In Epicor ERP, create a user that maps to that Windows account. You may want to give the Windows account and the Epicor ERP user account a name that indicates their purpose; for example, EpicorSocial. When configuring Epicor Social Enterprise later in this procedure, the custom account must be used as the login account for the Epicor CDC Log Reader service and as the application pool account used by the Epicor Social Enterprise web site. • Enable windows authentication for the Epicor Social Enterprise website. The Epicor Social Enterprise website by default does not turn on windows authentication and it must be turned on manually. See your Windows IIS documentation for instructions. Important It is suggested you make these adjustments before proceeding with the installation. Alternatively, both the Epicor Social Enterprise configuration utility and IIS Manager can be run post-installation from the server where you have installed Epicor Social Enterprise. 1. Select the Social Enterprise tab. Your dialog may look similar to the following:
70
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
2. Click the Browse button to select an existing Deployment Name or click the New button to create a new deployment. 3. Enter your name for the Social Enterprise site in the Web Site field. If you do not have a name you wish to use, accept the Default Web Site value. 4. Enter the Database Connection details for Social Enterprise. To do this: Important The account you use to create or access Epicor Social Enterprise database must have system administrator rights. a. Enter the Server Name. b. Select the type of Authentication to use for connection. c. Enter User and Password to use for authentication if needed. d. In the Database Name field, enter the database that will host Epicor Social details. e. Select the Create DB check box if you need to create a new database. f. Click Test Connection to validate the server name and credentials. 5. If you install Epicor Social for the first time, use the Initial Account section to create the initial user of the Social Enterprise system. Enter your User Name and Password which will be used to login to the Social Enterprise application. The password must be eight or more characters. It is recommended that you keep a record of the data you enter in this field. You will need to reference it later. 6. In the CDC Service section, select the CDC service account type and specify the account credentials. For the Built-in Account you can select Local Service or a Custom account. If you use Custom account, make sure this account is a member of the IIS_IUSRS group on the Web server. Important If your Epicor ERP application server uses Windows authentication, you must select Custom account for Web site. The Custom account you need to use is the same account that you specified for CDC service in the previous step and is the account discussed in the introduction to this procedure.
7. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. 8. Prior to using Epicor Social Enterprise, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Configure Epicor Social Enterprise.
7.5 Install Embedded Education Courses Use these steps to install the Epicor Education Module, which includes the embedded education courses. Note Verify that the ASP.NET module of your Windows Internet Information Services (IIS) installation is enabled before you start to install Epicor Education.
New Installation of Epicor 10.1.500
71
Post-Installation
Epicor ERP 10.1.500 Installation Guide
1. Select the Epicor Education tab. Your dialog may look similar to the following:
2. Click the Browse button to select an existing Deployment Name and click OK or click the New button to create a new deployment. 3. Enter your Epicor Education site name in the Web Site field. If you do not have a name you wish to use, accept the Default Web Site value. 4. Enter the Virtual Directory name for the Epicor Education. The default is EpicorEducation. The name can be changed to any name allowed in IIS. If the default is accepted, a virtual directory is created in IIS with a physical path and folder located under the \inetpub\wwwroot folder. 5. Define the Default User for Licensing details: a. Enter the Epicor User Name and Password to use for the connection to application server. The course web site uses this User ID and Password to login to the Education Application Server to verify licensing information. The default User ID and Password for the Epicor Education database is epicor / epicor. b. For Operation timeout, accept the default or adjust the wait time until an incomplete operation is stopped by the application server. c. If you selected UsernameSSLChannel authentication type for this application server, you must also select the Validate WCF Certificate check box. 6. Define the Application Pool details:
72
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
a. In the Application Pool Name field, select the Application Pool that will be used by the Epicor Education. The drop-down list displays only the application pools that are set to use Integrated Pipeline mode. If the list is empty, click the New button to create a new application pool that uses an Integrated pipeline. b. If you want to use a custom account, select the Use Custom Account check box and enter Application Pool Username and Application Pool Password for the account. 7. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. 8. Log into your Epicor ERP 10 application. Open System Setup > Company / Site Maintenance > Company Maintenance . On the General Settings tab, in the Help section, enter the Education Courses URL for the site that you just created. Click Save to record your settings. 9. Prior to using the Epicor Education Module, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Configure Epicor Education Module.
7.6 Install Epicor Information Worker Use these steps to install Epicor Information Worker. 1. Determine where you are installing Epicor Information Worker Server. It can be installed on the Epicor application server or on a separate server. If you are installing Epicor Information Worker on a separate server, verify that you have completed the steps from the Getting Started > Verify Prerequisites > Verify Windows Operating System Requirements and Configure Server Roles sections of this guide. 2. Select the Epicor Information Worker tab. Your dialog may look similar to the following:
New Installation of Epicor 10.1.500
73
Post-Installation
Epicor ERP 10.1.500 Installation Guide
3. Click the Browse button to select an existing Deployment Name and click OK or click the New button to create a new deployment. 4. Review the following fields that default with values: Install Path, Web Site, and Virtual Directory. 5. In the Application Pool section, review the default values. These values cannot be changed. 6. In the E-Mail Error Settings section, enter a valid E-Mail Address to identify the account from where the e-mail will be sent. Review the E-Mail Subject description. 7. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. 8. Prior to using Epicor Information Worker, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Configure Epicor Information Worker.
7.7 Install Epicor Online Help System Use these steps to install the Epicor ERP online help system on your server. Note that you can have multiple instances of the Epicor Help extension linked to each application server. Installing your help system gives you access to the form-level application help by pressing F1 or selecting Help > Contents. You can also access the field-level help by selecting Help > Field Help. 1. Select the Epicor Help tab. Your dialog may look similar to the following:
74
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
2. To install a new instance of the Epicor help or upgrade an existing Epicor help instance, choose one of the following: a. To update an existing extension, click the Existing Deployment drop-down list to select which application help extension you need to review or update. b. To install the application help, click the New button. Enter the Deployment Name for this application help release. Be sure to enter a name that helps you identify the specific Epicor Help release on your system. c. To update the application help with a new release, click the Browse (...) button. The Application Server Settings program locates existing application help releases. Select the release you wish to update. After you select the application help release you want to update, the fields activate for data entry. 3. Enter the Install Path that indicates the location where the files will be placed when you deploy the application help. 4. The Full Path field displays the directory where the application help will be installed within the Epicor application directory. The path includes the Install Path that you entered above and the \Epicor10Help folder. 5. Select the Web Site where you want to install the Epicor Help. It is recommended that you select the Default Web Site. 6. Enter the Virtual Directory name for the Epicor Help System. The default directory is Epicor10Help. You can change this value to any name that Internet Information Services (IIS) will accept. After you deploy the Epicor Help, a virtual directory is created in IIS using a physical path and the folder you define in this field. This physical path will be the Install Path directory. 7. Enter the Session Timeout value in minutes to indicate how long the application help window can remain open before the system shuts down the current session. 8. Select the Application Pool Name to use for the Epicor Help. You can either select an existing application pool from the drop-down list or click New to create a new application pool used exclusively for Epicor Help. a. If you select an existing application pool, this application pool is configured to use the Network Service account for its identity by default. If you wish to use a specific account instead, select the Use Custom Account check box. This activates the Application Pool User Name and Application Pool Password fields. You must enter a valid domain account with access rights to the network. If you are connecting to an application server that uses the Windows endpoint, this domain user account must also be linked to a valid Epicor user account. You link an Epicor user account to a domain account in User Account Security Maintenance; this program is located within the Epicor ERP application.
New Installation of Epicor 10.1.500
75
Post-Installation
Epicor ERP 10.1.500 Installation Guide
b. If you click New, the Create New Application Pool window displays.
c. Enter the name you will use in the New App Pool Name field. This value identifies the application pool throughout the system. d. By default, the application pool is configured to use the Network Service account for its identity. However if you wish to use a specific account instead, select the Use custom account for identity check box. This activates the Domain\User Name, Password, and Confirm Password fields. e. Enter the domain and the user account in the Domain\User Name field; for example, enter \. To effectively connect with the server, this account must be a valid domain account with access rights to the network. If this account is not valid, you will not be able to stop and start the application pool. Important If you are connecting to an application server that uses the Windows endpoint, be sure the application pool you select is configured with a domain user account linked to a valid Epicor user account (this means the Epicor user record has the Domain and Domain ID fields entered). If this account is not linked to an Epicor user account, you will receive a "Service Authorization failed" error during installation. To link an Epicor user account to a domain account, in your Epicor ERP application, go to System Setup > Security Maintenance and open User Account Security Maintenance. f. Click the Create New Pool button. The new application pool is created. Tip For information on how to configure the application pool, review the Add Epicor Application Server section in the Epicor ERP 10.1 Installation Guide, or the application server topics in the Epicor Administration Console help system.
9. Click the Deploy button. The Deployment Status window displays a progress bar as it validates the deployment process. When finished, click Close. 10. Log into your Epicor ERP 10 application. Open System Setup > Company / Site Maintenance > Company Maintenance . 11. On the General Settings tab, in the Help section, specify the Epicor Help URL. Note You can copy the Epicor Help URL using your Windows clipboard. To do this, in the Application Server Setup > Extensions > Epicor Help tab, locate the Current Deployment section and click
76
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
Copy URL to copy the Help URL to your Windows clipboard so that you can then paste it into the Company Maintenance program.
12. Click Save. Your Epicor Help System is ready.
7.8 Install Epicor SharePoint Publisher Use these steps to install Epicor SharePoint Publisher on your server. Epicor SharePoint Publisher supports the creation of SharePoint web parts that directly link to Epicor ERP Business Activity Queries (BAQs). Epicor SharePoint Publisher is not included on the Extensions tab in the Epicor Administration Console. To install Epicor SharePoint Publisher you run a separate executable file using the following steps. Note that if you create a new Web Application on the SharePoint Server after Epicor SharePoint Publisher has already been installed, you must reinstall Epicor Sharepoint Publisher in order for the new site to see Epicor web parts. 1. Verify that you have Microsoft SharePoint 2010 or 2013 installed on your server. 2. Create a domain account for using with SharePoint. Verify the following: • the account has the required SQL Server and local host privileges • the account is registered as a Managed account in SharePoint • you use this account to run all SharePoint application pools • you use this account to run all SharePoint modifications, such as running PowerShell scripts or admin utilities such as stsadm.exe 3. Log on to the server where you intend to install Epicor SharePoint Publisher. If you want to install Epicor SharePoint Publisher on a separate server, go to that server and use remote access to navigate to the shared [product] folder on your application server. 4. Go to the directory where your Epicor ERP application is installed. For example, go to C:\Epicor\[product]\[product version]\SupplementalInstalls. Note If you have installed an update to a base Epicor ERP application, you must use the updated installer. For example, go to C:\Epicor\[product]\[product version]\Updates\[update version]\SupplementalInstalls. Open the Epicor Sharepoint Publisher folder and then open the x64 folder. 5. Using the domain account that you created in a previous step, right-click the Setup.exe file and select Run as administrator. A Setup window appears. Click Next. 6. Specify the folder for the installation of Epicor SharePoint Publisher. Select the Just Me option as the SharePoint Publisher user. Do not select the Everyone option. Click Next. 7. On the Confirm Installation dialog, click Next. The installation begins. 8. When the installation is complete, click Close. 9. Prior to using Epicor SharePoint Publisher, you must complete the configuration steps in the Configure Epicor ERP Extension Applications > Configure Epicor SharePoint Publisher.
New Installation of Epicor 10.1.500
77
Post-Installation
Epicor ERP 10.1.500 Installation Guide
Chapter 8: Configure Epicor ERP Extension Applications Use this chapter to configure the Epicor ERP extension applications. You can configure the Epicor ERP extension applications after you have installed the extension applications and logged into your Epicor ERP 10.1 application for the first time. Extension applications include: Epicor Web Access, Epicor Mobile Access, Epicor Social Enterprise, Enterprise Search, Epicor Education, and Epicor Information Worker.
8.1 Deploy and Configure Epicor Web Access Use these steps to deploy and configure EWA. You must have Microsoft Internet Information Services (IIS) 7.5 or higher installed. The Epicor Web Access forms and components are an optional installation and are required only if browser-based access to your Epicor application environment is desired. Note While it is possible to deploy the Epicor Web Access forms on your Windows based Epicor Server, it is not recommended. For optimal performance and ease of maintenance, a separate Internet Information Server is recommended.
8.1.1 Assign EpicorWebAccess Folder Properties and Sharing Use these steps to assign required properties and sharing to the EpicorWebAccess folder so that the ASP.NET account has Write access. The Write permission is required for the whole virtual folder if you are deploying customizations and dashboards to EWA. The steps might be different based on your operating system. 1. Navigate to the wwwroot virtual directory and locate the EpicorWebAccess folder. For example, if your Epicor Web Access was installed to IIS, the default directory is: C:\inetpub\wwwroot\EpicorWebAccess. 2. Right-click the EpicorWebAccess folder and select Properties. 3. On the Sharing tab, click the Share button. In the File Sharing window, click Share. After the share is complete, click Done. 4. On the Security tab, in the Group or user names section, select IIS_IUSRS and click Edit. 5. On the Permissions dialog, select the IIS_IUSRS user group again. 6. In the Permissions for IIS_IUSRS list, select the Allow check box for the Write line. Note The selected group now has Allow selected for Read & Execute, List folder contents, Read, and Write.
7. Click OK to apply the changes. Click OK to close the Properties window.
78
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
8.1.2 Assign Resources Folder Properties and Sharing Use these steps to assign required properties and sharing to the Resources folder. The Write permission for only the Resources folder is required if you are using charts and localization with EWA. The steps might be different based on your operating system. 1. Navigate to the EpicorWebAccess virtual directory and locate the Resources folder. For example, if your Epicor Web Access was installed to IIS, the default directory should be C:\inetpub\wwwroot\EpicorWebAccess\Resources. 2. Right-click the Resources folder and select Properties. 3. On the Sharing tab, click the Share button. In the File Sharing window, click Share. After the share is complete, click Done. 4. On the Security tab, in the Group or user names section, select IIS_IUSRS and click Edit. 5. On the Permissions dialog, select the IIS_IUSRS user group again. 6. In the Permissions for IIS_IUSRS list, select the Allow check box for the Write and Modify lines. Note The selected group now has Allow selected for Modify, Read & Execute, List Folder Contents, Read, and Write.
7. Click OK to apply the changes. Click OK to close the Properties window.
8.1.3 Deploy Epicor Web Access Forms Use these steps to deploy Epicor Web Access forms. The delivered web forms are generated at the same version as the Epicor application software deployed in the release. The Web Menu includes the forms that are available for Epicor Web Access. 1. Epicor Web Access includes the majority of the Epicor application forms, with a few exceptions of the drag-and-drop scheduling forms and most of the system setup forms. Review the list of form exceptions, which include: • Job Scheduling Board • Multi Resource Scheduling Board • Resource Scheduling Board • Business Activity Query Designer • BPM Method and Data Directive Maintenance • Financial Report Designer • Menu and Security Maintenance • Mobile, Customer and Supplier Connect Maintenance • Translation Maintenance • System Agent • W2 Processing To find the complete list of form exceptions, navigate to the clientdeployment/client/res folder. With a text editor, open the WebAccess.xml file. Scroll through the file to view the forms that are not included.
New Installation of Epicor 10.1.500
79
Post-Installation
Epicor ERP 10.1.500 Installation Guide
2. Determine if you need further control over web forms that you need to exclude from Epicor Web Access. To exclude a form, use Menu Maintenance (using the Epicor Smart Client) and on the Security sheet, select the Exclude Epicor Web Access check box associated with each menu option. Note Epicor Web form supports group access security so this exclusion is only required when a form should be available to users from the Epicor Smart client but not the Epicor Web Client.
3. Determine if you need to customize any forms or create any user dashboards since these must be specially generated for Epicor Web Access. Note When deploying customized forms to EWA, the following are limitations on what can be converted: • Forms that have customization code that is written in VB.NET cannot be deployed to EWA. • Forms that have embedded Appbuilt/dashboard panels cannot be deployed to EWA. Note A prerequisite for generation is that any customization script must be supported in C# rather than VB.Net code. This is due to the fact that the process converts customization code from C# into Java Script for Browser deployment. This process is not possible from VB.Net code. Although VB.Net is supported for backward compatibility with the Epicor application, it is not recommended that new customizations are created using VB.Net with the Epicor application since they do not generate for Web Access without conversion to C#.
4. Determine how to process the customizations and dashboards containing customization code in VB.Net that were created prior to upgrading your Epicor application. You must either recreate those customizations using C#, or manually convert code either by hand or using a commercially available VB.Net to C# conversion routine. Instructions are available in a the document entitled Guidelines for Conversion of VB.Net to C# Customization Code in Epicor Application. Contact Epicor Support for this documentation. 5. If you want certain users to use a Time and Expense (TE) or Customer Relationship Management (CRM) license, direct them to use the following URL style to get to the login page: http:////default.aspx?LicenseType=TE or http:////default.aspx?LicenseType=CRM. Direct users of TE and CRM license types to set up browser Favorites using the appropriate URL.
8.1.4 Set Up Initial Configuration of Epicor Web Access Use these steps to configure Epicor Web Access within your Epicor ERP application. 1. Navigate to System Setup > Company/Site Maintenance and open the Company Maintenance program. 2. On the General Settings tab, in the Web Access section, enter your Web Access URL. For example, enter http:///. 3. Enter your Metadata Output Path. This is from the perspective of a client workstation that might be generating Epicor Web Access forms. The default path is C:\inetpub\wwwroot\EpicorWebAccess. For example, enter: \\\ where is the name of your web server and is a share on that server to your Web Access site name. Example: c:\inetpub\wwwroot\. 4. Click Save.
80
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
8.1.5 Install Epicor Lightweight Client Use these steps to install the lightweight Epicor Web Access client. A lightweight client allows a local smart client to work in conjunction with the EWA browser client to provide functionality not available from EWA forms. 1. Open Epicor Web Access. 2. Click on the Download Smart Client Installer icon that is located in the toolbar. Your toolbar may look similar to the following:
3. Run the installer. 4. On the Welcome dialog, click Next. 5. Accept the default installation folder or click the Browse button to change the lightweight client installation path. 6. Select whether you want the lightweight client to be available for all users of the machine where you install it or for you only. Click Next. 7. Click Next to confirm the installation. When the process is complete. click Close. 8. To run the EWA lightweight client, click the shortcut on your desktop and enter your Epicor credentials. Now you can access the full Epicor ERP functionality.
8.1.6 Configure EWA Reporting URL Display Features Use these steps to configure the Epicor Web Access report display feature if you use Windows Server 2008 R2 for your web server. You need to configure both PDF and XLS report formats.
Configure PDF: Windows Server 2008 R2 Web Server If you use Windows Server 2008 R2, use the following steps to set up a PDF configuration. 1. After creating an Epicor Web Access site, open Internet Information Server. 2. Expand the Sites and Default Web Sites nodes. 3. Locate the Epicor Web Site and single-click to enable the Feature view pane. 4. Under IIS section, double-click to open Handler Mappings. 5. In the Actions section, select Add Script Map. a. For the Request path, enter *.pdf.
New Installation of Epicor 10.1.500
81
Post-Installation
Epicor ERP 10.1.500 Installation Guide
b. For the Executable, browse and select the file: C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll c. For the Name, enter AboMapperCustom PDF 32. d. Click Request Restrictions. e. Go to the Verbs tab. Select the One of the following verbs checkbox. f. Manually enter GET,HEAD,POST,DEBUG. g. Click OK. h. Review the Edit Script Map setup form. The values should be the same as you previously entered. Click OK. i. A message appears asking if you want to allow the ISAPI extension. Click Yes.
Configure XLS: Windows Server 2008 R2 Web Server If you use Windows Server 2008 R2, use the following steps to set up a XLS configuration. 1. Under IIS section, double-click to open Handler Mappings. 2. In the Actions section, select Add Script Map. a. For the Request path, enter *.xls. b. For the Executable, browse and select the file: C:\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll c. For the Name, enter xlsMappingCustom XLS 32. d. Click Request Restrictions. e. Go to the Verbs tab. Select the One of the following verbs checkbox. f. Manually enter GET,HEAD,POST,DEBUG. g. Click OK. h. Review the Edit Script Map setup form. The values should be the same as you previously entered. Click OK. i. A message appears asking if you want to allow the ISAPI extension. Click Yes.
8.1.7 Generate Web Forms for User Dashboards Use these steps to generate Web Forms for user Dashboards. 1. Verify that the account that runs the Application Server's IIS application pool has Read & Write permissions to the Epicor Web Access MetaData Output Path. To do this, use the instructions in the previous section for generating web forms for custom forms. 2. On the Epicor smart client, navigate to the User Account Maintenance > Options tab. Verify that the Dashboard Developer check box is selected.
82
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
3. Open the Dashboard for which you want to generate a web form using the Developer Mode. To launch the Developer Mode, from the Dashboard's Tools menu, select Developer. 4. From the Tools menu, select Deploy Dashboard. 5. To make this dashboard available as a smart client application, select one of the following options: • Select the Deploy Smart Client Application check box. With this option selected, you can then later add this dashboard as a node on the Main Menu and access from within EWA site. • Select the Add Favorite Item check box. With this option selected, the dashboard becomes part of the Favorites > Dashboard Assemblies group found on the EWA Home Page. • Select the Generate Web Form check box. With this option selected, the dashboard is deployed as a web form you can access from the EWA site. 6. Click the Deploy button. 7. Once the deployment process is finished, click OK.
8.1.8 Generate Web Forms for Customized and Localized Application Forms Use these steps to generate web forms for customized and localized Epicor application forms. You must use the Epicor ERP 10 application to generate these web forms because Epicor Web Access does not support the Options button by which you can select the number of rows to return. 1. Navigate to System Management > Upgrade/Mass Regeneration > Customization Maintenance. 2. Click the Name button. The Customization/Personalization Search window opens. 3. In the Type drop-down list, select Customization. 4. Click the Options button. In the Search Options window, select the Return All Rows check box. Click OK. 5. In the Customization/Personalization Search window, click Search. The Search Results panel displays all customization. Click Select All. 6. From the Actions menu, select Generate All Web Forms. Click Yes in the confirmation window. 7. In the Type drop-down list, select Localization. 8. Click the Options button. In the Search Options window, select the Return All Rows check box. Click OK. 9. In the Customization/Personalization Search window, click Search. The Search Results panel displays all customization. Click Select All. 10. From the Actions menu, select Generate All Web Forms. Click Yes in the confirmation window.
New Installation of Epicor 10.1.500
83
Post-Installation
Epicor ERP 10.1.500 Installation Guide
8.1.9 Review Supported Browsers and Configuration Use these steps to review the browsers and browser configurations that are supported with Epicor Web Access. 1. Verify that one of the following browsers is installed on your system. Note that Epicor application supports only the latest releases of these browsers. • Internet Explorer • Mozilla Firefox 47.xx or earlier 2. If you use Firefox, complete the following steps to change your security settings to support JavaScript popups such as the search dialog box: a. In the Navigation bar, type about:config. b. In the Filter text box, type signed.applets.codebase_principal_support. c. Double-click on the entry. The value changes from false to true. d. Restart Firefox. 3. If you use Firefox, complete the following steps to access some Microsoft plug-in files to support Window Authentication: a. In Firefox, browse to the following: http://www.microsoft.com/genuine/diag/default.aspx?displayLang=en b. Click the Start Diagnostics button. c. Follow the online instructions to add the plug-in files.
8.1.10 Set Up EWA Compression (Windows Server 2008 R2 only) Use these steps to set up compression for EWA if you use Windows Server 2008 R2. With IIS 7, compression is enabled at the site level. Mime types are enabled globally and are applied to the applicationHost.config. 1. Create a backup of the metabase. To do this: a. To create the backup, run this command: %windir%\system32\inetsrv\appcmd.exe add backup "My Backup Name" b. To restore the backup, run this command: %windir%\system32\inetsrv\appcmd.exe restore backup "My Backup Name" c. To delete the backup, run this command: %windir%\system32\inetsrv\appcmd.exe delete backup "My Backup Name" 2. Enable Compression in IIS. To do this: a. In IIS, under Default Web Site, select the web site to be enabled. b. From the available IIS features, open the Compression feature. c. Select the Enable dynamic content compression and Enable static content compression check boxes.
84
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
d. Click Apply. Exit from IIS, and save settings. 3. The EWA extensions do not need to be modified. However, if you want to apply compression to specific extensions, do the following: a. Open the file: C:\Windows\System32\Inetsrv\Config\applicationHost.config b. Locate the httpCompression section. c. Edit the dynamicTypes and staticTypes sections to control which content gets compressed. IIS6 controls by file extension, IIS7 controls by mimeType. The "*" character is a wildcard and can be used in any combination. The easiest setup is to enable all with types */*. Here are some examples of enabling selective mimetype(s): dynamicTypes: staticTypes
8.1.11 Install Crystal Reports Embedded Server 2013 (optional) If you use Crystal Reports for your report generation from Epicor Web Access you must install Crystal Reports Embedded Server 2013. Note that it must be installed on the web server that is hosting Epicor Web Access. 1. If you have a previous version of Crystal Reports Embedded Server installed, you must first uninstall it. To do this, navigate to Start > Control Panel > Programs and Features. Select the option for Crystal Reports Embedded Server and click Uninstall. Refresh the list to verify the product was successfully uninstalled. 2. To install Crystal Reports Embedded Server, log on to EPICweb Customer portal website. Navigate to Products > Epicor ERP > Downloads > Epicor ERP > Version 10.1 > Third Party Products > Crystal. You can use this link: https://epicweb.epicor.com/products/epicor-erp/downloads. Download the latest Crystal Reports embedded server file to your workstation. For example, download SAP SVR EMBD 2013 SP06 OEM Win -32B.zip. Extract the file. Move the extracted files to the report server where the file are to be installed. Do the following: a. Navigate to the extracted file folder and Data_Units > RAS sub folder. Run the Setup.exe file. b. In the Setup dialog, select your language. Click OK. c. In the Welcome dialog, click OK. d. If prompted with a prerequisite checklist, review the status of each component. Click Next. e. Review the license statement and select to accept it. Click Next. f. In the Configure Product Registration dialog, enter the Product Key. Note that the Product Key information is listed in the Epicor Keycode Request file which is located in the extracted folder. g. In the Configure Destination Folder dialog, specify the folder. Click Next.
New Installation of Epicor 10.1.500
85
Post-Installation
Epicor ERP 10.1.500 Installation Guide
h. In the Select Languages Packages dialog, select one or more language packs to install. The English language is selected by default. Click Next. i. Select which features you would like to install. Click Next. j. Click Next to confirm to start the installation. A meter displays the progress. k. When completed, click Finish. 3. You need to set the Report Directory of the Central Configuration Manager. To do this: a. Navigate to Start > SAP Business Intelligence > Crystal Reports Server 2013 OEM Edition > Central Configuration Manager. b. Right-click on Crystal Reports Server 2013 and select Stop. c. Right-click on Crystal Reports Server 2013 and select Properties. d. In the properties dialog, select Parameters. e. In Option Type, select Server. f. For the Report Directory enter the value: C:\. g. Click OK to save your changes. h. Right-click on Crystal Reports Server 2013 and select Start.
8.2 Configure Epicor Mobile Access Use these steps to configure EMA.
8.2.1 Configure Epicor Mobile Access User Use these steps to configure Epicor Mobile Access User options. 1. Open the Epicor ERP application. Navigate to System Setup > Security Maintenance and open User Account Security Maintenance. 2. Select a User Id that requires ability to use Epicor Mobile Access on supported mobile devices. Click the Options tab. 3. Select the Allow Mobile Access check box. Click Save. 4. If you want to make an Epicor application dashboard available for a mobile device, review the Create Mobile Device Dashboards in the Epicor application help.
8.2.2 Assign Data Folder Properties and Sharing Use these steps to assign required properties and sharing to the Data folder so that the ASP.NET account has write access. Note that the group names may be different for IIS7.5 and IIS8. The steps might be different based on your operating system.
86
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
1. Navigate to the EpicorMobileAccess virtual directory and locate the Data folder. For example, if your Epicor Mobile Access was installed to IIS, the default directory is: C:\inetpub\wwwroot\EpicorMobileAccess\Data. 2. Right-click the Data folder and select Properties. 3. On the Sharing tab, click the Share button. In the File Sharing window, click Share. After the share is complete, click Done. 4. On the Security tab, in the Group or user names section, select IIS_IUSRS and click Edit. 5. On the Permissions dialog, select the IIS_IUSRS user group again. 6. In the Permissions for IIS_IUSRS list, select the Allow check box for the Write line. Note The selected group now has Allow selected for Read & Execute, List folder contents, Read, and Write.
7. Click OK to apply the changes. Click OK to close the Properties window.
8.3 Configure Epicor Enterprise Search Use these steps to configure your Epicor Enterprise Search.
8.3.1 Register Enterprise Search Server Use these steps to register your Enterprise Search server, create a search index database, and deploy the Enterprise Search standalone website. This procedure assumes a new installation in which there is no previously created search index database or Enterprise Search standalone website. If you previously registered a search server and later uninstalled the components, the registered search server still appears on the tree. The connection will, however, generate an error when you attempt to use it. Right-click the outdated search server and select Remove Search Server in this case. Note If your search server is in a DMZ in front of an internal firewall, you may need to open ports for the search service administration (default is 9098) and for SQL Server access (default is 1433). 1. If your Enterprise Search application pool is configured to use Windows account for authentication, you need to set up the Epicor Search Indexer service to log on with a Windows account that has access to SQL Server hosting your database. To do this: a. Navigate to Control Panel > Administrative Tools > Services. b. In the services list, right-click the Epicor Search Indexer service and select Properties. c. On the Log On sheet, select the This Account option. d. Enter the Enterprise Search Windows account credentials as This Account login and Password. Re-type your password in the Confirm Password field and click OK. e. Right-click the Epicor Search Indexer service and select Restart. f. Open Internet Information Services (IIS) Manager. Select your server and in the Actions pane, click Restart.
New Installation of Epicor 10.1.500
87
Post-Installation
Epicor ERP 10.1.500 Installation Guide
2. Navigate to Start > All Programs > Epicor Software > Epicor Administrative Tools and select Epicor Administration Console. 3. Right-click Enterprise Search Management and select Register Search Server. The Enterprise Search Server Configuration Wizard displays. 4. Specify the server and the port where Enterprise Search is installed. To do this: a. For Name, type the name of the server where the Enterprise Search server components are installed. Click Ping Server to validate the server connection. b. For Port, enter the port number of the Enterprise Search server service. Keep the default of 9098 unless the server has been manually configured to a different port. Click Validate Service to Continue to validate the port assignment. c. When both validations are successful, click Next. 5. Specify the SQL Server instance and database that will host your search indexes. To do this: a. For Server Name, select the SQL Server instance on the server where the Enterprise Search components are installed. b. For Log on to the server, select Use Windows Authentication or Use SQL Server Authentication. c. Click Test Connection to validate the server name and credentials. d. For Enter the name for your Search Index Database, it is recommended that you select the default value. For example, select SearchIndex. e. Click Next. 6. The next page presents the option of deploying the Enterprise Search standalone website. Verify that the Do not deploy web application option is selected and click Next. 7. Confirm your selection details and click Finish. The new search server is added under Enterprise Search Management in the Administration Console tree. 8. Create the database. To do this, right-click the new search server and select Create Database. The database SearchIndexversion is created on the default SQL Server instance on the server where the Enterprise Search server components are installed. For more information on selecting the SQL Server instance used for the search database and/or selecting its name, see the "Set SQL Server for Search Indexing" topic in the Administration Console online help. 9. Create the web application. To do this, right-click the new search server and select Create Web Application.
8.3.2 Rebuild Search Index Use these steps to populate the search index with data before the index can be used. 1. Under Enterprise Search Management, go to Named search server > Search Indexes. 2. Click the search index you wish to rebuild.
88
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
3. From the Action menu, select Rebuild Index. 4. Click OK on the message box confirming rebuild start. If you chose to view indexing results the results display in your default text editor when indexing is finished. Note If, in the summary log file that displays upon generation completion, there is a BAQ that has "0 crawl rows" listed, you should navigate to the BAQ in Enterprise Search Manager, right-click the BAQ and select Properties. Then on the Fields tab, select a field to use as a primary key and select Surrogate Key. Finally, rebuild the index. Note During a rebuild, the existing index is still available and is not replaced until the new index is finished building.
5. Go to the Scheduled Tasks node and set up a schedule to rebuild the index automatically.
8.3.3 Scheduled Tasks Use these steps to set index rebuilds to automatically take place on a schedule and keep search results as current as needed. Enterprise Search results are only as current as the last search index rebuild. Once you have created a search index definition, that search index must be built regularly to freshen the index data with data from the Epicor database. To accomplish this Windows Task Scheduler is used. You can use Task Scheduler manually or let Epicor Search Manager set one of the pre-configured tasks for you. Tip When records are deleted in the database, and the search index is not yet updated to reflect those deletions, the set of records sent to be displayed as a page of results may have gaps. For example, on page 1 of the results, there might be 1, 2, 3, 4, 6, 7, 9, 10 where 5 and 8 had been deleted so no link could be made. If this happens frequently, increase the frequency of index builds.
Use Pre-defined Schedule to Rebuild All Indexes Use these steps to rebuild indexes with a pre-defined schedule. Several pre-defined schedules are available to use for the least complicated setup for index rebuilds. To use one of the pre-defined schedules complete the following steps. Note that the pre-defined schedules affect all indexes. 1. Go to the Scheduled Tasks node under the your search server name. 2. From the Actions menu, select one of the Create Hourly/Daily/Weekly Rebuild All Indexes Task. The task is created and enabled. You can right-click the task and select Disable task to temporarily suspend the task.
Schedule Search Index Rebuild Manually Use these steps to manually schedule search index rebuild. I 1. Go to the Scheduled Tasks node under the your search server name. 2. From the Actions menu, select Launch Task Scheduler. Note If you are not on the server where Enterprise Search server components are installed, at this point, from within Task Scheduler from the Actions menu, select Connect to another computer and browse to the Enterprise Search server computer.
New Installation of Epicor 10.1.500
89
Post-Installation
Epicor ERP 10.1.500 Installation Guide
3. From the Action menu, select Create Basic Task. 4. For Name, type the name you want to use and click Next. 5. Select the interval schedule you want to use and click Next. Configure the details of the schedule on the next screen and click Next. 6. Select Start a Program. Click Next. 7. For Program/script, browse to C:\Program Files\Common Files\Epicor Software Corporation\Epicor Enterprise Search, select ESCmd.exe, and click Open. For Arguments, type RunIndexer /s:indexname. For example, if your search index name is EpicorERP, you would type RunIndexer /s:EpicorERP. Click Next. 8. Click Finish. If you click on the Task Scheduler Library node you see the newly-created task.
8.3.4 Enable Search Index Use these steps to set the search index for users (by company) and to grant users access to the Enterprise Search feature. 1. Log into the Epicor ERP 10 application. 2. Navigate to System Setup > Company/Site Maintenance > Company Maintenance. 3. On the General Settings sheet, configure the URL for user access to Enterprise Search. Under Enterprise Search: a. For Search URL, type the URL for Enterprise Search user access in this format: http://SearchServerName:PortNumber/search/SearchIndexName For example, if your search server name is EpicorApps, the user access port is the default 8098, and your search index name is ERPIndex, the URL would be http://EpicorApps:8098/search/ERPIndex. Note The user access port number applied here is different from the administrative port number used when registering the search server in the administration console b. Select Global URL if you want to use this search URL for all companies in your Epicor application installation. c. Save and close Company Maintenance. 4. Open System Setup > Security Maintenance > User Account Security Maintenance. 5. For each user you want to have access to Enterprise Search, open their record, click the Options sheet, select Allow Enterprise Search, and save the record. 6. Make the following adjustment if you are using Epicor Web Access (EWA): a. Open the web.config file of your EWA installation. b. In the EnterpriseSearchURL element, enter the URL set in step 3. c. Save the web.config file.
90
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
7. Optional - The company-level search URL set in step 3 can be overridden for an individual user or globally. • Individual User Override - Under Enterprise Search at the bottom of the Options sheet, clear Use Default URL and enter an alternate URL in Search URL. • Global Override - To globally override all company level enterprise search URLs in the Epicor application installation, set a URL in the element in the .sysconfig file that is being used by your Epicor application. The default in the client folder structure is Client\config\default.sy sconfig.
8.3.5 Enable Epicor Search Anywhere for Users Use these steps to enable Epicor Search Anywhere for users. Epicor Search Anywhere is a small application controlled by an icon in the system tray that allows users to trigger Enterprise Search from any application by performing certain keystrokes. The idea behind Epicor Search Anywhere is this: users are working in any application (such as a spreadsheet, a word processing document or an email), they highlight a word, complete a certain keystroke to submit the highlighted word to Enterprise Search and get back search results. They can then copy certain results back to the application where they are working. Administrator - Prerequisites Search Anywhere users must be set up for single-sign on in the Epicor application. See your Epicor application documentation for instructions on enabling the single sign-on feature. The search server web application must be created. See the topic Create Web Application in this help system. Administrator - Distribute Search Anywhere URL to Users Search Anywhere functions on the URL for an individual search index. The administrator must distribute the Search Anywhere URL for the target index. To find out the Search Anywhere URL for a search index: 1.
In Epicor Administration Console, go to Named search server > Search Indexes.
2.
Click the search index that you want to make available to Search Anywhere users.
3.
From the Action menu select Launch Search.
4.
Click OK to use the presented URL.
5.
If you need to, add the port number of the web site to the URL.
6.
Copy the URL from the browser address box and save it for the next step.
7.
Prepare and send an email to users who will use Search Anywhere to search this index. In the email: a.
For the email message, paste the entire user setup procedure in the next section Template for Email to Users - Download, Install, and Configure Search Anywhere.
b.
In steps 1 and 4 of the procedure, substitute the URL obtained in step 6 above in place of the placeholder .
New Installation of Epicor 10.1.500
91
Post-Installation
Epicor ERP 10.1.500 Installation Guide
Template for Email to Users - Download, Install, and Configure Search Anywhere You must download Search Anywhere from the Search Anywhere site, install it, and configure it (set the Search Anywhere URL). Obtain the Search Anywhere site URL for the following procedure from your administrator. 1.
Go to .
2.
On the page, do the following: a.
Click the icon in the upper right corner.
b.
Click Run and then Run again.
c.
Click Next and then Close.
3.
On your Windows Task Bar, right-click the Epicor Search Anywhere icon in the System Tray and select Set Search URI.
4.
Enter and click OK.
5.
Right-click the Epicor Search Anywhere icon in system tray and select Help to learn about Search Anywhere and using it in your applications.
8.3.6 Re-create Search Index Definition (If Needed) Use these steps if you need to re-create Search Index Definition. 1. Right-click Enterprise Search Management > Named Search Server > Search Indexes and select Create Index. 2. Select a search template and click Next. You can select the default template when provided (for example the EpicorERP template), or you can use a search template that you have created. 3. Set up the connection to the Epicor application server: a. For Server Endpoint, enter the application server URL. Get the correct URL from the element of the .sysconfig file that points to the application server. In your Epicor application installation, .sysconfig files are located in the client\config folder. Important In the URL, use the fully qualified domain name (FQDN). Do not use localhost.
b. For Binding, select the binding type that matches the binding type set in the element of the .sysconfig file. c. For Operation timeout, adjust the wait time until an incomplete operation is aborted. The default is 300 seconds. Get the correct value from the element of the .sysconfig file.
92
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
d. For Validate WCF Certificate, select or clear this checkbox to match the value set in the element of the .sysconfig file: • Select checkbox if . • Clear checkbox if . e. For DNS Identity, enter the expected DNS server name. Based on the Server Endpoint (Endpoint Binding) setup in the application server configuration, there are two scenarios where you need to enter a value in this field: • UsernameSSLChannel Selected in Endpoint Binding - When authenticating using message-level or transport-level Secure Sockets Layer (SSL) with X.509 certificates, WCF ensures that the certificate provided during the SSL handshake contains a DNS or Common Name (CN) attribute equal to the value specified in this field. • Windows Selected in Endpoint Binding - When the service authenticates using message-level or transport-level SSL with a Windows credential for authentication, and negotiates the credential, then the negotiation passes the service principal name (SPN) so that the DNS name can be checked. The SPN is in the form host/. Get the correct DNS server name from the element of the .sysconfig file. f. For User name and Password, enter the Epicor application user credentials for accessing the application server. g. Click Test Connection to verify. h. Click Next. 4. Either select Use all available companies or Select one or more companies to define which companies are included in the index. If you select one or more companies, select the companies to use. Note Available companies are the companies to which the user chosen in the previous screen has access. When you select Select one or more companies, and you later add a company, you then have to modify the index settings to add the new company and regenerate the index to see results from the newly-added company.
5. Set up the connection to the Epicor application database: a. For Server Name, type or select the SQL Server instance that hosts your Epicor application database. b. Select Windows or SQL Server authentication. If you chose SQL Server authentication, type a SQL Server user name/password that has access to the Epicor application database. If you chose Windows Authentication, the logged-on user is used for Windows authentication. c. Click Validate Connection To Continue. When you are creating or later editing a connection, you cannot proceed until this validation step has been performed successfully. d. For Connect to Database, select your Epicor application database. e. Click Next. 6. For Name, type a name for this index and click Next. Do not use any spaces in the name. Using the template name you chose for the index might be useful.
New Installation of Epicor 10.1.500
93
Post-Installation
Epicor ERP 10.1.500 Installation Guide
7. Review the choices you made. To change any information use the Previous button. Otherwise click Finish to create the search index. 8. Next step is to populate the index with data by building it. See the topic Rebuild Search Index.
8.4 Configure Epicor Social Enterprise Use these steps to configure the components required to run Epicor Social Enterprise.
8.4.1 Log In to Epicor Social Enterprise Use these steps to log in to Epicor Social Enterprise. 1. Open an internet browser and enter http:///ESE where is the web server specified during configuration. The Please log in page displays. Your screen may look similar to the following:
2. Enter the User ID and the Password for the initial user. 3. Optionally, select the Keep me logged in check box. 4. Click Log In. The user Home page displays.
8.4.2 Create Notification Source Use these steps to create a notification source and make it available for users. A notification source defines connection to an ERP database, the URL for the Epicor application server that uses the database, the URL for Enterprise Search, and the URL for Epicor Web Access. These settings are applied to background processes that monitor database changes which require notification messages generation.
94
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
1. On the Home page toolbar, click the Menu button and select the Admin icon on the toolbar that displays. The Administration page displays. Your screen may look similar to the following:
2. Click Notification Source Administration. The Notification Sources page displays. This page provides a list of all currently configured notification sources for the social enterprise. 3. Click Create New Notification Source. The Create New Notification Source window displays. Specify properties for a new notification source: Note You might need to verify some values to specify as notification source properties. To do this, go to the client\config folder in your Epicor application installation and open the *.sysconfig file where you can find such data as the Application Server URL, Endpoint Binding type, Connection Timeout, and WCFCertValidation. a. In the Name field, enter the notification source display name for lists, profiles, and properties pages. The value in this field is also used to auto-generate the notification source ID used by the system. b. In the Description field, enter the notification source description displayed to users. The description should include such information as which ERP system the source supports. c. In the Connection String field, specify the SQL Server connection string for the source ERP database. Example Server=MyServerName;Database=MyDatabaseName; User ID=MyUserName;Password=MyPasswordName Or Example Server=MyServerName;Database=MyDatabaseName; Trusted_Connection=True The values you need for the connection string can be obtained from the web.config file located in the Server folder in your Epicor server installation. In the web.config file, locate ERPContext and use the connection string values for Data Source, Initial Catalog, User ID, and Password. Important User names, passwords, and connection strings are encrypted for storage in the social enterprise database. d. In the Application Server field, enter the URL for the Epicor ERP application server that is configured to use the source ERP database specified in Connection String.
New Installation of Epicor 10.1.500
95
Post-Installation
Epicor ERP 10.1.500 Installation Guide
Example net.tcp://localhost/ICE3 The user's Epicor application user name and password are validated against the application server when the user registers a notification source, during subsequent processing of notification subscriptions, and searching of the registered notification source. e. In the Endpoint Binding drop-down list select the same binding that was configured in the Epicor application server. The options include: UsernameWindowsChannel, Windows, and UsernameSSLChannel. Important When your Epicor ERP application server is set up to use Windows authentication, you must also do (or verify that you already have) the following to support your Epicor Social Enterprise installation: • Create a Windows domain account that links back to a system User ID with Single Sign-On feature set up and Allow Session Impersonation option selected. In Epicor ERP, create a user that maps to that Windows account. You may want to give the Windows account and the Epicor ERP user account a name that indicates their purpose; for example, EpicorSocial. When configuring Epicor Social Enterprise later in this procedure, the custom account must be used as the login account for the Epicor CDC Log Reader service and as application pool account used by the Epicor Social Enterprise web site. • Enable windows authentication for the Epicor Social Enterprise website. The Epicor Social Enterprise website by default does not turn on windows authentication and it must be turned on manually. See your Windows IIS documentation for instructions. Both the Epicor Social Enterprise configuration utility and IIS Manager can be run from the server where you have installed Epicor Social Enterprise. To run the configuration utility, on the Start menu, go to Epicor Software > Epicor Social Enterprise and click Epicor Social Enterprise Configuration. f. Specify the Connection Timeout value. g. If you use the UsernameSSLChannel endpoint binding, select the Validate WCF Certificate check box to run X.509 SSL Certificate authentication. h. If you use the UsernameSSLChannel endpoint binding, you should enter the expected Domain Name System (DNS) identity of the server in the DNS Identity field. When the system runs WCF Certificate authentication, it uses this identity value to validate the application server. i. Use the Active check box to define whether the social enterprise's Epicor CDC Log Reader service should actively check the notification source database log table. If you clear the Active check box, the log reader skips this notification source when checking for changes. Notification messages are not generated for this source until you re-select the Active check box. j. In the Enterprise Search Url field, specify the URL for the Epicor Enterprise Search server and search index that will be used by this notification source to obtain ERP data. Example If you use the Enterprise Search default 8098 port and the Epicor Social Enterprise EpicorSocialEnterpriseIndex search index name, the URL may look similar to the following: http://DomainName:8098/search/EpicorSocialEnterpriseIndex k. In the Epicor Web Access Url field, enter the URL for the Epicor Web Access (EWA) installation which opens when user clicks the Open With command in a notification message or notification source search results record. If you do not have Epicor Web Access configured, you can specify the EWA URL later.
96
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
Example http://DomainName/EpicorWebAccess l. In the Days to keep notifications field, specify for how long notification messages are kept in the system before being permanently removed when there is no related activity (replies or reposts). The default value is 90 days. Note Notification messages older than a specified time value that are reposted or are part of a conversation are not removed from the system to avoid breaking up the conversation. m. Select the Do not remove notifications check box if you want to disable deletion of any notification messages from the system. 4. Click Save Notification Source.
8.4.3 Configure Email Server Use the following steps to configure connections to POP3 and SMTP mail servers for Epicor Social Enterprise. 1. On the Home page toolbar, click the Menu button and select the Admin icon on the toolbar that displays. The Administration page displays. 2. Click either POP3 Server Configuration or SMTP Server Configuration to display the corresponding configuration window. 3. Define POP3 or SMTP server settings. To obtain the settings, review the mail server documentation or contact your mail server administrator. 4. Click Test Connection to verify the connection prior to saving. 5. Verify the Active checkbox is selected. Active must be selected for both the SMTP and POP3 email servers for email processing to function without error. 6. When done, click Save Changes. Important User names, passwords, and connection strings are encrypted for storage in the social enterprise database.
8.4.4 Configure Web Site URL Use these steps to set the Epicor Social Enterprise website public URL that will be applied in template-based emails. A valid public website URL is required for email processing to function without error. 1. On the Home page toolbar, click the Menu button and select the Admin icon on the toolbar that displays. The Administration page displays. 2. Click Web Site URL Configuration to display the Site Property dialog box. 3. In the Value field, enter the public URL for the Epicor Social Enterprise website. This URL will be applied, in template-based emails, to create links to Epicor Social Enterprise content.
New Installation of Epicor 10.1.500
97
Post-Installation
Epicor ERP 10.1.500 Installation Guide
4. Click Save Changes.
8.4.5 Configure Twitter Credentials (Optional) Use these steps to configure the credentials that enable your Social Enterprise users to search on Twitter and display columns of search results on their Social Enterprise Home page. You must have a Twitter application set up that identifies your enterprise and you must have the Consumer key and Consumer secret values from the application's OAuth settings. To create a Twitter application, go to https://dev.twitter.com/apps. 1. On the Home page toolbar, click the Menu button and select the Admin icon on the toolbar that displays. The Administration page displays. 2. Click Twitter Configuration to display the Twitter Configuration dialog box. 3. Using the OAuth settings obtained from your Twitter application: a. Paste the Consumer key value into the Key field. b. Paste the Consumer secret value into the Secret field. 4. When done, click Save Changes. 5. Test the configuration: a. Navigate to the Home page and click Search on the toolbar. b. For Search Target, choose Twitter. c. Enter a search term that you know will return results and click Search. A column of search results displays when Epicor Social Enterprise is able to access Twitter. An error message displays if there is a problem.
8.4.6 Configure Message Editing (Optional) Use these steps to disable editing of user message postings. The default configuration is enabled, which allows user to edit their posted messages. This setting is global to all users and is applied to both public and private messages. When enabled (the default), the Edit action displays in a user's existing messages and can be used to edit and repost a message. An edited message, including an Edited status icon, replaces the original in the message stream of both the sender and recipients. Disabling message editing removes the Edit action and prevents the user from editing their posted messages. 1. On the Home page toolbar, click the Menu button and select the Admin icon on the toolbar that displays. The Administration page displays. 2. Click Message Edit Configuration to display the Site Property dialog box. 3. To disable editing: • Name - This field cannot be edited. • Value - Enter false to disable editing of posted messages.
98
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
4. Click Save Changes. You can later re-enable editing by repeating this procedure and returning the Value field to true in Step 3.
8.4.7 Invite Users Use these steps to create a new user account. Note Users may also create an Epicor Social account by using any Social feature in a connected Epicor ERP. 1. On the Home page toolbar, click the Menu button and select the Admin icon on the toolbar that displays. On the Administration page, click User Management. 2. Click the Invite User button. The Invite a new user to Epicor Social Enterprise window displays. 3. In the User ID field, enter the user ID you want to associate with the account and display as an active link in messages and lists. The user ID cannot contain spaces. Once the account is created, the user cannot edit their user ID. The value you provide in the User ID field is also applied as the user's name in the initial configuration of their user profile. The user can edit their name after logging in. 4. Enter the primary Email Address associated with the account. 5. In Access Level, select Standard (default) or Administrator to specify whether the account has rights to perform administrative actions for the social enterprise. 6. Click Invite. The new account is created and an email is sent to the new user's primary email address. The email provides a link to the password setup page, where the user can establish a password and log in for the first time. Alternatively, you can click Invite & Keep Form Open. The current invitation is sent and the fields are cleared so that you can invite another user. Important User names, passwords, and connection strings are encrypted for storage in the social enterprise database.
8.5 Configure Epicor Education Module Use these steps to configure the Embedded Education Courses Client and enable the Education Module which gives you access to the Embedded Education Courses. Using the Embedded Education Courses requires a Windows Server operating system and Microsoft Internet Information Services (IIS 7.5 or higher) with the ASP.NET module enabled. Note that the Education Module must be installed in your training environment, not in your live production environment.
8.5.1 Enable Education Module Use these steps to verify that the Education Module is licensed and enabled so that you can access the Embedded Education Courses. The Education Module is licensed and enabled similarly to how you license and enable the other Epicor application modules. 1. Open your Epicor Administration Console.
New Installation of Epicor 10.1.500
99
Post-Installation
Epicor ERP 10.1.500 Installation Guide
2. In the tree view, expand your Server Management > [server] > [application server]. 3. Under your application server, select the Licensing node to list the license details in the middle pane. Double-click on your license to open the Properties dialog. Note If you purchased the Education Module license after licensing your other Epicor application modules, be sure to import your new license file.
4. In the Properties dialog, click the Modules tab. 5. Locate the EducationERPStandardAndEnterprise module name and verify that the Enabled check box is selected. Click OK. 6. After enabling the Education module, verify that you can successfully launch the Embedded Education Courses. To do this: a. Open your Epicor application. b. Access to the Education Module differs based on your selected view, either Classic or Tile: • Classic View. From the tool bar select the Education Courses (stack of books) icon. Your tool bar may look similar to the following:
• Tile View. From the Home screen, select the Help menu. From the list of options, select Education Courses. c. From the Education Courses list, select a course. Verify that the course opens successfully. If the course does not open, review your configuration instructions in the previous section and try again.
8.6 Configure Epicor Information Worker Use these steps to configure Epicor Information Worker.
8.6.1 Generate Server Components for BAQs Use these steps to generate server-side components required for the updatable Information Worker BAQs. 1. Log in to Epicor as an administrative user and navigate to System Management > Upgrade/Mass Regeneration > Updatable BAQ Maintenance 2. Click QueryID.
100
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
3. For Basic Search, in the Query ID Starts With field type zIW. 4. Click Search. Click Select All and click OK. 5. Click the List sheet. From the Actions menu, select Regenerate All. 6. Repeat Steps 1 through 5 for each company in your Epicor ERP installation.
8.6.2 Deploy Alternate Contact Data Source Use these steps to create a separate Contacts folder in Outlook for Information Worker contacts. By default, Information Worker synchronizes all contacts to the Outlook client Contacts folder. 1. Open Information Worker Configuration Manager. To do this, go to Start > Programs > Administrative Tools > Information Worker Configuration Manager. 2. In the tree view, expand the Information Worker Configuration Manager > Configurations > Epicor node. Select the Outlook node. 3. In the Outlook Options section, select the Use Alternate Contact Folder checkbox. In the activated field, enter a new folder name of hold contacts, such as Epicor contacts. Save the changes. 4. Deploy your configuration file. To do this, in the Configurations node, right-click your configuration node and select Deploy. The "Configuration deployed successfully" message appears. Click OK. 5. Log in to Outlook and import the contacts.
8.6.3 Set Up Information Worker Clients Use these steps to configure client workstations to run Information Worker. Note that the Information Worker client installation must be run with local Administrator privileges. 1. Verify the following requirements for the client workstations: a. Verify you have one of the following operating systems installed on each client workstation: • Windows 7 (SP1) x86 / x64 • Windows 8 x86 / x64 Intel Architecture b. Verify you have Microsoft .NET 4.6.1 Client Profile installed. c. Verify each client workstation has Microsoft Office 2010 (32- or 64-bit version), or Microsoft Office 2013 (32- or 64-bit version) installed. Depending on which applications you plan to use with Information Worker, install Outlook, Word and/or Excel during your Microsoft Office installation. d. Verify you have Microsoft Visual Studio 2010 Tools for Microsoft Office installed. Note that it is provided through the Epicor ERP installation. e. Optionally, install the Epicor ERP application client to enable additional functionality. 2. In your Epicor ERP installation, verify each Information Worker user is set up as an Epicor user and that the Domain and Domain ID in the user record matches the domain and login name of their Windows credentials.
New Installation of Epicor 10.1.500
101
Post-Installation
Epicor ERP 10.1.500 Installation Guide
3. Install the Epicor Information Worker Client. To do this, open the email account on the workstation. Locate the email message that includes the web address you chose when installing the Information Worker Server. If you accepted the defaults, the web address is: http://servername/informationworker. 4. Follow the instructions on the web site to install the Epicor Information Worker Client. Review the troubleshooting information on the site if necessary.
8.6.4 Troubleshooting Installation Errors Use this section to review solutions to common Information Worker Server installation errors. Problem
Cause
Possible Resolutions
During the server installation, an error displays similar to:
Install could not set Go to error email properties. C:\Inetpub\wwwroot\InformationWorker\App_Data\
"Errors setting configuration values; installation will try to complete, but you may need to manually correct configuration values."
Note: If you changed the InformationWorker portion of the above address during installation, use Notepad to edit the Configuration.xml file. Search for ErrorFormEmailAddress and change the email address value to reflect the email account you want to use. Exit Notepad and save.
During the server installation, an error displays similar to:
Anonymous access is not enabled or the Information Worker "Errors setting web site values; virtual directory is not installation will try to complete, but using the Information you may need to manually set the Worker application ASP.NET version, Directory Security, pool. and/or create an application pool."
Click Start > Run > inetmgr to open IIS manager. Go to the virtual directory you configured (default name: InformationWorker).
If you have a previous install of IW, and you are importing customers and associated contacts, an error displays similar to:
• Unsync everything in Microsoft Outlook.
"Unable to add column named 'SysRowID. This may be a reserved name in Outlook"
Data Type mismatch since SysRowID in Epicor 9 is a string and in Epicor 10 it is a GUID.
• Verify Anonymous access is enabled under Authentication. • Under Basic Settings verify the Information Worker app pool is selected.
• Delete the Epicor folder in Microsoft Outlook. • Close Microsoft Outlook. • Navigate to the isolated storage files for Information Worker. • Delete the contents of the Schema folder. • Log back into Microsoft Outlook and try again.
8.7 Configure Epicor Sharepoint Publisher For information on how to setup and configure Epicor Sharepoint Publisher for use with your Epicor ERP 10 application, you can use the Epicor ERP online help. In the online help, navigate to Extension and Companion Programs > Epicor SharePoint Publisher. Examples of topics include: • Create a Document Library and Web Part Page • Add a Web Part • Data Synchronization
102
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
• Update Data Using the SharePoint Dashboard • Web Dasher Utility • BPM Informational Messages
New Installation of Epicor 10.1.500
103
Post-Installation
Epicor ERP 10.1.500 Installation Guide
Chapter 9: Install Epicor ERP 10.1 Client on a Workstation Use this chapter to install the Epicor ERP 10.1 client on your workstation. New customers adding an initial client workstation and existing customers adding an additional client workstation should use the following instructions to install the Epicor ERP 10.1 Client.
9.1 Install .NET Framework 4.6.1 or Later (Client) Use these steps to download and install Microsoft .NET Framework 4.6.1 or later onto your workstation. The .NET Framework 4.6.1 or later is required for your Epicor ERP 10.1 application. 1. Go to the Microsoft download center for .NET Framework 4.6.1 or later. You can use this link: https://ww w.microsoft.com/en-us/download/details.aspx?id=49982 2. Click the Download button to download the .NET 4.6.1 or later application. 3. Use the Microsoft instructions provided to guide you through the installation process.
9.2 Install Crystal .NET SDK Runtime (EWA Client optional) If you use Crystal Reports for your report generation from Epicor Web Access you must install Crystal .NET SDK Runtime on your workstation. Note that Crystal Reports Embedded Server must already be installed on the web server that is hosting Epicor Web Access. 1. If you have a previous version of Crystal .NET SDK Runtime installed, you must first uninstall it. To do this, navigate to Start > Control Panel > Programs and Features. Select the option for Crystal .NET SDK Runtime and click Uninstall. Refresh the list to verify the product was successfully uninstalled. 2. To install Crystal .NET SDK Runtime, log on to EPICweb Customer portal website. Navigate to Products > Epicor ERP > Downloads > Epicor ERP > Version 10.1 > Third Party Products > Crystal. You can use this link: https://epicweb.epicor.com/products/epicor-erp/downloads. Download the latest Crystal .NET SDK Runtime file to your workstation. For example, download SBOP BI PLATFORM 4.1 SP06 SDK WinRT.zip. Extract the file. Move the extracted files to the report server where the file are to be installed. Do the following: a. Navigate to the extracted file folder. Extract the file in that folder. Navigate to the Data_Units > BusinessobjectsRuntime sub folder. Select either 32bi t or 64bit. Run the Setup.exe file. b. In the Welcome dialog, click Next. c. Review the license statement and select to accept it. Click Next. d. If prompted, confirm the installation. Click Next. e. When completed, click Finish.
104
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
9.3 Install Epicor ERP 10.1 Client Software Use these steps to install the latest Epicor ERP 10.1 client software on your client workstation. Important You must perform these steps after the 10.1.500.x AppServer has been created and configured. Setting up the AppServer updates the *.sysconfig files necessary for the Epicor Client installation and update. 1. Make sure you are logged in as the Local Administrator on the client workstation. 2. On your client workstation, use a file explorer to navigate to the ClientInstaller folder on the server where your Epicor application is installed. For example, navigate to \\\Epicor\ERP10\ERP10.1.500.0\ClientDeployment\ClientInstaller. Double-click to run the E10Client.exe file. 3. The Welcome window appears for the client installation. Click Next. 4. The Client Destination Folder window appears. Specify the following paths. a. For the Install Epicor ERP Version 10.1 Client location, accept the default location, or click Change to browse and select a different location. b. For the Share Location, verify the network path is the correct path to the client installer, such as \\\ERP10.1.500.0deployment. This folder should not be deleted from the server. c. Click Next. Your dialog may look similar to the following:
New Installation of Epicor 10.1.500
105
Post-Installation
Epicor ERP 10.1.500 Installation Guide
5. The Shortcut Creation window appears. Select the check boxes for the client shortcuts that you want to create. Note: If an Auto* shortcut is displayed, do not select it. Select the Create Desktop Icons check box to create the Epicor ERP 10 and MES icons on your desktop. Click Next. Your dialog may look similar to the following:
6. The Ready to Install window appears. Click Next. 7. The client installation begins. A status bar displays the progress of the installation. When the installation is complete, click Finish. If prompted, reboot the workstation. 8. You can now log in to the Epicor ERP client. Note that when you log in for the first time, the client files are extracted. This may take a few minutes. 9. After running the E10client.exe for the first time, the silent.bat file is created and it stores the parameter information that was entered for the prompts. If you want to install the client on additional workstations, use the following steps to run the silent.bat file that installs the client without any manual intervention. a. Navigate to the client installer location on the server. For example, go to \\\ERP10\ERP10.1.500\ClientDeployment\ClientInstaller. b. To run the client installation, double-click the silent.bat file. The batch file runs the E10Client.exe file without requiring any manual intervention to answer prompts. Note If you move the E10Client.exe file to a different directory, you must also edit the silent.bat run command to specify the new path. For example, if you move the file to c:\epicor, you must update the path from E10Client.exe /s to \\server\epicor\clientinstaller\E10Client.exe /s. Note The silent.bat file includes the following flags: "/s" initiates the silent install, "Silent" confirms the use of the silent install, "Desktopico" indicates if the installer creates Desktop icons,
106
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Post-Installation
"SilentInstalls" is the name of the folder the shortcuts will be copied, "TargetDir" is the directory for the client to be installed, "ServerLoc" is the deployment where to pull the client.
New Installation of Epicor 10.1.500
107
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
Part IV: Supplemental Installations This part of the guide explains how to complete your Epicor ERP 10.1 application set up. Complete the sections appropriate for the supplemental components and products you intend to use.
Chapter 10: Install Microsoft Service Bus 1.1 Use this chapter to download and install Microsoft Service Bus for Windows Server 1.1 from the Microsoft Download Center website. The Microsoft Service Bus for Windows Server is only required if you use Multi-Company functionality and you process multi-company transactions between more than one database. The Microsoft Service Bus for Windows Server is not required if you process multi-company transactions within the same database and you use Multi-Company Direct functionality. It is recommended that you first install Microsoft Service Bus 1.1 in a test environment. After verifying that your Service Bus installation has connectivity to your Epicor ERP 10 environment and you can successfully transfer data, it is recommended that you then install Microsoft Service Bus 1.1 in your production environment.
10.1 Install Service Bus in a Test Environment Use this section to install Microsoft Service Bus for Windows Server 1.1 from the Microsoft Download Center website into a test environment. The following steps to install and configure the test environment use a basic configuration so that you can test your connectivity between the Service Bus and your Epicor ERP 10.1 application. 1. You must identify a user account to use for the Service Bus installation. To do this, find the user account that has the ability to access the following: • Application Server • SQL Server • Server where Service Bus will be located Note that you will enter this user account information during the configuration of Service Bus in step 5 below. It is required that you enter the user credentials for Service Bus that are required by your Windows security setup. For example, your user credentials for Service Bus may match your application server user, or your user credentials may be included in a Windows security group that has access to your application server. 2. Go to the Microsoft Download Center. Search for Microsoft Service Bus for Windows Server 1.1. You can use this link: https://msdn.microsoft.com/en-us/library/dn282144.aspx 3. To install Server Bus installation and test connectivity, select the Getting Started with Service Bus for Windows Server option.
108
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
4. To install the product, follow the instructions on the MSDN page in the Install Service Bus for Windows Server section. In this section, do the following: • Run the Web Platform Installer. • Search and select to install Windows Azure Pack: Service Bus 1.1. • Follow the prompts to download and install the product. 5. To configure the product, follow the instructions on the MSDN page in the Configure Service Bus for Windows Server section. Additional details are provided below: • Create a New Farm. Create a new farm using default settings if you do not already have an existing farm (cluster of servers). • SQL Server Instance. Note that it defaults to the first SQL Server instance it finds. You may need to change the default to a later version. Click Test Connection to verify. • Configure Service Account. Enter user credentials that you will use to run the Service Bus services. Refer to the user account identified in step 1 above. Click Test Connection to verify. • Certificate Generation Key. Enter a valid key combination. For example, Epicor1234. • After you click Next, the Summary dialog appears. It is recommended that you take screen captures of the entire dialog so that you can use the information later when you configure Multi-Company functionality within the Epicor ERP 10.1 application. The Summary dialog may look similar to the following:
New Installation of Epicor 10.1.500
109
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
• Click Apply (checkmark). The configuration process is applied and the operations are listed as completed when finished. If any part of the configuration process fails, you must re-start the wizard to run the configuration again. 6. Verify that the Service Bus databases were successfully created. To do this, connect to your SQL Server instance that you used during the installation. Confirm that the following databases were created: • SbGateway Database • SbManagementDB • SbMessageContainerXX (where XX is the number of databases you specified during the configuration). 7. Verify your Service Bus services and application pool user. To do this, on your server: a. Navigate to Start > Control Panel > Administrative Tools > Services. Verify that the following services are Started: • Service Bus Gateway • Service Bus Message Broker • Service Bus Resource Provider • Windows Fabric Host Service b. For each service, verify that the Log On As user is the Configure Service Account defined during the configuration of Service Bus. 8. Enter your Service Bus Connection information into your Epicor ERP application. To do this: a. Open your Epicor ERP 10.1 application. b. Navigate to System Setup > External System Integration > Setup > External System Maintenance. c. Click the External System button. Click Search. d. Select the MULTI record with Transfer Method = SERVICEBUS. e. Locate the Summary dialog screen capture from step 5 above. Enter the Service Bus Connection fields: • Server FQDN or Azure URI. Enter the FQDN (Fully Qualified Domain Name) for the server. • Namespace. Enter the Service Bus namespace value. • TCP Runtime Port. Enter the port listed on your Summary screen capture. • HTTP Management Port. Enter the port listed on your Summary screen capture. f. Click Save. g. Click Test Connection to verify. If the connection is successful, click OK. If an error message appears, review the information. Resolve the error and try again. 9. It is recommended that you now install Service Bus Explorer 2.1.3. Service Bus Explorer provides a connection to your Service Bus 1.1 on-premise installation in order to view the queues that the Multi-Company Server Process creates for sending and receiving messages between companies. This tool is maintained by a Microsoft developer and is available as a download from OneDrive. To download the tool:
110
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
a. Go to the OneDrive shared location. To do this, click this link: https://onedrive.live.com/?authkey=%21 ANNpNeRFbU7TuIQ&cid=09DBA4A06B360A65&id=9DBA4A06B360A65%215890&parId=9DBA4A06 B360A65%212210&action=locate . b. Select the ServiceBusExplorer2.1.3.zip file. Save the file to your local machine. c. Go to the location where you downloaded the zip file. Extract the file. The ServiceBusExplorer2.1 folder is extracted. d. In the ServiceBusExplorer2.1 folder, navigate to the bin > debug folder. Verify that the ServiceBusExplorer.exe file is located in the folder. If you use desktop icons for ease of access, right-click on the file and select Send To > Desktop. Note that you will run the Service Bus Explorer when you complete the configuration steps using the Multi-Company Technical Reference Guide. Note Additional information on Microsoft's development of the Service Bus Explorer tool is available on the Microsoft MSDN site. You can click this link:https://blogs.msdn.microsoft.com/paolos/2015/0 3/02/service-bus-explorer-2-6-now-available/.
10. You now must complete your Multi-Company functionality setup. To do this, use the Multi-Company Technical Reference Guide. The guide is available within the Epicor ERP 10 online help under the Multi-Site Management > Working With > Multi-Site Technical Reference Guide topic. You can also access the guide from the EPICweb Documentation > Technical Reference Guide site.
10.2 Install Service Bus in a Production Environment Use this section to install Microsoft Service Bus for Windows Server 1.1 from the Microsoft Download Center website into your production environment. The following steps to install and configure the production environment require you to know specific information, such as your Windows user credentials, so that you can test your connectivity between the Service Bus and your Epicor ERP 10 application. 1. On your production environment, repeat the steps in the previous section "Install Service Bus in a Test Environment". The steps may include: • Identify a user account to use for the Service Bus installation • Using the instructions on the MSDN page, complete the "Getting Started with Service Bus for Windows Server" section • Using the instructions on the MSDN page, complete the "Install Service Bus for Windows Server" section • Using the instructions on the MSDN page, complete the "Configure Service Bus for Windows Server" section • Verify that the Service Bus databases were successfully created • Verify your Service Bus services and application pool user • Enter your Service Bus Connection information into your Epicor ERP application • Install Service Bus Explorer 2.1.3. 2. As you did with your test environment, you now must complete your Multi-Company functionality setup. To do this, use the Multi-Company Technical Reference Guide. The guide is available within the Epicor ERP 10 online help under the Multi-Site Management > Working With > Multi-Site Technical Reference Guide topic. You can also access the guide from the EPICweb Documentation > Technical Reference Guide site.
New Installation of Epicor 10.1.500
111
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
Chapter 11: Install Languages Use this chapter to install language files, if you want to use other languages than English on your Epicor ERP application.
11.1 Install Language File Use these steps to download and install Epicor ERP 10.1 Language File. 1. Download the language XML file to your workstation: a. Log on to EPICweb and go to the customer portal website. Navigate to Products > Epicor ERP version 10 > Downloads. You can use this link: https://epicweb.epicor.com/products/epicor-erp/downloads. b. Navigate to Epicor ERP > Version 10.1 > Translations > . c. Select and download the language XML file to your workstation. 2. Install language file: a. Right-click on your Epicor ERP application shortcut and select Run as administrator. b. Navigate to System Setup > System Maintenance. Open the Language Maintenance program. c. Enter the ID of the language you want to load. If you do not know the language ID, click the Language ID button to use the search function. Clear the Installed check box, then click Search. Note To create a new Language ID, from the New menu, select New Language Name.
d. From the Actions menu, select Import Translations. e. In the Import Translations window, click the browse button next to the Translation File field and navigate to the downloaded language file. Select the file and click Open. f. Click Import. The import process starts. You must wait till the process finishes prior to performing the next step. g. In the Language Maintenance window, from the Actions menu select Rebuild Translation Table. h. Close the Epicor application and open it again.
11.2 Change Language Settings Use these steps to change language settings after installing the language file. Note To change language settings, you must run the Epicor ERP application as Administrator.
1. Change the language in the current session: a. In the Epicor ERP main application menu, from the Options menu select Change Language.
112
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
b. Select the installed language. c. Click OK. 2. Optionally, change the language for a user: a. In Epicor ERP, go to System Setup > Security Maintenance and open the User Account Security Maintenance program. b. Click the User ID button. Search and select the ID of the user for which you want to change language settings. c. On the Details sheet in the Language field, select the installed language. d. Click Save.
New Installation of Epicor 10.1.500
113
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
Chapter 12: Configure Country Specific Functionality (CSF) Use this chapter to find additional information about CSFs, including which CSFs are available in Epicor ERP 10.1, additional post-migration steps, and instructions install CSF Language. CSFs are part of the Epicor Installer. Use the steps in the Import License File and Enable Modules section of this guide to enable CSFs for required countries using the Epicor Administration Console. You can then navigate to the EPICWeb Downloads portal to download supplemental files for Epicor 10.1 CSF, such as Functionality Guides and CSF Language Translations. Note that CSF packages from previous Epicor versions are not compatible with Epicor ERP 10.1.
12.1 Review CSFs in Epicor ERP 10.1 Use this section to review the CSFs that are available in Epicor ERP 10.1. Note You can enable multiple CSFs on one Epicor installation with any number of application servers/databases. Only one country can be activated for a company. Note CSF posting rules are derived from the Extended posting rules, not the Standard posting rules. Functionality included in Standard posting rules may not be available in the CSF posting rules. Country Specific Functionality for the following countries are available in Epicor ERP 10.1. Argentina (AR)
Germany (DE)
Romania (RO)
Australia (AU)
India (IN)
Singapore (SG)
Belgium (BE)
Japan (JP)
Sweden (SE)
China (CN)
Malaysia (MY)
Switzerland (CH)
Colombia (CO)
Mexico (MX)
Taiwan (TW)
Czech Republic (CZ)
Netherlands (NL)
Thailand (TH)
Denmark (DK)
New Zealand (NZ)
United Kingdom (GB)
Estonia (EE)
Norway (NO)
United States of America (US)
Finland (FI)
Peru (PE)
Vietnam (VN)
France (FR)
Poland (PL)
Country Specific Functionality for the following countries are not available in Epicor ERP 10.1. Russia (RU)
South Korea (KR)
Turkey (TR)
12.2 Additional Post-Migration Steps for CSFs After the installation or migration to Epicor ERP 10.1 refer to the Country Specific Functionality Guides for any additional steps that can be required to set up your CSFs in Epicor ERP. The functionality guides are located within the Epicor application online help and also on the EPICweb Customer portal website. To access them from EPICweb, navigate to Products > Epicor ERP version 10 > Documentation. Expand your specific release and then expand Deliverable = Country Specific Functionality to display the list of guides.
114
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
12.3 Install CSF Language File Use these steps to download and install the language file for your Country Specific Functionality (CSF). The CSF language must be installed after the CSF functionality has been enabled and configured. These steps are common for all CSF packs, all versions of builds and of translations. You can use any translation version with any build version. If you are using an old version of the Epicor build or CSF pack, and translations are not available for the corresponding branch on the CSF download portal, you can import translations from the latest build branch. Note You will have a proper CSF translation installed only if you have imported both standard and CSF translation files. Refer to the Install Languages section earlier in this guide for instructions on how to install standard translation file. 1. Navigate to Epicor ERP > Version 10 > Country Specific Functionality > . Download the CSF language XML file. 2. Navigate to System Setup > System Maintenance and open the Language Maintenance program. 3. Enter the ID of the language you want to load. If you do not know the language ID, click the Language ID button to use the search function. Clear the Installed check box, then click Search. Note To create a new Language ID, from the New menu, select New Language Name.
4. From the Actions menu, select Import Translations. 5. In the Import Translations window, click the browse button next to the Translation File field and navigate to the downloaded CSF language file. Select the file and click Open. 6. Click Import. The import process starts. You must wait till the process finishes prior to performing the next step. 7. In the Language Maintenance window, from the Actions menu select Rebuild Translation Table. 8. Close the Epicor application and open it again. The CSF language file is now installed.
New Installation of Epicor 10.1.500
115
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
Chapter 13: Install Performance and Diagnostic Tool Use this chapter to install Performance and Diagnostic Tool. You can use the Epicor Performance and Diagnostic Tool to analyze Epicor logs to measure performance from both the client and the server. More information on the tool is available in the Performance Tuning Guide which is available from the Epicor ERP 10.1 Help. Use the information in the guide to run the tool. Use these steps to install the Epicor Performance and Diagnostic Tool. 1. In the Epicor Administration Console tree view, navigate to Server Management > [server] > [application server]. Your screen may look similar to the following:
2. Click the Performance and Diagnostic Tool button. Click Yes to confirm the installation. 3. In the Browse For Folder dialog, select the folder path to the installation files for the application server. For example, select C:\Epicor\[product]\[product version]. Click OK.
116
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
Note If you have installed an update to the base Epicor ERP 10.1 application, for example, Epicor ERP 10.1.400.x, you must use the updated installer. For example, go to C:\Epicor\[product]\[product version]\Updates\[update version]. Your screen may look similar to the following:
4. On the Performance and Diagnostic Tool Setup welcome dialog, click Next. 5. On the Choose folder dialog, accept the default installation path of select a different location in the tree. Click Next. 6. Accept the default Program group name or enter a name you want to use and define the installation scope. You can select the Create shortcuts for all users of this computer or the Create shortcuts just for me option. Click Next. 7. Click Next on the confirmation dialog. When the installation is complete, click Finish. 8. To open the Performance Diagnostic Tool, double-click the shortcut that was created on your desktop. 9. From the Help menu, select the help option to open the Performance Tuning Guide. Use the information in the guide to run the tool.
New Installation of Epicor 10.1.500
117
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
Chapter 14: Configure Application Request Routing Application Request Routing (ARR) extends Internet Information Services (IIS). This extension causes a server farm to also run as a load balancer between application servers. When ARR is installed, the server farm can route incoming message calls to multiple application servers, improving network performance and load distributes to an application server with the capacity available to process it. ARR works with several protocol binding options. This section of the guide explores how you implement ARR with the HttpsBinaryUserNameChannel binding and the HttpsOffloadBinaryUserNameChannel binding. To use other bindings with ARR, you can follow a similar process. These instructions also describe how you set up ARR in your test environment and in your live environment. This next graphic displays how you load balance your live system using the HttpsOffloadBinaryUserNameChannel protocol binding: the client sends calls to the ARR Server, and then the ARR Server distributes the calls to either Server 1 or Server 2. The connection is secured through valid signed certificates. You define which calls to send each server by creating rules.
14.1 Install and Configure Application Request Routing Use these steps to install and add the Application Request Routing (ARR) extension to Internet Information Services (IIS). 1. On your server machine, navigate to http://www.iis.net/downloads/microsoft/application-request-routing, download and install the ARR extension (if you do not have it installed). 2. Navigate to http://www.iis.net/downloads/microsoft/url-rewrite, download and install the URL Rewrite extension (if you do not have it installed). 3. Enable the Management Service feature in Internet Information Services (IIS) Manager (if you do not have it enabled): a. Launch the Server Manager. b. From the Main Menu, click Add roles and features. c. In the In the Before you begin dialog, click Next. d. In the Select installation type dialog, select the Role-based or feature-based installation option and click Next. e. The Select destination server step displays. Click the Select a server from the server pool radio button option, select the server, and click Next.
118
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
f. In the Select server roles dialog, expand the Web Server (IIS) > Management Tools node. Select the Management Service option. Click Next. g. In the Select features dialog, select which features you need. Click Next. h. Review your installation selections. If you are ready, click the Install button. 4. Set up remote connections to your servers. To do this: a. On your server machine, launch IIS Manager. b. Select your Server and double-click the Management Service icon. c. Select the Enable remote connections check box. In the Actions pane, click Apply. d. From the tree view, click the Start Page icon. e. From the Connection Tasks pane, select the Connect to a server… option. f. On the Connect to Server dialog, enter the full Server name and click Next. g. The wizard indicates whether a new connection was successful. Click Finish. h. Repeat steps D-F to add all the servers you need to load balance. i. When you finish, for each added server, repeat steps B-C to enable remote connections on all servers. 5. Connect Application Request Routing (ARR) to your servers. To do this: a. Within the IIS Manager, expand the ARRServer > Server Farms node. b. Right-click this node and select the Create Server Farm option. Click Yes to the Rewrite Rules warning message to create a default rule for the farm. Your screen may look similar to the following:
c. The new server farm displays as a node on the tree view. d. Add the servers you need to the new web farm. 6. Increase your Proxy Time-Out Value. To do this: a. On the ARR server, expand the Server Farms node. Select Farm. b. In the middle pane, double-click the Proxy icon. c. In the Proxy dialog, change the value of Time-out (seconds) to 10200 .
New Installation of Epicor 10.1.500
119
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
d. From the Actions menu, select Apply to save the change.
14.2 Create Certificates Use these steps to create certificates which secure and authenticate the connection between the clients and the servers. During testing you can use self-signed certificates. However when you implement ARR in your live production environment, these certificates must be valid and signed by a certificate authority. A certificate is created that connects to the ARR Server location; for example (https://[ARRServerName]) Note When you use the HttpsOffloadBinaryUserNameChannel binding, the calls transport through HTTP and a certificate is not needed to communicate with the servers. 1. While you set up the Epicor application in your test environment, you can create self-signed certificates. Use these temporary certificates to ensure your network is secure and has optimal performance. a. On your server machine, launch the Internet Information Services (IIS) Manager. b. From the tree view, select the ARR Server. Then from the middle pane, select Server Certificates. c. In the Actions pane of the Server Certificates dialog, click the Create Self-Signed Certificate option. d. In the Specify a friendly name for the certificate field, enter a name for the test certificate. Be sure this name easily identifies the purpose for the certificate. e. Select a certificate store for the self-signed certificate. Available options include: • Personal • Web Hosting f. Click OK. You can use this self-signed certificate within your test environment. Refer to the Add a Certificate section later in this guide for details on how to add this certificate to your server. 2. When you are ready to implement ARR in your live production environment, you must use valid signed certificates. To do this, you first request a certificate from a certificate authority and then comple the certificate request. a. On your server machine, launch the Internet Information Services (IIS) Manager. b. From the tree view, select the ARR Server. Then from the middle pane, select Server Certificates. c. In the Actions pane of the Server Certificates dialog, click the Create Certificate Request option. d. The Request Certificate wizard displays. In the Distinguished Name Properties step, enter details about your organization. Specify the following data: • Common name • Organization • Organizational unit • City/locality • State/province • Country/region
120
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
Once you have entered these details, click Next. e. The Cryptographic Service Provider Properties pane displays. From the Cryptographic service provider drop-down list, select from which authority you want to receive the certificate. f. Enter a Bit length for the encryption key. This value determines the security strength of the certificate. A higher value will make the certificate more secure, but it will also impact system performance. The default value is 1024. Click Next. g. In the File Name wizard, enter a name that helps you identify the certificate. For example, enter ARRCert. Click Finish. h. The certificate authority generates the certificate for you. When you receive it, return to the IIS Manager and select the Server Certificates option. i. In the Actions pane, click the Complete Certificate Request option. j. In the Complete Certificate Request dialog, click the Browse (…) button next to the File name containing the certification authority's response field. k. Enter a Friendly name for the certificate. This value helps you locate the certificate in your certificate store. l. Use the Select a certificate store from the new certificate drop-down list to indicate where you want to place this certificate. Available store options include: • Personal • Web Hosting m. Click OK. The .CER file is saved in the store you indicated. You can now use this valid certificate with your server. Refer to the Add a Certificate section later in this guide for details on how to add this certificate to your server.
14.3 Set Up HttpsOffloadBinaryUserNameChannel Server Use these steps to set up your servers for the HttpsOffloadBinaryUserNameChannel protocol binding. When you use the HttpOffloandBinaryUserNameChannel protocol binding, you need to configure the system to use this binding and then set up the ARR Server to use HTTPS. Your application servers will then use the HTTP protocol binding, and not an HTTPS protocol binding. 1. Update the web.config file on each server. All of the load balanced servers must use the HttpsOffloadBinaryUserNameChannel binding. a. On your server machine, open the web.config file. For example, navigate to C:\Epicor\ERP10\Server. b. Set up the scheme setting to use the HttpsOffloadBinaryUserNameChannel binding: c. Uncomment this behavior node:
New Installation of Epicor 10.1.500
121
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
d. Save and exit the web.config file. e. Repeat these steps on each server that you want to interact with ARR. 2. Define the HTTPS binding values on your ARR Server: a. Within the IIS Manager, expand the [YourServerName] > Sites > Default Web Site node. b. Right-click this node and select the Edit Bindings option. c. In the Site Bindings dialog, select the https type. The buttons activate on the right side of this dialog. Note If the https type is not available in the list, use Windows Online Help for information on how to add it. d. Click the Edit button. In the Edit Site Binding dialog, select the IP address for the site binding. e. For the Port, specify a port for the connection. For example, enter 443. f. Enter the Host name for the server. g. Optionally, select the Require Server Name Indication check box. h. From the SSL Certificate drop-down list, select the IP address that will use the certificate. i. Now select the certificate. Click the Select button. j. The available certificates appear on the Select Certificate dialog. Notice you can also search for certificates. Select the certificate you want to use and click OK. k. Click OK in the Edit Site Binding dialog. l. Close the Site Bindings dialog. 3. Activate HTTPS on the ARR server: a. Within the IIS Manager, right-click the [YourServerName] icon on the tree view and select Stop. b. After the server has stopped, right-click the [YourServerName] icon on the tree view again and select Start. c. Verify the server can open without any errors. Launch your browser and navigate to the SessionMod.svc file. For example, navigate to https://[YourServerName]/[YourEpicorInstallation]/Ice/Lib/SessionMod.svc.
14.4 Set Up HttpsBinaryUserNameChannel Server Use these steps to set up your servers for the HttpBinaryUserNameChannel protocol binding. When you use the HttpBinaryUserNameChannel protocol binding, you configure the system to use this binding and disable the SSL OFFLoad function. 1. Update the web.config file on each server. All of the load balanced servers must use the HttpsBinaryUserNameChannel binding. a. On your server machine, open the web.config file. For example, navigate to C:\Epicor\ERP10\Server.
122
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
b. Set up the scheme setting to use the HttpsBinaryUserNameChannel binding: c. Save and exit the web.config file. d. Repeat these steps on each server that you want to interact with ARR. 2. For the HttpsBinaryUserNameChannel protocol binding, data transactions use HTTPS instead of HTTP. To change this, disable the SSL OFFload function within the routing rules for the ARR Server. a. Within the IIS Manager, expand the Server Farms > ARR node. b. On the middle pane, select the Routing Rules icon. c. On the Routing Rules dialog, clear the Enable SSL offloading check box. A new ARR rule is automatically created and placed at the beginning of the URL rewrite rules. This new rule contains https:// at the beginning of its action URL. The request will now run as HTTPS on the application server.
14.5 Configure Application Servers Use these steps to configure your application servers for using the HTTPS binding. You create or update the applications servers within the Epicor Administration Console. This program controls how the Epicor application interacts with the system, so it does not directly connect to AAR. Because of this, you set up the application servers to interact with the Epicor Administration Console in a different way from how the web farm interacts with the system. To do this, set up your application servers to use the HttpsBinaryUserNameChannel protocol binding. This protocol is an intermediary binding that offloads the Secure Sockets Layer (SSL) both before and after the system can use the HTTPS binding. 1. Navigate to Epicor Administration Console. 2. In the tree view, select your Server Management > [server] > [application server]. 3. In the Actions pane, click Application Server Configuration. 4. Navigate to the Application Server Settings sheet. 5. From the Endpoint Binding drop-down list, select the HttpsBinaryUsernameChannel binding option. 6. Click Deploy. The application server now uses the HttpsBinaryUsernameChannel protocol binding. 7. Repeat these steps for each application server you wish to load balance.
New Installation of Epicor 10.1.500
123
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
14.6 Add Certificates These steps to add certificates to your live and test environments.
14.6.1 Add Certificate for Default Website Use these steps to add a certificate to use for Default Website in your live or test environment. 1. On your server machine, navigate to IIS Manager. 2. Expand the [ARRServerName] > Sites node. Right-click the Default Web Site node and select the Edit Bindings option. 3. In the Site Bindings dialog, select the https type. 4. Click the Edit button. On the Edit Site Binding dialog, select the IP address for the site binding. 5. In the Port field, enter a port for the connection. For example, enter 443. 6. Enter the Host name for the server. 7. If you need, select the Require Server Name Indication check box. 8. From the SSL Certificate drop-down list, select the IP address that will use the certificate. 9. Click the Select button. 10. The available certificates display in the Select Certificate dialog. Notice you can also search for certificates. Select the certificate you want to use and click OK. 11. Click OK in the Edit Site Binding dialog. The default web site for the ARR Server now uses the valid certificate you selected. If you are setting up your live environment, your system is now load balanced using Application Request Routing. However if you are using self-signed certificates in your test environment, you need to complete the additional tasks described in the next section.
14.6.2 Add Self-Signed Certificates (Test Environment) Use these steps to add self-signed certificates to your test environment. To use self-signed certificates in your test environment, the certificates on the ARR Server need to be exported. You then import these certificates into the client machines 1. Export the self-signed certificate from the ARR Server. Important You can only export public key certificates (.cer files). Do not distribute self-signed certificates with private keys (.pfx files) between clients. a. On your server machine, launch the IIS Manager. b. From ARR Server, select Server Certificates. c. In the center pane of the Server Certificates dialog, right-click the self-signed certificate you wish to export and select the Export option.
124
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
d. In the Export Certificate dialog, indicate the directory path where you want to export the self-signed certificate. Click the Browse (…) button next to the Export to field. e. In the Specify save as file name dialog, navigate to the directory path and folder you want to contain the export file. f. Enter a file name for the self-signed certificate. g. For the file type, select the *.* wildcard option. Click Open. h. Enter a Password and then enter this password again in the Confirm Password field. Click OK. The self-signed certificate (.cer file) is exported to your selected directory file location. 2. Import the self-signed certificate from the ARR Server into the Local Computer store on the client machines. This creates a secure connection between the client machines and the ARR Server in your test environment. a. On your client machine, from Control Panel, launch the Certification Manager. b. In the tree view, expand the Trusted People > Certificates node. Right-click the Certificates node and select the All Tasks > Import option. c. The Welcome step of the Certificate Import Wizard explains the purpose of the wizard. Click Next. d. On the File to Import step, click the Browse (...) button to find and select the self-signed certificate (.cer file). Click Next. e. Enter a Password for the certificate and click Next. f. Review your selection and click Finish. g. Repeat these steps on each client within your test environment. 3. Verify each client installation uses the correct connection to the server. To do this, update the .sysconfig file used to launch the client. a. Using your explorer, navigate to the config folder on your client installation. For example, C:\Epicor \[EpicorVersion]\Client\config. b. Open the .sysconfig file in a text editor like Notepad. c. Update the following settings: • If you use HttpsOffloadBinaryUserNameChannel, enter • If you use HttpsBinaryUserNameChannel, enter
d. Save the .sysconfig file. e. Now launch the Epicor client to verify it displays. f. Repeat these steps on each client in your test environment.
New Installation of Epicor 10.1.500
125
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
4. If you use the HttpsBinaryUserNameChannel protocol binding, you next create self-signed certificates on each server machine. Because your test environment uses an HTTPS protocol, the system needs these certificates to ensure the security of the connection. a. On your server machine, launch IIS Manager. b. Create a self-signed certificate for the test environment. From the tree view, select the [YourServerName] node. Then from the middle pane, select Server Certificates. c. In the Actions pane of the Server Certificates dialog, click the Create Self-Signed Certificate option. d. In the Specify a friendly name for the certificate field, enter a name for the test certificate. Be sure this name easily identifies the purpose for the certificate. e. Now select a certificate store for the self-signed certificate. Available options: • Personal • Web Hosting f. Click OK. g. Repeat these steps for each server you want to load balance in your test environment. 5. Export the self-signed certificate you created on each server machine. Important You can only export public key certificates (.cer files). Do not distribute self-signed certificates with private keys (.pfx files) between clients. a. In IIS Manager, from the [YourServerName] node, select Server Certificates. b. In the center pane of the Server Certificates dialog, right-click the self-signed certificate you wish to export and select the Export option. c. In the Export Certificate dialog, indicate the directory path where you want to export the self-signed certificate. Click the Browse (…) button next to the Export to field. d. In the Specify save as file name dialog, navigate to the directory path and folder you want to contain the export file. e. Enter a file name for the self-signed certificate. f. For the file type, select the *.* wildcard option. Click Open. g. Enter a Password and then enter this password again in the Confirm Password field. Click OK. The self-signed certificate (.cer file) is exported to your selected directory file location. h. Repeat these steps for each server you want to load balance in your test environment. 6. Import the server certificates into the ARR Server. The ARR Server runs as a client machine to the servers, so the ARR Server needs to trust these servers through a self-signed certificate. To do this: a. In IIS Manager, from the ARR Server, select Server Certificates. b. In the Actions pane of the Server Certificates dialog, click Import. c. In the Import Certificate dialog, either enter the Certificate name or click the Browse (…) button to find and select the exported certificate. d. If the certificated was exported with a password, enter this Password value.
126
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
e. If you want to export this certificate again, select the Allow this certificate to be exported check box. Click OK. f. Repeat these steps to import the server certificates for each server you wish to load balance. Because the client machines are connected to the ARR Server, they do not need the certificates from the servers. The client machines instead trust the ARR Server's certificate, so these connections are secure. Your test environment is now load balanced using Application Request Routing.
14.7 Manage Load Balance Use these steps to manage load balance. Once you have configured ARR to connect with the binding, you can then route all calls from a specific area of the Epicor application to a single server farm. This load balances the calls made against the system by pushing these specific calls out to a server farm designated to handle them.
14.7.1 Route Specific Calls to Server Farm Use these steps to route specific calls to a server farm. This example illustrates a configuration where one server farm, ARRMain, has two application servers as members. To load balance this system, you will next set up another server farm with one application server that will only process calls from the SalesOrder service. This reduces the calls sent to the ARRMain server farm. 1. Launch Internet Information Services (IIS) Manager. Under the Server Farms node, the ARRMain server farm displays. 2. From the tree view, right-click the Server Farms icon and select New Server Farm. 3. Create a server farm named ARRSales. 4. You are asked if you want to create the Rewrite Rule for the new server farm. Click No; you will instead manually create this rule. 5. The ARRMain server farm is currently processing all Epicor calls regardless from which source service they originate. To route specific service calls to the ARRSales farm, you manually create a rule. Click on the ARRSales server farm icon. 6. Now from the Actions pane, select Blank Rule. 7. In the Blank Rule dialog, you first set up the Match URL. From the Requested URL drop-down list, select the Matches the Pattern option. 8. You first set up the Match URL. From the Requested URL drop-down list, select the Matches the Pattern option. 9. From the Using drop-down list, select the Wildcards option. 10. Enter the Pattern. This limits the calls to the server to a specific service. For this example, enter *erp/bo/SalesOrder.svc; this server farm will only receive calls from the SalesOrder service. 11. To handle this example, you set up one condition. From the Logical grouping drop-down list, select Match All.
New Installation of Epicor 10.1.500
127
Supplemental Installations
Epicor ERP 10.1.500 Installation Guide
12. Click the Add button. For the Input protocol, select HTTPS. 13. Now for the Action, indicate you want all Sales Order calls to go to the ARRSales server farm. From the Action Type drop-down list, select Route to Server Farm. 14. For the Scheme, select the https:// option. 15. Click the Server farm drop-down list and select the ARRSales option. 16. Select the Stop processing of subsequent rules check box. This indicates only calls from the Sales Order Entry service are sent to the ARRSales server farm. 17. Prevent the ARRMain server from processing sales order calls. a. Click the server and select the Rewrite Rule option. Click Edit. b. Expand the Conditions section and click the Add button. c. From the Check if input string drop-down list, select Does Not Match the Pattern. d. Now for the Pattern, enter SalesOrder. e. Select the Ignore case check box. Save the rule change.
14.7.2 Test Load Balance Use these steps to test the load balance. Through this test, you can see if the calls sent from the SalesOrder service are routing to the server within the ARRSales server farm. 1. Log into the Epicor ERP application. 2. Navigate to Order Management > Sales Order Management > General Operations > Project Entry. 3. Click New Project and then click Clear. Repeat this step several times. 4. Return to Internet Information Services (IIS) Manager. 5. Click on the ARRMain server farm. The Monitoring and Management pane displays. Notice the service call messages display for Project Entry. 6. Return to the Epicor ERP application. 7. Navigate to Order Management > Sales Order Management > General Operations > Sales Order Entry. 8. Click New Order and then click Clear. Repeat this step several times. 9. Return to Internet Information Services (IIS) Manager. 10. Click on the ARRMain server farm. The Monitoring and Management pane displays again. Notice the ARRMain server farm does not receive sales order calls. 11. Now select the ARRSales server farm. Once again the Monitoring and Management pane appears, notice the sales order message calls display.
128
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Supplemental Installations
The sales order calls now only run on the ARRSales server farm, while all other calls run on the AARMain server farm. You can continue to add more rules to further balance the load between the two server farms.
New Installation of Epicor 10.1.500
129
Appendices
Epicor ERP 10.1.500 Installation Guide
Part V: Appendices This part of the guide includes appendices to help complete your Epicor ERP 10 application set up and also provides additional troubleshooting information.
Chapter 15: Manual Installation and Conversion Issues Use this chapter to assist with manual installations or conversion issues.
15.1 Verify Temporary Files Do Not Exist Prior to installing or migrating, use the following steps to clear out any existing temporary folders and files related to install aware processing. These temporary folders and files may exist due to prior upgrades that were not fully completed and they may cause your current upgrade to not install properly. 1. Go to your system Temp folder. The location of the Temp folder differs based on your operating system. To find the location of this folder, you can do one of the following: • Select Start > Run. In the command window, type: %temp%. Click OK. The Temp folder location opens in a browser. For example, the browser could open to C:\Users\[UserId]\AppData\Local\Temp. • Select Start and right-click on Computer. Select Properties. Click the Advanced System Settings link or the Advanced tab. Click Environmental Variables. In the User variables section, record the value for the Temp variable. 2. In the Temp folder and subfolders, delete the following: • folders that start with MIA* • files that end with *.TMP
15.2 Manually Install Epicor Administration Console Use these steps to manually install the Epicor Administration Console, if needed. The Epicor Administration Console is installed during the Epicor application installation, but it can be manually installed on a different server or reinstalled on the initial server, if needed. You may also need to install an update to the base Epicor ERP 10 application. 1. Navigate to the Administration folder in the path where your Epicor application is installed. For example, go to C:\Epicor\[product]\[version]\SupplementalInstalls\Administration. Note If you need to install an update to the base Epicor ERP 10.1 application, for example, Epicor ERP 10.1.500.x, skip to the last step in this procedure.
2. Right-click the setup.exe file and select Run as Administrator. A Welcome window appears. Click Next. 3. The Confirm Installation window appears. Click Next. 4. The Installing Epicor Administration Console window appears. Click Next.
130
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Appendices
5. The Installing Complete window appears. Click Close. 6. It is recommended that you open the log file to review the list of changes and any possible errors. 7. Optionally, you can add an Epicor Administration Console shortcut to your desktop. To do this, navigate to Start > All Programs > Epicor Software > Epicor Administrative Tools. Right-click Epicor Administration Console and select Send to > Desktop (create shortcut). 8. If you also need to install an update to the base Epicor ERP 10 application, for example, Epicor ERP 10.1.500.x, do the following: a. Navigate to the AdministrationUpdates folder in the path where your Epicor application update is installed. For example, go to C:\Epicor\[product]\[product version]\Updates\[update version]\SupplementalInstalls\AdministrationUpdates. b. Right-click the AdminConsoleUpdater.exe file and select Run as Administrator. c. Click the Install button. d. Exit the installation wizard when the process is complete. It is recommended that you open the log file in the Administration Console folder to review the list of changes and any possible errors.
15.3 Manually Set Up Information Worker Configuration If you use Epicor Information Worker and the initial configuration was not completed during when it was installed, you can use these steps to manually set it up. Epicor Information Worker must be configured before you distribute web site URL to Information Worker users. 1. Verify the Microsoft Office installation on the Information Worker user workstations complies with the Information Worker client system requirements. 2. Set up the Information Worker users in Epicor. Verify that each user is set up as an Epicor user with the Domain and Domain ID entered in their user record (matching the domain and logon name of their Windows credentials). 3. Connect the default Information Worker Configuration to your Epicor installation. a. In Information Worker Configuration Manager, in the tree, expand Configurations and expand Epicor. b. Click Data Source and view the values that defaulted into the screen from the Application Server setup. c. For Use default login credentials, note the following: • Selecting Use default login credentials causes the Information Worker Client and Configuration Manager to use the credentials of the logged-on Windows user when either application connects with the Epicor application server. • Clearing Use default login credentials results in being prompted for Windows credentials. • The setting chosen here becomes the initial setting for the Information Worker Client. Each user can later set whether or not to use default credentials from the Epicor ribbon in the Information Worker-enabled Office applications. d. Click Test Connection. If you are prompted for credentials, enter the credentials that match what is set up for single sign-on in your user account in Epicor. If your connection information and credentials successfully connect and authenticate, a success message displays.
New Installation of Epicor 10.1.500
131
Appendices
Epicor ERP 10.1.500 Installation Guide
e. In the tree, right-click Epicor and select Deploy. f. Click OK on confirmation. 4. Test the connection and client installer. From the workstation of one of your Information Worker users, go to the Information Worker web site URL that you established when installing the Information Worker extension, and follow the instructions for installing the Information Worker Client.
132
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Appendices
Chapter 16: Implement Single Sign On Use this chapter to implement single sign-on access to your Epicor ERP 10.1 application. Note that additional security implementation instructions are included in the Epicor ERP Implementation User Guide. To download the user guide, log onto EPICweb and select Documentation > User Guides. Under Epicor ERP 10.1, select the PDF icon to download the specific user guide. Prior to implementing single sign on, you must determine your user identity authentication method for accessing the Epicor ERP application. If you need additional information to make your decision, refer to the "Authentication Options" information in the Epicor Architecture Guide.
16.1 Set Up Automatic Sign On (Epicor Account) Use these steps to set up their Epicor user accounts to automatically sign into the Epicor ERP application. When you launch the Epicor ERP application, you bypass the logon window to directly access the menu. When you activate this functionality, you create an encrypted login account that only works on the user's client installation. 1. Navigate to System Setup > Security Maintenance > Password Policy Maintenance. 2. In the Permissions section, select the Allow save password check box. 3. Click Save. 4. Now when users log into the Epicor ERP application, they can decide whether they want to set up their client installation to automatically launch. For example, to do this for your account, launch the Epicor ERP application. 5. On the Home page, click the Settings tile. 6. Verify the General Operations setting group is selected. 7. Click the Preferences... option. 8. On the Preferences dialog, select the Automatically sign on check box. Note If you did not activate the Allow save password check box on Password Policy Maintenance in the previous step, the Automatically sign on check box is not available to select.
9. Click OK. The client installation saves your user name and encrypts your password. The next time you launch this client installation, you automatically log into the application.
16.2 Set Up Single Sign On (Windows Account) Use these steps to set up single sign on access using the same account you use to log into the Windows operating system. To set up these accounts for Single Sign On, you must use Windows authentication. You configure the client, the server, and the application server to authenticate logons through Windows. Through this method, you can also set up other applications to automatically login. Users can then access their complete environment. Note This automated login feature only works within environments where you control access through the User Name authentication protocols (Windows TCP binding). You cannot use this feature within
New Installation of Epicor 10.1.500
133
Appendices
Epicor ERP 10.1.500 Installation Guide
environments that use token authentication, Windows Channel authentication, or Secure Sockets Layer (SSL) Channel authentication protocols.
16.2.1 Set Up User Account Use these steps to set up a user account to use the Windows domain account. You do this in User Account Security Maintenance. 1. Navigate to System Setup > Security Maintenance > User Account Maintenance. Click the User ID field to find and select the user record for which you will activate the automated login feature. 2. Enter the Domain that the user accesses to log into the computer. 3. Enter this user’s Domain User ID. Tip When users log in automatically, the Epicor ERP application only uses this Domain User ID for the log in value. The account password is ignored. Since Windows validates the password when the user first logs into the client machine, the application only needs the Windows identity (Domain) User ID to determine whether the account can access the system.
4. When you select the Require Single Sign-On check box, you indicate this user account is restricted to only use Single Sign On for logging into the Epicor ERP application. Select this check box when: • The user will only access the server through Windows Authentication. • The server only runs Windows Authentication for all application servers. DO NOT select this check box when: • The server is configured for multiple application servers that use different authentication methods. For example, if one application server uses Windows authentication while another application server uses UsernameToken via SSL authentication, do not select this check box. • The user logs in through different authentication methods in different environments. For example, if the user logs in through Windows authentication at the office but logs in through UsernameToken via SSL authentication while working remotely without a VPN connection, do not select this check box. 5. Click Save.
16.2.2 Configure the Server Verify the web configuration file for the application server uses the Windows TCP binding configuration. 1. Access the Epicor server and launch a file explorer. 2. Navigate to the \inetpub\wwwroot\\ directory. 3. Using a text editor like Notepad, open the web.config file.
134
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Appendices
4. Locate the line that begins with Programs and Features. 2. Right-click Epicor ERP Version 10 and select Change from the context menu. The Install Wizard verifies Epicor ERP installation. To update the current installation, click Next. 3. On the Select components dialog, select the program features that you want to add or remove from the current Epicor ERP installation. Click Next. 4. On the confirmation dialog, click Next. The Epicor ERP features you selected are added or removed. 5. On the completion dialog, click Finish.
17.2 Uninstall Epicor ERP 10.1 Application Use these instructions if you need to uninstall the Epicor ERP 10.1 application from your server. It is highly recommended that you create a backup of all your important folders and files, such as the C:\Epicor\ERP10 folder and its subfolders, prior to uninstalling the application. It is also recommended that you save this backup in a safe location. Note that the uninstall process deletes everything from the \Epicor\ERP10 folder. Do not store your backup in the \Epicor\ERP10 folder. 1. Create a backup of your important folders and files. For example, at a minimum, create a backup of the following folders: • \Epicor\ERP10\db • \Epicor\ERP10\custom • \Epicor\ERP10\csg • \Epicor\ERP10\server\reports 2. Navigate to Control Panel > Programs and Features. 3. Right-click Epicor ERP 10.1 and select Uninstall from the context menu. 4. On the Uninstall Epicor ERP 10.1 dialog, click Next.
New Installation of Epicor 10.1.500
137
Appendices
Epicor ERP 10.1.500 Installation Guide
5. On the confirmation dialog, click Yes to confirm the removal of the Epicor ERP application. The Epicor ERP application is uninstalled. 6. On the completion window, click Finish. 7. The uninstall process may not delete files that were added or updated since the initial installation. To complete the uninstall process, go to the location where you initially installed the Epicor application. For example, go to \Epicor\ERP10. Manually delete any existing files and folders.
17.3 Uninstall Epicor ERP 10.1 Client Use these instructions if you need to uninstall the Epicor ERP 10.1 client from your workstation. 1. Go to the location where you initially installed the Epicor ERP 10.1 client. For example, go to \Epicor\ERP10\Client. 2. Manually delete any existing files and folders.
17.4 Uninstall Epicor ERP Application Extensions Use these steps to uninstall a previous installation of an Epicor ERP application extension from your server. Extension applications include Web Access, Mobile Access, Enterprise Search, Social Enterprise, Embedded Education Courses, and Information Worker. You must uninstall the previous installation if you plan using the same naming convention for the new instance of the extension. 1. On the server where your Epicor application is installed, open the Epicor Administration Console. To do this: • Windows 2012 / Windows 2012 R2. On the server, press + F to display the Charms bar and select Apps. Alternatively, on the Start screen, right-click the background and in the lower right corner select all Apps. On the Apps screen, select Epicor Software > Epicor Administration Console. • Windows 2008 R2. On the server, navigate to Start > All Programs > Epicor Software > Epicor Administrative Tools > Epicor Administration Console. 2. In the tree view, select your Server Management > [server] > [application server]. 3. In the Actions pane, click Application Server Configuration. 4. Click the Extensions tab. 5. Click the Browse button next to the Existing Deployment field and select the deployment to uninstall. 6. Select File > Uninstall and choose the extension you wish to remove. Note that only fully or partially installed extensions display on this menu. If the extension has not been fully or partially installed, it is not available to select. 7. Repeat these steps for any extensions you need to uninstall.
138
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Appendices
Chapter 18: Troubleshooting This section of the guide can be used if you need assistance in troubleshooting any installation or migration issues.
18.1 Review Error Message Resolutions Use this section to review error messages that may occur during your Epicor ERP installation and possible resolutions to those errors. Error Message
Possible Resolution
Access to path is denied
During the installation, you may receive this error if the attributes of the file being processed are read-only.
Assembly binding warning is turned OFF
When adding a new application server, you may receive this error if your server does not have the required roles configured. Refer to the section "Getting Started > Perform Pre-Installation Steps > Configure Server Roles" for instructions on configuring your server roles.
Insufficient winsock resources available to complete socket connection initiation
To resolve this server error, you must add or update the MaxUserPort value data in the registry file. To do this, go to HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\Tcpip\Parameters. Add the MaxUserPort parameter, if it does not already exist. If it does exist, open the parameter. The Edit DWORD (32-bit) Value dialog opens. Enter Value Data = fffe . Click OK to save.
Length of LOB data (xxxxxx) to be replicated When you have the Replication module enabled in SQL Server that exceeds configured maximum 65536 hosts your database, you may receive this error. To avoid this error, change the Max Text Replication Size value. To do this: Open your SQL Server Management Studio. Right-click the server with your database and select Properties. In the Select a page pane, click Advanced. Under the Miscellaneous title, change the Max Text Replication Size value to -1. Click OK. MSDTC on server 'servername' is unavailable Error occurs when a stand-alone instance of Microsoft SQL Server exists in a cluster environment and is set to start automatically. If the host node is re-booted, you may receive this error, as the MSDTC service is shut off. To resolve, navigate to Control Panel > Administrative Tools > Services and start the Microsoft Distributed Transaction Coordinator (MSDTC) service. In Windows 8, press the +F keys to display the Search bar. Select the Apps icon, launch the Component Services application and Start the service. System Configuration problem. No default As a post-installation step, you must install and configure the Task agent defined. Agent. System Out of Memory
If you are using the 32-bit client, you may be trying to process too many dashboards or BAQs at one time. To resolve this issue, consider using the 64-bit client since it uses more than 2GB memory which should avoid memory issues.
The authorization credential is expired
While performing a search from a client workstation to the Epicor Web Access server, the time values that are set on the client and server are not accurate according to the time zone. To resolve, on
New Installation of Epicor 10.1.500
139
Appendices
Epicor ERP 10.1.500 Installation Guide
Error Message
Possible Resolution the client workstation, go to Start > Control Panel > Date and Time. Verify that the time is accurate according to the time zone. On the Epicor Web Access server, go to Start > Control Panel > Date and Time. Verify that the time is accurate according to the time zone.
Unhandled Exception (due to Turkish Format To resolve the error, set the Format Culture to German to use that Culture) language format instead. To do this: In your Epicor application go to System Management > Company Maintenance > User. For a specific user, in the Format Culture field, select German. Keep the Language set to Turkish. Save and close. Note that the reports are now correct but the report tool bar may display text in German. Version Mismatch: Between Server and Client
To resolve the version mismatch error, you must install the client using the latest installer available.
WCF http activation is enabled (system hangs While creating or updating an application server, the Setup on this task) Environment dialog process hangs on the "WCF http activation is enabled" task when Microsoft Updates are available and haven't been applied. To resolve the issue, install the Microsoft Updates and reboot your system.
18.2 Restore Demonstration Database Use the following instructions to restore the Demonstration Database which is used for educational purposes along with the Epicor Education Module. 1. In the Epicor Administration Console, expand Server Management > [Epicor Server], highlight the name of the Training Application Server and from the Actions pane, select Stop Application Pool. 2. In the SQL Management Studio, delete the existing Training Database. 3. In the Epicor Administration Console, expand Database Server Management > [Server] and do the following: a. Highlight the Training Database, right-click and select Remove Epicor Database. b. Right-click the name of your SQL Server and select Add Demo DB. Enter the following details: • Name: The exact same name of the previous training database. • Deployment Server: The installation location of your Epicor ERP 10 environment. For example, enter C:\Epicor\ERP10\ERP10.1.500.x. Click OK.
4. Click Start. When complete, start the Training Application Server that was stopped in step 1. 5. Import the license file and assign it to your company. To do this: a. Expand your Server Management > [Server] > [application server]. Right-click the Licensing node and select Import License File. b. Browse to the location where you previously downloaded the license code file. Select the file and click Open to import the file.
140
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Appendices
c. In the middle pane, double-click on the licensing code file to open it. In the Properties dialog, click the Modules tab. Select the check box for each module you want enabled. Click OK. d. Click the Companies node. In the middle pane, double-click your company to open the Properties dialog. Click the Installation browse (...) to search for a list of installation license identifiers. Select the appropriate identifier. Click Select. Click OK to save.
18.3 Increase Number of Threads Available to SQL Server If you get user traffic related errors, you need to increase the number of threads available to SQL Server for your system to handle larger user traffic. To do this, update the processModel default settings in the machine.config file. 1. Log onto your server. Your user account must have administrator privileges for modifying Microsoft SQL Server values. 2. Navigate to either the C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Config or C:\Windows\Microsoft.NET\Framework\v4.0.30319\Config directory. 3. Using a text editor, open the machine.config file. 4. Locate the section. You should see the setting. 5. Update this setting to display the following values: 6. Save the machine.config file. 7. For this change to activate, reboot the server machine. 8. Repeat these steps so all application servers (AppServers) on your system use this setting.
18.4 Change Free Memory Requirement If your Task Agent Event Viewer log includes the error "Memory gates checking failed because the free memory (xxxxxxxx bytes) is less than 5% of total memory" it indicates that the server is under-resourced for the amount of load on it, which means demand for resources exceeds the available supply. To prevent this error, you either need to reduce demand (stop any application pool for an Epicor appserver that is not in use and any other process that is not needed) or to increase supply (add more RAM to the server). You can also use the following steps to bypass the free memory requirement check for the system to be able to start services when less than 5% free memory is available. 1. Locate your web.config file. To do this: a. Start IIS Manager. b. Navigate to your Epicor application server virtual directory. For example, ERP101500. c. Right-click on the folder and select Explore to open Windows Explorer.
New Installation of Epicor 10.1.500
141
Appendices
Epicor ERP 10.1.500 Installation Guide
d. Locate the web.config file in the root of the folder that opens. For example, go to C:\inetpub\wwwroot\ERP101500\Server. 2. Create a backup of the web.config file. 3. Use a text editor to open the original web.config file. Search for the node. 4. Place a cursor at the end of that line and press Enter to add a new line. 5. Paste the following on the new line: 6. Save the file. Close the text editor. 7. Repeat the steps above for each of your application servers. 8. After this process is complete, it is recommended that you recycle all of your application pools then restart the Task Agent service.
18.5 Manage LOB Data Replication The "Length of LOB data (xxxxxx) to be replicated exceeds configured maximum 65536" error may occur when you have the Replication module enabled in SQL Server that hosts your database. You have several options to avoid this error: 1. Exclude a table or column that causes the LOB data error from the Publishing Replication: a. Log in to your SQL Management Studio. b. Run the following query to locate the tables and columns that may cause LOB issues: use DECLARE @textthreshold int set @textthreshold = 65536 SELECT SCHEMA_NAME(T.schema_id) as Schema_Name, T.Name as Table_Name, C.name as Column_Name, C.max_length as Max_Length, T2.name as Data_Type, MSP.publication as Replication_Publication_Name FROM sys.tables as T INNER JOIN sys.columns as C ON T.object_id = C.object_id INNER JOIN sys.types as T2 ON C.user_type_id = T2.user_type_id INNER JOIN Distribution.DBO.MSarticles AS MSA ON MSA.source_object = t.name AND MSA.source_owner = SCHEMA_NAME(T.schema_id) AND MSA.publisher_db = db_name() INNER JOIN Distribution.DBO.MSpublications AS MSP ON MSA.publication_id = MSP.publication_id WHERE C.is_replicated = 1
142
New Installation of Epicor 10.1.500
Epicor ERP 10.1.500 Installation Guide
Appendices
AND (C.max_length = -1 OR C.max_length > @textthreshold) ORDER BY 1,2,3 c. Navigate to Replication > Local Publications. d. Right-click the publication on which the error occurred or may occur and select Properties. e. In the Select a page pane, click Articles. f. In the Objects to publish window, clear the check boxes of the tables or table columns returned in the query results. g. Click OK. 2. Change the Max Text Replication Size value: a. Open your SQL Server Management Studio. b. Right-click the server with your database and select Properties. c. In the Select a page pane, click Advanced. d. Under the Miscellaneous title, change the Max Text Replication Size value. You can either change this value to meet the length of LOB data from the error message or use the -1 value. Note If you use -1, the Max Text Replication size has no limit. This may reduce your system performance. e. Click OK.
New Installation of Epicor 10.1.500
143
Appendices
144
Epicor ERP 10.1.500 Installation Guide
New Installation of Epicor 10.1.500
Additional information is available at the Education and Documentation areas of the EPICweb Customer Portal. To access this site, you need a Site ID and an EPICweb account. To create an account, go to http://support.epicor.com.
View more...
Comments
