Products
  
  
  Crash Magic Online
  
  Intersection Magic
  
  Map Magic
  
  Knowledge Base
  
  
  
  Contact Us
  
  Meeting
  
  Shop
  
  Login
  

 

Knowledge Base Article:CMO213 


Registration keys moved to client area: Select login on the left menu bar.

Knowldegebase:
Search home page  

Upgrading your Crash Magic Online software running on IIS

Article created: Jun 26 2009, updated: Apr 12 2011

Background:  This article contains the steps for users to upgrade their Crash Magic Online program when running under IIS.

Status:  Info - "how to" article
Keywords:  Upgrade,version,msi
Categories:   *Installation and setup*

Explanation:

Crash Magic has been designed for easy administration. Running the program under IIS can add some extra steps to upgrading Crash Magic. This article was written to help users upgrade the program smoothly under IIS. This will not address upgrading Crash Magic that is running as a stand-alone service. It will not address changes to the Crash Magic system tables, changes to the configuration or users running multiple Crash Magic web services.

Before beginning the upgrade process ensure that the following steps have been taken. The current version Crash Magic software is running(Contact Pd' Programming if it is not). Ensure that the current database drivers are installed and running on the Crash Magic web server. The new Crash Magic Online version msi file should be downloaded, and saved to the computer that is currently running Crash Magic. Also ensure that you have received a registration key for the new version of the software. Each version of Crash Magic requires a unique registration key. Contact Pd Programming for information if you do not have one.



Solution:

Crash Magic will need to shut down for the upgrade process. It is recommended that Crash Magic users be informed that the system will be down momentarily for the upgrade process.  

A. The first goal is to stop the Crash Magic application pool. This will shutdown the Crash Magic web service.

  1. Open the IIS manager on the computer that is running Crash Magic
  2. Expand the Application Pools
  3. Click on the application pool that is running Crash Magic to select it(The recommended name for this pool is CrashMagicAP, but the installer does have the option to change the name)
  4. With the Crash Magic application pool selected click the stop button to stop the web service.
  5. Close the IIS manager for the upgrade process.

B. Now the new msi can be run to upgrade Crash Magic. Ensure that the msi for the new version is on the machine that is being upgraded.

  1. Double click on the MSI to start the install process.
  2. Click the Next button on the Welcome screen when it highlights.
  3. Select the location that Crash Magic is installed to( The default location is C:\Program Files\PdMagic\CrashMagicOline\).
  4. Click the Install button to install the new version.
  5. The Installer will open the Crash Magic configuration editor when completed.

The Crash Magic msi will upgrade the default program(Installed drive:\Program Files\PdMagic\CrashMagicOnline\Bin\ISAPI\CrashMagicOnline_ISAPI.dll). Users with multiple configurations on the same server will need to copy the new CrashMagicOnline_ISAPI.dll after the msi has run and replace the dlls of their additional installations. The following steps will need to be repeated as necessary for each configuration.

C. Enter the registration information for the new version.

  1. With the Crash Magic configuration editor open, select your configuration in the list box on the left side of the window.
  2. Ensure the Registration tab is selected, and enter the new registration key.
  3. Select File/Save to save the new registration information.

The Crash Magic software has now been upgraded. If the version of Crash Magic being  upgrading to requires changes to the system tables, the changes should be made at this point in the process. Contact Pd Programming if you are unsure.

D. New features that are added to Crash Magic may require updates to the Master shared user. The following steps show how to check for system updates.

  1. With the Crash Magic configuration editor open, and your configuration selected in the list box on the left side of the window.
  2. Click on the SYS Database tab.
  3. Click the Maintain Database button to open the Database Maintenance window.
  4. Click the Updates tab.
  5. Click the View system updates ... button.

E. System updates will be shown in blue with a check box next to them.

  1. With the cmUpdateForm open, click the check box(es) next to any updates listed.
  2. Click the Update button.
  3. Click the OK button when the updates have completed.
  4. Some updates may require other updates. Please, repeat section D. to ensure that all of the updates have been processed. If no further updates are displayed then continue to the next step. 
  5. Exit and save the changes that you have made in the Crash Magic configuration editor.

F. The last portion of this process is to start the Crash Magic web service.

  1. Open the IIS manager on the computer that is running Crash Magic
  2. Expand the Application Pools
  3. Click on the application pool that is running Crash Magic to select it.
  4. With the Crash Magic application pool selected click the start button to start the web service.
  5. Close the IIS manager.

The Crash Magic installation should now be tested. Log into the web site. Create a new study and reports to ensure the program is correctly rendering reports.

 


September 23, 2018 5:12AM

© 1999-2018 Pd' Programming, Inc - Lafayette, CO USA