How to configure the DBxtra Report Web Service on IIS (Internet Information Server)

Transcription

1 How to configure the DBxtra Report Web Service on IIS (Internet Information Server) Table of Contents Install the DBxtra Report Web Service automatically... 2 Access the Report Web Service... 4 Verify the IIS configuration... 5 What if you get an error and the configuration on the IIS has not been successful?... 6 Try to create the virtual directory manually... 6 In case the folder DBxtra. NET does not contain all required files... 8 The IIS Manager Enable ASP.NET version on your Server If you get the Error Server Application Unavailable In you you still get the Server Application Unavailable Error Connect to the DBxtra Report Web Service... 33

2 Although DBxtra will configure your Report Web Service automatically it sometimes requires manual configurations. Here are instructions for the most common issues you might face. To start using the DBxtra Report Web Service you need to create a DBxtra Server Database, which contains the definitions of all projects and objects created in DBxtra. Install the DBxtra Report Web Service automatically The first time you run DBxtra you ll be asked to create a DBxtra Server Database. See also: First time login to DBxtra Install the DBxtra Report Web Service Click on the Create.

3 Select the option Report Web Services. Select IIS with Web Server for the Report Web Service. Provide an Alias for the virtual directory that will contain the Report Web Service. Provide the physical directory for the virtual directory; the DBxtra Server DB will be created in this directory and all required files will be placed there. Click Create. Note: Provide a local directory that can be accessed by the IIS (Example: C:/DBxtra) Wait a few minutes until DBxtra creates the DBxtra Server DB and configures the virtual directory.

