Professional Documents
Culture Documents
Installation Guide
Patch 9.04.506A
About this Guide
This manual is provided for informational purposes only. Epicor Software Corporation makes no representations or
warranties with respect to the contents of this manual and specifically disclaims any and all implied warranties
including, but not limited to, merchantability and fitness for any particular purpose.
This manual is subject to change without notice. The contents of this manual are believed to be current and accurate
as of its date of publication. Changes to this manual between reprintings and other important information about the
software products 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.
Disclaimer
© Copyright 2010 Epicor Software Corporation. Epicor is a registered trademark of Epicor Software Corporation.
All other trademarks are the property of their respective owners and are acknowledged. Palm and Palm OS are
trademarks of Palm, Crystal Reports Application Server 9.0 and Crystal Reports Version 9 .NET Server are
trademarks of Crystal, Microsoft Internet Information Server 5.0, Microsoft Message Queue 3.0, WinCE, Microsoft
Project, Microsoft .NET Framework 1.1, Windows 2003 Server, Windows NT, Windows 2000, Windows XP,
Windows 98, Windows ME, Internet Explorer 6.0, Microsoft Office 2000, Microsoft SQL Server 2000, Microsoft
SQL Server 2005, Microsoft XML Core Services 4.0, Microsoft SQLXML 3.0, Soap Toolkit 2.0, Microsoft Outlook,
Microsoft Sharepoint Server, Microsoft Visual Studio Enterprise Architect are all trademarks of Microsoft, McAfee
Virus Scan is a trademark of McAfee, Intel Pentium III is a trademark of Intel and Adobe Acrobat Reader 5.0 is a
trademark of Adobe.
Published in the United States of America. No part of this publication may be reproduced in any form without the
prior written consent of Epicor Software Corporation.
March 2010
2. Install Progress OpenEdge 10.1C Service Pack and Hot Fix ..................................... Page 6
Pre-Installation Steps
Install OpenEdge
Service Pack and Hot Fix
Epicor 9 with
latest SP and/or Patch
is ready!
1. Pre-Installation Steps
Use these instructions to complete steps before you begin the actual service pack or
patch installation.
This release adds changes, resolved issues and enhancements to the Epicor 9.04
application. See the Review Change List section of this document to see the details of
what is included in this service pack or patch.
Your Epicor application version must be 9.04 or higher in order to install this service
pack or patch. If you have not already done so, upgrade to this version.
This release may require a schema change, so please anticipate that this upgrade may
take some time. Also note that if you have Customer Connect, you will need a service
pack for each of those products in order to upgrade the database.
Service packs may recreate SQL indexes. This logic may delete custom indexes that
you have created. It is recommended that you save them and recreate custom indexes
as needed.
Database and system backups are very important. Do not skip this step!
1. Create a backup of all your databases. In a standard installation, the files are
located in the \Epicor\Epicor904 directory.
2. Create a backup of your Epicor application. The files are located in the \oe101c and
\Epicor directories.
If you are using customized Crystal Reports, the report files must be backed up. These
backups are very important. Do not skip this step!
2. Save the reports as file names different from the standard report names.
We strongly recommend that you use a test environment to test all customizations to
verify that the customizations are working properly in the new environment before
installing them onto a live system.
2. Test all customizations, including Business Logic, User Interface, and Report.
3. Use the Report Data Definition program to add fields to the Report Dataset for
customized forms and reports. See the online help for more information on using
this program.
Use the following instructions to install the latest Progress OpenEdge service pack and
hot fix files. Note that the Progress OpenEdge service pack and hot fix files are
cumulative releases of the preceding service packs and hot fixes.
1. Log on to EPICweb and go to the Customer Portal Page. Navigate to Support >
Epicor 9 > Downloads.
3. Download and use the OpenEdge Service Pack Install Guide to install the
OpenEdge Service Pack.
4. Download and use the OpenEdge Service Pack Hot Fix Install Guide to install the
OpenEdge Service Pack Hot Fix.
If you use a Windows operating system with a Progress, SQL or SQL Unicode
database, use these instructions to install the Epicor 9 service pack and patch files. In
these instructions, drive C: refers to a local hard drive. If your local hard drive is
assigned to a different letter, substitute that letter during these instructions.
Some of the instructions are based on using Windows Server 2003. If you use a
different operating system, such as Windows Server 2008, you may need to make slight
adjustments to the instructions.
Use the following instructions to download the appropriate Epicor 9 patch files based
on your database.
1. Log on to EPICweb and go to the Customer Portal Page. Navigate to Support >
Epicor 9 > Downloads.
3. Download the latest Epicor 9 patch related to this installation. For example,
download one of the following files, based on your environment:
4. Download the latest Epicor 9 application Help Content Pack file onto your
machine. For example, download the Help904506A.EXE file.
Use the following instructions to stop the AppServers. Do not skip this step!
1. Verify all users log out of the system before stopping the AppServers.
Use these steps to install the latest Epicor 9 patch, if available, on your system.
5. Enter the directory where your program files are located. Click Next.
6. Enter the directory where your OpenEdge files are located. Click Next.
7. You may be prompted to verify your server name, operating system or database
type. If prompted, select the appropriate option and click Next.
Note! If you are an existing customer, you will complete the post-installation steps
using the Patch guide. If you are a new customer, you will complete the post-
installation steps using the Epicor 9 Installation Guide.
Use the following instructions to install the Help Content Pack. This file contains the
updated online help system available with this Epicor 9 patch.
1. Go to the directory where you downloaded the latest Help Content Pack file.
4. Enter the directory where your program files are located. Click Next.
If you use a Linux/UNIX operating system, use these instructions to install the Epicor
9 patch files. If you do not use Linux/UNIX, continue to the Post-Installation section.
Use the following instructions to download the appropriate Epicor 9 patch files based
on your database. The files must be downloaded to the Linux/UNIX server in the
Epicor904 folder.
1. Log on to EPICweb and go to the Customer Portal Page. Navigate to Support >
Epicor 9 > Downloads.
3. Download the latest Epicor 9 patch related to this installation. For example,
download one of the following files, based on your environment:
4. Download the latest Epicor 9 application Help Content Pack file onto your
machine. For example, download the Help904506A.EXE file.
Use the following instructions to stop the AppServers on the Windows workstation. Do
not skip this step!
1. Verify all users log out of the system before stopping the AppServers.
Use these steps to install the latest Epicor 9 patch, if available, on your system.
2. Navigate to the directory where you downloaded the latest patch file. For example,
go to the \Epicor904 folder.
3. Type “./<filename.bin>” where <filename.bin> is the name of the patch file you
downloaded. Press Enter to start the installation. An Initializing Wizard message
appears.
5. Type in the directory path where your OpenEdge files are located, or press ENTER
to accept the default path.
6. Type in the directory path where your Epicor program files are located, or press
ENTER to accept the default path.
8. A Summary window appears. Verify your directory path to your Epicor program
files. Press ENTER to accept the default.
10. On your Windows Admin workstation, navigate to the Epicor904 folder on the
Linux/UNIX server. For example, go to the \\<server>\Epicor904 folder.
13. Click Browse to enter the location of the Epicor904 folder on the Linux/UNIX
server. For example, enter \\<server>\Epicor904. Click OK. Click Next.
Note! Be sure to use the UNC path and not a mapped drive.
14. The Start Installation window appears. Click Next. The process may run for
several minutes.
Note! If you are an existing customer, you will complete the post-installation steps
using the Patch guide. If you are a new customer, you will complete the post-
installation steps using the Epicor 9 Installation Guide.
Use the following steps to install the Help Content Pack. This file contains the updated
online help system available with this Epicor 9 patch.
1. Go to the directory where you downloaded the latest Help Content Pack file.
4. Enter the directory where your program files are located. Click Next.
5. Post-Installation Steps
1. Restart the database you wish to upgrade. To do this, select Start — Programs —
OpenEdge 10.1C — Progress Explorer Tool. Use the Progress Explorer Tool to
start the database.
2. On the server, open the Epicor Admin Tools program. To do this, navigate to Start
— Programs — Epicor Software — Epicor 9.04 — Epicor Admin Tools.
3. Login with a valid User Id and Password. Note that the user must have Security
Manager rights.
- For example, Open Epicor Admin Tools in single-user mode. Verify the date
that program number 100 (Update Menu/Security) was run. If the date does not
reflect the correct date, you need to run the conversion program manually. To
run the program manually, highlight the conversion program and select
Conversion - Run Conversion Program. Click Yes to confirm.
- Repeat these steps for each mandatory program that did not complete
successfully, including 130, 140, 150, and 160.
If you use SQL or SQL Unicode, use the following steps to verify that each of the
following SQL performance script has been properly applied:
* 904-500DF.sql
* Epicor.9045XX.alter.index.allow_page_locks.sql
* Unique_Index.9045XX.sql
These scripts may need to be run against your database to enhance the performance.
If the script hasn’t been applied, the “SQL Scripts need to be run” message may appear
when you try to log into your Epicor application.
1. To test that the script has been applied, open SQL Studio and click on your
database to select it.
4. Go to the location where your SQL scripts are located. On a standard installation,
the SQL scripts are located in \Epicor Software\Epicor904\ClientServer\db\SQL.
5. Click on the 904-500DF.sql file to select it. Drag and drop the file into the open
query window. Click the Execute button. This process may take several minutes.
The message “Command completed successfully” displays.
6. To test that the script has been applied, open SQL Studio and click on your
database to select it.
1. To test that the script has been applied, open SQL Studio and click on your
database to select it.
4. Go to the location where your SQL scripts are located. On a standard installation,
the SQL scripts are located in \Epicor Software\Epicor904\ClientServer\db\SQL.
6. To test that the script has been applied, open SQL Studio and click on your
database to select it.
1. To test that your SQL script has been applied, open SQL Studio and click on your
database to select it.
4. Go to the location where your SQL scripts are located. On a standard installation,
the SQL scripts are located in \Epicor Software\Epicor904\ClientServer\db\SQL.
5. Click on the Unique_Index.9045XX.sql file to select it. Drag and drop the file into
the open query window. Click the Execute button. This process may take several
minutes. The message “Command completed successfully” displays.
6. To test that the script has been applied, open SQL Studio and click on your
database to select it.
Use the following instructions to update customized .mfgsys files, if you have
customized .mfgsys files.
By default, the deploymentServer path from the default .mfgsys file is used as the
location of the client zip file. Enter a specific location if you want to install the
client zip file from a different location.
3. You can review changes to the configuration setting files by using the Config file
editor. Select the check boxes for the mfgsys files you want to review.
4. Click Finish. The Config file editor appears, prompting you to view changes that
in the config settings for each mfgsys file that was checked. You can update the
settings as necessary.
5. To accept changes in the Config file editor, click Close. The configuration files are
updated so that they are current, ready to accept the service pack.
If you use Service Connect, and it is installed on a separate server other than your
Epicor application server, use these steps to copy a folder to the Service Connect server.
These steps must be completed each time a Service Pack is installed.
1. On the server where your Epicor application is installed, copy the \WebServices
folder. In a standard installation, the WebServices folder is located at \Epicor
Software\Epicor904. Copy only this folder; do not copy any other folders.
2. Navigate to the server where Service Connect is installed. Paste the \WebServices
folder into a directory of your choice.
Use these steps to reinstall your Web Services if your server is also used as a web server
to interface with the Epicor application using Web Services. For example, you need to
reinstall your Web Services if you use Service Connect, AQM, PLM, Epicor Portal or
Information Worker. Instructions for reinstalling your Web Services are located in the
WebServices directory. If your system is installed in \Epicor Software\Epicor904, the
instructions are in \Epicor Software\Epicor904\WebServices.
Use the following steps to verify and test your Epicor 9 application upgrades the first
time you log in.
Use these steps to import your posting rules if you use Extended Rules. If you only use
standard rules, this step has already been automatically completed for you when you
converted your data.
4. Click the Input File Name button. Navigate to the Extended posting rules folder.
For example, go to the following:
5. Select one or more .XML files. You can select multiple files by pressing the SHIFT
key while you highlight the files. Click Open to select the highlighted files.
6. Select the Import All check box to specify that you want to import all the selected
XML files. To specify individual XML files instead, you can select the Selected
check box for each file.
7. If this is not the first time you are importing posting rule files, you can select the
Replace All check box to replace your existing revision with the same name. To
specify to replace individual XML files instead, you can select the Replace
Existing check box for each file.
8. Select the Change All Revision Statuses To Active check box if you want to
change the revision from a draft to active for all transaction types being imported.
To specify to activate individual XML files instead, you can select the Activate
check box for each file.
9. Select the Import into all companies check box if you want to import the posting
rules into each company.
Note! Newly created revisions are automatically set to Active in the current company
only. In other companies, you need to update the status manually. In order to
make changes, your User Id must have access to the company.
11. You may be prompted with the Book Mapping dialog. Select the book identifier
you previously defined from the Map Book selection list. If you want to map the
selected book identifier to all transaction types, select the Use for all transaction
types check box. Click OK.
Note! To copy the rules from one book to another, you can use GL Transaction Type
Maintenance. You create a revision, and then copy both the header and detail
rules one at a time into a new book. Then activate the revision.
Use the following steps to review any standard posting rules that were not updated
during the conversion. If you were not prompted with an Information message during
the conversion, you can skip this step.
1. Get the screen capture of the Information message that you took during the
conversion process.
3. Search and select a transaction type that is listed on the Information message.
4. In the Tree View area, select a revision. From the Actions menu, select Change
Log Menu. Review the list of revisions that were added and blocked during the
last conversion process.
5. If a Revision you want is listed as Blocked, you can change it to Active. To do this:
6. Repeat the above step for each Revision listed on the Information message.
Note! If you have multiple companies, the Information message may list the same
blocked transaction type for each company. You must review the blocked
posting rules for each company where you have access.
Use these instructions to verify that your BPM methods have upgraded successfully. If
a BPM procedure has the Enabled check box selected, it automatically upgrades to
Epicor 9. But, if any procedures run custom 4GL code, you need to verify that this code
compiles properly.
Note! You must use these steps to properly upgrade your BPM directives. You cannot
just copy the BPM directives in the Epicor904\BPM\bo directory to another
directory. You also cannot keep the BPM directives in the current folder, they
must be properly upgraded to a new location.
2. Use the Method Search program to search for any Outdated Directives.
6. Research how to update each outdated directive to make it compatible with Epicor
9. This may involve updating your custom 4GL code to reflect the new schema.
7. Repeat these steps for all the outdated directives that you find.
If you use a 64-bit environment, you must enable the 32-bit version of ASP.NET 2.0 in
the 64-bit environment in order to install and deploy web based products, such as
Epicor Web Access and the Embedded Education Courses.
Note! When using a 64-bit server, you may encounter login issues when using Internet
Explorer 64-bit. Epicor Web Access allows users to enter login credentials, but
the application may not start. To resolve this security issue, use Internet
Explorer to add the Epicor Web Access site to the server’s trusted site list.
If you have installed a Windows 2008 (64-bit version) environment, use these steps to
enable the 32-bit version of ASP.NET 2.0 in a Windows 2008 64-bit environment.
If you have installed a Windows 2003 (64-bit version) environment and you are running
IIS 6, use these steps to enable the 32-bit version of ASP.NET 2.0 in a Windows 2003
64-bit environment.
1. From the Start menu, select Run. Type cmd and click OK.
4. Type the following command to install and register the version of ASP.NET 2.0
(32-bit) and to install the script maps at the IIS root and under:
%SYSTEMROOT%\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis -i
5. Run iisreset.
7. Expand the server node. Select the Web Service Extensions folder in the tree view.
8. In the WS Extensions window, select ASP.Net v2.0.50727 (32 bit). Verify that the
Allow check box is selected.
12. Select the application extensions for the .htm and .html extensions. Verify that
they are not pointing to the Framework64 directory.
13. If these extensions are not mapped, you must manually add each one separately.
To add the .htm extension, click Add and enter the following:
- Executable:
C:\WINDOWS\microsoft.net\Framework\v2.0.50727\aspnet_isapi.dll
- Extension: .htm
- Verbs: Select All Verbs.
- Click OK.
14. To add the .html extension, click Add and enter the following:
- Executable:
C:\WINDOWS\microsoft.net\Framework\v2.0.50727\aspnet_isapi.dll
- Extension: .html
- Verbs: Select All Verbs.
- Click OK.
If you use report generation from Epicor Web Access, you must install Crystal Reports
XI R2 Runtime and Crystal Reports XI R2 Embedded Server.
Use the following to review the specific platform requirements for Crystal Reports XI
R2 Runtime and Crystal Reports XI R2 Embedded Server.
Use the following steps to install the latest version of Crystal Reports XI R2 .Net 3.0
Runtime. This component must be installed on the web server that is hosting Epicor
Web Access. Crystal Reports XI R2 .Net 3.0 Runtime can be installed on Windows
Server 2008.
1. Before you install the latest runtime, you must uninstall any previous version of
Crystal Reports XI R2 .Net 3.0 Runtime.
2. Log on to EPICweb and go to the Customer Portal Page. Navigate to Support >
Epicor 9 > Downloads.
4. Download the latest Crystal Reports Runtime file from EPICweb to your
workstation. For example: Crystal Reports XI R2 .Net 3.0 Runtime SP5.zip.
5. Navigate to the downloaded file. Open the .zip file and extract the contents.
6. Move the extracted files to the report server where the files are to be installed.
9. Specify the folder for the installation of Crystal XI R2 .NET 3.0 Runtime, and
select Everyone as the user of the computer. Click Next.
Use these steps to install the latest version of the Crystal Reports XI R2 Embedded
Server on your server. This component can be installed either on the same server as the
Epicor Web Access forms, or on another server within the trusted domain, if Windows
2003 Server is being used for both Epicor Web Access and Crystal Reports XI R2.
Note! This version of Crystal Reports XI R2 Embedded Server is not compatible with
Microsoft Windows Server 2008 (32-bit or 64-bit) as a report server.
1. Before you install the latest Crystal Reports XI R2 Embedded Server, uninstall any
previous version of Crystal Reports XI R2 Embedded Server.
2. Log on to EPICweb and go to the Customer Portal Page. Navigate to Support >
Epicor 9 > Downloads.
4. Download the latest Crystal Reports Embedded Server file from EPICweb to your
workstation. For example: Crystal Reports XI R2 Embedded Server SP4.zip.
5. Navigate to the downloaded file. Open the .zip file and extract the contents.
6. Move the extracted files to the report server where the file are to be installed.
8. The Crystal wizard Welcome window appears. Select the installation language in
the wizard, and review the Installation Guide and Release Notes located in the
extracted files folder.
9. On the Crystal Reports Server Embedded Edition Setup form., click Next.
10. Review the license statement and select to accept it. Click Next.
11. For the Product Keycode, enter your license key. Click Next.
14. Click Next to confirm to start the installation. A meter displays the progress.
Use these steps to upgrade the Epicor Administration Console on your server. The
upgrade process includes uninstalling and then reinstalling your Epicor Administration
Console. These steps must be completed at each Service Pack or Patch release.
1. Navigate to the directory where your Epicor application is installed. For example,
go to \Epicor Software\Epicor904.
4. On the Epicor Utilities Setup dialog, click the Install Administration Console
button to start the installation.
6. On the Confirm Installation dialog, click Next. The files are installed.
Use these steps to upgrade your Epicor Web Access. The upgrade process includes
uninstalling and then reinstalling Epicor Web Access. These steps must be completed
at each Service Pack or Patch release. Depending on your server, these steps may take
up to one hour to complete.
Note! It is strongly recommended that you uninstall and then reinstall Epicor Web
Access prior to upgrading. If you run the Epicor Web Access Installer prior to
upgrading, you are prompted with the message "The site: <Site Name> already
exists. Would you like to delete and reinstall the site?" Select Yes. Be aware that
if you select No, the installer will upgrade on top of the existing site, and this
may cause file version errors.
1. Uninstall Epicor Web Access. To do this, select Start - Control Panel - Add or
Remove Programs. Select Epicor Web Access Utilities 9.0 and click Remove.
2. Reinstall Epicor Web Access Utilities 9.0. To do this, go to the Epicor Web
Access / Epicor Web Access Utilities 9.0 folder. Double-click the Epicor Web
Access Utilities.msi file.
Note! This process removes all the assemblies from the Global Assembly Cache
(GAC) and can take around 30 minutes, depending on your server.
1. If you use Internet Explorer 8, you need to configure Internet Explorer 8 to run in
Internet Explorer 7 compatibility mode. To do this, open Internet Explorer 8.
3. Add the EWA Server to the list of Internet Explorer 7 Compatible servers.
Note! The default for Internet Explorer 8 specifies all intranet sites as compatible.
4. Click OK to save.
1. Configure IIS 6 Management Compatibility for Windows Server 2008 (32-bit and
64-bit version). To do this, in the Programs and Features control panel, select Turn
Windows Features on or off.
2. From Roles - Web Server (IIS), right-click and select Add Role Services.
2. The Web Setting field values default from the previous installation. Review the
fields and only change the values if necessary.
* Enable Report: Select this check box if you have Crystal Report XI R2
Embedded Server installed on the same server or on the network. Selection
enables the Report Setting section. Note that this check box is only enabled
when a Crystal Report XI R2 .Net3 Runtime is installed on the server.
* Enable Single Sign On: Select this check box to use Windows authentication
for a single sign on. If it is not successful, it prompts for an EpicorWeb login.
* Report Appserver. The Report Appserver defaults to the name of the
webserver. If the Crystal Report XI R2 Embedded Server is installed on a
different server, change this name to identify the name of the server where it is
installed.
* Other Report Settings: No changes necessary. Accept all field defaults.
3. Click Install.
Note! This process installs all the assemblies to the Global Assembly Cache (GAC)
and can take around 30 minutes, depending on your server.
5. Click the red X in the upper right corner to close the installer.
Use the following steps to refresh the cache files on each client machine that runs EWA.
2. After the Main Menu appears, press Ctrl-F5 to refresh. This process may take
several minutes.
Use the following steps to assign required properties and sharing to the Resource folder.
1. Navigate to the Epicor Web Access virtual directory. For example, if your Epicor
Web Access was installed to IIS, the default directory would be:
:\inetpub\wwwroot\EWA\Resources
3. Click the Security tab. Select the IIS_WPG group from the Group or user names
list.
6. In the Permissions for IIS_WPG list, select the Modify and Write check boxes in
the Allow column.
Note! The IIS_WPG group now has Allow selected for Modify, Read & Execute, List
Folder Contents, Read, and Write.
Use the following steps to configure your application help system with EWA.
1. Edit the web.config configuration file to use the folder for your web client. To do
this:
- Edit the <helpServer> key line to specify the help folder. For example, the line
would look similar to:
2. Copy the entire Help folder from the deployment server to the root of EWA install.
Note! If the HelpServer key is configured with a remote server value, you do not have
to copy the entire Help folder from the deployment server. You only copy the
Help\FieldHelp and Help\HelpLinks folders.
Use the following steps to configure your embedded education courses with EWA.
1. Edit the web.config configuration file to use the folder for your web client. To do
this:
Use the following steps to install Adobe Reader on your Epicor Web Access client.
Installing the full Adobe Reader installs the appropriate browser add-on that is required
to render and view report .pdf files (from IIS).
If you use Windows Server 2003 (32 or 64) or Windows Server 2008 (32 or 64) for your
web server you must use these steps to configure the Epicor Web Access report display
feature. You need to configure both PDF and XLS report formats.
Crystal Reports XI R2 does not currently support Windows Server 2008 as a report
server platform. If you intend to use Windows Server 2008 (32-bit or 64-bit) as the web
server platform for Epicor Web Access, then the Crystal Reports XI R2 report server
must be placed on a separate server machine running Windows Server 2003 (32-bit or
64-bit).
Note! Epicor Web Access reporting has only been certified with Crystal XI R2
Embedded Server SP4 and Crystal Reports XI R2 .Net 3.0 Runtime SP5. Prior
releases and versions have not been certified or supported.
If you use Windows Server 2008 64-bit web services, use the following steps to set up
a PDF configuration.
1. After creating an Epicor Web Access site, open Internet Information Server.
3. Locate the Epicor Web Site and single-click to enable the Feature view pane.
If you use Windows Server 2003 64-bit web services, use the following steps to set up
a PDF configuration.
1. After creating an Epicor Web Access site, open Internet Information Server.
3. Browse to the Epicor Web Access site. Right-click and select Properties.
If you use Windows Server 2008 32-bit or 64-bit web services, use the following steps
to set up a XLS configuration.
If you use Windows Server 2003 64-bit web services, use the following steps to set up
a XLS configuration.
1. After creating an Epicor Web Access site, open Internet Information Server.
3. Browse to the Epicor Web Access site. Right-click and select Properties.
Use these steps to upgrade your Epicor Replication Server on a server that is hosting
one or more subscribing replicated databases. The upgrade process includes
uninstalling and then reinstalling Epicor Replication Server. These steps must be
completed at each Service Pack or Patch release.
2. Record the subscriber configuration settings. You will need to re-enter these
settings after installing the updated version of Epicor Replication Server.
1. Uninstall the Epicor Replication server. To do this, select Start - Control Panel -
Add or Remove Programs. Select Epicor Replication Server and click Remove.
4. On the Database Setup dialog, click Install to install the Epicor Replication
prerequisites.
Use the following steps to review the Replication Server configurations in the Epicor
application. See the Epicor application help system for more detailed steps, if
necessary.
6. Use the Progress Explorer Tool to stop, and then restart the server.
7. Verify that the log files produced by the Replication Agent and Replication Log
Reader do not contain errors.
Use the following steps to configure Replication Server using the Replication
Management Console. See the Replication Management Console help system for more
detailed steps, if necessary.
Note! For existing installations, use the values you recorded prior to uninstalling
Epicor Replication Server.
Note! Verify that the Sonic Topic Prefix setting in the Publisher properties matches
the Sonic Topic Prefix indentified as a Replication Setting in the Replication
System Management program.
5. Add a Target Database. A target database includes connection information for the
subscribing database.
6. Add a Subscriber instance. A subscriber instance links the target database to the
publisher.
7. Define filters to specify which tables and companies should be received by the
subscriber instance.
8. Initialize the Subscriber Instance. Initializing the subscriber instance creates tables
in the target database and copies the existing data to the target database.
Use these steps to upgrade your Epicor Enterprise Search. The upgrade process
includes uninstalling and then reinstalling Epicor Enterprise Search. These steps must
be completed at each Service Pack or Patch release.
Use these steps to verify the requirements before you begin the installation and
configuration of Epicor Enterprise Search.
2. Verify that the SQL Server 2005 installation has SQL and Windows
Authentication enabled.
3. Verify that the server where Enterprise Search is installed also has SQL Server
2005 installed as the named or primary instance. For example, if your server is
named Candy, then SQL Server 2005 must be made available as Candy, and not as
a sub or separate installation.
4. Verify you are running SQL Server locally. Note that the Epicor application SQL
database can be located on a remote server.
5. Verify that the account you used to log into the system is trusted by SQL Server.
5. On the Epicor Utilities Setup dialog, click the Install Enterprise Search button to
start the installation.
7. On the Confirm Installation dialog, click Next. The files are installed.
This section is optional if you are using SQL Server for your Epicor 9 transactional
database. When Epicor 9 is using Progress for its transactional database, you must
replicate the data to a SQL Server database for use by Enterprise Search. The replicated
database must be configured as a Fully Functional (Read Only) Subscribing database,
which means that the database includes the necessary schema and code needed to store
data for a fully working Epicor 9 application.
Note! Refer to Replication Server documentation in the Replication Server snap-in for
Admin Console and in the Epicor 9 application for full details on how to assign
replication profiles, configure replication subscribers, and enable data
replication.
Use the following steps as a basis to create a subscriber database that Enterprise
Search can use for indexing and searching.
2. Assign the existing replication profile for Enterprise Search to the companies that
are going to be indexed for searching. Data from the tables defined in the profile
are replicated to the subscriber database for each of the companies that were
assigned the profile.
Note! The Enterprise Search profile only includes the tables needed to support
indexing and searching for Enterprise Search. It is not a profile that replicates
all the necessary data that is needed to run a fully working Epicor 9 application.
This means that the Epicor 9 application, including Epicor Web Access, must
be running using the Epicor 9 transactional database and not using the
replicated database. If you need to run the Epicor 9 application against the
replicated database, you must either create or use an existing replication profile
that includes all of the tables in the transactional database.
3. Create a new Epicor 9 database for use as the subscriber database. To do this, use
the default SQL script located in the directory where your Epicor 9 application
server is installed.
4. Use the Replication Management Console to add this newly created database as a
Functional subscriber.
Use these steps to setup and configure Epicor Enterprise Search. To complete these
steps, you use a Windows command line tool. Note that when you type the commands,
the parameters are case-insensitive.
Note! If you are running on Windows Server 2008 or Windows Vista, you need to run
a Windows command prompt as the local administrator. To do this, navigate to
Start - Programs - Accessories. Right-click on Command Prompt and select
Run as Administrator.
2. Browse to the directory where your Epicor Enterprise Search program installed.
For example, go to Program Files\Common Files\Epicor Software
Corporation\Epicor Enterprise Search. Note that for a 64-bit Windows install, the
default directory begins C:\Program Files (X86)\.
3. Run the ESCmd utility to create the index database. To do this, type the following
command:
Parameter Description
/FileLocation Optional. Indicates where to locate the physical database files.
/Size Optional. Indicates the initial size (in KB) of the database MDF file. If the "size"
parameter is omitted, the default size is 40MB. In general, the index database
will be about 7% the size of the Epicor 9 application database. Note that the
index database recovery model is "bulk-logged", so the log file size is not
important.
4. Run the ESCmd utility to create an indexed system. To do this, type the following
command:
Parameter Description
/host The Epicor 9 server name.
/user The Epicor 9 user name used for managing indexes (should be an admin).
/o Overwrites any existing system definition with the same system code.
5. Set the SQL Server login information for the application database. To do this, type
the following command:
Parameter Description
/s The “system code” that identifies the indexed system, where host is the Epicor
9 server name and port is the Epicor 9 server port number.
/dbServer The name of the SQL server instance containing the target application
database.
/dbPassword The SQL Server account password used to access the application database.
Note! The application database that Enterprise Search queries can be either the actual
Epicor 9 database or a replicated Epicor 9 database. When Epicor 9 uses
Progress for its transactional database, you must replicate the data to a SQL
Server database for use by Enterprise Search. Be sure you have already
completed the above steps in the "Configure Replication Server for Epicor
Enterprise Search" section. You can also follow these steps if you are using
SQL Server for the transactional database, however it is recommended to that
you use the main transactional database.
Parameter Description
/s The “system code” that identifies the indexed system, where host is the Epicor
9 server name and port is the Epicor 9 server port number.
7. Go to the Services control panel. Stop and restart the Epicor Search Indexer
service.
8. Use the Task Scheduler in Windows to add a scheduled task to run the command:
ESCmd RunIndexer /s:host:port. The scheduled task is needed so that your data
is indexed on a regular interval.
Use these steps to enable Epicor Enterprise Search functionality from within the Epicor
application. In the configuration file you use to launch the Epicor application, you must
specifiy the EnterpriseSearchURL.
1. With a text editor, open the configuration file you use to launch the Epicor
application. For example, open the default.mfgsys file.
3. Assign security rights to the Epicor application users who need to access
Enterprise Search. To do this:
4. Log back into the Epicor application. A search field should appear on the Main
menu toolbar. Click this search button to open Epicor Enterprise Search.
The value specified for the path parameter should be the value that was specified
when the original ESCmd Web CreateApplication command was run.
2. Create the Enterprise Search web site. Creating the web site is optional and is not
needed for Enterprise Search support from within the Epicor application client. To
do this, type the following command:
Parameter Description
/site The name of the IIS Web Site under which to create the Epicor Enterprise
Search web application.
/path The virtual path for the search site (web application name).
/files A physical location to place the web site files. If the location does not exist, the
system will try and create it.
3. Set the Epicor Web Access base url. To do this, type the following command:
Parameter Description
/s The “system code” that identifies the indexed system, where host is the Epicor
9 server name and port is the Epicor 9 server port number.
/url The base url for Epicor Web Access may need to include a port setting
depending on your web site configuration. If the site is not on the default port,
then that port setting must be included in the url. For example, http://localhost/
EpicorWebAccess or http://localhost:8080/EpicorWebAccess.
The Enterprise Search web site is now operational. The URL to access the site is
http://machinename/application/moniker/search.htm where:
The Enterprise Search web site work only for Epicor users that have single sign-on
enabled in Epicor 9. This means that the Epicor user must have the user's domain user
name and domain name assigned to it.
When you get prompted to enter credentials, enter your domain user name and
password.
Use these steps to re-install and license the Embedded Education Courses. Using the
Embedded Education Courses requires a Windows Server operating system and
Microsoft Internet Information Services (IIS 6 or IIS 7).
If you have installed a Windows 64-bit environment, verify that you completed the
“Configure 64-Bit Environments” instructions in the Post-Installation section. These
steps are required in order for web based products, such as Embedded Education
Courses, to work properly.
Use these steps to re-install the Embedded Education Courses using the Epicor
Education Course Installer.
1. On the server where your Epicor application is installed, navigate to the Epicor
Education folder. For example, navigate to C:\Program Files\Epicor
Software\Epicor904\Epicor Education.
3. If you have Windows Server 2008 or Windows Vista installed, you must first
select the following:
* Select the Web Site where you want to install the Education courses. It is
recommended that you select the DefaultWebSite.
* Select the App Pool to use for the Education courses. It is recommended that
you select the DefaultAppPool and then verify that it is set to 32-bit and
Integrated. To verify the settings:
4. Enter the Alias you want to use to gain access to the courses. The alias is used as
part of the course server URL. Do not use spaces. The default is EpicorEducation.
Note! It is recommended that you record the Alias that you enter. In the next section,
you are required to configure the client by editing the .mfgsys configuration file.
To edit this file, you will need to enter the Alias and the course server URL.
5. Enter the Directory. The directory can be any folder on the server. For example,
if you have a folder on your server where you host Web content, such as
C:\Inetpub\wwwroot, you can install the courses to a sub-folder under that folder.
For example, enter a directory such as C:\Inetpub\wwwroot\EpicorEducation.
6. For the Server Name enter the name of the server where your Epicor application
is installed.
7. Enter the Port used by the AppServer. To find your port number:
- Go to the Config folder on the server where your Epicor application is installed.
For example, go to the Epicor904\client\config folder.
- Open your train.mfgsys file and look at the AppServer node. The port number
should be listed. For example, the default port for the training database is 9011.
Note! The Server Name and Port must point to a training database and not a live
database within your production environment.
8. Enter a valid Epicor application User ID and Password. The course web site uses
this User ID and Password to login to the Training AppServer to verify licensing
information. The default User ID and Password for the Epicor Education database
is manager / manager.
9. Click Create.
Note! If any entries were not valid, a warning icon appears next to the invalid field.
Enter a valid entry in the field and click Create again.
10. After a message displays that the site has been created, close the Epicor Education
Course Installer.
* Edit the <courseServer uri="" /> line to specify the location where the
education courses are installed. For example, if the courses are installed on a
server named Company1 and the alias is set to EpicorEducation, the line would
be: <courseServer uri="http://Company1/EpicorEducation/" />.
Note! Be sure to use the Alias that you entered and recorded in a previous step when
you ran the EduCourseInstaller program.
* Edit the <helpServer uri="" /> line to specify the location where the help files
are installed. For example, if the help files are installed on a server named
Company1, the line would be: <helpServer uri="//Company1/Help/" />.
Note! If the help files are installed on the deployment server, it is not necessary to edit
the <helpServer uri="" /> line.
- For example, the <helpSettings> node with the edited lines would look similar
to the following:
<helpSettings>
<!-- if you want your htm pages hosted on a separate server than the deployment
files, then you would enter the uri in the helpServer uri attribute -->
<helpServer uri="http://Company1/Help/" />
<courseServer uri="http://Company1/EpicorEducation/" />
<E9EducationKeysServer uri="" />
...
</helpSettings>
Use these steps to license the Embedded Education Courses. License keys are specified
by Education Course module, not Epicor 9 modules.
2. On the toolbar, click the Education Course button (student with a graduation cap).
The Education Course program opens.
- Load License from file. Choose this option to enter the name of the license file.
- Enter License Keys. Choose this option to manually enter the key if you were
sent a file that contains your license keys. At the file prompt, browse to the file
and open it. Manually copy the license key information from the file into your
database. This step only has to be completed once and it is saved in the
Education database.
- Retrieve the key from EPICweb. Choose this option to download and install
license key information from EPICweb. Log on to EPICweb by entering your
User Id and Password. Click OK. Your EPICweb login information is verified
and then your embedded education course license keys are automatically
installed on your system.
Note! When a Service Pack is applied, the Education database is updated and the
license key information must be re-imported. If courses are delivered with the
service pack, reinstall them in the same location on the server.
5. To view the embedded education courses, click the Refresh button from the
toolbar in the application. If the refreshed embedded education courses do not
display, you should close and reopen the application.
1. Log on to EPICweb and go to the Customer Portal Page. Navigate to Support >
Epicor 9 > Downloads.
- Progress: Epicor9_Database_904506x_Vx_Progress.zip
- SQL: Epicor9_Database_904506x_Vx_SQL.zip
- SQL Unicode: Epicor9_Database_904506x_Vx_SqlUnicode.zip
- Linux 64: Epicor_Database_904506x_Vx_Linux64.zip
Use the following instructions to verify the prerequisite steps have been completed.
Use the following instructions to restore the Demonstration Database using the
Progress ProRestore command. These instructions assume the Epicor 9 Demonstration
Database is installed in: C:\Program Files\Epicor Software\Epicor904\db\Training.
Note! If you use SQL Server, do not use these instructions. Instead, use the
instructions in the next section: “Restore the Demonstration Database - SQL
Server”.
9. When the restore is completed, you are returned to the C:\Programs Files\Epicor
Software\Epicor904\db\Training> prompt. Type exit to close the DOS window.
10. To re-import your product license codes, log into Epicor Admin Tools. To do this,
navigate to Start - Programs - Epicor Software - Epicor 9.04 - Epicor Admin
Tools.
11. Login with a valid User ID and Password. Note that the user must have Security
Manager rights. For example, login as manager / manager.
12. Connect to the location of your training environment, such as Epicor Train904.
13. Specify the imported license file for each company. To do this:
15. Scroll down the list of programs to number 5450 called “Re-set DB Sequences”.
Highlight the program to select it.
16. From the Conversion menu, select Run Conversion Program. Click Yes to
confirm.
Use the following instructions to restore the Demonstration Database using SQL
Server. These instructions assume you have an EpicorTrain904 database in SQL Server
2005.
Note! If you use Progress, do not use these instructions. Instead, use the instructions
in the previous section: “Restore the Demonstration Database - Progress”.
2. Within SSMS, verify the Server Type is connected to the database engine.
4. Right-click on the EpicorTrain904 database. From the context menu, select Tasks
— Restore — Database. The Database window displays.
5. Click on the General tab. Within the Source for Restore section, select From
Device.
8. Click the Add button to locate and select the backup file. This file is:
Epicor9_Database_904506x_Vx_SQL.BAK
10. Select the check box next to the Backup Name field. This defines the back up set
to restore.
12. Select both the Overwrite the existing database and Leave Database Ready to
use (Restore with Recovery) check boxes.
13. Verify the Restore Database Files As fields match the correct server directory
paths where the database files currently exist. For example:
15. A dialog box displays indicating the database restoration is complete. Click OK.
17. To re-import your product license codes, log into Epicor Admin Tools. To do this,
navigate to Start - Programs - Epicor Software - Epicor Administrative Tools
- Epicor Administration Console.
18. Login with a valid User ID and Password. Note that the user must have Security
Manager rights. For example, login as manager / manager.
19. Connect to the location of your training environment, such as Epicor Train904.
20. Specify the imported license file for each company. To do this:
22. Scroll down the list of programs to number 5450 called “Re-set DB Sequences”.
Highlight the program to select it.
23. From the Conversion menu, select Run Conversion Program. Click Yes to
confirm.
Use the following instructions to start the database and main Appserver
2. Minimize the Progress Explorer Tool. Do not start the other Appservers yet.
3. Activate your module licenses. To do this, follow the steps detailed in the previous
“License Embedded Education Courses” section.
Use the following instructions to set up your system agent. The paths for the System
Agent, which control report printing, must be reset after a database restore. These
instructions assume your database is set to be the main Mfgsys database directly located
in this folder: C:\Programs Files\Epicor Software\Epicor904\db\Training.
6. For the Server File Directory, enter \\<your machine>\EpicorData. You can
locate your machine name by selecting Properties - Computer Name.
1. Open the Progress Explorer Tool. Start the following Appservers in order:
* Epicor904TaskAgent
* Epicor904ProcessServer
Use the following instructions to verify that the Demonstration Database was properly
updated.
4. Verify that the version has changed to the correct version you installed.
Use the following list to review the Software Change Requests (SCRs) that have been
resolved with this release.
The Summary Description for each SCR starts with an SCR Type, which describes the
nature of the change. A Detail Description is included if further explanation is needed.
Financial Management
Accounts 67646 Application Payment Entry - Edit list sorting by Supplier ID not for Name, Invoice
Payable column not wide enough with 9+ digits
72632 Application Bank Funds - Transfer uses the Posted Currency amount instead of
the Bank Currency amount
72969 Application Invoice Entry AP - AP Invoice Entry Group out of balance based on
number of lines on the first invoice entered
Accounts 64860 Application Invoice Entry AR - Missing Sales Order number when Get Shipment is
Receivable used
66460 Application Invoice Entry AR - When printing Shipment Invoice, the first contact
name is also printed in the second invoice
69309 Application Invoice Entry AR- Unit price field always shows the price converted
into Base currency, instead of Document Currency
70915 Application Aged Receivables - Invoice Adjustment does not affect the report for
the date of the adjustment
71755 Application Cash Receipt - Cannot change a cash receipt if the company does not
have Currency Management
Cash 67408 Application Payroll Check Entry - Incorrect Overtime General Ledger Account
Management when printing check register
Currency 54863 Application Currency Revaluation Process - Currency Revaluation Report does
Management not show the Reporting Currency revaluation data
Fixed Assets 71861 Application Asset Posting Process - Asset depreciation posted multiple times
General 49688 Application COA/ General Ledger account - GL account with inactive segment
Ledger stays active
71601 Application Verify Balances - Changes the Fiscal Period of GLJrnDtl record
based on JEDate
71819 Application GL Period End - Custom Posting rules allows transactions with invalid
accounts to post
72081 Application General Ledger - MS LAB:Lock wait timeout of 180 seconds expired
due to hardcoded key value
72236 Application Posting Engine - Cannot Activate Revision with BAQ calling Decimal
or Date type field
72482 Application Journal Entry - Single Book posting error in the log:
"abtMoveABTToHistory" was not found
73459 Application Posting Engine - Duplicate Journal Numbers being assigned with
Multi-Book Posting
Production Management
Data 71065 Application End Activity - Does not update Part Location Quantity field on an
Collection issued material when Auto Receive is selected
Job 57254 Application Job Manager - WipQty column in Job Manager label reads Number11
Management
59367 Application Job Entry - A warning message does not display when the Production
Quantity does not match the lot size calculation
Material 71783 Application Process MRP - Deletes all part quantity allocations in fulfilment
Requirements
Planning
Scheduling 56961 Application Resource Scheduling Board - Job did not move on the board and after
refreshing, does not appear
72273 Application Schedule Board - When the job has more than one labor record, the
board marks the whole operation as complete
Sales Management
Demand 69652 Application Demand Entry - Demand Line List sheet displays two columns with
Management the label 'Rev'
72046 Application Bill of Lading Entry - Create a new RDD for Bill of Lading for EDI
72135 Application Demand Entry - Releases are not closed If they are updated with less
or equal than the Shipped Qty
72360 Application Demand Entry - Error Logs are not displayed for schedules that are
not yet posted
EDI 60123 Application Demand Entry - Sales Order Header is created when Demand is
rejected due to a price discrepancy
61592 Application EDI Inbound - When an EDI inbound file is imported, lines that have
the same Part are joined
65045 Application EDI Inbound - Demand Detail Extra Charge lines cause constraint
errors in the workflow
Order 67419 Application Fulfillment Work Bench - Does not accept dd/mm/yy date format when
Management selecting the date for search
71089 Application Fulfillment Work Bench - Credit Hold check box is still checked even
though order is no longer on credit hold
71781 Application Cross Dock- Unhandled Exception when refreshing form after
Adjustment
Quote 72369 Application Opportunity / Quote Entry - Validate reference designators is not
Management working between subassemblies and materials
Inventory 48454 Application Time Phased Mtl Requirements - The 'Ignore if needed by' field only
Management works if the date is the latest related to a Sales Order
67866 Rule Inventory / WIP Reconciliation Report - Does not disburse costs to
proper WIP G/L Accounts
Purchasing 52417 Application Purchase Order Entry - When changing PO Suggest to a PO, the Unit
Management Price is reverted to value of Supplier Price List
56668 Application Purchase Order Entry - Duplicating PO's does not enable "Buy for"
options and allows to approve it without a job
67778 Application Generate Suggestions - Ship Via on a sales order is not brought over
to the PO Suggestion
68429 Application Purchase Order Entry - Does not print Part Number if the supplier part
is manually entered in PO Suggestion
Shipping / 51181 Application Customer Shipment Entry - Job Ship Qty shows too many decimals
Receiving when Mass Ship is used to generate the line
68106 Application Customer Shipment Entry - Does not pull in weight UOM from picked
orders
70261 Application Customer Shipment Entry - Unable to select Serial Numbers in Pack
Out when processed from Material Queue
71142 Application Customer Shipment Entry - Ex Buy to Order releases display error
when shipping
72163 Application Customer Shipment Entry - Kit Component lines are removed after
editing previous line using Mass Ship
Epicor Web 66468 Tools Web Forms Chart Tracker - Clicking Retrieve on Movement Summary/
Access (EWA) Total clears the specific sheet
66472 Tools Web Forms Chart Tracker - Pressing Retrieve on the Journal Detail
sheet does not return data
Software 72312 Tools BL Tester - Unhandled exception: Bad URL Format: Invalid numeric
Development port number
Kit (SDK)
General 70885 Tools BPM - BPM Server raises an exception when processing a .net action
if the BO dataset contains data in more than one table
Financial Management
Module SCR Type Description
General 71542 Application General Ledger Account - GL Import Utility add features for FC
Ledger transactions into FC Accounts
Sales Management
Demand 66334 Application Demand Entry - Provide the ability to use the customer price received
Management in the inbound file
EDI 62006 Application EDI Inbound - Workflow validation should check again after an invalid
part is re-submitted
Order 67239 Application Project Entry - Build Project Analysis doesn't honor Enable Mfg Cost
Management Elements checkbox
Quote 69397 Application Opportunity / Quote Entry - Slow performance when loading the
Management search screen