Would it be better with a book template (i.e. the step style pages used in the installation guide)

Configure The Crystal Web Service

Both Quick Reports and Operational Reports of type Crystal Reports could be previewed and printed from both IFS Enterprise Explorer and IFS Web Client. Yet, there are some configuration parts one would have to carry out before using this feature. The following describes how you can install and setup the Crystal Report Web Service.

Contents

• Installing and configuring Crystal Web Service
• Configuring the System Parameters
• Known limitations

Installing and configuring Crystal Web Service

Local system Administrator account should be used for all the below configuration steps. 

Prerequisites

1. CRYSTL component must be included in the build.
2. Dot Net runtime version 4. You can download and install this from the Microsoft download site, http://www.microsoft.com/download
3. Java 1.5 or any certified java version should be installed. path to Java bin should be available in the PATH system variable. If you install Java after installing IIS, restarting the World Wide Web Publishing service is required.
4. Microsoft IIS.
5. For IIS 7.0, you need to install “IIS 6 Management Compatibility” Role. Follow the steps given below to install it. Without this the Crystal Web Service installation will not run properly.
   This step is not required for IIS 7.5

    

   1. From Windows go to Start\Administrative Tools\Server Manage (This example is with respect to Windows 2008)

2. On the left Navigation tree go to Server Manager\Roles\Web Server (IIS) and select "Add Role Service"

3. On the "Select Role Services" pane, scroll down to "IIS 6 Management Compatibility". Select the all check boxes underneath the node.

4. Click "Next" from the "Select Role Services" pane, and then click "Install" at the "Confirm Installations Selections" pane.

5. After the installation finishes successfully click “Close” to leave the “Add Role Services” wizard.

5. Oracle Client needs to be installed, recommended version is 10G Release 2 (10.2) or later. An entry matching the Oracle TNS entry specified under <ORACLE_TNS> tag found in ifs-crystal-config.xml in the Web Service installation folder needs to configured in to the tnsname.ora file. You will find this ifs-crystal-config.xml file after you install the Crystal Web Service. For example C:\Inetpub\wwwroot\IFSCRWebSetup.
6. Install Crystal Dot Net runtime files. Locate the Crystal Merge Module which contains the Crystal Dot Net runtime files required to run the Web Service at <ifs_home>\instance\<instance_name>\CrystalWebService_xbit_<instance_name>.zip select the correct zip according to the architecture of the web-service host . Unzip and locate the correct mis file and install.
   eg:32bit CRRuntime_32bit_13_0_1.msi 
   eg:64bit CRRuntime_64bit_13_0_1.msi 
   

If all prerequisites are met, follow the steps below to install and configure the Crystal Web Service

1. Create a folder in the machine where the Crystal Web Service is going to be installed and copy the Crystal Report files that are going to be previewed from IFS Enterprise Explorer to this folder. This folder will be referred to as the OpenReportPath later on in the installation process. If the reports are Info Services Reports make a folder by the ordering language inside the "OpenReportPath" folder and copy the files in to that languge folder. For example, if one is are going to order Info Service reports with "en" language then create a folder called "en" inside the "OpenReportPath" folder and copy the Info Service layout of type Crystal in to the "en" folder.
2. From the Application Server locate the CrystalWebService_<instance_name>.zip file found at <ifs_home>\instance\<instance_name> where <instance_name> is the name of the Extended Server instance. Unpack it into a folder on the same or a different machine to install the Crystal Web Service. Run the setup.exe to install the Web Service.
3. Select Default Web Site as the Site, enter a new name for the Virtual Directory or leave the default value as it is and select the Application Pool as ASP.NET v4.0, click Next to start the installation. (If .NET 4 is unavailable reinstall Dot Net runtime version 4 and restart the setup )

4. The following is shown if the installation is successful.

5. After successfully installing the web service, browse to the virtual directory folder in wwwroot of IIS (e.g. C:\Inetpub\wwwroot\<Virtual Directory>) and open the Web.Config file from a text editor. Specify the folder where the Crystal Reports are stored under the key OpenReportPath. This is the same folder that was referred to as the OpenReportPath at the beginning of this installation process.

For example,

<appSettings>
   <add key="OpenReportPath" value="C:\reports\Test Reports\CXI"/>
</appSettings>

6. Browse to <OS folder>\Microsoft.NET\Framework\v4.0.xxxx\CONFIG folder (e.g. C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\CONFIG) and open the machine.config file from a text editor. Under the  <configuration>\<system.web> section, comment the following line

<processModel autoConfig="true"/>

and insert the following line,

<processModel enable="true" userName="SYSTEM" password="AutoGenerate" />

7. From the IIS, Check the Basic settings for the Virtual Directory , Make sure its running on ASP .NET v4.0 Application Pool.

8. In IIS version 6 the Dot Net Web Service Extensions are Prohibited by default. Make sure these Web Service Extensions are Allowed in the environment where the Crystal Web Service is installed. To allow these extensions, from the IIS Manager, go to Web Service Extensions. From the right hand side panel make sure that the, Active Server Pages and ASP .NET v.4.0.xxxxx Web Service Extension status are set to Allowed. If not, select these two extensions and click the Allow button to (or select Allow from the RMB menu) change the status to Allowed.

Do the following in order to enable Web Service Extension in IIS version 7. Please note that this example is based to Windows 2008 and IIS 7.

1. From Windows go to Start\Administrative Tools\Server Manage.
2. On the left Navigation tree go to Server Manager\Roles\Web Server (IIS) and select "Add Role Service".
3. On the "Select Role Services" pane, scroll down to "Application Development" and select “ASP .NET” and ”ASP” check boxes. You will be prompt to add some other required features in order for ASP .NET to run properly. Select “Add Required Role Services”.

4. The final selection will look like below.

5. Click Next from the "Select Role Services" pane, and then click "Install" at the "Confirm Installations Selections" pane.
6. After the installation finishes successfully click “Close” to leave the “Add Role Services” wizard.

9. Restart the machine which has the Crystal Web Service installed.

Configuring the System Parameters

One needs to configure some System Parameters in order for IFS to communicate with the Crystal Web Service. Namely these System Parameters are,

Note: If you set YES to web database access security system parameter then you need to add the CR_WEB_INIT procedure in the CRYSTAL_WEB_UTIL_API package to your Crystal layout. Check the developer guide lines on how to add the CR_WEB_INIT procedure  to a layout.Note: This is only available on sites with an IFS Development License. 

Known limitations

• If you perform multiple report requests to the same crystal web service simultaneously, you can get the Error in retrieving the saved PDF report from Crystal Web Service exception. This limitation is due to an error in Crystal Runtime. This has been reported to the crystal runtime vendor. The issue will be addressed internally by an LCS bug(104424).