OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6

(1)

OrgPublisher 11

Silverlight

Configuration

for Server 2003,

IIS 6

(2)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Table of Contents

Introduction

The purpose of this document is to provide detailed information on the OrgPublisher Microsoft® Silverlight information and Internet environmental settings you need to deploy this feature and publish OrgPublisher Silverlight charts.

Audience

The intended audience for this document is the OrgPublisher chart administrator, with permissions to turn Windows features on or off.

System Requirements

(4)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 IIS 6 Setup and Configuration

IIS 6 Setup and Configuration

The C:\inetpub\wwwroot folder already exists and has the required permissions to run “children” files; this is where you publish your Silverlight charts.

Confirming Windows Features

1. Access the Control Panel, then select Add or Remove Programs. The Add or Remove Programs window opens.

Figure 1.

2. Click Add/Remove Windows Components on the left. The Windows Components Wizard opens.

Figure 2.

(5)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 IIS 6 Setup and Configuration 3. Double-click Application Server. The Application Server dialog opens.

Figure 3.

4. Double-click Internet Information Services (IIS). The Internet Information Services (IIS) dialog opens.

Figure 4.

5. Click Internet Information Services Manager. The Internet Information Services Manager dialog opens.

(6)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 IIS 6 Setup and Configuration

Figure 5.

6. Select World Wide Web Service (you may have to scroll to the bottom of the list) and click OK. Click OK again to return to the Windows Components

Wizard. Click Next.

7. Click Finish when the wizard completes the components configuration.

You are returned to the Add or Remove Programs window.

Verifying .NET Framework 4 Extended

1. Verify that you have Microsoft .NET Framework 4 Extended by opening the Control Panel. Select Add or Remove Programs.

If you do not have .NET 4 installed, check with your IT administrator or install it from http://go.microsoft.com/fwlink/?LinkID=186913.

2. When .NET 4 Framework is installed, navigate to C:\inetpub\wwwroot and add a subfolder named OPSilverlight.

Figure 6.

3. Follow the Publishing Wizard and publish a cross browser chart using Microsoft Silverlight.

Note: this folder name is also used for the Application Pool and the Silverlight identity when you set file permissions.

(7)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 IIS 6 Setup and Configuration At this time, additional folders are added to the OPSilverlight folder.

Figure 7.

In addition, the following files are placed in the folder. Only those marked are used in an IIS6 environment.

Figure 8.

(8)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Automated IIS 6 (ISAPI Enabled) Setup

Automated IIS 6 (ISAPI Enabled)

Setup

OrgPublisher allows you to execute a batch file to automatically perform all the steps necessary to complete the IIS 6 setup.

You can, however, choose to process each step in the setup manually.

Use the Publishing Wizard to publish a Silverlight chart by selecting cross browser then Microsoft Silverlight options.

Executing the Setup Batch File

The batch execution file, IIS6_Setup.bat, is added to the OPSilverlight folder after you publish a Silverlight chart. The chart administrator can run this file to setup IIS 6.

1. Navigate to C:\inetpub\wwwroot\OPSilverlight and double-click on IIS6_Setup.bat.

An MS-DOS command prompt window opens.

Figure 9.

2. Type the name of the chart you published and press Enter.

When the setup is complete, the command prompt window closes.

3. Create each additional module mapping by double-clicking the

IIS6_Add_Chart.bat in C:\inetpub\wwwroot\OPSilverlight folder.

Figure 10.

Note: Each Silverlight chart you publish using a new publishing definition requires a handler mapping, specifically, a module mapping.

(9)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Manual Internet Information Services 6 (IIS 6) Setup

Manual Internet Information Services

6 (IIS 6) Setup

If you chose not to use the automated setup, follow the steps in this section to complete the IIS 6 setup.

Setting Up and Configuring the Application Pool

1. Click Start, Administrative Tools, and then Internet Information Services (IIS) Manager.

2. In the left pane, right-click Applications Pool, New, and Application Pool. The New Application Pool dialog opens.

3. In the Application pool ID field, type OPSilverlight and then click OK.

The application pool is created.

Creating Applications

1. In the same window as above, click Web Sites then Default Web Site.

2. Right-click Silverlight and click Properties. The OPSilverlight Properties dialog opens.

Figure 11.

