Miraplacid Scripting Components 2.0

Component installation steps:

1. Log in as root.
2. Unpack installation archive like this: tar -xzpf filename.tar.gz
3. Stop ShiliASP server (please, make sure that it stopped).
4. Launch ./setup.sh <Path_to_Chili_ASP>, i.e. ./setup.sh /opt/casp.
5. If installation completed successfully, a new folder will be added to Miraplacid Components common folder (/var/miraplacid/MSC), which will contain "examples" and "doc" folders, user license and component-related data.
6. Start ShiliASP server.
7. Set up sharing between multiple domains if needed (only for Shareware components).
8. Try to start some examples.

Note: If you want to reinstall component, you have to uninstall it first.

Component uninstallation steps:

1. Log in as root.
2. Stop ShiliASP server.
3. Run ./setup.sh <Path_to_Chili_ASP> -u to uninstall a component. After your confirmation the component will be removed from your system.
4. Start ShiliASP 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 may be added to special license file /etc/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.
To register a component:

1. Log in as root.
2. Launch ./setup.sh <Path_to_Chili_ASP> -r.
3. Enter First Name, Last Name and Key provided by Miraplacid when you bought the component. Make sure data you enter exactly match your receipt.
   

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.
Server object error 'ASP 0178' Server.CreateObject Access Error The call to Server.CreateObject failed while checking permissions. Access is denied to this 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:/opt/casp/lib-chilicom/libmscexec.so Source:Miraplacid.MSCExec.1 error '80040112' Error:Systemmessage, messageid = 0x80040112 Description:Trial period expired	Components is registered, Object has been created, but trial period is expired. Possible reasons: 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:/opt/casp/lib-chilicom/libmscexec.so Source:Miraplacid.MSCExec.1 error '80040112' Error:Systemmessage, messageid = 0x80040112 Description:Check license for server: [www.testasp.com] failed	Server name is not added to the a section for this component in /etc/msc.ini	Set up sharing between multiple domains for the server where you've got an error (server name is in a brackets).