Thank you for purchasing Mechanic's Mate CM Web Application Version 3.30.  This file contains important information designed to help you with the installation of this product. You'll find details on:

• System Requirements
• Pre-Installation System Configuration
• Running the Installation
• Post-Installation System Configuration
• Contacting Customer Support

1. Coporate or Facility Intranet
2. Windows 2012 Server OS running Roles/Features:
   1. Roles
      1. Web Server (IIS)
      2. Web Server (IIS)\Web Server\Application Development\ASP
      3. Web Server (IIS)\Web Server\Application Development\ISAPI Extensions
         
      4. Web Server (IIS)\Web Server\Application Development\Server Side Includes
      5. Web Server (IIS)\Web Server\Common HTTP Features
      6. Web Server (IIS)\Management Tools\IIS Management Console
      7. Web Server (IIS)\Management Tools\IIS 6 Management Compatibility\IIS 6 Management Console
   2. Features
      1. WoW64 Support
      2. SMTP Server
3. Configuration Highlights/Troubleshooting Notes
   1. Mechanic's Mate CM Web Work Request is a 32bit app.
   2. Mechanic's Mate COM+ Application is named "Mechanics Mate MM5"
   3. Allow IIS Intrinsic Properties should be enabled for "Mechancis Mate MM5" COM+ App components - verify with 32bit Component Manager - C:\WINDOWS\SysWOW64\mmc comexp.msc /32
   4. "Mechanics Mate MM5" COM+ App Identity must be set to Admin account or one with sufficient privilege.
   5. "Mechanics Mate MM5" COM+ App may need "Enforce Access Checks for this Application" to be un-marked.
   6. "Mechanics Mate MM5" COM+ App components run in single threaded apartment model.
   7. Application pool must be classic 32bit application pool, no managed code.
   8. Set virtual folder to use classic 32bit pool via Add Application to the virtual folder.
   9. Default 64bit ASP Handler Mapping must be disabled.
   10. ASP Handler Mapping for 32bit inetsrv.dll, "%windir%\system32\inetsrv\asp.dll" must be added.
   11. ASP Server Side and Client Side Debugging should be enabled with errors sent to browser enabled.
   12. "Show friendly HTTP error messages" should be disabled in Internet Explorer and debugging turned on.
   13. IIS 6.0 Manager is necessary for SMTP Server configuration.
   14. SMTP Server Smart Host setting should point to MS Exchange Server machine (if available).
   15. Use the 32bit Registry Editor C:\Windows\SysWOW64\regedit.exe if verifying Mechanic's Mate CM Web Configurator settings.

1. Log in as Administrator.
2. Install a Network Version of the Mechanic's Mate Windows' Application.
3. Ensure the Roles/Services listed in System Requirements are installed.
4. Configure Internet Information Services (IIS) using Internet Services Manager.
   1. Choose an existing or create a New Web Site within Internet Services Manager for the Mechanic's Mate CM Web Application.
   2. Create an IIS virtual directory for the Mechanic's Mate CM Web Application within the selected web site. This may be accomplished via the following steps:
      1. Launch the Virtual Directory Creation Wizard for the selected web site.
      2. When prompted for a Virtual Directory Alias or Short Name, you may enter "mmate" for example.
      3. For the Physical Path, please enter the full path for the folder which will contain the Mechanic's Mate Web Application Content (ASP and HTML). In our example, we used "c:\maint\cmwebapp".
      4. Ensure the Connect As setting has sufficient privilege - utilize the Test button.
      5. Please click the OK button to confirm your settings.
   3. Create a classic 32bit application pool, no managed code. You may call it "32bitClassic".
   4. Right click on the "mmate" virtual folder and choose Add Application and set the application pool to the "32bitClassic" pool that you just created.
   5. Default 64bit ASP Handler Mapping must be disabled for the "mmate" virtual folder.
   6. ASP Handler Mapping for the 32bit inetsrv.dll, "%windir%\system32\inetsrv\asp.dll" must be added for the "mmate" virtual folder. You may choose to call the handler "ASP Classic 32bit".
   7. ASP Server Side and Client Side Debugging should be enabled with errors sent to browser enabled for the "mmate" virtual folder.
   8. "Show friendly HTTP error messages" should be disabled in Internet Explorer and debugging turned on.

