Miraplacid Scripting Components 1.1

Installation & Administration Guide for Windows Components

 
 

Installation

Component installation steps:
  1. Log in as user with Administrator privileges.
  2. Unpack installation archive to some folder.
  3. Launch setup.exe.
    During installation process you will be asked about path the component to be placed after intallation. Default path is "C:\Program Files\Miraplacid\MSC".
    If you agree with this path, press "Enter"; otherwise type another location.
  4. If installation completed successfully, a new folder will be added to Miraplacid Components common folder (C:\Program Files\Miraplacid\MSC), which will contain "examples" and "doc" folders, user license and component-related data.
  5. Set up sharing between multiple domains (only for Shareware components).
  6. Try to start some examples.
Note: If you want to reinstall component, you have to uninstall it first.

Uninstall

Component uninstallation steps:
  1. Log in as user with Administrator privileges.
  2. Stop IIS server.
  3. Run setup.exe -u to uninstall a component. After your confirmation the component will be removed from your system.
  4. Start IIS server.

Additional notes for shareware components (does not impact free components)

After the installation shareware components will be fully functional until the end of trial period.
After expiration of the trial period, ASP page will fail with error "Trial period expired".
When it will happen, you will have to register the component or uninstall and stop using it.

Sharing Miraplacid Scripting Components between multiple domains (does not impact free components)

Shareware components verify server name for every request.
All the granted permissions must be added to special license file SYSTEM_DIRECTORY\msc.ini.
The structure of this file is follow:
[component_name_A component_name_B ... component_name_F]
domain_name_1
domain_name_2
...
domain_name_n

[component_name_K component_name_L ... component_name_Z]
domain_name_1
domain_name_2
...
domain_name_n

For example,
[mscupload] www.foo.com www.bar.com [mscexec mscgzip] www.foobar.com
Every component may have individual section in the file or share it with other components. One section may contain several component names.
Names of components in section headers are their "official" names in lowercase.
Amount of sites that could be listed in every section depends on number of licenses you've bought for this component. "Single license" allows only one site name pers section, all extra site names will be ignored.
In a case of access a component from an unlicensed site error will be returned.
"Ulimited license" holders can use use "*" symbol instead of site name. In this case any site of a hosting can use this component.
Unregistered shareware components always works in "Single license" mode.
Number of licenses depends from your choice when purchasing each component or components package.
License file maintaining is a responsibility of server or hosting system administrator.The component name must be lower-case.

Registration (does not impact free components)

Registration is necessary only for shareware components.
  1. Launch setup.exe -r.
  2. Enter First Name, Last Name and Key provided by Miraplacid when you bought the component. Make sure data you enter exactly match your receipt.

Troubleshooting


Problem Plausible reason Solving tips
Components: MSCBlob and MSCGZip
Unspecified error: Description:File System: Unable to create file.
Your server is not permitted to write to the destination folder or the file is already exists and server is not permitted to overwrite it. Check and adjust file and folder permissions.
Server object error 'ASP 0177 : 800401f3'
Server.CreateObject Failed
Systemmessage, messageid = 0x800401f3
Component is not registered. Install the component.
Microsoft VBScript runtime error '800a01ad'
ActiveX component can't create object
Component is registered, but the component file has been moved or deleted or you don't have enough permissions to run it. Reinstall the component.
Module name:C:\WINNT\SYSTEM32\MSCUPLOAD.DLL
Source:Miraplacid.MSCUpload.1 error '80040112'
Description:Trial period expired
Components is registered, Object has been created, but trial period is expired
Possible reasons:
  1. registry key HKEY_LOCAL_MASHINE\Software\Miraplacid\MSC\InstallPath with a path to installed component is missed or invalid.
  2. no such file: msc.key in a folder where the component has been installed.
  3. Access denied to file msc.key.
  4. File msc.key is damaged or invalid.
  5. Trial period is over.
If the trial period is not over reinstall the component. Otherwise buy the component or uninstall and stop using it.
Module name:C:\WINNT\SYSTEM32\MSCUPLOAD.DLL
Source:Miraplacid.MSCUpload.1 error '80040112'
Description:Check license for server: [www.test.com] failed
Component is registered, Object has been created, but account number verification fails. Possible reasons:
  1. File SYSTEM_DIRECTORY\msc.ini is missed
  2. Not enough permission to read SYSTEM_DIRECTORY\msc.ini
  3. There are no appropriate section for the component in SYSTEM_DIRECTORY\msc.ini
  4. Server name is not added to the a section for this component in SYSTEM_DIRECTORY\msc.ini or number of licenses is exceeded (position in the list is greater than number of purchased licenses)
  5. You have attempted to create Shareware Component in global.asa using <OBJECT> tag.
  1. Check permissions for file SYSTEM_DIRECTORY\msc.ini
  2. Set up sharing between multiple domains for the server where you've got an error (server name is in a brackets).
  3. Do not use Miraplacid Scripting Components in Application or Session level scope as static objects (created using <OBJECT> tag).

 
 
Technical Support   Copyright © 2001, 2002 by Miraplacid