CM Web ReadMe
April 3, 2019
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
- Coporate or Facility Intranet
- Windows 2012 Server OS running Roles/Features:
- Roles
- Web Server (IIS)
- Web Server (IIS)\Web Server\Application Development\ASP
- Web Server (IIS)\Web Server\Application Development\ISAPI Extensions
- Web Server (IIS)\Web Server\Application Development\Server Side Includes
- Web Server (IIS)\Web Server\Common HTTP Features
- Web Server (IIS)\Management Tools\IIS Management Console
- Web Server (IIS)\Management Tools\IIS 6 Management Compatibility\IIS 6 Management Console
- Features
- WoW64 Support
- SMTP Server
- Configuration Highlights/Troubleshooting Notes
- Mechanic's Mate CM Web Work Request is a 32bit app.
- Mechanic's Mate COM+ Application is named "Mechanics Mate MM5"
- 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
- "Mechanics Mate MM5" COM+ App Identity must be set to Admin account or one with sufficient privilege.
- "Mechanics Mate MM5" COM+ App may need "Enforce Access Checks for this Application" to be un-marked.
- "Mechanics Mate MM5" COM+ App components run in single threaded apartment model.
- Application pool must be classic 32bit application pool, no managed code.
- Set virtual folder to use classic 32bit pool via Add Application to the virtual folder.
- Default 64bit ASP Handler Mapping must be disabled.
- ASP Handler Mapping for 32bit inetsrv.dll, "%windir%\system32\inetsrv\asp.dll" must be added.
- ASP Server Side and Client Side Debugging should be enabled with errors sent to browser enabled.
- "Show friendly HTTP error messages" should be disabled in Internet Explorer and debugging turned on.
- IIS 6.0 Manager is necessary for SMTP Server configuration.
- SMTP Server Smart Host setting should point to MS Exchange Server machine (if available).
- Use the 32bit Registry Editor C:\Windows\SysWOW64\regedit.exe if verifying Mechanic's Mate CM Web Configurator settings.
Pre-Installation System Configuration
- Log in as Administrator.
- Install a Network Version of the Mechanic's Mate Windows' Application.
- Ensure the Roles/Services listed in System Requirements are installed.
- Configure Internet Information Services (IIS) using Internet Services Manager
.
- Choose an existing or create a New
Web Site within Internet Services Manager for the Mechanic's Mate CM Web
Application.
- 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:
- Launch the Virtual Directory Creation Wizard
for the selected web site.
- When prompted for a Virtual Directory Alias
or Short Name, you may enter "mmate" for example.
- 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".
- Ensure the Connect As setting has sufficient privilege - utilize the Test button.
- Please click the OK button to confirm your settings.
- Create a classic 32bit application pool, no managed code. You may call it "32bitClassic".
- Right click on the "mmate" virtual folder and choose Add Application and set the application pool to the "32bitClassic" pool that you just created.
- Default 64bit ASP Handler Mapping must be disabled for the "mmate" virtual folder.
- 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".
- ASP Server Side and Client Side Debugging should be enabled with errors sent to browser enabled for the "mmate" virtual folder.
- "Show friendly HTTP error messages" should be disabled in Internet Explorer and debugging turned on.
Running the installation
- Log in as Administrator.
- 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.
- Run setup.exe from the Mechanic's Mate CM Web Installation CD.
- If you have any questions, please contact Customer Support;
otherwise; proceed with the installation as prompted.
Post-Installation System Configuration
- Log in as Administrator.
- Complete Component Services Configuration for the Mechanic's Mate CM Web
Application.
- Launch Component Services from Server Manager -> Tools Menu.
- Navigate to the "Mechanics Mate"
COM+ Application within Component Services.
- Verify that "Mechanics Mate" COM+ Application Components
are installed.
- Launch the "Mechanics Mate" COM+ Application Properties
Dialog.
- Within the Advanced Tab, set Server Process Shutdown to Leave running
when idle. Click OK.
- 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:
- Log on Locally. This may be set via Local Security Policy.
- Access This Computer From The Network. This may be set via Local Security
Policy.
- 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).
- 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.
- Access to the local SMTP Virtual Server. Please see next step.
- 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:
- 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.
- Authentication should be set to Windows Security Package. Anonymous
Access and Basic Authentication should be turned off.
- SMTP Server Smart Host setting should point to MS Exchange Server machine (if available).
- If you need help with this, please contact your IT Department or Technical
Support.
- 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.)
- 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".
- 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.
- 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.
- 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.
- 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.
- 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.
- Verify that the web site containing the Mechanic's Mate CM Web Application
is "started" via Internet Services Manager
- Provide users with the ability to run Mechanic's Mate CM Web Application
by any of the following methods:
- 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.
- 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"
Contacting Customer Support
Get email support via [email protected]
You may purchase annual support agreements directly from your reseller. The annual
support agreements provide virtually unlimited toll free telephone support. In
addition, we provide at no additional charge, 90 (ninety) days (from the date
of purchase) toll free telephone support with the purchase of our software. For
details contact your reseller or dial 1-800-587-5152 EST between the hours of
9:00 am and 5:00 pm.
|
Company Headquarters
www.mechanicsmate.com
Tel: (800) 587-5152
|