Installing App Studio

In this section:

There are two ways to run the installation utility:


Top of page

x
Web and/or Application Server Options

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.


Top of page

x
Installing App Studio and WebFOCUS on the Same Machine

When installing WebFOCUS and App Studio on the same machine, do the following:

  1. Ensure that your machine meets the WebFOCUS requirements.
  2. Completely install and configure WebFOCUS.
  3. Install App Studio.

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.


Top of page

x
Running the Installation

How to:

Follow this procedure to install App Studio.

Note: You must be an administrator to the Windows machine to run the installation.



x
Procedure: How to Install App Studio

The App Studio installation can be obtained through an Internet download.

  1. Run the downloaded file (setup.exe) and respond when prompted to unpack files needed during the installation.

    When the files are unloaded, the installation begins with a Welcome window, as shown in the following image.

    Installation program Welcome window

  2. Click Next at the Welcome window.

    The License Agreement is displayed, as shown in the following image.

    License Agreement window

  3. Select I accept the terms of the license agreement if you accept the License Agreement and then click Next.

    The following image shows the Software Registration dialog box.

    Software Registration window

  4. Type the product serial number when prompted and click Next.

    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.

  5. Click Yes to accept the Registration Confirmation.

    A window appears, describing App Studio requirements, as shown in the following image.

    Software requirements window

  6. Review the requirements and then click Next.

    The Select Program Folder window opens, as shown in the following image.

    Select Program Folder window

    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.

  7. Accept the default program folder, or specify a new one, and click Next.

    The Choose Destination Location window opens, as shown in the following image.

    Choose Destination Location screen

  8. Specify the following locations, or accept the default values:
    1. Product Installation Directory. This contains the software executable files. The new software will be placed in this directory.

      Accept the default value or click Browse to select a different directory.

    2. Application Directory. This contains the sample applications that come with the product, and is the location where you create stand-alone applications.

      Accept the default value or click Browse to select a different directory.

    3. Disk. If there is more than one disk or shared folder to which the software can be installed, select the one on which you want to install.
  9. Click Next.

    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.

    Components Setup window

    This window includes the following options. If an option is already installed or unavailable, it is grayed out:

    • WebFOCUS App Studio. When selected, this installs the App Studio development environment. This option is required.
    • Java 2 SDK, SE 1.6.0_25. When selected, this installs Java components needed for App Studio. If Java SDK 1.5 or higher is not already installed, you must install this SDK.

      Note: This option is not enabled if version 1.6.0_25 or higher is already installed.

    • Apache Tomcat 7.0.33 When selected, this installs Apache Tomcat for use as the web and/or application server. Select this option to configure the App Studio Help locally on your machine.

      Note: This option is not enabled if a supported version of Tomcat is detected.

    The following configuration options appear:

    • Use WebFOCUS configuration. This option is visible if WebFOCUS is detected on the same PC. When selected, the installation continues and will not allow customizable configurations.
    • Configure Apache Tomcat 7.0.33 stand-alone. When selected, this configures the detected or installed Apache Tomcat version for use with App Studio as both a web and application server. This can also be manually configured, as explained in Configuring Additional Web and/or Application Servers. Select this option to configure the App Studio Help locally on your machine. If the option to use the WebFOCUS Configuration is selected, the Tomcat configuration is enabled, and will create an App Studio Help context that does not affect the WebFOCUS configuration.
    • Configure Apache Tomcat 7.0.33 connector (plug-in) for Microsoft IIS. When selected, this configures Apache Tomcat as the application server, configures IIS as the web server, and configures communications between IIS and Tomcat. IIS must be installed to use this option. This can also be manually configured, as explained in Configuring Additional Web and/or Application Servers.
    • Advanced Configuration. When selected, this configures the aliases and context roots created during the installation and provides optional settings to customize them. Customizing the available options ensures they are different from the aliases and context roots used by WebFOCUS or an earlier version of App Studio in case you select the option to have multiple installations.

      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.

    • WebFOCUS Quick Data. This option installs an Excel Add-In that allows developers to create WebFOCUS reports directly from Microsoft Excel. Developers create reports using InfoAssist, and output is displayed in the active Excel Workbook.

      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. WebFOCUS RStat is a statistical modeling workbench embedded in App Studio. It allows you to perform common statistical and data mining tasks, and develop models that can be deployed as scoring applications on every platform. RStat enables data miners and Business Intelligence developers to collaborate with the same features used to access, manipulate, or transform data, develop predictive models, and create and deploy scoring applications along with associated reports to any worker within their organization.

      WebFOCUS RStat includes:

      • Intuitive user interface in App Studio to access the most widely used statistical and data mining models: decision trees, neural networks, linear and logistic regressions, random forests, support vector machine, boosting, association rules, K-means, and hierarchical clustering.
      • Ability to prepare the data. For example, extract it from any data source, manipulate and transform fields to prepare data for analysis, and perform the modeling in App Studio.
      • Access to a simple web form so that you can, with the click of a button, generate scores and predictions without having to know anything about data mining and modeling.
      • Ability to perform common data exploration tasks and various distribution tests in order to determine the most appropriate modeling technique.
      • Ability to explore the data visually with a robust set of charts and interactive visualizations.
      • Incorporate predicted values and scores into any WebFOCUS report so that users can benchmark their intuitions and expert opinions to ensure that they have taken all factors into consideration when making decisions.
      • RStat is extensible through scripts and open source to leverage the numerous packages developed by industry experts and scientists to perform highly complex analyses and rapidly deploy applications.

      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:

    • WebFOCUS App Studio. When selected, this installs the App Studio development environment. This option is required.
    • Java 2 SDK, SE 1.6.0_25. When selected, this installs Java components needed for App Studio. If Java SDK 1.5 or higher is not already installed, you must install this SDK.

      Note: This option is not enabled if version 1.6.0_25 or higher is already installed.

    • Local App Studio Help (Requires Local Tomcat Application Server) configure Apache Tomcat 7WF for Appstudio Help. When selected, this installs Apache Tomcat as the application server for your App Studio Help.
    • Configure Remote App Studio Help (The remote help must be setup manually). When selected, this configures App Studio so it accesses the Help on a remote application server. If you choose this option, you need to type a host name and port number based on the application server that is hosting the Help system.

      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.

  10. Select the components you wish to install and configure, and then click Next.

    The Start Copying Files window opens, as shown in the following image.

    File Copying screen

  11. Review the summary of tasks that will be performed during the install and click Next to begin the installation.

    An installation progress dialog box opens, as shown in the following image.

    Installation progress dialog box

    Once the installation has completed, the InstallShield Wizard Complete dialog box opens, as shown in the following image.

    Installation completion window

  12. Click Finish to complete the installation.

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.


