In this section: |
There are two ways to run the installation utility:
The App Studio installation can automatically configure one of the following for you:
This document assumes IIS listens on port 80 and Tomcat listens on port 8080. If you change the defaults, substitute accordingly.
You can manually configure a different application server, as explained in Configuring Additional Web and/or Application Servers.
When installing WebFOCUS and App Studio on the same machine, do the following:
The App Studio installation program will detect that WebFOCUS is already installed and allows you to select and use the WebFOCUS configuration or install App Studio with its own configuration. If you select to use the WebFOCUS configuration, the install program will not provide options to automatically configure a web or application server. In this case, you do not need to configure a web or application server for App Studio if one is already configured for WebFOCUS on the machine. App Studio will use the existing WebFOCUS environment including the web or application server configuration. All products can co-exist and use the WebFOCUS environment through App Studio or a browser.
If you choose to create a separate configuration for App Studio, you must select the Advanced Configuration option and specify a unique alias for /ibi_apps and port for the App Studio Reporting Server to avoid conflicts with the WebFOCUS configuration.
How to: |
Follow this procedure to install App Studio.
Note: You must be an administrator to the Windows machine to run the installation.
The App Studio installation can be obtained through an Internet download.
When the files are unloaded, the installation begins with a Welcome window, as shown in the following image.
The License Agreement is displayed, as shown in the following image.
The following image shows the Software Registration dialog box.
The serial number is based on your license agreement and controls the software edition that is installed.
If you type a valid serial number, the Registration Confirmation window appears.
A window appears, describing App Studio requirements, as shown in the following image.
The Select Program Folder window opens, as shown in the following image.
You can change the Program Folder name by adding a suffix. Changing the default name will also change the folder name where App Studio will be installed. For example, if the default folder name is WebFOCUS 80 App Studio, the product will be installed in a directory with the name ...\AppStudio80.
The Choose Destination Location window opens, as shown in the following image.
Accept the default value or click Browse to select a different directory.
Accept the default value or click Browse to select a different directory.
The WebFOCUS App Studio Setup window opens. This options that display are specific to the edition of App Studio that you are installing.
The following image shows the WebFOCUS App Studio Setup window that displays when you license the App Studio edition or App Studio Visual Discovery edition of the product. This means that you can perform local or stand-alone development, remote development, and have full access to all of the features that are available in App Studio.
This window includes the following options. If an option is already installed or unavailable, it is grayed out:
Note: This option is not enabled if version 1.6.0_25 or higher is already installed.
Note: This option is not enabled if a supported version of Tomcat is detected.
The following configuration options appear:
Select this option to configure the App Studio Help remotely. The Web Server and Application Server Configurations window opens, as shown in the following image.
Note: This option is only available if you clear the Configure Apache Tomcat stand alone check box in the previous window.
Enabling this option through App Studio provides a single-user license applicable only to the App Studio user. This option also functions against the local App Studio environment or against licensed WebFOCUS environments.
This feature must be licensed separately for use in multi-user WebFOCUS environments. This also applies when App Studio and WebFOCUS are installed on the same PC. For additional information, see Technical Memo 4649: Using WebFOCUS Quick Data Add-in.
WebFOCUS RStat includes:
For additional information on WebFOCUS RStat, see the Using WebFOCUS RStat for Predictive Analytics manual.
The WebFOCUS RStat software can be downloaded from the Customer Support site.
Note: These configuration options are available even if you select the option to use the WebFOCUS configuration. When you select the Advanced Configuration option to configure Tomcat, you are only able to configure the App Studio Help locally.
To manually configure a different application server, deselect the configuration options and refer to Configuring Additional Web and/or Application Servers.
The following image shows the WebFOCUS App Studio Setup window that displays when you license the Managed Reporting Developer edition, or Report Developer edition of the product. This means that you can perform remote development, and have access to specific features in App Studio.
This window includes the following options. If an option is already installed or unavailable, it is grayed out:
Note: This option is not enabled if version 1.6.0_25 or higher is already installed.
For more information about configuring the machine that will be hosting the remote Help, see Deploying the App Studio Help on a Remote Application Server.
The Start Copying Files window opens, as shown in the following image.
An installation progress dialog box opens, as shown in the following image.
Once the installation has completed, the InstallShield Wizard Complete dialog box opens, as shown in the following image.
Note: If you choose the Tomcat connector (plug-in) option and receive a message that says Unable to Create Filter, some manual configuration is required. To do this, open the Internet Services Manager, right-click your website, and choose Properties. On the ISAPI Filters tab, determine if a Jakarta or ServletExec filter appears. If neither appear, click Add and add the isapi_redirect.dll file using the filter name Jakarta. For more information, review the remainder of this chapter and then see Configuring Microsoft IIS to Use the Tomcat Connector (Plug-in). Also, be aware that you cannot use the Tomcat plug-in if ServletExec ISAPI is installed.
After installation, the App Studio directory structure is created. The default location is:
C:\ibi
The following are some of the main subdirectories. The actual directories may vary based on your license:
Contains applications and data. By default, this is the APPROOT directory where WebFOCUS looks for application files. Sample files are provided in the \ibinccen and \ibisamp directories.
Contains a backup of the cgivars.wfs file. If your main cgivars.wfs configuration becomes corrupt, you can use this backup file to replace a corrupt version.
Contains the graphical front-end components for creating WebFOCUS applications.
Contains WebFOCUS Client configuration files. Many of these files were installed with the WebFOCUS Reporting Server in previous versions. However, the main communications file odin.cfg is still installed under the srv80\wfs\etc directory instead.
Contains the install.cfg that holds information about the installation.
Contains webpage components that provide local processing, web-based tools, and other features.
Contains space for logs.
Contains Magnify data and sample applications.
Contains links for sample applications.
Contains a WebFOCUS Reporting Server installed and configured for App Studio.
Contains space for local processing.
Contains reporting and maintain templates.
Contains features and files for additional configurations.
Contains the WebFOCUS web application.
Contains the embedded Derby database files.
If you installed Tomcat, the default location is:
drive:\ibi\tomcat
If you are using Tomcat and IIS together, the Tomcat plug-in (connector) is installed in:
C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector
App Studio creates a log file in the following location for Windows 7:
drive:\Users\user_id\as_80_inst_date_time.log
where:
Is your Windows user ID.
Is the date and time the log file was created.
This log file provides information about the App Studio installation. If you contact Customer Support Services with an installation problem, have this file available.
The App Studio development features require certain components installed with the WebFOCUS Reporting Server. Therefore, a Reporting Server is always installed with App Studio even when one is already installed, or you use App Studio for remote processing.
This server is configured for App Studio and installed within the App Studio directory structure. On the Start menu, it is under Programs, Information Builders, WebFOCUS 80 App Studio, and WebFOCUS 80 Server for App Studio.
Note: The server only starts with security OFF and can only be started by the user who installed App Studio.
If you install App Studio on the same machine as WebFOCUS, be sure to configure the server installed for WebFOCUS and not the server installed with App Studio. The server installed for WebFOCUS should be started before App Studio. Otherwise, App Studio starts the server installed with App Studio instead.
Reference: |
If you are not using Tomcat, proceed to Verifying App Studio.
If you installed Tomcat with App Studio, the installation is done silently and uses default settings.
drive:\ibi\tomcat
<catalina_home>\conf\server.xml
If you change defaults, substitute accordingly in procedures and examples. You also need to update the App Studio connection settings so it knows the correct Tomcat HTTP port if you change the default. See Tomcat Ports.
This secures access to the Tomcat Manager and Administration web applications and restricts connections by remote IP addresses or hosts.
Restriction to localhost only connections is done by configuring <catalina_home>\conf\server.xml and adding an entry for address="127.0.0.1" to the segment <Connector port="8080"…/>. For example:
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 --> <Connector port="8080" maxHttpHeaderSize="8192" address="127.0.0.1" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />
<catalina_home>\Jakarta Isapi Redirector
WebFOCUS |