JIRA 4.0 : Installing JIRA on IBM Websphere 6.x
This page last changed on Oct 05, 2009 by alui.
These instructions will help you install JIRA on IBM Websphere 6.x. On this page: 1. Unpack JIRADownload and unzip JIRA (but not with XP's unzipper nor the default tar utility on Solaris). Ensure that you download the WAR/EAR version, not the Standalone version that is recommended on the Downloads page.
A new directory containing JIRA will be created, hereafter referred to as $JIRA_INSTALL.
2. Configure JIRA2.1 Configure entityengine.xmlThe edit-webapp/WEB-INF/classes/entityengine.xml file needs to be modified to specify the correct database field type. The example below is configured for MS SQL Server. Please ensure that the value of the jndi-jdbc/jndi-name attribute has the "java:comp/env/" prefix. The prefix should be in the file by default. <datasource name="defaultDS" field-type-name="mssql" helper-class="org.ofbiz.core.entity.GenericHelperDAO" check-on-start="true" use-foreign-keys="false" use-foreign-key-indices="false" check-fks-on-start="false" check-fk-indices-on-start="false" add-missing-on-start="true"> <jndi-jdbc jndi-server-name="default" jndi-name="java:comp/env/jdbc/JiraDS"/> </datasource>
2.2 Modify web.xmlEdit webapp/WEB-INF/web.xml file and remove lines: <!-- Uncomment for WebSphere Uncomment for WebSphere --> which appear towards the bottom of the file. After removing the lines the <resource-ref> entry should look like: <!-- resource references --> <resource-ref> <description>Database for JIRA</description> <res-ref-name>jdbc/JiraDS</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>SERVLET</res-auth> <res-sharing-scope>Unshareable</res-sharing-scope> </resource-ref> Please ensure that the res-sharing-scope is set to Unshareable. 2.3 Set JIRA HomeTo specify the location of your JIRA Home Directory (note that you need to do this before you build JIRA):
You can specify any location on a disk for your JIRA home directory. Please be sure to specify an absolute path. Please note that you cannot use the same JIRA home directory for multiple instances of JIRA. We recommend that you do not specify your JIRA home directory inside your installation directory, to prevent information from being accidentally lost during major operations (e.g. backing up and restoring instances). 3. Build JIRANow build JIRA by running the build script for your platform (e.g. build.bat on Windows or build.sh on a Unix or Linux system). This will produce the deployable WAR file in the dist-generic directory. 4. Configure the Websphere datasourceThe datasource for the database should now be configured in Websphere using the Websphere Administration Console. See this guide for setting up a DataSource in the admin web interface. When defining the datasource map it to the jdbc/JiraServerDS JNDI key. Please ensure that the JNDI key is set to jdbc/JiraServerDS and not jdbc/JiraDS. 5. Deploy JIRA in WebsphereThe JIRA WAR file can now be deployed to Websphere (by e.g. using Websphere's Administration Console). When deploying the JIRA WAR file, please bind JIRA's jdbc/JiraDS datasource to Websphere's jdbc/JiraServerDS entry.
6. Set mail.mime.decodeparametersThe following system property must be set in order for the JIRA mail handler to work correctly with emails from RFC 2231-compliant mail clients: mail.mime.decodeparameters=true System properties are set in different ways depending on your application server. 7. Start JIRAWhen you access the path at which you have deployed JIRA, via your web browser, the Setup Wizard should appear. User-contributed notesHave experiences to share with Websphere 6.x and JIRA? We welcome your thoughts. Please see the user-contributed Websphere notes. |
![]() |
Document generated by Confluence on Oct 06, 2009 00:26 |