Configuring the Target Servers (Optional)

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. You can set the DEVELOPERS variable to restrict authorization.

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 and you can install them on different servers or platforms.

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.

The cgivars.wfs file is located in:

Type of Installation	Location of cgivars.wfs
Developer Studio with localhost	install_drive:\ibi\DevStudio77\srv77\wfs\etc
WebFOCUS	install_drive:\ibi\WebFOCUS77\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\DevStudio77\srv77\wfs\bin
WebFOCUS	install_drive:\ibi\WebFOCUS77\srv77\wfs\bin

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

Access the WebFOCUS Administration Console from the Start menu, choose Programs, WebFOCUS, and WebFOCUS Administration Console.
On the WebFOCUS Administration Console, click Configuration from the left pane and under Client Settings, click General.
Locate the APPROOT variable in cgivars.wfs. 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 2000).

When specifying the setting, use forward slashes (/) to separate directories, as shown in the default setting:
```
APPROOT=install_drive:/ibi/apps
```
An example is:
```
APPROOT=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.
Click Save and exit the WebFOCUS Administration Console.
Note: You must have Administrator privileges in order to modify WebFOCUS Client configuration privileges.

Procedure: How to Set the WebFOCUS Reporting Server Deployment Path Using the Reporting Server Console (Windows)

Access the Reporting Server Console:
- From the Start menu, choose Programs, WebFOCUS Server, 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 icon on the toolbar.
Select Workspace from the left pane, then select Configure.
On the Workspace Configuration window, click the Edit edaserve.cfg button in the upper part of the right pane.
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.
Click Save and Restart and exit the Reporting Server Console.
Note: You must have Administrator privileges in order to modify WebFOCUS Reporting Server configuration privileges.

Procedure: How to Set the Web Server and WebFOCUS Reporting Server Deployment Path Using a Text Editor (Windows and UNIX)

Open the cgivars.wfs file in a text editor such as Windows Notepad.
Locate the APPROOT 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 2000).

When specifying the setting, use forward slashes (/) to separate directories, as shown in the default setting:
```
APPROOT=install_drive:/ibi/apps
```
An example is:
```
APPROOT=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.
Save the changes and close cgivars.wfs.
Open the edaserve.cfg file in the text editor.
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.
Save the changes and close edaserve.cfg.

Procedure: How to Set the Deployment Path (z/OS)

To configure the WebFOCUS Reporting Server, set the APPSNS (application name space) parameter to YES in the EDACFGF configuration routine. In the qualif.INSTALL.DATA(FFSSERV) server configuration file (service block EDAAPPS), the APPROOT variable will be set to the qualif.APP used to install and configure the server.

For example:

APPROOT=EDAYHC.V5R2M01.APP

For more information on the APPSNS parameter, see the Server Installation, Configuration and Operations for MVS manual.

If you are using WebFOCUS Reporting Server for z/OS for deployment, the base application files are allocated during configuration (APPSNS=YES).

Top of page

Example: Allocating Base Application Files (z/OS)

The following is an example of base files allocated for the application:

EDAYHC.V5R2M01.APP.BASEAPP.ACCESS.DATA
EDAYHC.V5R2M01.APP.BASEAPP.FOCEXEC.DATA
EDAYHC.V5R2M01.APP.BASEAPP.FOCSTYLE.DATA
EDAYHC.V5R2M01.APP.BASEAPP.GIF.DATA
EDAYHC.V5R2M01.APP.BASEAPP.HTML.DATA
EDAYHC.V5R2M01.APP.BASEAPP.MASTER.DATA

Procedure: How to Set the Deployment Path (AS/400)

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.
In the Web server HTTP configuration file, add the following lines for APPROOT:
```
Pass /APPROOT/* /IBI/APPS/*
Pass /approot/* /ibi/apps/*
```

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:

If you are using Internet Information Server (IIS), an alias is automatically created for you. During installation of Developer Studio or WebFOCUS, you can choose automatic configuration of IIS.
The APPROOT alias must correspond to the APPROOT path in cgivars.wfs.

Procedure: How to Create an Alias on the Web Server (Windows 2000)

From the Start menu, select Settings to open the Control Panel.
Choose Administrative Tools.
Choose Internet Services Manager. This selection opens a tool that allows you to manage the IIS (the Web server).
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.
Follow the instructions of the Virtual Directory Creation Wizard to create a new virtual directory for APPROOT on the selected Web site.

Note: The Windows Challenge/Response is supported.

Reference: DEVELOPERS Variable for Restricting Authorization

The ibiweb.cfg file contains the DEVELOPERS variable, which identifies users with authorization to deploy files. By default, all users can deploy files:

DEVELOPERS=*

The ibiweb.cfg file is located in:

Type of Installation	Location of ibiweb.cfg
Developer Studio with localhost	install_drive:\ibi\DevStudio77\srv77\wfs\web\cgi
WebFOCUS	install_drive:\ibi\WebFOCUS77\client\wfc\web\cgi

Procedure: How to Restrict Authorization to Deploy Files Using the WebFOCUS Administration Console (Windows)

Access the WebFOCUS Administration Console from the Start menu, choose Programs, WebFOCUS, and then WebFOCUS Administration Console.
The WebFOCUS Administration Console opens. Select Configuration from the options on the left.
Select Startup Parameters.
On the ibiweb.cfg configuration window, select the DEVELOPERS variable and click Modify.
In the Usage field on the next window, enter the new value for the variable.
For an individual user, supply the users logon ID. The user must have write access. For example:
```
DEVELOPERS=admin
```
For multiple users, separate IDs with a semicolon. For example:
```
DEVELOPERS=admin;power_user1;power_user2
```
Click Save and exit the WebFOCUS Administration Console.

Procedure: How to Restrict Authorization to Deploy Files Using a Text Editor (Windows and UNIX)

Open the ibiweb.cfg file in a text editor such as Windows Notepad.
Locate the DEVELOPERS variable.
For an individual user, supply the users logon ID. The user must have write access. For example:
```
DEVELOPERS=admin
```
For multiple users, separate IDs with a semicolon. For example:
```
DEVELOPERS=admin;power_user1;power_user2
```
Save and close ibiweb.cfg.