1. Log in as Administrator.
2. Ensure that you have chosen or created the IIS Virtual Directory for this application during the Pre-Installation System Configuration. You will be prompted for this information during the installation process.
3. Run setup.exe from the Mechanic's Mate CM Web Installation CD.
4. If you have any questions, please contact Customer Support; otherwise; proceed with the installation as prompted.

1. Log in as Administrator.
2. Complete Component Services Configuration for the Mechanic's Mate CM Web Application.
1. Launch Component Services from Server Manager -> Tools Menu.
2. Navigate to the "Mechanics Mate" COM+ Application within Component Services.
3. Verify that "Mechanics Mate" COM+ Application Components are installed.
4. Launch the "Mechanics Mate" COM+ Application Properties Dialog.
5. Within the Advanced Tab, set Server Process Shutdown to Leave running when idle. Click OK.
6. Within the Identity Tab, set the application's identity which is the user account it runs under. The account will need the following minimal privileges:
1. Log on Locally. This may be set via Local Security Policy.
2. Access This Computer From The Network. This may be set via Local Security Policy.
3. Full Access to the "Compliance Technologies" registry key within HKEY_LOCAL_MACHINE\SOFTWARE. This may be set via Security->Permissions within the Registry Editor(Regedt32.exe).
4. Full Control permission for the Mechanic's Mate Application Folder and Subfolders. This may be set from the Security Tab within the Folder Properties Dialog.
5. Access to the local SMTP Virtual Server. Please see next step.
3. Verify whether the local SMTP Virtual Server is configured and running with Server Manager -> Tools Menu -> IIS 6 Manager. If NOT previously running or configured, the following settings should be configured within the Access Tab of the SMTP Service Properties:
   1. Relay Restrictions should be set; so that, no computer is allowed to relay regardless of authentication. Relay is not needed for the Mechanic's Mate CM Web App.
   2. Authentication should be set to Windows Security Package. Anonymous Access and Basic Authentication should be turned off.
   3. SMTP Server Smart Host setting should point to MS Exchange Server machine (if available).
   4. If you need help with this, please contact your IT Department or Technical Support.
4. Launch the CM Web Configurator located within the Mechanic's Mate Start Menu. (Please note that the < and > signs within the subsequent items denote a text substitution and are not to be included within the actual settings. Double quotes denoting the beginning and end are not to be included either.)
   1. Web Start URL should be set to: "http://<fully qualified domain name of app server >/<virtual directory name>/login.asp". An example would be "http://ns1.southcohospital.com/mechmate/login.asp".
   2. Please enter the Email From Address which is used for email notifications generated by Web Work Requests. If you don't want to use an actual user's account, please use "mmate_auto_notify@<fully qualified domain name of server>"; so that it will be resolvable to the local SMTP service.
   3. Maintenance Supervisor Email should be set to the desired recipient for notification of New Web Work Requests. An example would be "[email protected]". You may leave this field blank if you would like to disable email notification for new work requests.
   4. Corp. Home URL is OPTIONAL and may be left blank. It is only needed when a corporate web page is directly linked to newworkorder.asp(New Work Requests) and the desired behavior is for a return to the corporate web page upon submission of a New Work Request. This feature is NOT applicable if newworkorder.asp is launched in a new browser window.
   5. Please set the Application Paths and Facility Names for your data sets. Entries must be sequential. Application Path should point to the application folder(containing mechint.exe); this would be the parent of the data folder.
   6. If running, please unload the application for the Mechanic's Mate Virtual Directory within Internet Services Manager; so that, the any changes may take effect. This is necessary since the CM Web Configurator Settings are cached as Application Variables.
5. Verify that the web site containing the Mechanic's Mate CM Web Application is "started" via Internet Services Manager
6. Provide users with the ability to run Mechanic's Mate CM Web Application by any of the following methods:
   1. Build a link on your Corporate or Facility Web Site to the Mechanic's Mate CM Web Application. Please see the code within <cm web app virtual directory>/default.htm for an example of the Javascript call.
   2. Provide users with the Mechanic's Mate CM Web Application's URL.
      Syntax: "<Server URL or IP>/<CM Web App Virtual Directory name>/login.asp"
      For example: "pluto.widgets.com/mmate/login.asp"