here - Meditech

MEDITECH ARRA Report Manager
Installation Instructions
1
Table of Contents
Purpose
Requirements of the Hosting Server
Executing the Installer
Configuring IIS
Accessing the MEDITECH ARRA Report Manager
Common Installation/Configuration Issues
Installation wizard rolls back and is interrupted prior to completion
Internet Information Server 4.0 not installed
Microsoft .NET Framework 4.0 not installed
The 'targetFramework' attribute... error
Service Unavailable : HTTP Error 503 error
Unable to set password error / Unable to validate authentication information
Unable to add authentication server/static content not served by IIS
2
Purpose
This document details the steps necessary to install and configure the MEDITECH ARRA Report
Manager, a web based solution for managing, deploying and executing MEDITECH’s supplied
ARRA Meaningful Use reports. It is assumed that this installation will be handled by a system
administrator with knowledge of the Microsoft .NET Framework, Internet Information Services
(IIS) and Microsoft SQL Server. If you do not have administrative privileges sufficient for
installing and configuring these components and Windows file permissions on the server which
will host the MEDITECH ARRA Report Manager, please contact your organization’s IT
department to have the installation completed by an authorized individual.
Note: Though the Microsoft SQL server which houses the MEDITECH Data Repository SQL
databases is often a suitable choice for hosting the MEDITECH ARRA Report Manager, it is
possible to install the MEDITECH ARRA Report Manager on a separate server if desired.
Requirements of the Hosting Server
The MEDITECH ARRA Report Manager will not properly install unless the server on which it is
hosted meets or exceeds the following requirements:
 Windows 2003 Server or greater
 Internet Information Services (IIS) 4.0 or greater
 Microsoft .NET Framework 4 or greater http://www.microsoft.com/enus/download/details.aspx?id=17718
 Internet access to https://www.meditech.com/arrareports/
 Access to the Microsoft SQL Server housing the MEDITECH Data Repository SQL
databases
 Microsoft Internet Explorer, Mozilla Firefox, or Google Chrome
3
Executing the Installer
If your server meets or exceeds the minimum installation requirements, begin the installation
process by following the steps below.
1. Download the installer package from https://www.meditech.com/arrareports/setup.exe
and, on the server which will host the MEDITECH ARRA Report Manager, launch the
setup.exe file.
2. The ARRA Web Tool installation wizard will start. Click Next to continue
4
3. The wizard will begin installing the program. Click Install to continue.
4. The wizard will detect your IIS folder and install the virtual directory
“MTArraWebTool”. Click Next to continue once complete.
5
5. If successful, the wizard will show confirmation that the installation completed. Click
Finish to exit the wizard.
6
Configuring IIS
With the installation wizard now complete, IIS can be configured by following the steps below.
1. Navigate to the new MTArraWebTool virtual directory in IIS
7
2. Give full control to the IIS user under the MtArraWebTool virtual directory in IIS
8
3. Ensure that within SQL server, the database to which you are trying to connect with the
MEDITECH ARRA Report Manager has an account established for the IIS server with
the required permissions. If this does not exist, you may encounter a “A connection to the
master database on server (SERVER NAME) could not be established.” message upon
establishing a database connection within the MEDITECH ARRA Report Manager.
4. While the ARRA Report Manager is running Open Windows Task Manager > Processes
and look for the “w3wp.exe*32” process and see which User Name the process is using.
This User Name must be added to the SQL Server with the proper permissions. In the
below screen print, the process is using “NETWORK SERVICE”
9
5. Within SQL Server open Security > right-click Logins and choose New Login. Click
Search to the right of Login Name. On the new window which is entitled Select User or
Group click the “Advanced” button. On the next Select User or Group window choose
“Find Now”, then scroll down below and select the User Name to be added. In this
example we select “NETWORK SERVICE” to add this account to SQL.
10
6. If you still have issues at this point, you can also investigate the Event Viewer. Go to
Control Panel>All Control Panel Items>Administrative Tools> Event Viewer> Windows
Logs>Application Log and look at the MSSQLSERVER event. Make note of the User
account, in this example the IIS account is “IIS APPPOOL\DefaultAppPool”
7. In SQL, add the new account under Security > Logins with sysadmin privileges
Additional note: If you are deploying the MEDITECH ARRA Report Manager on a
server other than where the SQL database is located, your IIS configuration environment
must use a network account that has the ability to access that server. Please see the
following link for additional information and instructions.
http://www.iis.net/learn/manage/configuring-security/application-pool-identities
11
Accessing the MEDITECH ARRA Report Manager
With IIS and SQL permissions configured, it should now be possible to connect to the
MEDITECH ARRA Report Manager. From the server on which the MEDITECH ARRA Report
Manager is hosted it is possible to use localhost to identify the server, while other clients must
use the hostname of your server.
For example, from the server on which the MEDITECH ARRA Report Manager is hosted, type
http://localhost/MtArraWebTool/Default.aspx into the address bar within your browser, and from
other clients use http://(your server name)/MtArraWebTool/Default.aspx.
See the MEDITECH ARRA Report Manager user manual for instructions detailing initial
configuration.
12
Common Installation/Configuration Issues
Issues may arise when attempting to run the installation wizard, configuring IIS or launching the
MEDITECH ARRA Report Manager for the first time. Some of the more common issues have
been documented below along with corrective steps.







