Miraplacid Scripting Components 2.0

Component installation steps:

1. Log in as user with Administrator privileges.
2. Unpack installation archive to some folder.
3. Launch %componentname%.exe setup wizard.
   During installation process you will be asked about path the component to be placed after intallation. Default path is "C:\Program Files\Miraplacid\MSC\%componentname%".
   If you agree with this path, press "Next"; otherwise browse to another location.
   On the next screen, wizard will show you installation progress.
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", "install" and "doc" folders, user license and component-related data.
5. Set up sharing between multiple domains if needed (only for Shareware components).
6. Try to start some examples.

Component uninstallation steps:

1. Log in as user with Administrator privileges.
2. Stop IIS server.
3. Run %componentname%.exe from components's install folder. Choose "Uninstall/Reinstall" of "Uninstall". Press "Next" button.
4. Wait for process conpletion and press "Finish" button.
5. Start IIS server.

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.

When using components in ASP environment, you may grant access to each component only to particular sites (domains). 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.
Shareware components verify server name for every request.
Access to the component will be restricted only if file msc.ini exists and readable to web server user account and if some section contains name of the component. If file msc.ini does not exist or contain no section for some component, access to the component will be allowed to every site of the hosting.
In a case of access a component from an unlicensed site error will be returned.
You can use use "*" symbol instead of site name. In this case any site of a hosting can use this component.
License file maintaining is a responsibility of server or hosting administrator.

Registration is necessary only for shareware components.

1. Run %componentname%.exe from components's install folder. Choose "Register" and press "Next" button.
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. Press "Finish" button.

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: registry key HKEY_LOCAL_MASHINE\Software\Miraplacid\MSC\InstallPath with a path to installed component is missed or invalid. no such file: msc.key in a folder where the component has been installed. Access denied to file msc.key. File msc.key is damaged or invalid. 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: Server name is not added to the a section for this component in SYSTEM_DIRECTORY\msc.ini You have attempted to create Shareware Component in global.asa using <OBJECT> tag.	Set up sharing between multiple domains for the server where you've got an error (server name is in a brackets). Do not use Miraplacid Scripting Components in Application or Session level scope as static objects (created using <OBJECT> tag).