3. Click Create and accept the default application name.

4. In the Execute permissions field, click the down-arrow and select OPSilverlight.

(10)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Manual Internet Information Services 6 (IIS 6) Setup Your settings should look like the following example.

Figure 12.

Click OK to close the dialog.

5. Expand the Silverlight folder and repeat steps 2–4 for each of the subfolders;

Data, Source, and UI.

Figure 13.

After the applications are created, your folder and file structure look like the following sample:

(11)

Figure 14.

Adding MIME Type

1. Right-click the OPSilverlight folder and select Properties. The OPSilverlight Properties dialog opens.

Figure 15.

2. If the MIME type shown in the example above does not appear in the Registered MIME types list, click New.

Figure 16.

(12)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Manual Internet Information Services 6 (IIS 6) Setup 3. Type .xap in the Extensions field. Type application/x-silverlight-app in the

MIME type field. Click OK.

Adding Application Extension Mapping

An application extension must be added for the Silverlight WCF Web service.

1. In the OPSilverlight folder, right-click the Service subfolder.

The Service Properties dialog opens to the Directory tab.

Figure 17.

2. Click Configuration. The Application Configuration dialog opens.

(13)

Figure 18.

3. Scroll through the list in the Applications extensions section to verify whether or not the .svc extension exists for the following path:

C:WINDOWS\Microsoft.NET\v4.0.30319\aspnet_isapi.dll

4. If it does appear in the list, select it and click Edit. The Add/Edit Application Extension Mapping dialog opens.

5. Select the Limit to field, and type GET, POST, DEBUG, HEAD. Click OK.

6. If the .svc extension does not appear in the list, click Add. The Add/Edit Application Extension Mapping dialog opens.

Figure 19.

7. Click Browse in the Executable field and navigate to

C:\WINDOWS\Microsoft.NET\v4.0.30319, and select aspnet_isapi.dll.

Click OK.

(14)

8. Type .svc in the Extension field.

9. Select Limit to and type GET, POST, DEBUG, HEAD.

10. Select the Script engine check box and click OK.

Adding a Web Service Extension

A web service extension must be added for each chart you publish.

1. In IIS, expand your local computer folder and click Web Service Extension and select Add a new Web service extension.

Figure 20.

The Web Services Extensions window opens.

Note: This path may not be valid if Windows 2003 server was installed to a different directory. If you do not see v4.0.30319, follow the Validate .NET4 Extended Framework is installed.

(15)

Figure 21.

2. In the Tasks section, click Add a new Web service extension. The New Web Service Extension dialog opens.

Figure 22.

3. Type the name of your chart in the Extension name field and click Add. The Add file dialog opens.

Figure 23.

(16)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Manual Internet Information Services 6 (IIS 6) Setup 4. Browse to the location of your chart dll, as in the example below.

Figure 24.

5. Open that folder, in this example, the Data folder. Select the chart you want to publish and click Open.

Figure 25.

The path to the chart is added to the Add file dialog, as shown in the example below.

Click OK.

(17)

Figure 26.

Setting File Permissions

1. Navigate to your OPSilverlight, or root, folder for your charts.

Figure 27.

2. Right-click OPSilverlight and select the Security tab in the OPSilverlight Properties dialog.

Figure 28.

3. In the Group or user names section, select NETWORK Service and click Edit. The Permissions for OPSilverlight dialog opens.

(18)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Manual Internet Information Services 6 (IIS 6) Setup 4. Click Add. All the permissions (except for the Special permissions check box)

in the Allow column are automatically selected. Click OK.

Figure 29.

(19)

OrgPublisher 11 Silverlight Configuration for Server 2003, IIS 6 Add New Charts

Add New Charts

Once IIS is set up to process Silverlight charts, you must add each new published Silverlight chart to IIS. A batch file performs this action for you.

Using the IIS6_Add_Chart Batch File

When you publish a new Silverlight chart, the data files are created by the Publishing Wizard.

1. Navigate to your OPSilverlight folder.

Figure 30.

2. Double-click on the IIS6_Add_Chart.bat file. A DOS command prompt window opens.

Figure 31.

3. At the prompt, type the new chart name. In our example below, we used Silverlight Directory.

Figure 32.

4. Press Enter. When the add chart process is complete, the DOS command prompt window closes.