Home

Genji Installation Guide

Contents

1. Readme no J Apache Software Foundation Blog a Readme pt dJi Tomcat7 0 3 J plugins _ Torque properties d an Le reportTemplates aj Track Website b webapps E license_de E uninstall a i track license_en 4 Trackplus gt Readme de do Database 6 Readme en di Images 4 Readme es y log Readme fr m plugins o Le reportTemplates Figure 1 3 Genji directory layout The web container structure is predetermined by the Java Server Pages specification and the servlet container being used If a different database shall be used it can be placed anywhere else even on a separate server The directory for attachments and index data can also be placed anywhere else where it can be read and written to from the servlet container This directory is configured inside the Genji application and stored in the database 1 6 Attachment Data Configuration In Genji an arbitrary number of files can be attached to an item For performance reasons these attachments are not stored inside the Genji database but on the file system You must provide sufficient disk space to accommodate all attachments There is a single attachment directory In a clustered environment this directory needs to be read and write accessible from all cluster nodes 1 7 Text Search Configuration 1 7 Text Search Configuration Genji provides full text search facilities for all issue fields and attached files The indices for the text search facility are ke
2. Release 5 0 Genji Installation Guide Scrum Tool and Issue Tracking Kr H Steinbeis Transferzen trum trac Task Management Solutions Genji Installation Guide Scrum Tool and Issue Tracking H Steinbeis Transferzentrum Task Management Solutions H Steinbeis Transferzentrum Task Management Solutions Steinbeis GmbH amp Co KG Task Management Solutions Eugen Ruoff Str 30 D 71404 Korb Germany Tel 49 7151 994 89 60 Fax 49 7151 994 89 61 Support support trackplus com Genji No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopying recoding scanning or otherwise except as permitted under Sections 107 or 108 of the 1976 United States Copyright Act without the prior written permission of the Publisher Genji and the Genji logo are trademarks of Steinbeis GmbH amp Co KG and may be registered in certain jurisdictions The absence of a trademark from this list does not constitute a waiver of Steinbeis s intellectual property rights concerning the trademark All other company brand and product names may be trademarks or registered trademarks of their respective holders Steinbeis disclaims any responsibility for specifying which marks are owned by which companies or which organizations Copyright 2001 2015 Steinbeis GmbH amp Co KG All rights reserved October 2015 If you have any comments or suggestions regarding
3. This switch determines if e mails coming from the Genji system carry as their sent from address the value given in the previous field Genji system email or if it carries the address of the person causing the email For example if an issue was changed the issues manager will be informed of the change by e mail Automail If the check box mentioned above is checked the e mail will have as its sent from address trackplus trackplus com and the sent from name will be Trackplus If the check box was not checked the sent from address will appear as Smith Diana Genji Some SMTP servers do not like to sent messages with a from address different than the account which has been used to gaining access In the example above the SMTP server might not like to use an account trackplus trackplus com while sending messages from diana smith fake com Mail encoding You need to define an e mail encoding that is being used by Genji when sending out e mails UTF 8 should work in most cases For Western languages ISO 8859 1 usually works fine SMTP server name For Genji to be able to send notifications you need to give it the name of your SMTP server Some company internal installations do not require authentication before using the server some do If au thentication is being used it can be either SMTP authentication or POP before SMTP In the first case you also have to set the SMTP user name and
4. Internet Explorer 8 with reduced performance MySQL 5 x Firebird 2 x Oracle 11g MS SQL Server 2000 2005 2008 2012 PostgreSQL 8 x IBM DB2 9 x Oracle WebLogic 11 JBoss 7 Jetty 8 and 9 Apache Tomcat 7 0 and up Websphere Application Server Table 1 1 Hardware and software supported by Genji Operating System Remarks Windows Server 2003 2008 2012 Windows 7 Windows 8 Linux 2 4 Ubuntu Debian SuSE RedHat MacOS X Table 1 2 Supported operating systems 1 2 1 Genji Windows Installer This packages permits to install Genji on machines with Windows operating systems With the default Firebird database server it is suited for non clustered production environments up to about 50 users and for local test installations If you prefer to use another database system you can configure the connection during the installation process 1 2 2 Genji Binary WAR file The Genji WAR file can be copied to a servlet containers webapps directory and will usually be expanded there by the servlet container Using this package requires more manual configuration but any choice of 4 Chapter 1 Before You Install database server servlet container and operating system can be used The WAR file package should be used ifthe database server and servlet container coming with the Windows installer do not fit or if Genji shall be installed on a non Windows system like Linux Solaris HP UX etc 1 2 3 Genji Binary EAR file This
5. want to access incoming e mails by an IMAP inbox Mailbox password In case of POP before SMTP authentication supply your POP password here Alsosupply this if you want to access incoming e mails by an IMAP inbox Keep messages on server If this is checked reading the e mails does not delete the messages on the server This can be helpful if you also want to manually scan the Genji mailbox Authorizing E mail Domains To prevent users from unverified domains e g hotmail com gmx com to register a Perl5 regular ex pression can be defined so that only e mail domains matching that expression are allowed to register The default pattern is to allow all domains to register Genjican be configured such that users may register themselves However you can restrict registration to specific domains and even user email accounts for example such that only your customers are allowed to register with the system The pattern that is allowed to register is a Perl pattern Here are some example pattern Te t bosch com This example permits just users from domain bosch com to register Some more examples Te t t online de t computer org matches all users from domains t online de and computer org The pattern 29 4 4 Setting up Full Text Search w w w w 2 3 matches all e mail domains with no restrictions This is the default pattern 4 4 Setting up Full Text Search Genji uses the Lucene ind
6. 3 7 SAP DB Database There are several users reporting that they have Genji running successfully with SAP DB However this RDBMS is not in the rollout test plans and therefore not officially supported 3 4 Step 3 Installing an Application Server 3 4 1 Apache Tomcat on Ubuntu Debian On Ubuntu and Debian systems install Apache Tomcat 8 or later like this 19 3 4 Step 3 Installing an Application Server sudo apt get install tomcat8 The Tomcat startup script is located at etc init d tomcat8 Rather than changing it we modify the defaults in etc default tomcats sudo vi etc default tomcat8 We set JDK_DIRS to the proper Java installation JDK_DIRS usr lib jvm java 7 oracle And we make sure Tomcat starts with enough memory for code and data and knows about some important directories JAVA_OPTS Djava awt headless true XX PermSize 256M XX MaxPermSize 334M Xms384M Xmx1024M DTRACKPLUS_HOME home trackplus DJENKINS_HOME home jenkins DLATEX_HOME usr bin The entries for Jenkins and KAlpXare optional and required only when you use these tools To install AIEXon an Ubuntu system use Save the modified script and start Tomcat sudo etc init d tomcat8 restart Check if you get the Tomcat default start page under http lt yourcomputer gt 8080 or http lt yourcomputer com gt Thereafter shut down the server again sudo etc init d tomcat8 stop You should now have a running Tomcat servlet container rea
7. file is very similar to the WAR file and can be loaded into application servers using their application management facilities Using the EAR file it is possible to use a variety of operating systems servlet containers and database servers It requires the same amount of manual configuration as the WAR file 1 3 New Installation with Windows Installer Installing Genji using the Windows installer consists of the following steps 1 Verify system configuration 2 Install Java JDK or JRE 3 Create database optional 4 Run Windows installer 5 Configure application Figure 1 1 Installation process with installer Step 1 Verify System Configuration Before you install Genji verify that your server and client machines meet hardware and software spec ifications For more information see Table 1 1 on page 4 Step 2 Install Java JDK or JRE Genji uses Java technology In this installation step a Java Development Kit JDK or a Java Runtime Environment JRE needs to be installed on the server machine unless it is already there Step 3 Optional Create Database Unless you want to use the default database server you need to create an empty database Just run the installer it takes care of almost everything Step 4 Run Windows Installer Make sure you can run the installer as Administrator right mouse click Run as Administrator Just run the installer it takes care of almost everything 5 1 4 Installation without Inst
8. have the same rights as the admin user except that these rights are limited to specific projects 27 4 2 Entering License Key Information You can configure later on any user to have system administrator privileges All server configuration steps described below will be managed via menu entry Administration Manage server Server configuration 4 2 Entering License Key Information Cut and paste the license key from the key file you received into the text area and save You should see the number of active users covered and the expiration date of the license 4 3 Setting up E mail 4 3 1 Basic E mail Setup Genji will send notification messages to involved users for example if certain state changes occur new issues are created or responsible persons are being modified Genji also sends initial passwords after registration or lost passwords via e mail For this feature to work Genji has to be able to connect to an SMTP server You have to configure your SMTP server name on the server configuration page as shown in Fig 3 3 There are several other options when configuring your e mail notification service Genji system e mail here you should define an e mail account which is being inserted as sent from by Genji in any e mail the systems sends out You can further down select however if the sent from address of outgoing e mails is the one of the user initiating the causing action Use Genji from address in e mails
9. me we Os Single Sign On with Genji User Database IIIA e e 6 Upgrading Genji 6 1 6 2 Upgrading an Installer Based Installation Upgiading a Manali instala e ac aut ede coe a a en de es ea 7 Trouble Shooting Genji 71 72 73 74 75 Possible Conflicts with Competing Web Servers 2 222222 o Potential Problem on Windows 2003 Server o o IA AAA Possible Problems on 64 Bit Windows Systems InstallationProblemDebugging Runtime Trodblesheating o es IA a he 27 27 28 28 28 30 30 30 30 31 31 33 33 33 35 35 35 35 36 36 39 39 39 Contents 8 Uninstalling Genji 43 8 1 Uninstalling Genji from Windows Installer 43 8 2 Uninstalling Genji from Windows gt scree b ssas sa auda karakana ki EEA 43 83 Uninstallng Genjitom Aa 24 aea e be an a de aaa ni wein 44 Index 45 List of Figures 1 1 1 2 1 3 1 4 1 5 2 1 5 1 5 2 Installation process with installer 2 222 ee 5 Installation process without installer 2 2 oo oo oo 6 Geni directory layout rer re ee 7 Genji Simple COMNGUIATION lt x ash a Aa Po ee AS 8 Genji cluster CONTQUESI N Wa lan at a Heme hi aid 9 Running the Genji Windows Installer o o o o 12 Conhguning CPA INGEN asi a to nd 38 Connguring CBAINJERKING 2 AA AA A AAA IIIA 38 Welcome to this Guide Welcome to Genji on
10. minimum configuration steps you need to do after a first installation and before you can use your Genji system productively In particular the following topics are considered e First login and access to server configuration e Setting up E mail If you have installed Genji manually you may have to configure the following topics are to be considered as well e Setting up full text search e Setting up attachment handling e Configuring for operation in proxied environments optional e Configuring session time out 4 1 First Login and Access to Server Configuration To carry out the configuration steps in this chapter you have to login as system administrator The system administrator account is created during database installation using a predefined default password To login as the system administrator use user name admin password tissi There is a second account created during initial setup the guest account To login as a regular guest user with but a few access rights user name guest password trackplus You should change the administrator password before you expose your server to the public How this is done is described in the Genji User s Manual The admin user has access to all project administration access management pages It should be her privilege to add new projects Each project itself may have several project specific administrators out of the regular user base These project specific administrators
11. on Usually you would not change the default value In the same file you can define the session time out If there are no requests sent during this time from a client to the server the server terminates that session and the user would have to log in again to access the system The session time out can furthermore set by an system administrator for each user on the user s profile page 31 Integrating Genji with other Applications 5 1 Overview You can integrate other web based applications with Genji such that you can switch between them via the Genji menu bar The following applications are currently supported directly Jenkins continuous integration server http www jenkins org Jenkins is very useful if you are devel oping any kind of software SonarQube a quality improvement tool for software development Integrated bug finding and code coverage tools help you to prevent bugs early in the development cycle and generate code that is robust and easy to maintain http Awww sonarqube org ViewVC a browser for Subversion repositories You can link Genji items with Subversion repositories and directly move from an item to the corresponding revision or file Genji even puts some access control on top of ViewVC so that users can only see repositories they have a Genji permission for http www viewvc org WebSVN another browser for Subversion repositories Here too you can link Genji items with Subver sion repositories an
12. this document please send them by e mail to support trackplus com Contents 1 Before You Install 3 1 1 What Youneed to run Genjl Aa aa 3 12 Geniilinstallation FES u 2 4 24 baad aa we de ek ae he 3 1 2 1 Geni Windows Installer 304 dea ea Reo aA ORE ee ara 4 1 2 2 G nji Binary WARAS gt u sa ea BS a Ge a Be a wah Ge ad 4 123 Genii Binary EARI Gc ae de hea wd eo Cee KA IAA 5 1 3 New Installation with Windowslnstaller 5 14 Installation without Installer ss eepe a se ek an wh a a E 6 1 5 Installer Directory Layout and TRACKPLUS_HOME 0 000000000 7 1 6 Attachment Data Configuration ooa 4 cea ara RO Na sr 7 17 TESSA CONQUIST e add bee a ana 8 18 About Genji Technology 4 al a na aa Aa ad dd 8 1 81 Geni WERTEN 52 2 0 0 228 bs A a er 8 1 8 2 lmternei lnttanen o e 24 44 44 ee eh 9 1 83 LoadBalahcer uscar aa eek 9 1 84 ABplieaton SEVER cacas Se a bn SOA BE we ad 9 1 85 Database seiver ooo sf Habe ed A a oe ee 9 PR AE hee bath Ba on beak wee ig Ss Ae AG coke ae ah ow ae 10 1 87 EMA SEINE sos SS AMG Gah w OHS od Me AEM A ete a aa 10 1 383 Directory SEVER 022663 aoa we ae a oe ow Oa 10 2 Installing Genji with Installer 11 21 Obtaining the Genji Package oua uud ud ann PR eh eke eh G 11 22 Step 1 Verifying System Configuration ss es aaa an ar eee Ree ann 1 2 2 11 SVEM 3 42 yc dd Bhd Te ed ae a wa eed 1 222 CCESSTOSMIUP SEVER o e sada Ree oe ae B
13. using LDAP authentication on both systems 5 8 Single Sign On with Genji User Database For smaller installations it can be convenient to use the Genji user database as a source for single sign on SSO configurations rather than providing a central single sign on server For example you can use Genji and Jenkins and you have to login just once The installer will configure everything in preparation for this use case Manually you need to proceed as follows 1 In TOMCAT_DIRECTORY conf server xml please add the following code in the Engine section lt Engine name Catalina defaultHost localhost gt lt Realm className com aurel track realm TrackJDBCRealm connectionURL JDBC_CONNECTION_URL driverName DB_DRIVER userCredCol passwd userNameCol loginname userTable TPERSON gt 2 Right below this entry add or enable the single sign on valve lt Valve className org apache catalina authenticator SingleSignOn gt where the JDBC connection parameters are those found in TRACKPLUS_HOME Torque properties Here is an example for a MySQL database JDBC_CONNECTION_URL jdbc mysql localhost 3306 track user trackp amp password tissi amp autoReconnect true DB_DRIVER org gjt mm mysql Driver 3 In TOMCAT_DIRECTORY conf web xml add the following code below the other similar entries lt servlet gt lt servlet name gt Login lt servlet name gt lt servlet class gt com aurel track login Login lt servlet class
14. A EAD an Boe 11 23 Step Installing theJava SDK o za ua e aes 12 24 Step 3 Optional CreatinganEmptyDatabase 12 25 Step R unningthe Installer os Qe ae oO ee ee ee ee ba he aa 12 2 6 Integrating Apache Tomcat with IS IAA 13 3 Installing Genji Manually 15 31 Obtaining the Genji Package 4 2 84 css aba an denn Be Gade eels 15 3 2 Step 1 Verifying System Configuration oo osoa erea rania daraa ERER 15 3 2 1 Systemikeguiremenits oe oa Bb eke a BL ERE ed an en 15 3 2 2 JNGCESSTO SNIP SOIVER e una Wa he AEA RA ae ee 16 33 Step 2 Creating the Genji Database 2 2 2 a a bo doe we Pod aaa 16 33 1 MYSQL Database cag Ga aa ee ee Io eee OEE Ce ne ee de 16 33 2 Firebird Database an aus we hee ee Oy bet bee a des 16 o 2 barn nee RoR hn oe a Soke Cede we ae Boke ee eon Behn 17 334 Oracle Database us uo wa dene ER heh Oe See ks wh a 18 Contents 3 4 35 3 6 3 7 335 IBM DB2 Database o 5 suche wenn beh da eae Pee we hd 330 POSIGIESOL sib en de 33 7 SAPDB Database i ean una ee den we ie eS er eee OS ee YA Step 3 Installing an Application Server 2 Co Coon onen 3 4 1 ApacheTomcatonUbuntu Debian 34 2 Apache Tomcaton Windows so sa siose s saes ee sa na Eaa e a 34 3 Integrating Apache Tomcat with IIS 344 Oracle WEBLOGIC ocios a ua ea ee he ee we 34 5 1BMWebsphere 2 2 22mm SAG JBOSS dd edie aan ple und le A ec Re ch en ed ae
15. Administration gt Logging configuration You can view the log messages via Administration gt Server status on the Log tab 42 Uninstalling Genji 8 1 Uninstalling Genji from Windows Installer When Genji was installed using the Windows installer several packages have been installed and need to be removed for a complete uninstall e Genji itself e Firebird database server e Apache Tomcat servlet container e Graphviz package The following describes the procedure how to uninstall Genji when it was installed using the Windows in Staller Go to the Windows System Control page Select the Software icon and select Genji remove The remove will not remove the data that you have accumulated with Track If you want to remove all data manually remove the Genji installation directory which is typically C Program Files Genji f you are not using the Firebird database server for anything else remove it using the Software icon as described above for Genji fyou are not using Apache Tomcat for anything else remove it using the Software icon as described above for Genji f you are not using the Graphviz package for anything else remove it using the Software icon as described above for Genji This will remove all registration entries and files that have been placed on your computer by Genji 8 2 Uninstalling Genji from Windows If you have not used the installer for a Genji i
16. Genji should be ready to use Alternatively you could use the track v ear file for deployment Look at the description for the Oracle WebLogic server for instructions on how to do this You have to set the attachment directory on the server configuration page see section 4 5 when using JBoss Otherwise you will loose all attachments once your JBoss server is stopped 3 5 Step 4 Configuring the Database Connection 23 3 6 Installing Plugins 3 5 1 Establishing a Database Connection You have to connect the database you created in section 3 3 with the Genji application This is done via entries in file TRACKPLUS_HOME Torque properties The following is an excerpt and the respective areas are shown THIS USER WITH THIS PASSWORD HAS TO BE KNOWN BY YOUR DATABASE SYSTEM torque dsfactory track connection user trackp torque dsfactory track connection password tissi 1 Firebird on Windows systems torque database track adapter firebird torque dsfactory track connection driver org firebirdsql jdbc FBDriver torque dsfactory track connection url jdbc firebirdsql localhost D Data trackdata track gdb 2 Firebird on Unix The user name and password must match the respective entries you used for the database The JDBC driver and connection URL also depend on your database name and type There is an example in the default Torque properties file for each supported database type most of which are commented out Enab
17. SMTP password described below In the second case you have to configure the POP parameters 28 Chapter 4 Configuring Genji SMTP Port Default is 25 Usually you don t have to change this SMTP user name In case your SMTP server requires SMTP authentication supply the user name here SMTP authentication mode Company internal SMTP servers sometimes do not require special authentication If your SMTP server does you need to click the check box and select an authentication mode You can use either use a special user password for the SMTP server or use the same user password as for the incoming mail or use the POP3 before SMTP authentication mode where you will first be logged in into the POP3 incoming mail server and this will authenticate you for the outgoing SMTP mail server SMTP password In case your SMTP server requires SMTP authentication supply the password here Mailserver protocol Genji supports two incoming mail protocols POP3 and IMAP Here you can choose which one your server uses Mailserver name n case of POP before SMTP authentication supply your POP server here You will also have to configure this if you want to be able to submit issues by e mail to either a POP3 mailbox or an IMAP mailbox Mailserver port Default is 110 for POP3 and 143 for IMAP You usually do not have to change this Mailbox user n case of POP before SMTP authentication supply your POP user account here Also supply this if you
18. STOMCAT_HOME webapps directory cd TOMCAT_HOME tbs webapps Copy the track v war file of this distribution into the TOMCAT_HOME webapps directory and rename it to track war Start the Tomcat servlet container using the Windows Tomcat startup batch file TOMCAT_HOME bin startup bat or the Configure Tomcat utility Tomcat now unpacks the track war 21 3 4 Step 3 Installing an Application Server file into a directory TOMCAT_HOME webapps track Genji will not run yet since we still have to configure the database connection So it is best to stop Tomcat again before we proceed either using the Configure Tomcat utility or with TOMCAT_HOME bin shutdown bat Now proceed with section 3 5 on page 23 to configure the database connection 3 4 3 Integrating Apache Tomcat with IIS You can run Tomcat behind an Internet Information Server IIS Make sure you have e arunning instance of a Microsoft Windows 2008 R2 Server with IIS installed e Java 2 Standard Edition Developer Kit JDK 1 7 or later e Jakarta Tomcat 6 0 or later e Jakarta Tomcat Web Server Connector JK2 for IIS from the Apache download site Make sure you have the JDK and Tomcat installed before you proceed using the installers provided Then follow the instructions at this place 3 4 4 Oracle WebLogic Oracle WebLogic is a commercial application server You deploy and run Genji well on Oracle WebLogic You can deploy Genji in either exploded or unexpl
19. aller Step 5 Configure Genji This step involves some basic setup like changing the administrator password establishing connection to an e mail server and defining where on your file system you want to keep attachments and indexes 1 4 Installation without Installer Installing Genji without an installer consists of the following steps 1 Verify system configuration 2 Install Java JDK or JRE 3 Install database server 4 Install application server 5 Configure DB connection 6 Configure application Figure 1 2 Installation process without installer Step 1 Verify System Configuration Before you install Genji verify that your server and client machines meet hardware and software spec ifications For more information see Table 1 1 on page 4 Step 2 Install Java JDK or JRE Genji uses Java technology In this installation step a Java Development Kit JDK or Java Runtime Environment JRE needs to be installed on the server machine Step 3 Install Database Management System Genji runs on a variety of database servers for more information see Table 1 1 on page 4 Before Genji can be installed a database server must be running on a database server machine The database server machine can be different from the Genji server In a clustered environment there is usually a single database server and several cluster nodes running the Genji application Step 4 Install Application Server Genji is a J2EE application and re
20. an SMTP server before setting up Genji For test purposes you could use your own e mail account but this is not recommended if your SMTP server requires authentication It is definitely best to get a dedicated e mail account for your Genji installation 11 2 3 Step 2 Installing the Java SDK 2 3 Step 2 Installing the Java SDK Many systems already come with a Java runtime environment JRE installed Make sure that you have an up to date version version 1 7 or newer When you have a 64 bit Windows system e g Windows 7 or Windows Server 2008 R2 install the 64 bit Java version You can get it from http www java com download 2 4 Step 3 Optional Creating an Empty Database Unless you want to use the default Firebird database coming with the installer you need to create an empty database before you run the installer For example in MySQL you would enter mysql gt create database track default character set utf8 mysql gt commit For the following database system you must download the JDBC driver yourself and install it in the Apache Tomcat 1ib directory e Oracle database e IBM DB2 database 2 5 Step 4 Running the Installer The installer installs the application in about five minutes with basically no user interaction It comes with a servlet container Tomcat a complete SQL database system suitable even for medium size installations of up to 50 users Firebird and the Genji application itself Willkommen beim I
21. d alone You may have to set the JAVA_HOME environment variable to the location where you installed the Java SDK either in the Tomcat startup scripts or inthe Windows System Control panel On Windows you also have to set the memory settings appropriately If you are starting Tomcat as a service there is a utility that comes with Tomcat accessible from your Windows Start menu as Configure Tomcat Go to the tab named Java and configure in the bottom part of the screen the e Initial memory pool to 512 MByte e Maximum memory pool to 512 MByte or more In addition you should set the PermSize which you can do by entering the following two lines at the end of the JavaOptions text field in the Tomcat configuration screen XX PermSize 256M XX MaxPermSize 384M Xms384M Xmx1024M DTRACKPLUS_HOME C tbs Program Files tbs Trackplus DJENKINS_HOME C tbs Jenkins Watch that you do enter these each on an extra line and watch that you don t have extra white space at the end or elsewhere Sometimes port 8080 is already used by some other server on your computer Select a different port then for Tomcat such as 80 You can configure this in the server xml file in the Tomcat conf directory In the following it is assumed that Tomcat has been installed under STOMCAT_HOME For a Windows based system this is at C Program Files Apache Software Foundation Tomcat 8 0 To install the Genji application change to the
22. d directly move from an item to the corresponding revision or file Genji puts some access control on top of WebSVN so that users can only see repositories they have a Genji permission for http www websvn info ViewGit with the same functionality as ViewVC but for Git repositories http www viewgit fealdia org Furthermore there is software Genji can use or cooperate with for various tasks KipxXfor creating beautiful reports http www miktext org e Eclipse Mylyn to work with Genji directly from within Eclipse e JasperSoft Studio to create report templates 5 2 Installing the Portal Plug In To integrate web based applications into Genji download the Portals plug in from our web site The file is called portals x y z tpx Then proceed as follows 33 5 2 Installing the Portal Plug In 1 Copy portals x y z tpx to TRACKPLUS_HOME plugins and restart the server 2 Under TRACKPLUS_HOME plugins portals x y z there is a file called trackplus plugin xml It looks like this lt trackplus plugin id trackplus plugin name PortalPlugin gt lt plugin info gt lt description gt Portal plug in lt description gt lt version gt 5 0 lt version gt lt application version min 5 0 max 10 0 gt lt vendor name Steinbeis Trackplus url http www trackplus lt plugin info gt lt S SERVER will be replaced by the Track server base URL lt including the protocol You can also use a fixed URL lik
23. d the latest version of this document from the Steinbeis web site http www trackplus com Before You Install This chapter provides an overview over the installation process and specifies system requirements for Genji lt describes What you need to run Genji Genji Installation Files e The Installation Process with Windows Installer e The Installation Process without Windows Installer Attachment Data Configuration Text Search Configuration About Genji Technology 1 1 What You need to run Genji Genji runs on any platform with the requirements listed in Table 1 1 Table 1 2 shows the operating system configurations that are officially supported Beyond that Genji should run on any operating system for which a Java runtime engine is available 1 2 Genji Installation Files Genji offers three types of installation files e Windows installer e Web archive file WAR e Enterprise archive file EAR You need to download only one of them depending on the system configuration you like to use 3 1 2 Genji Installation Files Object Requirement Computer Main memory Disc space Java Virtual Machine SMTP E Mail Server Browser Database System Application Server PC virtual server workstation Mac min 1 GByte min 1 GByte available Java SDK or JRE version 1 7 x or up any standard SMTP server GMX Hotmail Internet Explorer 9 or up Firefox 22 or up Safari 6 or up Chrome or up
24. de an existing Genji to a newer version Chapter 7 Trouble Shooting Genji Describes how to trouble shoot common installation problems Chapter 8 Uninstalling Genji Describes how to uninstall Genji from your server Documentation Library The documentation library consists of the following documents Genji Installation Guide This document describes the Genji installation process 1 Welcome to this Guide Genji Administrator s Guide Describes procedures to administer a Genji installation add modify and delete projects manage users manage workflows manage security and customize attributes and screens Genji User s Guide Describes how to use Genji for regular users project managers and process managers Release Notes Describes the history of changes for the latest Genji release This should help to decide if its worthwhile to upgrade from a previous release The most up to date versions of the documentation library can be accessed at http www trackplus com Additional Online Resources You can find additional online resources at our homepage at http www trackplus com In particular there are e White papers e Forums at http www trackplus com forum The forums provide patches and answers to frequently asked questions e Demo installations at http www trackplus org track demo Documentation Updates We are continuously updating its product documentation with new information You can downloa
25. de de BRA e A Step 4 Configuring the Database Connection 2 2222 nme 3 5 1 Establishing a Database Connection Mala zus ha SO IA ee en REMAINING steps sc au an aaa a nn a ee 3 7 1 File System Configuration in Clustered Environment 2 2 22 222er 4 Configuring Genji 4 1 42 43 44 45 46 47 First Login and Access to Server Configuration AA II ee Entering License Key Information lt 4 eaa sus en da eee ee ee tar ees Seka s ra BOR she dh ae Ble bok a ok Wet A ie Blk bo Aw ee 43 1 Bic Ern llisetup e were Sa ara de hae A Sods Ba eke S Setting upIFull Text Search usa ara RSE ea be eps Gon ls Swe See Re we EA setting UP Attachment Handling sca ss kw an na SE ee ee Oe we Ew 4 5 1 Setting up the Attachment Root Directory IAA 45 2 Configuring the Attachment Size Limit o ee ee Configuring for Proxied Environment 2 6 84 do ar ana ne ea e ka Connguring Session TIMEOUT a Susan eh Wee Mo Mee ee He ho Hed oO 9 5 Integrating Genji with other Applications 5 1 32 33 5 4 55 5 6 5 7 5 8 PSII ii Ki Ta ek Be YG Grete Os Pa EN IA Installlmasche Portal PIUA 2 ioe a4 ko kok ee a Pe rd GAG eS JENKINS aora Oe LE aa Wa bate BE eh eA MES alte ds de Gdn A ye ee cde VIEW Sa te ke Beth Mylonas os eae da le BAe wt cles ites 1A hy Be i th ey AO Seater ee wy aw BO gs ae MEWO 04 a Rae Bhs ha eon se oe Aad wR ew td de Bt ap ooh es SOMAQUBS 5 ess dk hte Gla a Vo Rel pee dd Oe Ee
26. dy for deployment of Genji If you want to have a more professional installation with all security issues considered you should integrate the Tomcat servlet container with an Apache HTTP server How to do this is described in the documentation that comes with Tomcat Sometimes port 8080 is already used by some other server on your computer Select a different port then for Tomcat such as 80 You can configure this in the server xml file in the Tomcat conf directory In the following it is assumed that Tomcat has been installed under STOMCAT_HOME On a Debian Ubuntu system this at var 1ib tomcat8 To install the Genji application change to the STOMCAT_HOME webapps directory cd TOMCAT _HOME webapps Copy the track v war file of the Genji distribution into the TOMCAT_HOME webapps directory and rename it to track war Start the Tomcat servlet container 20 Chapter 3 Installing Genji Manually sudo etc init d tomcat8 start on Linux Tomcat now unpacks the track war file into a directory TOMCAT_HOME webapps track Genji will not run yet since we still have to configure the database connection So it is best to stop Tomcat again before we proceed with sudo etc init d tomcat8 stop Now proceed with section 3 5 on page 23 to configure the database connection 3 4 2 Apache Tomcat on Windows Installation of the Windows version of Tomcat is straightforward and doesn t require any special skills as long as Tomcat is run stan
27. e lt https www yourdomain com lt module id jenkins name Jenkins iconCls jenkinsApp useHeader true description Jenkins integration url SERVER jenkins gt lt module id websvn name Subversion iconCls websvnApp useHeader true description Subversion repository browser url SERVER websvn gt lt module id viewvc name Subversion iconCls websvnApp useHeader true description Subversion repository browser url SERVER cgi bin viewvc cgi gt lt module id viewgit name ViewGit iconCls viewgitApp description ViewGit useHeader true description Git repository browser url SERVER viewgit gt lt module id sonar name Sonar iconCls sonarApp 34 com gt Chapter 5 Integrating Genji with other Applications useHeader true description SonarCube Quality Assurance url SERVER sonar gt lt trackplus plugin gt Edit this file to match your installation Make sure you use the same protocol http or https on all servers 3 For some applications note the remarks in the specific sections below 5 3 Jenkins For Jenkins it is best to have the same user names and passwords on the Jenkins and on the Genji server This can be ensured by using LDAP authentication on both systems 5 4 WebSVN Genji calls WebSVN to show linked revisions and files directly from the cockpit or single items To enable this behaviour you need to patch WebSVN In t
28. e another database instead of Firebird or another servlet container or application server than Apache Tomcat This chapter describes e How to obtain the Genji package ow to verify your system configuration ow to install the Java SDK or Java SRE ow to set up an application server ow to configure the database connection H H H e How to install the Genji database H H H ow to install additional components for PDF document generation from Wiki documents and Gantt charts 3 1 Obtaining the Genji Package Download the required files of the Genji package from the Steinbeis Trackplus download area and save it under e g C tracktmp or any other place At the end of the installation procedure you may remove these files and directories You need the following file where v stands for the version e track v war 3 2 Step 1 Verifying System Configuration 3 2 1 System Requirements Make sure your system meets the requirements in Table on page In particular make sure that a Java runtime environment 1 7 or newer is installed on your system 15 3 3 Step 2 Creating the Genji Database 3 2 2 Access to SMTP Server You should have access to an SMTP server before setting up Genji For test purposes you can use your own e mail account or some free service account you set up for this purpose For a production environment you should obtain a dedicated e mail account for your Genji installation 3 3 Step 2 C
29. e of the most powerful and yet pleasant to use web based task management systems for the enterprise Genji serves as an issue tracking and project management application that supports track ing and managing all critical activities throughout a projects lifecycle Genji brings transparency into project status team members responsibilities and time and cost budgets It is highly configurable and easily adapts and extends to meet your specific project control needs How This Guide is Organized The Genji Installation Guide describes the system requirements and installation process for Genji It contains the following chapters Chapter 1 Before You Install Provides an overview of the product and specifies the requirements onf server and client configura tions for installing Genji Chapter 2 Installing Genji with Windows Installer Describes how to install Genji with Tomcat and a Firebird database using a Windows Installer Chapter 3 Installing Genji manually Describes how to install Genji manually with different database servers and servlet containers Chapter 4 Configuring Genji Describes how to configure Genji e mail access directories for attachments indexing how to start and stop the server and how to set up the first project Chapter 5 Integrating Genji with other Applications Describes how to integrate Genji with Subversion and Git repository browsers Jenkins and Sonar Chapter 6 Upgrading Genji Describes how to upgra
30. ent Handling 4 5 1 Setting up the Attachment Root Directory Attachments are stored on the file system and not in the database You should configure a directory on a volume with sufficient space for your attachments If you do not configure this parameter attachments will be stored inside the application directory This could result in complete loss of all attachment data on some application servers 4 5 2 Configuring the Attachment Size Limit It is possible to limit the size of attachments to prevent people from loading Gigabytes on the Genji server The limit can be set to any amount of MBytes The default size limit is 4 0 MByte 30 Chapter 4 Configuring Genji 4 6 Configuring for Proxied Environment Genji has been designed to operate in a proxy environment Usually Genji can extract the URLs that are in cluded in notification e mails automatically This automatic detection works fine ifthere are no proxy servers between the application server and the user clients If there is a proxy server hiding the application server the correct server URL has to be configured via parame ter Genji Server URL on the site configuration page for example http gandalf In non proxied environments you can leave this field empty which will enable the automatic detection feature for the server URL 4 7 Configuring Session Time Out In file web xml a cookie time out can be set to allow a user to directly access an issue without having to log
31. er suffices Genji officially supports Apache Tomcat JBoss WebLogic WebSphere Sun Webserver Jetty and JRun The deployed application is packaged into a single Web Application Archive WAR file T he Java Database Connectivity JDBC interface is used to communicate between the application server and the database server 1 8 5 Database Server Persistent data is stored in the Genji database Genji supports schemas on Oracle DB2 Microsoft SQL Server MySQL Firebird Postgres Sybase and Derby 1 8 About Genji Technology 1 8 6 File Server Genji stores attachments to issues and indices for the text search facility directly in files and not in the database In a clustered environment these data should be stored on a single server 1 8 7 E Mail Server Genji sends e mails to its users when something of interest to them happens Genji can also create issues from incoming e mails To support this functionality Genji needs to have a connection to an SMTP server and optionally to an IMAP or POP3 server for incoming e mails Genji basically behaves like a standard e mail client like Outlook Thunderbird or Lotus Notes It is possible to configure a secured link between the clients and the server using SSL or TLS 1 8 8 Directory Server Genji stores its users and passwords in its own database However Genji can use a directory server to verify passwords so that users do not have to administer different passwords in various places When y
32. erver e Oracle e DB2 e Postgres 6 2 Upgrading a Manual Installation To upgrade a manual installation proceed as follows 1 Note the directory where you store the attachments We call this TRACKPLUS_HOME 2 Stop the Tomcat server 3 If there is no file Torque properties in your TRACKPLUS_HOME directory copy it there from webapps track WEB INF Torque properties to TRACKPLUS HOME 4 Remove directory webapps track 5 Replace file vebapps track war by the new version 6 Check that the Tomcat JVM parameters include an entry DTRACKPLUS_HOME lt dir from step 1 gt 7 Start the Tomcat server 39 6 2 Upgrading a Manual Installation Have a look at the Tomcat log files and make sure there were no errors 40 Trouble Shooting Genji 7 1 Possible Conflicts with Competing Web Servers If on first startup you do not get the login screen there may be another web server already running on port 80 and 8080 of your system Competing web servers could have been installed for example as part of Windows Server Visual NET or some other development software Also known to cause problems are servers that have Oracle installed on them Oracle might install its own web server on port 80 and 8080 Skype can also block these ports To get Genji running in such a case you should either shut it down or deploy Genji with it Alterna tively you could change the default port in file serverxml of the Tomcat server by defau
33. exing system to search for issues based on keywords The index system c an be configured using several parameters Enable full text search Here you can enable TOLplus If this is not set TQLplus syntax is not recognized You can disable this if you have only little disk space left Index attachments This enables indexing of attachments Since attachments can be quite large setting this option will increase disk usage by Genji considerably Reindex on startup If you want to start a complete reindex after server startup set this switch This ensures that your index is complete It also purges index entries that may not be needed any more Take into consideration that it may take some time until the index is complete again Lucene analyzer Choose the preferred analyzer for your index A good analyzer gets rid of small words of little impor tance like a or the and so on This is of course language dependent so if you have an analyzer that matches the primary language of the installation enter it here New analyzers can be added if you pack them into a file lucene analyzersjar and drop this file into the lib directory of the Genji application The safe bet is to use the Standard Analyzer Lucene index root directory This is where Genji will place the index file Depending on the size of your documents disk space requirements can become quite large Make sure there is enough space at this location 4 5 Setting up Attachm
34. gt lt servlet gt 4 Also in TOMCAT_DIRECTORY conf web xml add the following code at the end of the file 36 Chapter 5 Integrating Genji with other Applications lt servlet mapping gt lt servlet name gt Login lt servlet name gt lt url pattern gt sso login lt url pattern gt lt servlet mapping gt lt security constraint gt lt web resource collection gt lt web resource name gt all lt web resource name gt lt url pattern gt lt url pattern gt lt http method gt GET lt http method gt lt http method gt POST lt http method gt lt web resource collection gt lt auth constraint gt lt role name gt admin lt role name gt lt auth constraint gt lt user data constraint gt lt transport guarantee gt NONE lt transport guarantee gt lt user data constraint gt lt security constraint gt lt login config gt lt auth method gt FORM lt auth method gt lt form login config gt lt form login page gt sso login success true lt form login page gt lt form error page gt sso login success false lt form error page gt lt form login config gt lt login config gt 5 Copy the folder trackSSOLogin from TRACKPLUS_HOME sso into TOMCAT_DIRECTORY conf Do not rename or modify this folder in any way 6 Copy file TRACKPLUS_HOME sso com trackplus sso x y z jar into TOMCAT_DIRECTORY lib directory 7 Only for Jenkins please open TOMCAT_DIRECTORY webapps jenkins WEB INF web xml and search for lt log
35. he TRACKPLUS _HOME plugins portals x y z directory there is a file called config php On a Debian or Ubuntu Linux Server copy this file to etc default websvn 5 5 ViewVC Genji calls ViewVC to show linked revisions and files directly from the cockpit or single items To enable this behaviour you need to patch ViewVC 1 Remove all repository entries from etc viewvc viewvc conf 2 Replace files usr lib viewvc lib config py and usr lib viewvc lib viewvc py with the versions from TRACKPLUS_HOME plugins portals x y z The location of the original files depend on your server configuration You may have to search for these files using find name viewvc py 3 You can adapt the templates to improve the visual appearance 5 6 ViewGit Genji can call ViewGit to show linked revisions and files directly from the cockpit or single items To enable this behaviour you need to patch ViewGit 1 Replace files lt viewgit install directory gt inc localconfig phpand lt viewgit install directory gt index php with the versions from TRACKPLUS_HOME plugins portals x y z The location of the original files depend on your server configuration You may have to search for these files using find name localconfig php 2 You can adapt the templates to improve the visual appearance 35 5 7 SonarQube 5 7 SonarQube For SonarQube it is best to have the same user names and passwords on the SonarQube and on the Genji server This can be ensured by
36. in config gt Remove this block or comment it out using the symbols lt start comment gt end comment 8 Restart your Tomcat Finally you need to enable container based authentication for Genji and Jenkins or any other application you like to integrate 37 5 8 Single Sign On with Genji User Database ds My setinos CE KB Projects gt GB Project templates gt ML Users amp groups gt 4 Customize gt de Actions gt LDAP server URL da Gitte I Manage server za LDAP login attribute name uid 12 A pe EA LDAP bind password BJ Broadcast email Force central password E 12 Figure 5 1 Configuring CBA in Genji Jenkins CE Jenkins Configure Global Security 3 Configure Global Security Enable security TCP port for JNLP slave agents Fixed Random Disable Disable remember me o Access Control Security Realm N 2 Delegate to servlet contaja Figure 5 2 Configuring CBA in Jenkins 38 Upgrading Genji This chapter describes how to upgrade an existing Genji installation to a newer version We consider two cases e Upgrading an installer based installation e Upgrading a manual installation 6 1 Upgrading an Installer Based Installation To upgrade an installer based installation just execute the new installer The standard database types are supported e Firebird e MySQL e MS SQLS
37. le the lines pertaining to your database type and comment out the others After changing any of the settings in Torque properties the servlet container Tomcat or your application server has to be restarted for the changes to take effect 3 6 Installing Plugins If you like to connect Genji to your Subversion repository you need an additional library which you can freely download from the Steinbeis extension download site Place the file into the lib directory under webapps track WEB INF 1ib of your Genji application and restart your server 3 7 Remaining Steps At this point you should have completed the basic installation procedure and after you have restarted your application server or reloaded the Genji application you should be able to log into the system by pointing your browser to the URL under which you have installed the system Some configuration steps remain to be done to get the Genji configured and ready to serve projects This mostly concerns e mail connection setup and configuration of directories for attachments and indexes These configuration steps are carried out using the regular Genji web browser user interface s o there is no need to directly work on the server any more from this point on The details of the remaining configuration steps are described in the next chapter 24 Chapter 3 Installing Genji Manually 3 7 1 File System Configuration in Clustered Environment When working in a clustered envir
38. lt installed under C Program Files Apache Software Foundation Tomcat 8 0 conf from 8080 to some other number In this case you have to enter the port number as part of the URL where you access Genji like http localhost 7080 track instead of http localhost track 7 2 Potential Problem on Windows 2003 Server The Genji installer runs itself an installer for the Firebird database management system There is a known problem with this installer on Windows 2003 Server Systems To solve this problem download the Firebird installer yourself and run it manually Then have a look at the Genji forum for an up to date work around to get the database server up an running Thereafter run the Genji installer again 7 3 Possible Problems on 64 Bit Windows Systems On a 64 bit system also make sure that you have a 64 bit Java installed and that your JAVA_HOME variable points to the 64 bit version If you have an older 32 bit version uninstall that first 7 4 Installation Problem Debugging The installer writes a log file in the same directory from which you executed the installer This log file contains a lot of hints in case something should have gone wrong 41 7 5 Runtime Troubleshooting 7 5 Runtime Troubleshooting To effectively analyze runtime problems it is helpful to increase the number of log messages being written to the application servers log and to the Genji log window You can set the logging level as administrator via
39. might be older e You need to enable the option EnableChildFirstClassLoading in file WEB INF conf axis2 xml lt parameter name hotupdate gt false lt parameter gt lt parameter name enableMTOM gt false lt parameter gt lt parameter name enableSwA gt false lt parameter gt lt Remove comment from the following line only for IBM Websphere gt lt parameter name EnableChildFirstClassLoading gt true lt parameter gt Furthermore you need to make sure that Genji classes are loaded first You need to go to Application Types gt WebSphere enterprise applications gt Select your app gt Manage modules gt select your app from Module column gt Class loader order combo box and there select Classes loaded with local class loader first parent last 3 4 6 JBoss JBoss is a popular Java application server You can obtain it from the JBoss download site Follow the instructions of installing JBoss In particular adapt the JAVA_HOME variable in the JBoss startup scripts to the path where you had installed your Java SDK Make sure that the ports you want to serve on aren t being used by another web server on your machine To install Genji you have to unjar the track v war file and modifythe Torque properties configuration files as described further down in section 3 5 Thereafter you jar it again to a file track war and copy it to the JBoss deployment directory If you have properly installed your RDBMS see section 3 3
40. milar When possible select the Super Server architecture For easy setup and administration of the Firebird Database some administrative tool support may be helpful You find a bunch of tools at www ibphoenix com A nice tool for administering the database you can find at www flamerobin org Chapter 3 Installing Genji Manually Check ifthe database server is listening netstat an grep 3050 should result in a line including LISTEN in it Go and change the default SYSDBA password from MASTERKEY to your own Don t forget this password opt interbase bin gsec modify sysdba user sysdba password MASTERKEY pw lt new_SYSDBA_password gt Add a new user with name trackp and some password opt interbase bin gsec add trackp user sysdba password lt new_SYSDBA_password gt pw lt trackplus_admin_password gt The database is created from scratch using the isql command line utility don t type the isql prompts from where you extracted your Genji database package opt interbase bin isql u trackp p tissi isql gt create database opt interbase db track gdb isql gt quit Make sure the owner and permissions are set right chown R firebird opt interbase db chmod 700 opt interbase db To access the database via FlameRobin you have to register it in this tool The file path that needs to be entered is as seen from the server e g opt interbase db track gdb The alias is of no importance 3 3 3 MS SQL Ser
41. n Danish Norwegian CP1252 Russian Cyrillic General CP1251 Spanish odern_Spanish CP1252 Swedish Finnish_Swedish CP1252 UTF 8 UTF8 UTF 16 UNICODE Table 3 1 Some code page settings for the TDS JDBC driver 4 Microsoft SQLServer torque database track adapter mssql torque dsfactory track connection driver net sourceforge jtds jdbc Driver torque dsfactory track connection url jdbc jtds sqlserver localhost track charset CP1252 3 3 4 Oracle Database Genji has been tested to run with Oracle 9i Oracle 10g and Oracle 11g databases This document will not cover how to set up a database in Oracle Once your database administrator has set up a database he must grant you all privileges to create and modify objects in your schema 3 3 5 IBM DB2 Database Genji supports IBMs DB2 database Here are some hints how to proceed Install DB2 and create a new database for example named TRACK The schema name should be the same as the database user name you will be using later on to connect the Genji software with the database You should have enough table spaces The default is 4k and you should choose 32K If the table space is not sufficient the scripts will not run You have to change the date strings in file dbase populate sql to have the right format which is YYYY MM DD hh mmiss nnnnn and set the dates in the two INSERT INTO TPERSON statements to the time 18 Chapter 3 Installing Genji Manually pattern above Al
42. nder menu entry the Administration Server Admin for the paths of these directories 44 i Steinbeis Transferzentrum ra C Task Management Solutions Steinbeis GmbH amp Co KG Task Management Solution Eugen Ruoff Str 30 71404 Korb Germany Tel 49 7151 994 89 60 Fax 49 7151 994 89 61 E mail sales trackplus com www trackplus com
43. nstallation on Windows the procedure to remove Genji depends on the type of application server and database server you have been using The following items have to be removed unless you are using them for anything else as well 43 8 3 Uninstalling Genji from Unix e Genji itself Database server Servlet container or application server Graphviz Genji itself consists of e the applications WAR or EAR file in the webapps directory of your servlet container e the expanded directory for Genji in the webapps directory of your servlet container e the attachment and indexing files The attachment and indexing files can reside anywhere on the disk you would have to check on the Administration Server Admin dialog for the paths of these directories 8 3 Uninstalling Genji from Unix The uninstall procedure for Genji from a Unix system depends the database server and servlet container you have been using for Genji The following items have to be removed unless you are still using them for something else Genji itself Database server e Servlet container or application server e Graphviz Genji itself consists of e the applications WAR or EAR file in the webapps directory of your servlet container e the expanded directory for Genji in the webapps directory of your servlet container e the attachment and indexing files The attachment and indexing files can reside anywhere on the disk you would have to check inside Genji u
44. nstallations Assistenten f r Genji 5 0 0 10 Dieser Assistent wird Sie durch die Installation von Genji 5 0 0 10 begleiten Es wird empfohlen vor der Installation alle anderen Programme zu schlie en damit bestimmte Systemdateien ohne Neustart ersetzt werden k nnen Klicken Sie auf Weiter um fortzufahren heces Figure 2 1 Running the Genji Windows Installer Chapter 2 Installing Genji with Installer You must make sure that you run the installer with administrator privileges This you can do either by running it from the context menu Run as administrator or by logging in as user Administrator It does not suffice if you execute the installer as a user with system administration privileges 2 6 Integrating Apache Tomcat with IIS Tomcat can run behind an MS Internet Information Server To configure such a setup make sure you have e arunning instance of a Microsoft Windows 2008 R2 Server with IIS installed e Java 2 Standard Edition Developer Kit JDK 1 7 0 or later e Jakarta Tomcat 6 0 or later e Jakarta Tomcat Web Server Connector JK2 for IIS from the Apache download site Make sure you have the JDK and Tomcat installed before you proceed using the installers provided Then follow the instructions at this place Installing Genji Manually This chapter provides a step by step description of the manual installation process in case you want to deploy on a non Windows system like Linux or you want to us
45. o operate Genji with a single machine running application server file service and database server A standard workstation with 1 GByte of main memory and 1 GByte of disk space should be sufficient to serve several hundred users and accommodate up to 100 000 issues 1 8 1 Genji Web Clients Genji requires a standard browser like Internet Explorer Firefox Opera or Safari on each client There is no need to install any additional software on the client The browser needs to have JavaScript enabled Chapter 1 Before You Install Track Web Clients D gt es es D gt Internet Intranet Track Cluster Load Balancer Installation Application Server C G Database Server File Server Figure 1 5 Genji cluster configuration 1 8 2 Internet Intranet Genji client requests are transmitted via HTTP protocol to the server It is possible to configure a secured link between the clients and the server using SSL https 1 8 3 Load Balancer When working with a load balancer client requests are transmitted to the load balancer and distributed according to server availability within the cluster The load balancer is optional it is common to operate Genji with a single application server 1 8 4 Application Server Client requests are dispatched by servlets to the Genji application software on the application server Genji does not require a fully J2EE application server a simple servlet contain
46. oded mode using the track v ear file You cannot easily use the track war file directly due to classpath loader issues in WebLogic To install Genji on Oracle WebLogic you have to first extract the track war file contained in track v ear jar xvf track v ear track war You now have a track war file in the same directory as the track ear file Extract file WEB INF Torque properties from the track ear file jar xvf track war WEB INF Torque properties Change to directory WEB INF and modify the Torque properties file as described further down in section 3 5 Basically this configures your database connection Thereafter you jar everything back together jar uvf track war WEB INF Torque properties jar uvf track v ear track war You can now deploy the application using the standard Oracle WebLogic deployment procedure You have to set the attachment directory on the server configuration page see section 4 5 on page 30 when using Oracle WebLogic Otherwise attachments may not work properly or you will loose all attachments once the server is stopped 22 Chapter 3 Installing Genji Manually 3 4 5 IBM Websphere IBM Websphere is acommercial application server You deploy and run Genji well on IBM Websphere You can deploy Genji in either exploded or unexploded mode using the track v ear file Two things you need to be aware of e Make sure you have a JDK 1 7 or later installed The default coming with the application server
47. onment in Solaris or Linux you must mount the file system repository before you start the Genji installation process Note that the mount to the file system repository should not use any cache mechanisms To mount a file system repository in Linux with NFS mounts modify the etc fstab file as follows lt source gt lt target gt nfs sync noac 0 0 To mount a file system repository with SMBFS mounts from a Windows machine modify the etc fstab file as follows lt source gt lt target gt smbfs credentials root smbpasswd rw gid lt GID gt uid lt UID gt fmask 0777 dmask 0777 0 O For example tpserver TPrepository mnt TPrepository smbfs credentials root smbpasswd rw gid 10 uid tpadmin fmask 0777 dmask 0777 O O Where tpserver TPrepository is the UNC of the source path uid tpadmin is a domain user Note that tpadmin must be a user on the Windows server and must belong to the Administrators group mnt TPrepository is the local folder The tpadmin in this example must be defined in the credential file root smbpasswd as follows username tpadmin password lt tpadmin password gt You must also edit the etc samba smb conf file and change the workgroup value to a domain name for example TRACKPLUS To mounta file system repository in Solaris with NFS mounts modify the etc vfstab file as follows lt source gt lt target gt nfs yes sync noac 25 Configuring Genji This chapter describes the
48. ou connect Genji to a directory server you can use your standard password also in Genji It is possible to configure a secured link between the clients and the server using SSL https Installing Genji with Installer This chapter provides a step by step description of the installation process on MS Windows based systems like Windows XP Windows 7 Windows 2003 Server Windows 2008 Server or Windows 2012 Server using the Windows installer In particular it describes e How to obtain the Genji package e How to verify your system configuration e How to install the Java SDK or Java SRE e How to install using the Windows installer 2 1 Obtaining the Genji Package Download the required files of the Genji package from the Steinbeis Trackplus download area and save it under e g C tracktmp or any other place At the end of the installation procedure you may remove these files and directories 2 2 Step 1 Verifying System Configuration 2 2 1 System Requirements Before you start make sure that your system meets Genji requirements Be aware that the Genji installer installs a Tomcat application server on the default Windows drive where your Program Files directory is located Make sure there is at least 300 Mbyte of disk space there Make sure that you have sufficient disk space for the system itself the database the indexes and the attachments see Table 1 1 on page 4 2 2 2 Access to SMTP Server You should have access to
49. pt outside of the database in a separate directory This directory should provide enough disk space for about half the size of the attachment directory In a clustered environment it needs to be read and write accessible from all cluster nodes 1 8 About Genji Technology Genji is an enterprise wide application that is based on Java technology This technology enables Genji to run ona wide variety of server hardware and operating systems Genji is a web based application and does not require any software installation on the client side a simple web browser suffices Genji Enterprise Edition Track Web Clients gt Internet Intranet Track Simple Installation Application Server Figure 1 4 Genji simple configuration supports clustering A cluster is a group of application servers that run Genji as if they were a single entity Each application server in a cluster is referred to as a node or a cluster node Clusters provide mission critical services to ensure maximum scalability and high availability The load bal ancing technique within the cluster is used to distribute client requests across multiple application servers making it easy to scale to an infinite number of users The cluster of servers can run on Windows Linux and Solaris based platforms or any other platform that supports Java Figure 1 5 illustrates how Genji client requests are transmitted within a cluster The standard configuration is t
50. quires a servlet container like Apache Tomcat or application server like JBoss Websphere or Weblogic to run This servlet container needs to be installed before Genji itself can be installed The deployment of the Genji application depends on the application server used Basically it means to unpack or upload a file on the application server Chapter 1 Before You Install Step5 Configure Database Connection After Genji has been deployed to the application server you need to modify a single configuration file to establish connection to the database Step6 Configure Genji This step involves some basic setup like changing the administrator password establishing connection to an e mail server and defining where on your file system you want to keep attachments and indexes If the Genji Windows Installer is used steps 1 to 5 are executed automatically by the installation software 1 5 Installer Directory Layout and TRACKPLUS_HOME When Genji is installed via the installer the resulting directory layout is as illustrated in Figure 1 3 The database files attachments and indices are stored in a separate folder under C Program Files Genji This folder is called TRACKPLUS_HOME A special file is Torque properties It contains the information on how Genji connects to the Genji database In case you want to use a different database you need to modify this file amp Local Disk C 3 ID Database 4 Readme it de Program Files A Images
51. reating the Genji Database Before you can install Genji itself you must create an empty database How you do this depends on the database system you want to use 3 3 1 MySQL Database Using the mysql gt command line client create a database Use InnoDB as the database engine and configure UTF 8 as standard encoding mysql user root p lt YourMySQLRootPassword gt mysql gt create database track default character set utf8 mysql gt GRANT ALL PRIVILEGES ON track to trackpo IDENTIFIED by lt trackplus_admin_password gt WITH GRANT OPTION mysql gt GRANT ALL PRIVILEGES ON track TO trackp localhost IDENTIFIED by lt trackplus_admin_password gt WITH GRANT OPTION mysql gt FLUSH PRIVILEGES mysql gt quit The database should now be up and running If you want to use the built in backup function of Genji you have to configure your MySQL instance to not use backslash escapes In file my ini on Windows or my cnf on Unix or whatever configuration file you are using add the following entry sql mode NO_BACKSLASH_ESCAPES If there already is a mode entry add the mode mentioned to the existing mode s separated by a comma 3 3 2 Firebird Database The software can be obtained via http www firebirdsql org en downloads Select the required server binary for your operating system The instructions for Unix below assume you are using the Linux rpm For other Unix operating systems the procedure should be si
52. ternatively delete the two date fields TOKENEXPDATE and EMAILLASTREMINDED from these insert statements Obtain a suitable JDBC driver for DB2 from the IBM download area for example db2java jar Place it into your Tomcat lib directory Change the Torque properties to map to db2 Comment out all other similar entries and enable the following entries torque dsfactory track connection user yourDB2Username torque dsfactory track connection password yourDB2Password DB2 torque database track adapter db2app torque dsfactory track connection driver COM ibm db2 jdbc app DB2Driver torque dsfactory track connection url jdbc db2 TRACK 3 3 6 PostgreSQL Genji supports PostgreSQL databases Be aware that there have been reports of slow performance on Post greSQL version 8 x Here are some hints to get a Genji database on a PostgreSQL server The following assumes that you are currently on the Postgres directory of the database package and that the PostgreSQL utilities are in your path createuser username postgres password d P A sysid 501 trackp gt Enter password for new user lt trackplus_admin_password gt gt Enter it again lt trackplus_admin_password gt gt Password lt postgres user password gt gt CREATE USER createdb owner trackp username trackp password track productName Database gt Password lt trackplus_admin_password gt gt CREATE DATABASE gt Password lt trackplus_admin_password gt 3
53. ver Genji works well with MS SOL Server Version 2000 2005 and 2008 Genji uses the jTDS JDBC driver to connect to the database server The most important point to consider is the correct setting of the character set and collation so that non ANSI characters are properly stored and retrieved This setting should be explicitly set when creating the database It is not recommended to use the standard settings of the database server Create the database with the Enterprise Manager tool Make sure you are using the right collation set when creating the database see Table 3 1 It might be best to add a new user which will be used as owner of the database The database should now be up and running The MS SQL Server JDBC driver needs to be enabled in the Torque properties file located in the webapps directory of your servlet container or application server as described below You need to choose the right character set Example configuration for a standard German MS SQLServer installation 17 3 3 Step 2 Creating the Genji Database Region Collation TDS Charset Chinese traditional Taiwan Chinese Taiwan Stroke CP950 Chinese simplified PRC Chinese_PRC CP936 Danish Danish_Norwegian CP1252 English Latini General CP1252 Farsi Arabian CP1256 Finnish Finnish_Swedish CP1252 French French CP1252 German Latini General CP1252 Hebrew Hebrew CP1255 Italian talian CP1252 Japanese Japanese CP932 Netherland Latini General CP1252 Norwegia

Download Pdf Manuals

Related Search

Related Contents

Controlador Térmico Diferencial STDC    CCD-TRV69E  Air Navigation Pro 4  IC Intracom 365925 USB cable  Viewsonic PJD5155L data projector  Manual - Nintendo of Europe  BNC588 - DAQ Plone Site  CDA HN6110  

Copyright © All rights reserved. Failed to retrieve file