After setting up your environemnt corresponding to your operating system, make sure
you create a subfolder Service in your service's AppData
folder. This folder is created automatically if the installation is done using the
installer files. When deploying manual, this folder has to be created by hand.
If you are using any Internet Information Services (IIS) earier than version 7.0 you must change the Web.config file. The default settings are:
<system.webServer>
<modules>
<add name="WebComposition.Dgs.RestHttpModule"
type="WebComposition.Dgs.RestHttpModule" />
</modules>
<directoryBrowse enabled="false" />
</system.webServer>
IIS 6 however requires the corresponding module to be added within the
system.web section instead as shown below.
<system.web>
<httpModules>
<add name="WebComposition.Dgs.RestHttpModule"
type="WebComposition.Dgs.RestHttpModule" />
</httpModules>
</system.web>
This section covers the setup precedure on a Windows XP system using the Internet
information Services (IIS) Manager 5.1.
To setup the WebComposition DataGridService start the Internet Information Services
(IIS) Manager. Select the appropriate web site (e.g. 'Default Web Site') and choose
'New', 'Virtual Directory...' to create a new virtual directory for the WebComposition
DataGridService.
Follow the instruction on the screen. When prompted for the name of the virtual
directory choose any. Consider the name you choose here carefully. The name chosen
here represents the WebComposition DataGridService hosting the resources.
When prompted for the directory name of the content, enter the directory name where
you have installed the local copy of the WebComposition DataGridService. If the
installer files have been used, this is the same directory name as the one used
in during the installation procedure.
Do not change any access permissions when propmted for it.
Right-click the newly created virtual directory in the Internet Information Services
(IIS) Manager and select 'Properties'. Chose the tab 'ASP.NET' tab and make sure,
2.0 or later is selected in the field 'ASP.NET verison'.
Select the tab 'Home Directory' and click 'Configuration...'. Choose the tab 'Mappings'
in the following dialog and select '.svc' from the 'Application Mappings' list.
Click 'Edit' to adjust the application extension mappings for the WebComposition
DataGridService.
Add the verbs 'PUT' and 'DELTE', seperated by commas into the box 'Limit to'.
Finally, test your local installation of the WebComposition DataGridServie by selecting
the following link or by typing 'http://localhost/DataGridService/DataGridService.svc'
into your browser's address field.
You local copy of the WebComposition DataGridService has now been succesfully set
up.
This section covers the setup precedure on a Windows Vista system using the Internet
information Services (IIS) Manager 6.0.
To setup the WebComposition DataGridService start the Internet Information Services
(IIS) Manager. SElect the appropriate web site (e.g. 'Default Web Site') and choose
'Add Application' to create a new application directory for the WebComposition DataGridService..
When prompted for a alias and the path for the application, choose any name for
the alis. Consider the ame you choose carfully. the name chosen here represents
the WebComposition DataGridService hosting the resources. Enter the directory name
where you have installed the local copy of the WebComposition DataGridService. If
the installer fules have been used, this is the same directory name as the one used
during the installation procesdure.
Finally, thest you local installation of the WebComposition DataridService by selecting
the following link or by typing 'http://localhost/DataGridService/DataGridService/'
into you browser's address field.
Your local copy of the WebComposition DataGridService has now been successfully
set up.
Troubleshooting
In case you receive a 500.19 error, this is a result of the new 'Configuration
Locking' to support IIS administration. This avoids the appliance of the following
settings in the Web.config file.
<system.webServer>
<modules>
<add name="WebComposition.Dgs.RestHttpModule"
type="WebComposition.Dgs.RestHttpModule"
/>
</modules>
</system.webServer>
Enalbe this by executing the following command as administrator.
%windir%\system32\inetsrv\appcmd unlock config section:system.webServer/modules
In case you receive a 404.3 error, your web server is not set up correctly. the file
name extension (.svc) is not recognized, and is ths not allowed on your web server.
Ensure the Windows Communication Foundation is set up problably. Execute the command.
%windir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe
-i
In case you receive a 500 error, describing handler 'svc-integrated' has a bad module
'ManagedPipelineHandler', this indicates the Windows Communication Foundation HTTP
Activation is not set up probably. Open 'Control Panel' and go to 'Programs', 'Turn
Windows features on or off'. Make sure the entries 'Windows Communication Foundation
HTTP Activiation' as well as 'Windows Communication Non-HTTP Activation'are checked.
In case you receive a 500.19 error, and you run a x64 system (e.g. Windows Vista 64-bit) your web server is not set up correctly.
Ensure the Windows Communication Foundation is set up probably. Execute the command:
%windir%\Microsoft.NET\Framework64\v3.0\Windows Communication Foundation\ServiceModelReg.exe
-i
Make sure the .NET Framework 2.0 is set up problably. Execute the command:
%windir%\Microsoft.NET\Framework64\v2.0.50727\aspnet_regiis.exe -i
Documentation is currently being written.
Documentation is currently being written.