4 Once the configuration of the virtual directory is finished, DBxtra will display a message indicating that a shortcut to access the Report Web Service has been created on the desktop. If the setup has been successful, you the logon window will open and you ll be able to open DBxtra and run the Report Web Service. Access the Report Web Service The Report Web Service is accessible through the menu Report Web Service from the main menu of DBxtra or from the shortcut created on your desktop that has the same name assigned as the virtual directory (example: "DBxtra. NET - Web Service Report ") or directly through a Web browser entering the URL of the virtual directory (example: Once the DBxtra Report Web Service is set up, you can open it in the IIS Manager (Start Menu-> Settings-> Control Panel-> Administrative Tools-> IIS Manager).

5 Verify the IIS configuration If you can open the DBxtra Report Web Service without any problem there is no need to alter any settings on the IIS, but if you want to verify settings within the IIS Manager you can see that in the Default Web site the virtual directory DBxtra.NET has been created and contains the DBxtra Server DB and all the files required for the operation of the DBxtra Report Web Service. Right click on the virtual directory which was created by DBxtra to see its properties.

6 What if you get an error and the configuration on the IIS has not been successful? What if DBxtra was unable to make the configuration of the virtual directory automatically in IIS and an error like the following occurs? Try to create the virtual directory manually Check if the directory that you selected in the configuration window DBxtra. NET - Creating New DB Server contains the folder "DBxtra. NET.

7 Regardless of the occurred error, within the directory provided in the "DBxtra. NET - Creating New DBxtra Server DB" window there should be a folder named "DBxtra. NET". The "DBxtra. NET folder must contain all necessary files for the Reporting Web Service.

8 The folder "bin" which is inside the folder "DBxtra. NET must contain all the files that appear in the image below. In case the folder DBxtra. NET does not contain all required files In case these folders do not contain all the necessary files for the Report Web Service, please go to the DBxtra. NET installation folder (probably C:/Program Files/DBxtra.NET) and copy all files and folders form the sub-folder "Report Web Service (example: "C: \ Program Files \ DBxtra. NET \ Web Report Service ). Paste all files and folders into the virtual directories bin folder (see image above).

9 Once we are sure that the "DBxtra. NET folder exists and contains all the necessary files for the Report Web Service, we open the IIS Manager (Start Menu-> Settings-> Control Panel-> Administrative Tools-> IIS Manage) to create the virtual directory manually. Note: The images shown are from a computer with Operating System Microsoft Windows Server 2003, so the setup screens may be different if your Operating System is not Windows 2003 Server; however they are quiet similar and the information needed for its configuration is the same.

10 The IIS Manager Select the local server ( local computer ).

11 Select the Web Sites folder and double click on it. The Web Sites folder will show all available Web sites.

12 Select the Web site where you want to create the DBxtra Report Web Service". Note: Be sure to choose a Web Site that is working properly and is in running state; in the column "State" it should display the value "Running" for the Web Site in which you want to create the DBxtra Report Web Service. If you do not have a web site under "State - Running", select one and then right click to Start the service for the web site.

13 Note: If you don t have a Web Site available it is necessary to on in order to create the virtual directory for the "DBxtra Report Web Service"; for this purpose right click on Web Sites folder and select New -> Web Site and follow the indications. Note: In case you can t launch any Web Site successfully you ll need to reinstall IIS altogether; you can do that from the option Add or Remove windows components in the Control Panel. Once we have a Web Site that is available and running successfully, create the virtual directory for the "DBxtra Report Web Service" in the selected Web Site.

14 Start the virtual directory. Provide the necessary information to create the virtual directory. Assign a name to the Virtual Directory Alias.

15 Select the directory "DBxtra. NET that contains all the files needed for the" DBxtra Report Web Service"; that s the directory that was created when DBxtra tried setting the virtual directory automatically.

16 You need to activate the privilege "Run scripts (such as ASP) and the privilege "Write" for the virtual directory. We finished the setup wizard for the virtual directory; but we have not completed yet all the settings required for the DBxtra Report Web Service.

17 Once the setup wizard has finished, you can view the virtual directory in the selected Web Site. The virtual directory needs to have assigned the ASP.NET version ; in the properties window of the virtual directory. Verify or assign the ASP.NET version. Right click the on the virtual directory and select Properties.

18 Select the ASP. NET tab.

19 The ASP.NET version must be assigned.

20 Click OK to apply changes and close the properties window. Note: If the ASP.NET version is not available or does not appear in the Properties window, you must enable ASP.NET version for your server. Enable ASP.NET version on your Server. If you are using Windows Server 2003 do the following: To enable ASP.NET on a Server running Windows Server 2003 by using the Configure Your Server wizard 1. Click Start, and then click Manage Your Server. 2. In the Manage Your Server window, click Add or remove a role. 3. In the Configure Your Server wizard, click Next. 4. In the Server Role dialog box, click Application Server (IIS, ASP.NET) and then click Next. 5. In the Application Server Options dialog box, select the Enable ASP.NET check box. 6. Click Next, and then click Next again.

21 7. If you are prompted to do so, insert your Windows Server 2003 installation CD in the CD- ROM drive, and then click Next. 8. When the installation is complete, click Finish. To enable ASP.NET on a Server running Windows Server 2003 by using Add or Remove Programs: 1. In Control Panel, click Add or Remove Programs. 2. Click Add/Remove Windows Components. 3. In the Components box in the Windows Components Wizard, select the Application Server check box, and then click Details. 4. In the Application Server dialog box, select the ASP.NET check box, and then click OK. 5. In the Windows Components Wizard, click Next to begin installing ASP.NET. 6. When the Windows Components Wizard has finished configuring Windows Server 2003, click Finish. For other operating systems like Windows XP or Windows 2000 Professional, to enable ASP.NET version in the properties window: Registering ASP.NET on IIS after installing the.net Framework If you install the.net Framework on a system that has IIS already installed, IIS is automatically configured to handle requests to ASP.NET pages, and to redirect the execution to the ASP.NET runtime. However, it may happen that you installed the framework on a Windows 2000 Professional system where IIS was not already present, and just later decided to add IIS. Registering ASP.NET on IIS is not just a matter of associating the various.aspx,.asmx,.axd,.ashx and the other ASP.NET extensions to the aspnet_isapi.dll ISAPI, more has to be done to create the ASP.NET account and to set it for ASP.NET requests, register the ISAPI itself and other stuff. Doing all this manually can be a difficult operation, and requires a good understanding of many details. Fortunately there is a utility, shipped with the.net Framework but not documented, that can take care of these configuration chores for you. The utility is aspnet_regiis.exe, it is located under %WindowsDir%\Microsoft.NET\Framework\vx.y.zzzz\ and you should call it with the -i parameter: aspnet_regiis.exe i Example: Use the command line and run C: \ WINDOWS \ Microsoft.NET \ Framework \ v \

22 Aspnet_regiis.exe-i Once we verified that our virtual directory is created and assigned the ASP.NET version , we tested whether our browser in a virtual directory works correctly; typed the address in the browser of our virtual directory Example: Note: If the web site in which we created the virtual directory runs on a different port to the default port that is 80, we must specify the port that is running our web site in the URL. Example: If you get the Error Server Application Unavailable If the test in the browser has not been successful and we get an error as shown below, read on. To solve this problem we must add a new "Application Pool" and assign it to the virtual directory.

23 We assign an ID to our Application Pool and select the configuration option "Use default settings for new application pool. Click OK.

24 Now we assign the application pool we created in our virtual directory in it s the properties window.

25 Try again in the browser to see if our virtual directory works;

26 In you you still get the Server Application Unavailable Error Revise that the identity used by your Application Pool created in the properties window and assign permissions to this identity in the virtual directory.

27 By default the security account for an application pool is "Network Service". Once we know the identity which our Application Pool is running with, we assign permissions in the virtual directory of our DBxtra Report Web Service". Select the virtual directory and make use of the right mouse click and then select "Permissions".

28 In "Permissions" we add the identity that our Application Pool is running with. Example "Network Service". Click Add. Provide the identity of your Application Pool.

29 Note: To add a security account that belongs to your PC, we must indicate the name of our PC separated by a "\" from the account security. Once you add the account security of your "Application Pool", it appears available in the list of Security Window of "Permissions". Select and activate the permissions of "Read & Execute, Read and Write" and click OK.

30 Try again in the browser to access your virtual directory; it should work correctly displaying the following screen. Login as user "Admin" Note: The first time you create a "DBxtra Server DB" the default user is "Admin" and it has no password assigned.

31 When you click "Sing In" you ll be sent to the project page of the "DBxtra Report Web Service" and therefore your Report Web Service is running correctly. Note: If you receive a message like The Internet Guest Account/ASPNET User does not have write permissions to the directory of web application. Please contact to your administrator., it is

32 because you don t have not assigned the "Write" permission to the identity that your "Application Pool" is running with. Once you know that our "DBxtra Report Web Service is running correctly, connect the "DBxtra Designer" application to your Report Web Service.

33 Connect to the DBxtra Report Web Service Select "Connect to an Existing DBxtra Server DB". Select "Report Web Service.

34 Provide the URL of the DBxtra Web Service that you created and click the button "Connect". See also: Connect to an existing DBxtra Server Database. More about running the DBxtra Report Web Service on IIS Internet Information Server.