Top of page

x
App Studio Directory Structure

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:

\apps

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.

\AppStudio80\backup

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.

\AppStudio80\bin

Contains the graphical front-end components for creating WebFOCUS applications.

\AppStudio80\client

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.

\AppStudio80\config

Contains the install.cfg that holds information about the installation.

\AppStudio80\ibi_html

Contains webpage components that provide local processing, web-based tools, and other features.

\AppStudio80\logs

Contains space for logs.

\AppStudio80\magnify

Contains Magnify data and sample applications.

\AppStudio80\QuickLinks

Contains links for sample applications.

\AppStudio80\srv80

Contains a WebFOCUS Reporting Server installed and configured for App Studio.

\AppStudio80\temp

Contains space for local processing.

\AppStudio80\Templates

Contains reporting and maintain templates.

\AppStudio80\utilities

Contains features and files for additional configurations.

\AppStudio80\webapps

Contains the WebFOCUS web application.

\AppStudio80\derby

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

Top of page

x
Installation Log Files

App Studio creates a log file in the following location for Windows 7:

drive:\Users\user_id\as_80_inst_date_time.log

where:

user_id

Is your Windows user ID.

date_time

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.


Top of page

x
WebFOCUS Reporting Server for App Studio

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.


Top of page

x
Tomcat Security and Settings

Reference:

If you are not using Tomcat, proceed to Verifying App Studio.



x
Reference: Apache Tomcat Installation Information

If you installed Tomcat with App Studio, the installation is done silently and uses default settings.


WebFOCUS