Table of Contents
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 .............................................................................................................................................. Context /SpagoBI ................................................................................................................................................................. Context /SpagoBI*Engine .................................................................................................................................................... Thread Manager ................................................................................................................................................................... Some additional Libraries ...................................................................................................................................................... Run & Test... .......................................................................................................................................................................... 3 3 3 3 4 4 4 4 5 5 5 5 6
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 Some additional Libraries Run & Test... These are the steps to install SpagoBI:
Install JDK
If you haven't installed JVM ( 1.5 or 1.6 )in your computer, you have to download it from SUN site 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 test if the installation is correct, you have to: try to double-click on apache-tomcat-6.0.18/bin/startup.bat Open Browser to http://localhost:8080 You should be able to see the "Tom cat"
Configure SpagoBI
And now you have to edit some configurations file.
Edit server.xml
This is the main configuration file of Tomcat and in this file we have to Set up DataSource Set up Environment variables From the version *2.3* the context information are embedded in *META-INF/context.xml*, these files are already included in all packages. If you don't use the 6.0.18 version of Tomcat you have to check in [ http://www.apache.org ] how these configurations are made.
Remember 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 service You 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 you prefere. <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 this xml 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>
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 /SpagoBICommonJEngine Context: <ResourceLink global= "wm/SpagoWorkManager" name= "wm/SpagoWorkManager" type= "jcommonj.work.WorkManager" />
commonj-twm.jar concurrent.jar mysql-connector-java-3.1.13-bin.jar foo-commonj.jar some required libraries for JDBC Drivers.