OrgPublisher Silverlight Configuration for Server 2003, IIS 6

Transcription

1 OrgPublisher Silverlight Configuration for Server 2003, IIS 6

2 Table of Contents Table of Contents Introduction... 2 Audience... 2 IIS 6 Setup and Configuration... 3 Confirming Windows Features... 3 Verifying.NET Framework 4 Extended... 5 Automated IIS 6 (ISAPI Enabled) Setup... 7 Executing the Setup Batch File Setting Up and Configuring the Application Pool... 8 Creating Applications... 8 Adding MIME Type Adding Application Extension Mapping Adding a Web Service Extension Setting File Permissions Add New Charts Using the IIS6_Add_Chart Batch File Revised 5/08/14 1

3 Introduction 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 Revised 5/08/2014 2

4 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 Click Add/Remove Windows Components on the left. The Windows Components Wizard opens. Figure 2. Revised 5/08/2014 3

5 IIS 6 Setup and Configuration 3. Double-click Application Server. The Application Server dialog opens. Figure Double-click Internet Information Services (IIS). The Internet Information Services (IIS) dialog opens. Figure Click Internet Information Services Manager. The Internet Information Services Manager dialog opens. Revised 5/08/2014 4

6 IIS 6 Setup and Configuration Figure 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 2. When.NET 4 Framework is installed, navigate to C:\inetpub\wwwroot and add a subfolder named OPSilverlight. Figure 6. Note: this folder name is also used for the Application Pool and the Silverlight identity when you set file permissions. 3. Follow the Publishing Wizard and publish a cross browser chart using Microsoft Silverlight. Revised 5/08/2014 5

7 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. Revised 5/08/2014 6

8 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 Navigate to C:\inetpub\wwwroot\OPSilverlight and double-click on IIS6_Setup.bat. An MS-DOS command prompt window opens. Figure Type the name of the chart you published and press Enter. When the setup is complete, the command prompt window closes. Note: Each Silverlight chart you publish using a new publishing definition requires a handler mapping, specifically, a module mapping. 3. Create each additional module mapping by double-clicking the IIS6_Add_Chart.bat in C:\inetpub\wwwroot\OPSilverlight folder. Figure 10. Revised 5/08/2014 7

9 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 Click Create and accept the default application name. 4. In the Execute permissions field, click the down-arrow and select OPSilverlight. Revised 5/08/2014 8

10 Your settings should look like the following example. Click OK to close the dialog. Figure 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: Revised 5/08/2014 9

11 Figure 14. Adding MIME Type 1. Right-click the OPSilverlight folder and select Properties. The OPSilverlight Properties dialog opens. Figure If the MIME type shown in the example above does not appear in the Registered MIME types list, click New. Figure 16. Revised 5/08/

12 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 Click Configuration. The Application Configuration dialog opens. Revised 5/08/

13 Figure 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\v \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 Click Browse in the Executable field and navigate to C:\WINDOWS\Microsoft.NET\v , and select aspnet_isapi.dll. Click OK. Revised 5/08/

14 Note: This path may not be valid if Windows 2003 server was installed to a different directory. If you do not see v , follow the Validate.NET4 Extended Framework is installed. 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. Revised 5/08/

15 Figure In the Tasks section, click Add a new Web service extension. The New Web Service Extension dialog opens. Figure Type the name of your chart in the Extension name field and click Add. The Add file dialog opens. Figure 23. Revised 5/08/

16 4. Browse to the location of your chart dll, as in the example below. Figure 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. Revised 5/08/

17 Figure 26. Setting File Permissions 1. Navigate to your OPSilverlight, or root, folder for your charts. Figure Right-click OPSilverlight and select the Security tab in the OPSilverlight Properties dialog. Figure In the Group or user names section, select NETWORK Service and click Edit. The Permissions for OPSilverlight dialog opens. Revised 5/08/

18 4. Click Add. All the permissions (except for the Special permissions check box) in the Allow column are automatically selected. Click OK. Figure 29. Revised 5/08/

19 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 Double-click on the IIS6_Add_Chart.bat file. A DOS command prompt window opens. Figure At the prompt, type the new chart name. In our example below, we used Silverlight Directory. Figure Press Enter. When the add chart process is complete, the DOS command prompt window closes. Revised 5/08/