Only install the legacy API (in-process) Server Role if you have a pressing reason to do so (for example, because you have legacy code that you are unqilling to migrate). Otherwise, install the API (RESTful) Server Role. Installing the legacy API (in-process) Server Role involves registering .NET Server Controls, configuring Profiling & Personalization, and setting up the Ambient Data Framework. The API (in-process) Server Role is typically installed on the staging or live Web site, and takes care of resolving dynamic links between content items.
Procedure
- Ensure that all the prerequisites for a Content Delivery Server Role are met on your target system.
- Ensure that on the machine on which API (RESTful) runs, the .NET Framework has the WCF Services feature "HTTP Activation" switched on.
- Create the following Web application directory structure:
- In the root folder, create a
bin\ subfolder.
- In the
bin\ folder, create subfolders config\ and lib\.
- Access the SDL Web installation media.
- Navigate to the Content Delivery\roles\ folder.
- Access the api\in-process\dotnet\bin\ subfolder.
- Copy all DLLs in this folder to the bin\ folder of your Web application.
- If you run a 32-bit .NET Web application, from your installation media, copy the file Content Delivery\resources\x86\xmogrt.dll, overwriting the file xmogrt.dll already in your Web application.
- On the installation media, navigate to the Content Delivery\roles\api\in-process\java\lib\ folder.
- Copy all the JAR files from this folder to the bin\lib\ folder of your Web application.
- Copy and rename the contents of the Content Delivery\roles\api\in-process\config\ folder on the installation media to the bin\config folder of your Web application.
- Copy cd_licenses.xml, your Content Delivery license file available from SDL Customer Support, to the bin\config directory of your Web application.
If you want to name the file differently or put it in a different location, you need to update the License element in your configuration files.
- Optional: Configure logging.
- Configure the Storage Layer and optionally encrypt sensitive strings.
- Disable recycling of the Application Pool of this Web application by doing the following:
- Open IIS Manager.
- From the tree on the left, select the current machine and navigate to the Web application you just created.
- Click Advanced settings to open a dialog with the application's properties, and note down the value of Application Pool.
- Close the dialog.
- From the tree on the left, under the current machine, now select the Application Pools node.
- From the list on the right, select the Application Pool you just noted down.
- Select Recycling in the Edit Application Pool area on the right.
- In the dialog that opens, deselect Regular time intervals, then click Next and Finish to commit your change.
- Restart IIS.
- Copy the file Web.config from the bin\config\ folder of your Web application and merge its contents with the Web.config in the bin\ folder of your Web application.
- Open Web.config for editing and add a page control as follows:
<configuration>
<system.web>
<pages>
<controls>
<add tagPrefix="tridion"
namespace="Tridion.ContentDelivery.Web.UI"
assembly="Tridion.ContentDelivery" />
</controls>
</pages>
</system.web>
</configuration>
- If you intend to use Profiling & Personalization functionality, do one of the following:
-
Application Pool in Classic Mode
-
Add the following inside the <httpModules> inside the <system.web> section (create an <httpModules> element if it does not yet exist):
<add type="Tridion.ContentDelivery.Web.WAI.WAIModule, Tridion.ContentDelivery" name="TridionWAIHttpModule" />
-
Application Pool in Integrated Mode
-
Add the following inside the <system.webServer> section:
<directoryBrowse enabled="true">
Add the following inside the <modules> inside the <system.webServer> section (create a <modules> element if it does not yet exist):
<add type="Tridion.ContentDelivery.Web.WAI.WAIModule, Tridion.ContentDelivery" name="TridionWAIHttpModule" />
- Save and close Web.config.
- Restart the Web application.