Ubicore 3.2 Installation Guide - Linx & Postgres
Contents
1. this guide is assumed to have Administrator rights and previous experience of installing software and performing administrative tasks on the target system It is required that Java 1 5 or later is installed including a javac compiler A Java Runtime environment like JRE from Sun does not usually contain this Ubicore has been tested with Sun JDK 1 5 0 06 By default the Ubicore server installation package assumes that it is installed in lopt ava jdk1 5 0 06 The Appendix A describes how to prepare the Ubuntu Linux distribution for Ubicore Overview The Ubicore server consists of three main software components e PostgreSQL Database e Ubicore running inside Apache Tomcat Servlet Container e Apache HTTP Server optional Apache Tomcat is included in the Ubicore installation package and will be installed by the install script PostgreSQL and Apache HTTP Server must be installed separately according to their respective documentation PostreSQL may be replaced by other SQL databases with JDBC support e g Oracle This guide will only explain how to install using PostgreSQL however Postgres Installation and Configuration Installation and configuration of the PostgreSQL database server is needed before continuing with the installation of Ubicore It is recommended to use PostgreSQL version 8 2 or later Instructions for installation is available on http www postgresgl org docs 8 2 static installation html The Ubicore installa2. MaKewave Rev Al Ubicore version 3 2 Installation Guide for Unix and Postgres DB Copyright Makewave AB 2009 All right s reserved Ubicore 3 2 Installation Guide Linx amp Postgres Table of Contents Table of Contents T Introduction said os Sect oad baa be stai bati a uides ratus ani dde sepi t aen ied RERUE 3 IM Prereg isite Styron ienne ie n 3 Ae Dau A ro oti wesc puted e EEE E ET E A E AEE E REE ee 3 2 Postgres Installation and Configuration seessoeessesssosssocessosssoessoesssosesoesssoessoessoessssessoeessoesssese 3 2 1 Running a separate database machine ssesseseeseseseeseeseeesresrtsssesresresstesresssresssressseresseresssress 3 3 Installing UDiCOr essesi E 4 SA Installing the UDbICOLG SEVE i nn n E E debut Mv bata E ud oa eed 4 3 2 Initializing the Ubicote DBs ete EQ A E s E kent leeds eased 4 3 2 1 Initializing the DB on a fresh anstall tori ie ee er er itk pte ten Gore toi uet 4 32 2 Misr ating froni Ubicore 3 ase coii rete ge p ESSI e RUE RR CRUUR NEMESIS Tas eo ele 4 3 3 Config ringe Bio so ict ER 5 3 5 1 Pet C MC OM IO ULATION os oos nec teet ed den aee ter eee adeo domes ad tme read 5 3 3 2 Databas COE UO oae NI Rete pei tUe tenes ulnas eh E Re EAE exte ied ia 5 4 Starting Stoppino UDIQOUFEG ade dseberes euo sh bete aERb ke eph uu ER Runs a reta eoa Teneo Ree ER DRE Rear er nP EE VR RERO ERI 5 2 Stabe Ot DIG ONG uude o opa Gus tpa Gopher ndi eot a tU coalatwi sine E aa e E e
3. ameters in the start script The start script can be located at Ubi cone bin ubsacere sh Ubicore 3 2 Installation Guide Linx amp Postgres Section 4 Starting Stopping Ubicore 4 1 Starting Ubicore To start Ubicore run as root S opt ubicore bin ubicore sh start 4 2 Stopping Ubicore To stop Ubicore run as root E opt ubicore bin ubicore sh stop 4 3 Running as service The supplied start script is a customized version of the default start script shipped with tomcat This may be modified or used to run ubicore as a service Please refer to the tomcat documentation for achieving this 5 Testing the installation To test the installation of Ubicore visit the Ubicore Portal http lt hostname gt lt port gt portal 6 Configuring Apache HTTP Server optional It may be required in some environments that the Apache Tomcat installation is not directly accessible from external networks such as the Internet This can be for security reasons to implement load balancing to implement secure HTTP connections using SSL or make use of certain Apache HTTP server features etc An option in this case is to install an Apache HTTP server to front the Apache Tomcat server s There are two options in doing this using the module mod jk using built in proxy functionality The mod jk may be desirable for performance reasons and should be easy to configure if using Apache HTTP Server 2 2 The configuratio
4. inane am BM ERU 6 4 2 Stopping DDIGORe od tudo D deti ud i sea CU E dite Elda S epe 6 d uniling 3s SeFVICBR d Seats EA E devenue E AE PAR dur n ed eats 6 S Testing CE ais Call ACO esr 6 6 Configuring Apache HTTP Server Optiomal ccssccscsssssssscssssecsscscsscsecscsssssscsscscsessssscssees 6 TFurther icr 6 Appendix A Preparing a Ubuntu Server eeeeeeee eerte ee eene eee en eee etn setas set ens sette esa asses teenaaue 7 1 TUVGE OCW CUNO Power 7 2 uris eov 6 mur cassusasassossechssscecessesseucobectasneseUeacecssaatexetanasesods secs 7 KE cr parce 7 4 Creating a Ubicore User and Groupiissiscssesevcacestsccessacorenssatvcdessovecasssecoceuensuceossnscsustoseuedssdesunsassese 8 S Installation rro oen E T 8 5 1 Installation failure due to TSYO o A sonal acces esas psi RR vibes er t cep RU RP ANE 8 5 2 Redirecting to th portal web apps nonet etia pe Door c P rebbt eaten Lote d Aa v DUE 8 6 Starting Ubicore as e dedic mc 8 Ubicore 3 2 Installation Guide Linx amp Postgres Section 1 Introduction 1 1 1 2 2 1 Introduction This document outlines the steps that need to be taken to install the Ubicore server on a Unix based computer system such as the different Linux distributions or Mac OS X Please refer to the corresponding installation guides for other operating systems such as Windows Prerequisites The reader of
5. n of this option may however be tricky if using other versions of Apache HTTP Server The second option has been thoroughly tested with Ubicore and the supplied configuration should work well with most Apache HTTP Server installations It is recommended to review and understand the workings of the Apache proxy module before applying this configuration The example configuration is available in opt ubicore httpd ubicore conf 7 Further Reading Please see the following Ubicore manuals for further reading e Ubicore Getting Started e Ubicore User s Manual Ubicore 3 2 Installation Guide Linx amp Postgres Appendix A Preparing a Ubuntu Server Appendix A Preparing a Ubuntu Server 1 Introduction Instructions on how to setup and prepare a Ubuntu server for installing Ubicore Applies to Ubuntu version 7 10 and higher Instructions assume a virgin Ubuntu installation 2 PostgreSQL To find suitable package name candidates apt cache search postgresql To get the package description apt cache show pgk Install postgresql 8 2 and some recommended extras S apt get install postgresal 9 2 apt get install ca certificates oidentd postgresql doc 8 2 Manual start of postgresql sudo etc init d postgresql1 8 2 start 3 Installing Java First make sure that restricted tree is enabled in etc apt sources list lines like deb http security ubuntu com ubuntu gu
6. re install ubicore sh to etc init d ep opc uloicore Din toi1corSs sia eue sumus el Ubicore 3 2 Installation Guide Linx amp Postgres Appendix A Preparing a Ubuntu Server update rc d ubicore sh defaults The second command creates the etc rcN d links needed
7. tion script assumes that there is a super user postgres defined as in the PostgreSQL installation guide Running a separate database machine This guide and the Ubicore installation package assumes that the PostgreSQL database server is running on the same machine as the Ubicore server Note that if you are planning run the database on a separate machine from the Ubicore server or if you need to access the database server from other machines in your network you will need to Ubicore 3 2 Installation Guide Linx amp Postgres Section 2 Postgres Installation and Configuration 3 1 3 2 3 2 1 3 2 2 change the settings in the postgresql conf file in the PostgreSQL data directory usually usr local pgsql data http www postgresgl org docs 8 2 static runtime config connection html You may also need to add trust records to the pg_hba conf file usually usr local pgsql data pg hba conf http www postgresgl org docs 8 2 static client authentication html Installing Ubicore Before installing Ubicore v3 2 any other instance of Ubicore should be stopped before proceeding with the installation When making an upgrade from a previous version Ubicore 3 2 can be installed over the previous installation Ubicore v3 2 may of course also be installed separately not overwriting any previous installations Installing the Ubicore server It is recommended to install Ubicore in the opt directory of the file system Make s
8. tsy security main restricted deb src http security ubuntu com ubuntu gutsy security main restricted Then install javas apt get install sun java5 bin sun java5 demo sun java5 doc sun java5 fonts sun java5 jdk sun java5 jre sun javab5 plugin Ubicore 3 2 Installation Guide Linx amp Postgres Appendix A Preparing a Ubuntu Server 5 1 5 2 Creating a Ubicore User and Group Create the ubicore user and group adduser System group no create home disabled login ubicore Installation Notes Installation failure due to jsvc If the installation failes due to compiling jsvc fails install it via apt and enable the capability module apr ger 3umetell jewe lin amp ugse leaa Jswe gop omes egomet oue 5 5 26 1911 7 ewe modprobe capability The last command enables the security capability module a line capability will be added to the file etc modules Redirecting to the portal web app To set up a default page that redirects to the portal web app mkdir opt ubicore tomcat webapps ROOT cat opt ubicore tomcat webapps ROOT index html EOF html head meta http equiv refresh content 0 URL portal gt lt head gt lt body gt lt body gt lt html gt EOF chown R ubicore ubicore opt ubicore tomcat webapps ROOT Starting Ubicore as a Service To make a service out of ubico
9. un on port 8080 and to connect to the postgres DB on the same host If these default settings should be changed the following sections describe how to apply changes to the configuration Tomcat configuration By default Ubicore is configured to run on port 8080 If you wish to run on other ports it is required to edit the Ubicore runtime configuration available in ubicore tomcat conf server xml Changing the line lt Connector port 8080 gt to lt Connector port 80 gt will make the server run on the standard HTTP port More documentation on Apache Tomcat server xml configuration is available on http tomcat apache org tomcat 5 5 doc config Database Connection By default Ubicore is configured to connect a PostgreSQL database on the local machine using the default port 5432 the schema ubicore and the database user ubicore Should you choose to install the database on another machine or running on another port schema or user it is required to edit the Ubicore runtime configuration available in ubicore tomcat conf server xml Documentation for the Apache Tomcat Resource directive is available on http tomcat apache org tomcat 5 5 doc jndi datasource examples howto html Documentation for the PostgreSQL URL is available on http jdbc postgresql org documentation 8 1 connect html Starting Stopping Ubicore Before starting the server you may need to edit a few par
10. ure that your user have permission to write in the opt directory and navigate there eed ejpt Unpack the Ubicore installation package 9 tar ozzy lt path gt ubleore lt version gt tar Gz Run the installation script 9 oj wlodcoie bsim amete l slm After successful completion the install script has Installed Apache Tomcat server in opt tomcat apache tomcat version Initializing the Ubicore DB Make sure that the PostgreSQL database server is running and fully functional It is needed to be able to complete the installation of Ubicore Initializing the DB on a fresh installaion To initialize the Ubicore DB on a fresh installation run the init script 9 opt ubicore clo oim imnit cia sm During the installation you will be prompted with the password for the postgres database user and later with the password for the ubicore database user The later has the default password ubicore Migrating from Ubicore 3 1 When upgrading from Ubicore 3 1 to 3 2 run the init script with additional flags Ubicore 3 2 Installation Guide Linx amp Postgres Section 3 Installing Ubicore 3 3 3 3 1 3 3 2 9 Ope ublcore db bin iniesdh sh mus 12572 This will migrate the DB to 3 2 format To check which upgrades are possible supply the 1 flag e g 9 Opt ubicore clo bin init cio sa 1 Configuring Ubicore Ubicore is configured to r
Download Pdf Manuals
Related Search