Installation wizard rolls back prior to completion
Internet Information Server 4.0 not installed
Microsoft .NET Framework 4.0 not installed
The 'targetFramework' attribute... error
Service Unavailable : HTTP Error 503 error
Unable to set password error / Unable to validate authentication information
Unable to add authentication server/static content not served by IIS
13
Installation wizard rolls back and is interrupted prior to completion
If the installation wizard begins, then rolls back and displays an interrupted message, in IIS open
the DefaultAppPool > Advanced Settings and Set “Enable 32-bit Applications” to True
14
Internet Information Server 4.0 not installed
If you receive a message “This setup requires Internet Information Server 4.0 or higher for
configuring IIS Virtual Roots. Please make sure that you have IIS 4.0 or higher.” you will need
to install and/or enable Internet Information Services
15
To enable IIS on a server running Windows Server 2003:
1. Click Start, point to Settings, and then click Control Panel.
2. In Control Panel, double-click Add or Remove Programs.
3. In the Add or Remove Programs dialog box, in the left pane, click Add/Remove Windows
Components.
4. On the Windows Components page, in the Components box, click Application Server,
and then click Details.
5. In the Application Server dialog box, in the Subcomponents of Application Server box,
select the check boxes for ASP.NET, Enable network DTC access, and Internet
Information Services (IIS).
6. Click Internet Information Services (IIS), and then click Details.
7. In the Internet Information Services (IIS) dialog box, in the Subcomponents of Internet
Information Services (IIS) box, select the check boxes for Common Files, File Transfer
Protocol (FTP) Service, Internet Information Services Manager, SMTP Service, and
World Wide Web Service.
8. Click World Wide Web Service, and then click Details.
9. In the World Wide Web Service dialog box, in the Subcomponents of World Wide Web
Service box, select the check boxes for Active Server Pages, WebDAV Publishing, and
World Wide Web Service, and then click OK.
10. In the Internet Information Services (IIS) dialog box, click OK.
11. In the Application Server dialog box, click OK.
12. On the Windows Components page, click Next.
13. On the Completing the Windows Components Wizard page, click Finish.
To enable IIS on a server running Windows Server 2008:
1. Click the Start, click Control Panel, click Programs, click Programs and Features,‌ and
then click Turn Windows features on or off. If you are prompted for an administrator
password or confirmation, type the password or provide confirmation.
2. In the list of Windows features, click the plus sign (+) next to Internet Information
Services, click the plus sign (+) next to World Wide Web Services, click the plus sign (+)
next to Application Development Features, and then select Application Development
(ASP, ASP.NET,.NET Extensibility,ISAPI Extensions,ISAPI Filters)
16
Microsoft .NET Framework 4.0 not installed
If you receive a message “Microsoft .NET Framework 4.0 Full package or greater needs to be
installed for this installation to continue.” you will need to install .NET Framework 4.0 or
greater. For instructions on how to install .NET Framework 4.0 go to
http://www.microsoft.com/en-us/download/details.aspx?id=17718.
The 'targetFramework' attribute... error
If you receive a message “The 'targetFramework' attribute in the <compilation> element of the
Web.config file is used only to target version 4.0 and later of the .NET Framework” you will
need to install .NET Framework 4.0 or greater. For instructions on how to install .NET
Framework 4.0 go to http://www.microsoft.com/en-us/download/details.aspx?id=17718.
17
Service Unavailable : HTTP Error 503 error
If you receive a message “Service Unavailable : HTTP Error 503. The service is unavailable.”
open IIS and look for the application pool of the selected website. Select the Application Pool as
shown in the diagram below. Right click on the website name in the Application Pool and then
click on Start as shown in the picture below:
18
Unable to set password error / Unable to validate authentication information
If you receive a message ”Unable to set password. Access to the path
'C:\inetpub\wwwroot\MtArraWebTool\App_Data\AuthServer.xml' is denied.” please recheck that
the MtArraWebTool virtual directory in IIS has the required permissions.
If you receive a message ”Unable to validate authentication information” please recheck that the
IIS user has the required permissions to the MtArraWebTool folder. Set the required permissions,
close and reopen the browser, and retry http://localhost/MtArraWebTool/.
19
Unable to add authentication server/static content not served by IIS
Depending on the version of IIS installed, static content files may served by IIS to the client
browser as empty files when the ARRA Report Manger is loaded. Symptoms of this issue vary
by IIS version, but the most common are that images may not render and buttons may not work.
Below is an example of JavaScript files failing to load:
The “$ is not defined” error (found within a client browser’s console) indicates that the jQuery $
function alias is not understood because the jQuery core library and UI files were served as
empty files. To access a client browser’s console and check for errors:
 In Chrome, press Control + Shift + J
 In Firefox, press Control + Shift + K
 In IE, press F12 to launch developer tools, then click console. You will need the IE
console open before clicking the button or it will not log an error
To resolve the error, IIS must be configured to serve static content to clients. The following
article describes how to configure IIS appropriately::
http://support.microsoft.com/kb/2196177
20

Download Report