Installation Alessandro Taurelli 2010/06/15 13:39
Table of Contents 1 Installation... 3 1.1 Install JDK... 3 1.2 Install Tomcat... 3 1.3 Install SpagoBI Metadata DB... 3 1.4 Deploy SpagoBI WebApplication on Tomcat... 4 1.5 Configure SpagoBI... 4 1.6 Some additional Libraries... 8 1.7 Run & Test...... 9 Page 2 - last modified by Alessandro Taurelli on 2010/06/15 13:39
SpagoBI Installation 1 Installation 1.1 Install JDK 1.2 Install Tomcat 1.3 Install SpagoBI Metadata DB 1.4 Deploy SpagoBI WebApplication on Tomcat 1.5 Configure SpagoBI 1.5.1 Edit server.xml 1.5.2 Set Up Data Source 1.5.3 Set up Environment variables 1.5.3.1 Environment variables: spagobi_resource_path 1.5.3.2 Environment variables: spagobi_sso_class 1.5.3.3 Environment variables: spagobi_service_url 1.5.3.4 Environment variables: spagobi_host_url 1.5.4 Context /SpagoBI 1.5.5 Context /SpagoBIJasperReportEngine 1.5.6 Thread Manager 1.6 Some additional Libraries 1.7 Run & Test... 1 Installation These are the steps to install SpagoBI: 1.1 Install JDK If you haven't installed JVM in your computer, you have to download it from SUN site and install it. 1.2 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" 1.3 Install SpagoBI Metadata DB SpagoBI use a schema to store some information about configuration, document template, etc You have to create this schema using a SQL script according to your DBMS Type ( Oracle MySQL.. etc...): you can find available scripts in "Scripts db" package of SpagoBI Server release. Those released files may contain, apart from.sql scritps, a README.txt file and patches to be applied to SpagoBI Server: in this case you have to follow the instructions of README.txt after having deployed SpagoBI war files as explained here below. For example, in MySql you have to open "MySql Query Browser" and execute this file: MySQL_create.sql MySQL_create_fk.sql MySQL_create_quartz_schema.sql Page 3 - last modified by Alessandro Taurelli on 2010/06/15 13:39
And to recreate Foodmart you have to open "MySql Administrator" and execute an import of foodmart DB. Remember to change the MySQL File dimension (my.ini) 1.4 Deploy SpagoBI WebApplication on Tomcat Copy all WAR in WEBAPP Folder of Tomcat, run Tomcat with start.bat. 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 1.5 Configure SpagoBI And now you have to edit some configurations file. 1.5.1 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 Set up Context of all WebApplications ( only before the version 2.3 ) 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. 1.5.2 Set Up Data Source To add a new Data Source you have to insert this fragment of XML under <GlobalNamingResources> <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= Page 4 - last modified by Alessandro Taurelli on 2010/06/15 13:39
"10" maxwait= "-1" name= "jdbc/foodmart" password= "root" type= "javax.sql.datasource" url= "jdbc:mysql://localhost/foodmart" username= "root"/> The first is the Connection poll for SpagoBI metadata and the second is the Connection pool for Foodmart ( the DWH for demos ) The JDBC driver must be presented in the folder lib 1.5.3 Set up Environment variables To add a new Variable you have to insert this fragment of XML under <GlobalNamingResources> "<VARIABLE_NAME>" type= "java.lang.string" value= " <VARIABLE_VALUE>" /> Remember to insert in each Context the resource-link: "<VARIABLE_NAME>" name= " <VARIABLE_NAME>" type= 1.5.3.1 Environment variables: spagobi_resource_path "spagobi_resource_path" type= "java.lang.string" value="c:\spagobi2.0\resources"/> SpagoBI Server uses this path to read some resources like: QBE DataMart Mondrian XML schema Talend JOB Image included in report HTML file Remember to create this PATH!!!!! 1.5.3.2 Environment variables: spagobi_sso_class Page 5 - last modified by Alessandro Taurelli on 2010/06/15 13:39
"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 ) 1.5.3.3 Environment variables: spagobi_service_url "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 1.5.3.4 Environment variables: spagobi_host_url "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 1.5.4 Context /SpagoBI From the version 2.3 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"> "jdbc/spagobi" name= "jdbc/spagobi" type= "javax.sql.datasource"/> "jdbc/foodmart" name= "jdbc/foodmart" type= "javax.sql.datasource"/> Page 6 - last modified by Alessandro Taurelli on 2010/06/15 13:39
"spagobi_resource_path" name= "spagobi_resource_path" type= "spagobi_sso_class" name= "spagobi_sso_class" type= "spagobi_host_url" name= "spagobi_host_url" type= </Context> You have to define /SpagoBI Context, this configuration depends on the Tomcat version ( check on http://www.apache.org ) 1.5.5 Context /SpagoBIJasperReportEngine From the version 2.3 these context information 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"> "jdbc/foodmart" name= "jdbc/foodmart" type= "javax.sql.datasource"/> "jdbc/spagobi" name= "jdbc/spagobi" type= "javax.sql.datasource"/> "spagobi_resource_path" name= "spagobi_resource_path" type= "spagobi_sso_class" name= "spagobi_sso_class" type= Page 7 - last modified by Alessandro Taurelli on 2010/06/15 13:39
"spagobi_service_url" name= "spagobi_service_url" type= </Context> For each external engine you have to define the Context: Write this context: /SpagoBIBirtReportEngine /SpagoBIGeoEngine /SpagoBIGeoReportEngine /SpagoBIJasperReportEngine /SpagoBIJPaloEngine /SpagoBIJPivotEngine /SpagoBIQbeEngine /SpagoBITalendEngine /SpagoBIWekaEngine 1.5.6 Thread Manager SpagoBI uses a Thread manager in off-line activities to: Execute Talend JOB 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 Context: "wm/spagoworkmanager" name= "wm/spagoworkmanager" type= "jcommonj.work.workmanager"/> 1.6 Some additional Libraries Each SpagoBI WebApplication contains all required libraries to run, for the resources defined in server.xml you have to include these libraries in /LIB folder. commonj-twm.jar concurrent.jar mysql-connector-java-3.1.13-bin.jar foo-commonj.jar some required libraries for JDBC Drivers. You can find these libraries in source distribution or Demo-SpagoBI-x.x.x-apache-tomcat-6.0.18-XXX.zip Page 8 - last modified by Alessandro Taurelli on 2010/06/15 13:39
1.7 Run & Test... Open Browser : http://localhost:8080/spagobi You can use this users: biadmin bitest bimodel bidev biuser The password and username are the same. Page 9 - last modified by Alessandro Taurelli on 2010/06/15 13:39