SpagoBI 3 - Installation

Angelo Bernabei 2011/06/20 16:49

......................................................................................... Run & Test...................................................................................................................................................................................................................................................................... Some additional Libraries ................................ 3 3 3 3 4 4 4 4 5 5 5 5 6 Page 2 .................................last modified by Angelo Bernabei on 2011/06/20 16:49 ...................................................................................... Thread Manager ........................................... Install SpagoBI Metadata DB ......................................................................................................................................................................................................... Install Tomcat ...................................................................................................................... Context /SpagoBI ........................................................................................................................SpagoBI 3 ................. Set up Environment variables ...................................................................................................................................................................xml .............................................Installation Table of Contents Install JDK ..................... Edit server................................................................................................................................................................................................................................................................................................................................................ ...................................................................... Deploy SpagoBI WebApplication on Tomcat ............................................................................................................................................................... Set Up Data Source ................ Context /SpagoBI*Engine ......................................................spagobi_server .................................................................................................................................................. Configure SpagoBI ....................

sql • MySQL-create-quartz-schema. Remember to change the MySQL File dimension ( my.sql And to recreate Foodmart you have to open "MySql Administrator" and execute an import of foodmart DB. Don't worry if Tomcat writes some type of error in console or log files Page 3 . you have to download it from SUN site and install it.. These are the steps to install SpagoBI: Install JDK If you haven't installed JVM ( 1.5 or 1.18/bin/startup. a README.0.18.bat. For example.. document template. apart from .spagobi_server . To test if the installation is correct.0. This operation extracts all WAR files and allows you to edit the configuration files.org/download-60.6 )in your computer.txt file and patches to be applied to SpagoBI Server: in this case you have to follow the instructions of README...18 from http://tomcat.apache.ini) Deploy SpagoBI WebApplication on Tomcat Copy all WAR in WEBAPP Folder of Tomcat. in MySql you have to open "MySql Query Browser" and execute this file: • MySQL-create.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. etc....txt after having deployed SpagoBI war files as explained here below.last modified by Angelo Bernabei on 2011/06/20 16:49 .0. run Tomcat with startup. Those released files may contain. etc. you have to: • try to double-click on apache-tomcat-6.Installation • • • • • Install JDK Install Tomcat Install SpagoBI Metadata DB Deploy SpagoBI WebApplication on Tomcat Configure SpagoBI ° Edit server..bat • Open Browser to http://localhost:8080 • You should be able to see the "Tom cat" Install SpagoBI Metadata DB SpagoBI use a schema to store some information about configuration. You have to create this schema using a SQL script according to your DBMS Type ( Oracle. Install Tomcat Download Tomcat 6.SpagoBI 3 .cgi and unzip apache-tomcat-6..sql scritps. MySQL .zip.): you can find available scripts in "Scripts db" package of SpagoBI Server release.

FakeSsoService(NO SSO) • it.sql.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.jdbc.lang.String" value= "C:\spagobi2.CasSsoService ( CAS 2.common.String" /> Environment variable: resource-path <Environment name= "spagobi-resource-path" type= "java.String" value= "<VARIABLE-VALUE>" /> Remember to insert in each Context the resource-link: <ResourceLink global= "<VARIABLE-NAME>" name= "<VARIABLE-NAME>" type= "java.mysql.org ] how these configurations are made.eng.String" value= "it.lang.services.Driver" maxActive= "20" maxIdle= "10" maxWait= "-1" name= "jdbc/spagobi" password= "root" type= "javax. If you don't use the 6.lang. • it.Driver" maxActive= "20" maxIdle= "10" maxWait= "-1" name= "jdbc/foodmart" password= "root" type= "javax.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 Set up Environment variables To add a new Variable you have to insert this fragment of XML under <GlobalNamingResources> <Environment name= "<VARIABLE-NAME>" type= "java.spagobi.xml*.eng. Edit server.eng.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 !!!!! Environment variable: spagobi-sso-class <Environment name= "spagobi-sso-class" type= "java.Installation Configure SpagoBI And now you have to edit some configurations file.jdbc. these files are already included in all packages.sql.mysql.lang.services.spagobi.services.spagobi_server .0.18 version of Tomcat you have to check in [ http://www. 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.cas.0 ) Page 4 .SpagoBI 3 .DataSource" url= "jdbc:mysql://localhost/spagobi" username= "root" /> <Resource auth= "Container" driverClassName= "com.last modified by Angelo Bernabei on 2011/06/20 16:49 .3* the context information are embedded in *META-INF/context.FakeSsoService" /> These classes implements the interaction between SpagoBI and the SSO system.common.spagobi.apache.

apache.eng. for the resources defined in server.eng.spagobi_server .String" value= "http://localhost:8080" /> This URL is used to produce some address in html.xml you have to put: <Resource auth= "Container" factory= "de.spagobi.services.String" /> </Context> You have to define /SpagoBI Context.0 ) • it.lang. but you can insert this xml in server.work.last modified by Angelo Bernabei on 2011/06/20 16:49 .sql.cas.xml if you prefere.xml.DataSource" /> <ResourceLink global= "spagobi-resource-path" name= "spagobi&#95.CasSsoService3NoProxy ( CAS 3.FooWorkManagerFactory" maxThreads= "5" name= "wm/SpagoWorkManager" type= "commonj.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.String" /> <ResourceLink global= "spagobi-host-url" name= "spagobi-host-url" type= "java.SpagoBI 3 .lang.String" /> <ResourceLink global= "spagobi-service-url" name= "spagobi-service-url" type= "java.spagobi.eng.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.cas.xml you have to include these libraries in /LIB folder.WorkManager" /> *Important*: you have to put this resource link in /SpagoBITalendEngine and /SpagoBICommonJEngine Context: <ResourceLink global= "wm/SpagoWorkManager" name= "wm/SpagoWorkManager" type= "jcommonj.xml if you prefere.CasSsoServiceNoProxy( CAS 2.Installation • it.org ] ) Context /SpagoBI*Engine These context information are true for all ENGINE and are embedded in META-INF/context.lang.0 . but you can insert this xml in server.lang.lang.sql.commonj.services.cas.WorkManager" /> Some additional Libraries Each SpagoBI WebApplication contains all required libraries to run.CasSsoService3 ( CAS 3. <Context docBase= "SpagoBIJasperReportEngine" path= "/SpagoBIJasperReportEngine" privileged= "true" reloadable= "false" > <ResourceLink global= "jdbc/foodmart" name= "jdbc/foodmart" type= "javax.String" /> <ResourceLink global= "spagobi-sso-class" name= "spagobi-sso-class" type= "java.resource-path" type= "java.sql. Page 5 .sql. without WebService Security ) • it.work.work.DataSource" /> <ResourceLink global= "jdbc/foodmart" name= "jdbc/foodmart" type= "javax.spagobi.lang. in server. without WebService Security ) Environment variables: spagobi-service-url <Environment name= "spagobi-service-url" type= "java.DataSource" /> <ResourceLink global= "jdbc/spagobi" name= "jdbc/spagobi" type= "javax. this configuration depends on the Tomcat version ( check on [ http:// www.services.DataSource" /> <ResourceLink global= "spagobi-resource-path" name= "spagobi-resource-path" type= "java. 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.myfoo.0.lang. <Context docBase= "SpagoBI" path= "/SpagoBI" privileged= "true" reloadable= "true" > <ResourceLink global= "jdbc/spagobi" name= "jdbc/spagobi" type= "javax.xml.lang.String" /> <ResourceLink global= "spagobi-sso-class" name= "spagobi-sso-class" type= "java.

jar mysql-connector-java-3.x.jar concurrent.zip Run & Test.0.SpagoBI 3 . Open Browser : [ http://localhost:8080/SpagoBI ] You can use this users: • • • • • biadmin bitest bimodel bidev biuser The password and username are the same..1.last modified by Angelo Bernabei on 2011/06/20 16:49 .Installation • • • • • commonj-twm..x-apache-tomcat-6.18-xxxx.spagobi_server . You can find these libraries in source distribution or All-In-One-SpagoBI-3.jar foo-commonj. Page 6 .jar some required libraries for JDBC Drivers.13-bin.