Configuring the Target Servers (Optional)

How to:

Reference:

During installation, Developer Studio and WebFOCUS set certain variables that affect the implementation of the deployment feature. You have the option of changing the values for these variables to meet site-specific needs. Most sites use the default values supplied during installation.

You can optionally specify the path in which files will reside on the web server and the WebFOCUS Reporting Server. The path is defined by the APPROOT variable, which you can set in two different files, one for the web server and one for the Reporting Server.

You also have the option of restricting the users authorized to deploy files.

Follow the instructions in this topic to review or change the settings. You can use the WebFOCUS Administration Console and the Reporting Server Console to edit the files that contain the variables, or you can edit them manually.

You need read and write access to the web server and WebFOCUS Reporting Server in order to deploy files.

Note: The Application Root (APPROOT) directory of the WebFOCUS Client and Reporting Server do not need to point to the same physical location. You can install them on different servers or platforms.


Top of page

x
Reference: APPROOT Variable for Setting the Deployment Path

The cgivars.wfs file contains the APPROOT variable for the path in which deployed files will reside on the web server. Typically these files include HTML pages, graphic images, Cascading Style Sheets, and JavaScript files.

For the client, the APPROOT variable points to the setting for IBI_Approot_Directory in the Administration Console. This setting is in the webconfig.xml file, which is located in \ibi\WebFOCUS80\config.

The cgivars.wfs file is located in:

Type of Installation

Location of cgivars.wfs

Developer Studio with localhost

install_drive:\ibi\DevStudio80\srv80\wfs\etc

WebFOCUS

install_drive:\ibi\WebFOCUS80\client\wfc\etc

The edaserve.cfg file contains the APPROOT variable for the path in which deployed files will reside on the WebFOCUS Reporting Server. Typically these files include procedures, WebFOCUS StyleSheets, and customized HTML pages that require processing on the Reporting Server.

The edaserve.cfg file is located in:

Type of Installation

Location of edaserve.cfg

Developer Studio with localhost

install_drive:\ibi\DevStudio80\srv80\wfs\bin

WebFOCUS

install_drive:\ibi\WebFOCUS80\srv80\wfs\bin



x
Procedure: How to Set the Web Server Deployment Path Using the WebFOCUS Administration Console (Windows)

The APPROOT variable points to the setting for IBI_Approot_Directory in the Administration Console.

  1. Access the WebFOCUS Administration Console from the Start menu, choose Programs, Information Builders, WebFOCUS 80 Developer Studio, WebFOCUS Developer Studio Utilities, and WebFOCUS Administration Console.
  2. On the WebFOCUS Administration Console, click Configuration from the left pane and under Application Settings, click Application Directories.
  3. Locate the IBI_Approot_Directory in the webconfig.xml file. Change the setting to a directory that exists on the web server.

    Ensure that this directory is also configured as a virtual directory on the web server, to allow users access to the application. For details, see APPROOT Alias and How to Create an Alias on the Web Server (Windows).

    When specifying the setting, use forward slashes (/) to separate directories, as shown in the default setting:

    IBI_Approot_Directory=install_drive:/ibi/apps

    An example is:

    IBI_Approot_Directory=d:/ibi/apps

    During deployment, Developer Studio creates a new subdirectory on the web server under APPROOT. For example, d:\ibi\apps\Sales.

    You can add one or more subfolders to the web server deployment path. For details, see Step 3: Partition the Project Files.

  4. Click Save and exit the WebFOCUS Administration Console.

    Note: You must have Administrator privileges in order to modify WebFOCUS Client configuration privileges.


Top of page

x
Procedure: How to Set the WebFOCUS Reporting Server Deployment Path Using the Reporting Server Console (Windows)
  1. Access the Reporting Server Console:
    • From the Start menu, choose Programs, Information Builders, WebFOCUS 80 Developer Studio, WebFOCUS 77 Server for Developer Studio, and Web Console.

      or

    • In Developer Studio, expand the applicable environment under WebFOCUS Environments. Expand Data Servers. Select the remote WebFOCUS Reporting Server. Click the WebFOCUS Reporting Server Console button on the toolbar.
  2. From the menu bar, select Workspace.
  3. In the navigation pane, expand the Configuration Files folder.
  4. Right click Workspace - edaserve.cfg and select Edit.
  5. Locate the APPROOT variable. Change the setting to a directory that exists on the WebFOCUS Reporting Server.

    During deployment, Developer Studio creates a new subdirectory on the WebFOCUS Reporting Server under APPROOT. For example, c:\ibi\apps\Sales.

  6. Click Save and Restart Server and exit the Reporting Server Console.

    Note: You must have Administrator privileges in order to modify WebFOCUS Reporting Server configuration privileges.


Top of page

x
Procedure: How to Set the Web Server and WebFOCUS Reporting Server Deployment Path Using a Text Editor (Windows and UNIX)
  1. Open the webconfig.xml file in a text editor, such as Windows Notepad.
  2. Locate the IBI_Approot_Directory variable. Change the setting to a directory that exists on the web server.

    Ensure that this directory is also configured as a virtual directory on the web server, to allow users access to the application. For details, see APPROOT Alias and How to Create an Alias on the Web Server (Windows).

    When specifying the setting, use forward slashes (/) to separate directories, as shown in the default setting:

    <param-name>IBI_Approot_Directory</param-name>
         <param-value>install_drive:/ibi/apps</param-value>

    An example is:

    <param-name>IBI_Approot_Directory</param-name>
         <param-value>d:/ibi/apps</param-value>

    During deployment, Developer Studio creates a new subdirectory on the web server under APPROOT. For example, d:\ibi\apps\Sales.

    You can add one or more subfolders to the web server deployment path. For details, see Step 3: Partition the Project Files.

  3. Save the changes and close webconfig.xml.
  4. Open the edaserve.cfg file in the text editor.
  5. Locate the APPROOT variable. Change the setting to a directory that exists on the WebFOCUS Reporting Server.

    During deployment, Developer Studio creates a new subdirectory on the WebFOCUS Reporting Server under APPROOT. For example, c:\ibi\apps\Sales.

  6. Save the changes and close edaserve.cfg.

Top of page

x
Procedure: How to Set the Deployment Path (AS/400)
  1. In the CGI_BIN/EXPORT(WEBEXPORT) directory, set the APPROOT variable to the APPNAME defined during installation of the WebFOCUS Reporting Server for AS/400. This value is the same one defined for APPROOT in the xxxBIN/CONFIG(EDASERVE) file.
  2. In the web server HTTP configuration file, add the following lines for APPROOT:
    Pass /APPROOT/* /IBI/APPS/*
    Pass /approot/* /ibi/apps/*

Top of page

x
Reference: APPROOT Alias

After you set the APPROOT variable, you may need to create an alias for it. The alias allows browsing of the application directory and read permission.

The following will help you determine if you need to create an alias:


Top of page

x
Procedure: How to Create an Alias on the Web Server (Windows)
  1. From the Start menu, select Settings to open the Control Panel.
  2. Select Administrative Tools.
  3. Select Internet Services Manager. This selection opens a tool that allows you to manage IIS (the web server).
  4. In the Internet Information Services window, locate and expand the Default Web Site node.

    Right-click the Default Web Site node and choose New, followed by Virtual Directory.

  5. Follow the instructions of the Virtual Directory Creation Wizard to create a new virtual directory for APPROOT on the selected website.

Note: The Windows Challenge/Response is supported.


WebFOCUS