There are two methods for installing the Business Analytics (BA) design tools.
You can use either of these methods:
- The Pentaho Business Analytics Installation Wizard
- Install each separate tool manually.
Choose an installation method
Review the following table to determine which installation method is best for you.
|Method:||Pentaho Wizard Installation||Manual Installation|
The Pentaho Business Analytics Installation Wizard is the easiest way to install design tools, utilities, or plugins on the server or client workstations.
Use this method for evaluating the Pentaho Suite and for rapid development.
The manual method allows you to manually copy design tool installation files to any directory on the server or client workstations.
Use this method for rapid development.
|Expertise:||Basic computer knowledge.||Basic computer knowledge.|
Each method takes about 15 minutes to complete.
As specified in the Components Reference each of the following items:
|Approximate Installation Time||5 - 10 minutes per client tool|
Install tools with the Installation Wizard
The Pentaho Business Analytics Installation Wizard is the preferred method for installing BA design tools.
Run the Pentaho Business Analytics Installation Wizard according to the instructions in the Evaluation Installation of the Pentaho Suite.Be sure to perform the following steps while running the wizard.
On the Setup Type window, select the Let me decide for myself option.
When the Pentaho Applications window displays during the installation process, select any combination of the following BA design tools:
- Reporting Design Tools
- Analysis Design Tools
When the installation wizard is complete, start the tools using one of the following ways:
- Windows: Select the tool you want to start from the Start menu.
- Linux: Open a Terminal window, then navigate to ~/pentaho/design-tools/ and launch the tool.
- Mac: Navigate to the Applications/pentaho/design-tools/ and double-click the file.
Perform a manual installation of the BA design tools
To manually install design tools, follow these steps.
Step 1: Download files
You can download installation files from either of these locations:
On the Customer Portal home page, sign in using the Pentaho support user name and password provided in your Pentaho Welcome Packet.
Click Downloads, then click Pentaho 9.3 GA Release in the 9.x list.
On the bottom of the Pentaho 9.3 GA Release page, click the Client Tools folder in the Box widget.
A list of folders appears corresponding to each client tool. Click each folder to access and download the following files.
NoteFor prd-ee Mac OS customers, the unique file is included as part of the prd-ee package.
- Aggregation Designer Design Tool: pad-ee-9.3.0-dist.zip
- Metadata Editor Design Tool: pme-ee-9.3.0-dist.zip
- Schema Workbench Design Tool: psw-ee-9.3.0-dist.zip
- Report Designer Design Tool: prd-ee-9.3.0-dist.zip
Step 2: Unpack the files
Use a ZIP tool to extract the file you just downloaded.CautionDo not use Unarchiver 3.3 to unzip files; it may corrupt the plugin file names.
Open a Command Prompt window or a Terminal window and navigate to the folder that contains the files you just extracted.
Depending on your operating system, enter one of the following commands at the prompt.
- Windows: install.bat
- Linux: ./install.sh
Read the license agreement that appears. Select Accept, then click Done.NoteIf you are unpacking the file in a non-graphical environment, open a Terminal window or a Command Prompt window and type java -jar install.jar -console and follow the instructions presented in the window.
Specify where you want the file to be unpacked.
This location can be temporary because you will be manually placing the files in the appropriate directories later in these instructions.
Click the Next button. The Installation in Progress window appears.
When the installation progress is complete, click Quit to exit the Unpack Wizard.
Step 3: Install the design tools
Create a directory for installing your design tools.NoteFor publishing reports, models, and schemas created with the design tools, we recommend you install the design tools in a directory on a workstation or server that is on the same network as the Pentaho Server.
If you are unsure of the directory in which to install the design tools, we suggest that you create a Pentaho directory and design-tools subdirectory on your workstation and install the design tools there. If you choose this option, the directory path should look like the following:
Verify that you have the appropriate permissions to read, write, and execute commands in the directories you created.
Extract the design tool installation file(s) to the design-tools directory.
As you extract the installation files, directories which hold the design tools are created.
- Aggregation Designer: pentaho/design-tools/aggregation-designer
- Metadata Editor: pentaho/design-tools/metadata-editor
- Report Designer: pentaho/design-tools/report-designer
- Schema Workbench: pentaho/design-tools/schema-workbench
(Optional) Install the Analysis Enterprise Edition plugin
AUDIENCE: Advanced Mondrian users who want to distribute cached data across a self-managed cluster of peers.
The Analysis Enterprise Edition Plugin is distributed as a set of JAR archives and configuration files which must be deployed alongside an existing Mondrian installation. This plugin contains Analysis engine enhancements for large ROLAP deployments. When this JAR archive is deployed properly, it will register new features and make them available to Mondrian. For more information about using this plugin with Mondrian, see Mondrian cache control.
Follow the instructions below to install the Pentaho Analysis Enterprise Edition package:
If you have not already done so, retrieve the pentaho-analysis-ee-9.3.0.zip file from the Pentaho website.
Unpack the file to a temporary location.
Stop the Pentaho Server if it is running.
Copy the following JARs from the /pentaho-analysis-ee/lib/ directory to the /tomcat/webapps/pentaho/WEB-INF/lib/ directory.
Copy all the configuration files (listed in the following table) from /pentaho-analysis-ee/config/ to the /tomcat/webapps/pentaho/WEB-INF/classes/ directory.
File Description pentaho-analysis-config.xml Defines the global behavior of the Pentaho Analysis Enterprise Edition plugin. Settings in this file enable you to define which segment cache configuration to use, and to turn off the segment cache altogether. infinispan-config.xml The InfinispanSegmentCache settings file. It configures the Infinispan system. jgroups-tcp.xml Configures the cluster backing the Infinispan cache. It defines how the nodes find each other and how they communicate. By default, Pentaho uses TCP and multicast discovery, which enables you to run many instances on a single machine or many instances on many machines. (There are examples of other communication setups included in the JAR archive.) This file is referenced by infinispan as specified in the infinispan-config.xml configuration file. memcached-config.xml Configures the Memcached-based segment cache. It is not used by default. To enable it, modify SEGMENT_CACHE_IMPL in: pentaho-analysis-config.xml
Depending on the installation type, there would not be a pentaho.war file.In archive-based installations and executable-based installations, the pentaho.war is already deployed and the application will show as: /tomcat/webapps/pentaho/
Remove the temporary pentaho-analysis-ee directory.
To enable the segment cache plugin, first follow the installation steps above.
Once complete, open the file WEB-INF/classes/pentaho-analysis-config.xml and set the following property:
<entry key="USE_SEGMENT_CACHE">true</entry>For more details see: http://wiki.pentaho.com/display/analysis/Pentaho+Analysis+EE