OrgPublisher Silverlight Configuration for Server 2008, IIS 7
Table of Contents Table of Contents Introduction... 2 Audience... 2 IIS 7 Setup and Configuration... 3 Confirming Windows Features... 3 Verifying.NET Framework 4 Extended... 5 Automated Internet Information Services (IIS 7) Setup... 7 Executing the Setup Batch File... 7 Manual Internet Information Services (IIS 7) Setup... 8 Setting Up and Configuring the Application Pool... 8 Converting Folders to Applications... 9 Setting Anonymous User... 10 Adding Module Mapping(s) for Charts... 12 Setting File Permissions... 13 Add New Charts... 17 Using the IIS7_Add_Chart Batch File... 17 Revised 8/28/14 1
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 8/28/14 2
IIS 7 Setup and Configuration IIS 7 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 Programs and Features. 2. In the left panel, click Turn Windows features on or off. The Windows Features dialog opens. 3. Using the example on the next page, confirm that your machine settings match the settings in the example. Expand each node in order to determine if all the correct features are selected. Revised 8/28/14 3
IIS 7 Setup and Configuration Figure 1. Revised 8/28/14 4
IIS 7 Setup and Configuration Verifying.NET Framework 4 Extended 1. Verify that you have Microsoft.NET Framework 4 Extended by opening the Control Panel. Select Programs and Features. Figure 2. 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 3. Note: This folder name is also used for the Application Pool and the Silverlight identity when you set file permissions. Revised 8/28/14 5
IIS 7 Setup and Configuration 3. Follow the Publishing Wizard and publish a cross browser chart using Microsoft Silverlight. At this time, additional folders are added to the OPSilverlight folder. Figure 4. Revised 8/28/14 6
Automated Internet Information Services (IIS 7) Setup Automated Internet Information Services (IIS 7) Setup OrgPublisher allows you to execute a batch file to automatically perform all the steps necessary to complete the IIS setup. You can, however, choose to process each step in the setup manually. Executing the Setup Batch File The batch execution file, IIS7_Setup.bat, is added to the OPSilverlight folder after you publish a Silverlight chart. The chart administrator can run this file to setup IIS 7. 1. Navigate to C:\inetpub\wwwroot\OPSilverlight and double-click on IIS7_Setup.bat. An MS-DOS command prompt window opens. Figure 5. 2. 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. Revised 8/28/14 7
Manual Internet Information Services (IIS 7) Setup Manual Internet Information Services (IIS 7) Setup If you chose not to use the automated setup, follow the steps in this section to complete the IIS 7 setup. Setting Up and Configuring the Application Pool 1. Click Start, type Run in the search field and press enter. 2. In the Open dialog, type inetmgr and click OK to start Internet Information Service (IIS7) Manager. 3. In the right panel, under Actions, click View Application Pools. 4. If Silverlight is not listed in the Name column, click Add Application Pool under Actions. The Add Application Pool dialog opens. 5. Type OPSilverlight in the Name field and click OK. 6. In the.net Framework version drop-down list, select the currently installed version of the.net 4 Framework and click OK. OPSilverlight is added to the Application Pool list. 7. Select the Application Pool you just created and, in the Actions pane, click Advanced Settings. If your computer is a 32-bit machine, go to step 9 in this procedure. Revised 8/28/14 8
Manual Internet Information Services (IIS 7) Setup Figure 6. 8. If Enable 32-Bit Applications is not set to True, click to select True. 9. In the Process Model section, confirm that the Identity row reads ApplicationPoolIdentity. Click OK. Converting Folders to Applications 1. In the Connections pane, double-click Sites, Default Web Site, and OPSilverlight. Figure 7. 2. Right-click each folder and select Convert to Application. The Add Application dialog opens. Revised 8/28/14 9
Manual Internet Information Services (IIS 7) Setup Figure 8. 3. Click Select, OPSilverlight, and click OK. Setting Anonymous User The following steps must be repeated for the OPSilverlight, Data, Service, and UI folders. 1. In the IIS window, double-click Authentication. Revised 8/28/14 10
Manual Internet Information Services (IIS 7) Setup Figure 9. The Authentication dialog opens. Figure 10. 2. Right-click Anonymous Authentication and select Edit. Figure 11. The Edit Anonymous Authentication Credentials dialog opens. Revised 8/28/14 11
Manual Internet Information Services (IIS 7) Setup Figure 12. 3. Verify the Application pool identity radio button is selected. Click OK. Adding Module Mapping(s) for Charts Each published Silverlight chart requires a handler mapping, specifically, module mapping. 1. In the Connections panel, select the Data folder and double-click Handler Mapping. Figure 13. 2. Click Add Module Mapping in the Actions pane. The Add Module Mapping dialog opens. Figure 14. Revised 8/28/14 12
Manual Internet Information Services (IIS 7) Setup 3. Complete the fields using the following graphic as an example. Pacific Eastern is the chart name we use. o Request path chart name.dll o Module IsapiModule (from the drop-down list) o Executable the complete path to your Silverlight chart o Name OPSilverlight (the same as your folder name) Click OK. Figure 15. 4. If you used the Manual setup to publish your first Silverlight chart, go directly to step 6. If you used the Automated setup for your first Silverlight chart, the following dialog opens. Figure 16. 5. Click Yes to return to the Add Module Mapping dialog. 6. Click OK to close IIS. Setting File Permissions File permissions are set to give OrgPublisher full control to manipulate Silverlight charts. Revised 8/28/14 13
Manual Internet Information Services (IIS 7) Setup 1. Go to C:\inetpub\wwwroot\OPSilverlight (or, if your chose a different location, to the physical path where you published your chart). Figure 17. 2. Right-click OPSilverlight and select Properties. The OPSilverlight Properties dialog opens. Figure 18. 3. Select the Security tab and click Edit. The Permissions for OPSilverlight dialog opens. 4. Click Add. The Select Users, Computers, Service Accounts, or Groups dialog opens. Revised 8/28/14 14
Manual Internet Information Services (IIS 7) Setup Figure 19. 5. Click Locations and select your computer machine name. The Select Users or Groups dialog opens. 6. In the Enter the object names to select section, type IIS AppPool\OPSilverlight and click Check Names. 7. If the system verifies the group, click OK. The Permissions for OPSilverlight dialog opens. Note: If the system does not find the group, verify that the names used match with the names entered in the installation of.net Framework and the file permissions sections. 8. In the Groups or user names list, locate and select OPSilverlight. Figure 20. 9. In the Permissions for OPSilverlight section, select the Allow check box for Full control. All the boxes are automatically selected, except for Special Permissions. Click OK. Click OK again to close the OPSilverlight Properties dialog. Revised 8/28/14 15
Manual Internet Information Services (IIS 7) Setup The OrgPublisher Silverlight Configuration for Server 2008, IIS 7 is complete. You can successfully view your published Silverlight chart. Revised 8/28/14 16
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 IIS7_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 21. 2. Double-click on the IIS7_Add_Chart.bat file. A DOS command prompt window opens. Figure 22. 3. At the prompt, type the new chart name. In our example below, we used Silverlight Directory. Figure 23. 4. Press Enter. When the add chart process is complete, the DOS command prompt window closes. Revised 8/28/14 17