Embed Size (px)
Citation preview
SpagoBI InstallationAngelo Bernabei2013/11/14 12:05
spagobi_server - SpagoBI Installation
Page 2 - last modified by Angelo Bernabei on 2013/11/14 12:05
Table of ContentsInstall JDK .............................................................................................................................................................................. 3Install Tomcat ......................................................................................................................................................................... 3Install SpagoBI Metadata DB ................................................................................................................................................ 3Deploy SpagoBI WebApplication on Tomcat ....................................................................................................................... 4Configure SpagoBI ................................................................................................................................................................. 4
Edit server.xml ..................................................................................................................................................................... 4Set Up Data Source ............................................................................................................................................................. 4Set up Environment variables .............................................................................................................................................. 4Context /SpagoBI ................................................................................................................................................................. 5Context /SpagoBI*Engine .................................................................................................................................................... 5Thread Manager ................................................................................................................................................................... 6
Additional libraries ................................................................................................................................................................. 6Run & Test ............................................................................................................................................................................. 6
spagobi_server - SpagoBI Installation
Page 3 - last modified by Angelo Bernabei on 2013/11/14 12:05
This section describes the installation procedure for the latest release of SpagoBI. For older versions, please check here .
Beside the quick start procedure that installs all SpagoBI engines with minimal configuration effort (All-In-One),advanced users can choose to manually select which engines to download and install.
This section describes how to perform a customized installation of SpagoBI.
• Install JDK• Install Tomcat• Install SpagoBI Metadata DB• Deploy SpagoBI WebApplication on Tomcat• Configure SpagoBI
° Edit server.xml° Set Up Data Source° Set up Environment variables
· Environment variable: resource-path· Environment variable: spagobi-sso-class· Environment variables: spagobi-service-url· Environment variables: spagobi-host-url
° Context /SpagoBI° Context /SpagoBI*Engine° Thread Manager
• Additional libraries• Run & Test
Install JDK
If you haven't a JVM (1.5 or 1.6) already installed on your machine, you have to download and install it.
Install Tomcat
Download Tomcat 6.0.18 from http://tomcat.apache.org/download-60.cgi and unzip apache-tomcat-6.0.18.zip.To check if the installation was successful:
• double-click on apache-tomcat-6.0.18/bin/startup.bat• open your browser and type http://localhost:8080• you should be able to see the "Tom cat"
Install SpagoBI Metadata DB
SpagoBI relies on a schema to store metadata about configuration, document template, etc.You need to create this schema using a SQL script according to your DBMS Type (e.g., Oracle, MySQL, etc.). You caneasily create the schema by running the scripts shipped with SpagoBI (in the Scripts db package) of the chosen SpagoBIServer release.
The Scripts db package may contain, apart from .sql scritps, a README.txt file and patches to be applied to SpagoBIServer: follow the instructions of README.txt after having deployed SpagoBI war files as explained below.
For example, in MySql you have to open "MySql Query Browser" and execute these files:
• MySQL-create.sql• MySQL-create-quartz-schema.sql
In order to recreate the Foodmart DB open MySql Administrator and execute an import of foodmart DB.Remember to change the MySQL File dimension ( my.ini)
spagobi_server - SpagoBI Installation
Page 4 - last modified by Angelo Bernabei on 2013/11/14 12:05
Deploy SpagoBI WebApplication on Tomcat
Copy all WAR in WEBAPP Folder of Tomcat, run Tomcat with startup.bat (Windows) or startup.sh (Linux).This operation extracts all WAR files and allows you to edit the configuration files.
Don't worry if Tomcat writes some type of error in console or log files
Configure SpagoBI
Now you have to edit some configuration file.
Edit server.xml
This is Tomcat main configuration file. Here you need to set up:
• DataSource• Environment variables
From SpagoBI version *2.3* context information is defined within the *META-INF/context.xml* files, which are alreadyincluded in all packages.
If you don't use the 6.0.18 version of Tomcat you have to check at [ http://www.apache.org ] how these configurationsare made.
Set Up Data Source
To add a new Data Source you need to add the following XML excerpt under tag:
<GlobalNamingResources>
Here is the excerpt to add:
<Resource auth= "Container" driverClassName= "com.mysql.jdbc.Driver" maxActive= "20" maxIdle= "10" maxWait= "-1" name= "jdbc/spagobi" password= "root" type= "javax.sql.DataSource" url= "jdbc:mysql://localhost/spagobi"username= "root" /><Resource auth= "Container" driverClassName= "com.mysql.jdbc.Driver" maxActive= "20" maxIdle= "10" maxWait= "-1" name= "jdbc/foodmart" password= "root" type= "javax.sql.DataSource" url= "jdbc:mysql://localhost/foodmart"username= "root" />
The first represents the Connection pool for SpagoBI metadata and the second the Connection pool for Foodmart ( DWHused for demos )Note that the JDBC driver must be available under the /lib folder.
Remember to insert in each Context the resource-link:
<ResourceLink global= "<JNDI_NAME>" name= "<JNDI_NAME>" type= "java.lang.String" />
Set up Environment variables
To add a new Variable you need to add the following XML excerpt under tag:
<GlobalNamingResources>
Here is the excerpt:
<Environment name= "<VARIABLE-NAME>" type= "java.lang.String" value= "<VARIABLE-VALUE>" />
Remember to insert in each Context the resource-link:
<ResourceLink global= "<VARIABLE-NAME>" name= "<VARIABLE-NAME>" type= "java.lang.String" />
Environment variable: resource-path
<Environment name= "spagobi-resource-path" type= "java.lang.String" value= "C:\spagobi2.0\resources" />
This path is used to store resources that SpagoBI Server will look for at the specified directory. These resources are:
• QBE datamarts• Talend jobs
spagobi_server - SpagoBI Installation
Page 5 - last modified by Angelo Bernabei on 2013/11/14 12:05
• Images that are used within reports• HTML files• .xls. or .csv files used in self-service datasets
Until SpagoBI 3.x the same path should also include:
• Mondrian XML schemas
Starting SpagoBI 4, Mondrian schemas are made available to SpagoBI Server under a dedicated catalog.
Dont' forget to create this PATH !
Environment variable: spagobi-sso-class
<Environment name= "spagobi-sso-class" type= "java.lang.String" value="it.eng.spagobi.services.common.FakeSsoService" />
These classes implements the interaction between SpagoBI and the SSO system.
• it.eng.spagobi.services.common.FakeSsoService(NO SSO)• it.eng.spagobi.services.cas.CasSsoService ( CAS 2.0 )• it.eng.spagobi.services.cas.CasSsoServiceNoProxy( CAS 2.0 , without WebService Security )• it.eng.spagobi.services.cas.CasSsoService3 ( CAS 3.0 )• it.eng.spagobi.services.cas.CasSsoService3NoProxy ( CAS 3.0, without WebService Security )
Environment variables: spagobi-service-url<Environment name= "spagobi-service-url" type= "java.lang.String" value= "http://localhost:8080/SpagoBI" />
This URL is only for back-end serviceYou have to change this value if SpagoBI core and some Engines are not installed in the same server
Environment variables: spagobi-host-url<Environment name= "spagobi-host-url" type= "java.lang.String" value= "http://localhost:8080" />
This URL is used to produce some address in html.This is useful if there is a proxy server between the SpagoBI Server and the Browser
Context /SpagoBI
These context information are embedded in META-INF/context.xml, but you can insert this xml in server.xml if youprefere.
<Context docBase= "SpagoBI" path= "/SpagoBI" privileged= "true" reloadable= "true" > <ResourceLink global= "jdbc/spagobi" name= "jdbc/spagobi" type= "javax.sql.DataSource" /> <ResourceLink global= "jdbc/foodmart" name= "jdbc/foodmart" type= "javax.sql.DataSource" /> <ResourceLink global= "spagobi-resource-path" name= "spagobi-resource-path" type= "java.lang.String" /> <ResourceLink global= "spagobi-sso-class" name= "spagobi-sso-class" type= "java.lang.String" /> <ResourceLink global= "spagobi-host-url" name= "spagobi-host-url" type= "java.lang.String" /></Context>
You have to define /SpagoBI Context, this configuration depends on the Tomcat version ( check on [ http://www.apache.org ] )
Context /SpagoBI*Engine
These context information are true for all ENGINE and are embedded in META-INF/context.xml, but you can insert thisxml in server.xml if you prefere.
<Context docBase= "SpagoBIJasperReportEngine" path= "/SpagoBIJasperReportEngine" privileged= "true" reloadable="false" ><ResourceLink global= "jdbc/foodmart" name= "jdbc/foodmart" type= "javax.sql.DataSource" /><ResourceLink global= "jdbc/spagobi" name= "jdbc/spagobi" type= "javax.sql.DataSource" /> <ResourceLink global= "spagobi-resource-path" name= "spagobi_resource-path" type= "java.lang.String" /> <ResourceLink global= "spagobi-sso-class" name= "spagobi-sso-class" type= "java.lang.String" /> <ResourceLink global= "spagobi-service-url" name= "spagobi-service-url" type= "java.lang.String" /></Context>
spagobi_server - SpagoBI Installation
Page 6 - last modified by Angelo Bernabei on 2013/11/14 12:05
Thread Manager
SpagoBI uses a Thread manager in off-line activities to:
• Execute Talend JOB• Execute Process ( CommonJ Engine )
It's possible to configure the number of thread, in server.xml you have to put:
<Resource auth= "Container" factory= "de.myfoo.commonj.work.FooWorkManagerFactory" maxThreads= "5" name= "wm/SpagoWorkManager" type= "commonj.work.WorkManager" />
*Important*: you have to put this resource link in /SpagoBITalendEngine and /SpagoBICommonJEngineContext: <ResourceLink global= "wm/SpagoWorkManager" name= "wm/SpagoWorkManager" type="jcommonj.work.WorkManager" />
Additional libraries
Each SpagoBI WebApplication contains all libraries required to properly run it.As for resources defined in server.xml you need to include these libraries in /LIB folder.
• commonj-twm.jar• concurrent.jar• mysql-connector-java-5.0.8-bin.jar• foo-commonj.jar• some required libraries for JDBC Drivers.
You can find these libraries in source distribution or in the All-In-One package.
Run & Test
Open your browser and type [ http://localhost:8080/SpagoBI ]
The following users are available by default (usr/pwd):
• biadmin/biadmin• bitest/bitest• bimodel/bimodel• bidev/bidev• biuser/biuser
Choose a user and log in: now you are ready to start!
