Siebel Reports Administration Guide > Installing the Siebel Reports Server for Microsoft Windows > Siebel Reports Server Installation >

Installing the Siebel Report Server Access


Siebel Report Server Access consists of libraries used by the Actuate e.Reporting Server to communicate with the Siebel Server.

You must install Siebel Report Server Access on the same machine on which you installed Actuate e.Reporting Server. Siebel Report Server Access will also automatically import report executable files into the Report Encyclopedia.

Siebel Report Server Access also contains customized Active Portal templates and the Active Portal Security Extension library.

Install the Siebel Report Server Access using the user account set up during the Actuate e.Reporting Server installation.

To install the Siebel Report Server Access

  1. Before starting the installation, make sure that the Actuate HTTP service and the Actuate Process Management Daemon are stopped.
  2. Insert the Windows Server Programs, Siebel Enterprise Server, Base CD-ROM into the CD-ROM drive.
  3. In Windows Explorer, navigate to the ses directory and double-click setup.exe.
  4. Depending on whether you are installing your Siebel Report Server Access for the first time or adding a new language to an existing instance, take the appropriate action:
  5. To install the server software in a new instance, select None as the default and click Next. Proceed to Step 5.

    To install a new language in an existing instance, select the displayed instance and click Next. Proceed to Step 9.

  6. The installer prompts you to choose the installation directory for the Siebel application.
  7. By default, setup installs Siebel Server software in the C:\ drive in a directory named sea7xx. If desired, you may choose a different drive for installation.

    To choose a different directory

  8. Click Next.
  9. The installer prompts you to select the component that you want to install.

  10. Choose from the following options:
  11. Choose the Typical setup option and click Next.
  12. NOTE:  There are three options (Typical, Compact, and Custom) available from the Setup Options screen. For the Siebel Reports Server, only Typical is a valid selection.

    The Installer language selection screen appears.

  13. Confirm the Language Pack you are installing for the Siebel Report Server Access and click Next.
  14. Servers are installed, at a minimum, with a base language and, optionally, with one or more additional languages.

    NOTE:  Unless your database is Unicode enabled, Siebel Systems does not support installation of any language other than U.S. English on top of a base Japanese, Simplified Chinese, Traditional Chinese, or Korean Language Pack.

    The installer program performs a validation check to make sure that installation prerequisites are met.

    If they are not, a prompt appears stating which installation requirement is not met, such as, installation of Microsoft Data Access Components (MDAC), for example.

    The installer prompts you that the setup program will install program shortcuts to your Program menu with the name Siebel Enterprise Server 7.x.x.

    NOTE:  To override the default action and install the program icons to a different Program folder in the list under Existing Folders, type the name for that folder.

    The installer displays the location into which it will install the Siebel Report Server Access and any other servers you have elected to install. It also displays the file size.

  15. If this is acceptable, click Next. Otherwise, click Back to adjust your installation parameters or location.
  16. The installer proceeds to install the specified files.

    After the install, a warning screen appears stating:

    Setup did not find the "language" language pack on the current media. Please insert the CD containing the "language" language pack and select "setup.exe" file from the "language" folder.

    Where:

    language = the Siebel code for the Language Pack you installed; for example, enu for U.S. English.

    Click OK.

  17. Remove the current CD from the drive and insert the Windows Server Programs, Siebel Enterprise Server, Language CD-ROM (where Language stands for the Language Pack you want to deploy, such as enu for U.S. English) into the CD-ROM drive of the same server.
  18. In Windows Explorer, navigate to the ses\language directory (where language stands for the Language Pack you want to deploy, such as enu for U.S. English) and double-click setup.exe.
  19. After the language pack installation is complete, a warning screen appears stating:

    Please re-insert the base CD and browse to the "setup.exe" file to enable setup to continue.

    Click OK.

  20. Reinsert the Windows Server Programs, Siebel Enterprise Server, Base CD-ROM into the CD-ROM drive.
  21. In Windows Explorer, navigate to the ses directory and double-click setup.exe to continue with the Siebel Reports Server Access installation.
  22. The Installer screen appears. Click Finish.

Postinstallation Tasks for the Siebel Report Server Access

After installing Siebel Report Server Access, you must perform the following tasks:

NOTE:  For running reports in Chinese (Simplified and Traditional), Korean and ENU certified languages, the Arial Unicode MS font needs to be installed under C:\Windows\Fonts on the Windows machine running the Reports Server.

Configuring the Active Portal Template Files

The customized Siebel Active Portal templates will overwrite the ones installed with Actuate Active Portal.

To configure the Active Portal Template Files

  1. Navigate to the following directory under Siebel Report Server Access installation; for example, C:\sea75x\rptsrvr\BIN\RPTCAST\language.
  2. Where:

    language = the Siebel code for the Language Pack you installed; for example, enu for U.S. English

  3. Double-click the rptcast.zip file and extract the files to the Active Portal directory (for example, C:\Program Files\Actuate6\ActivePortal).
  4. NOTE:  In the Extract pop-up window that appears, accept the default Use Folder Names. If unchecked, the files will not extract into the correct folders, which results in a red cross showing instead of the Siebel logo.

  5. Access the Active Portal login page by typing the following URL:
  6. http://ActuateHTTPServiceMachineName:ActuateHTTPServicePortNumber/acweb/login.jsp.

    Where:

    ActuateHTTPServiceMachineName = the name of the machine where Actuate Active Portal is installed. Actuate HTTP service is usually installed on the same machine as Active Portal.

    ActuateHTTPServicePortNumber = the port number of Actuate Active Portal. By default, the port number is 8700.

    You should see the Siebel logo on the Actuate Active Portal login page.

NOTE:  The administrator should make sure that all users clear their browser cache after the template files are applied.

Setting Up the Active Portal Security Extension Library

This library enables the Siebel Reports Server Single Sign-On, which allows users to view reports without having to manually log onto the Reports Server.

To set up the Active Portal Security Extension Library

  1. Stop the Actuate HTTP service from the Windows Services panel.
  2. Move the siebel.jar file from the Siebel Reports Server installation folder to the Active Portal lib directory, for example:
  3. C:\Program Files\Actuate6\ActivePortal\WEB-INF\lib

  4. In the same Siebel Reports Server installation folder find the swewase.dll file and do the following:
    1. Create the folder Native under the Actuate HTTP Service installation bin directory, for example:
    2. C:\Program Files\Common Files\Actuate\6.0\Actuate HTTP Service\bin

    3. Move the swewase.dll file to this folder.
  5. Delete the Standalone folder in the Actuate HTTP Service installation work directory, for example:
  6. C:\Program Files\Common Files\Actuate\6.0\Actuate HTTP Service\work

  7. Start the Actuate HTTP service.

NOTE:  After setting up Active Portal Extension Library, you are no longer able to log into Active Portal by typing the URL http://ActuateHTTPServiceMachineName:ActuateHTTPServicePortNumber/acweb/login.jsp. The Actuate HTTP service port number is by default 8700.

The Siebel Reports Server cookie (ReportCookie) is used once Single Sign-on is established. The ReportCookie passes a user name and auto-generated password to the Reports Server when a report is requested in the Siebel Web Client. For more information on using the ReportCookie, see Siebel Web Client Administration Guide on the Siebel Bookshelf for more information.

Setting the Disable Caching of ROX Parameter

NOTE:  The Disable Caching of ROX parameter is used in Actuate 6 SP1 (Siebel Release 7.5.2.200) or higher.

A change in Actuate e.Reporting Server's functionality causes the Siebel report libraries to not be unloaded after report generation completes. This parameter needs to be set to make sure that the libraries are unloaded after the completion of report generation. This allows the factory server to be in a stable state when the next report request arrives.

The following instructions will set the Disable Caching Property of ROX parameter in the Actuate Management Console.

To set the Disable Caching of ROX parameter

  1. From the Start menu, open the Actuate Management Console.
  2. On the Actuate System/Volume Log In page, select System Administration from the drop-down list.
  3. Log in with the Administrator user name and password.
  4. From the left pane, select Servers.
  5. Under the Name column, click the name of the server.
  6. The server's properties page will appear.

    1. Click the Advanced tab.
    2. In the Properties drop-down list, select Factory service properties.
    3. Select Disable Caching of ROX and click Edit.
    4. Change the value of Disable Caching of ROX to true.
    5. True is lower cased.

    6. Click OK to close the edit window.
  7. Click OK on the Advanced page.
  8. Log out of Actuate Management Console.
  9. Restart the Actuate e.Reporting Server.
Setting Actuate e.Reporting Server Parameters

Siebel Systems strongly recommends that the Reports Server administrator set the Actuate e.Reporting Server parameter ReportingServices - Number of Requests Before Recycling Processes to 100 to avoid memory leaks.

For instructions on how to modify this Actuate e.Reporting Server parameter, see the section titled "Setting advanced server properties" in Administering Actuate e.Reporting System guide. This guide is located in PDF format on the Siebel eBusiness Third-Party Bookshelf under Actuate.

NOTE:  You will find this and other parameters for the Actuate e.Reporting Server by opening the Actuate Management Console, logging into System Administration, selecting a Server, and selecting the Advanced tab.


 Siebel Reports Administration Guide 
 Published: 18 July 2003