JIRA Essentials 3rd Edition Use the features of JIRA to manage projects and effectively handle bugs and software issues Patrick Li - Instantly access the complete ebook with just one click
JIRA Essentials 3rd Edition Use the features of JIRA to manage projects and effectively handle bugs and software issues Patrick Li - Instantly access the complete ebook with just one click
com
https://ebookgate.com/product/jira-essentials-3rd-edition-
use-the-features-of-jira-to-manage-projects-and-effectively-
handle-bugs-and-software-issues-patrick-li/
OR CLICK BUTTON
DOWLOAD EBOOK
https://ebookgate.com/product/jira-development-cookbook-1st-edition-
edition-kuruvilla/
ebookgate.com
https://ebookgate.com/product/puppet-4-essentials-2nd-edition-acquire-
skills-to-manage-your-it-infrastructure-effectively-with-puppet-felix-
frank/
ebookgate.com
https://ebookgate.com/product/getting-the-builders-in-how-to-manage-
homebuilding-and-renovation-projects-3rd-edition-leonard-sales/
ebookgate.com
https://ebookgate.com/product/fair-use-free-use-and-use-by-permission-
how-to-handle-copyrights-in-all-media-1st-edition-lee-wilson/
ebookgate.com
Reflections on Management How to Manage Your Software
Projects Your Teams Your Boss and Yourself SEI Series in
Software Engineering 1st Edition Watts S. Humphrey
https://ebookgate.com/product/reflections-on-management-how-to-manage-
your-software-projects-your-teams-your-boss-and-yourself-sei-series-
in-software-engineering-1st-edition-watts-s-humphrey/
ebookgate.com
https://ebookgate.com/product/software-modeling-and-design-uml-use-
cases-patterns-and-software-architectures-1st-edition-hassan-gomaa/
ebookgate.com
https://ebookgate.com/product/global-software-and-it-a-guide-to-
distributed-development-projects-and-outsourcing-1st-edition-christof-
ebert/
ebookgate.com
https://ebookgate.com/product/math-you-can-t-use-patents-copyright-
and-software-ben-klemens/
ebookgate.com
www.it-ebooks.info
JIRA Essentials
Third Edition
Patrick Li
BIRMINGHAM - MUMBAI
www.it-ebooks.info
JIRA Essentials
Third Edition
All rights reserved. No part of this book may be reproduced, stored in a retrieval
system, or transmitted in any form or by any means, without the prior written
permission of the publisher, except in the case of brief quotations embedded in
critical articles or reviews.
Every effort has been made in the preparation of this book to ensure the accuracy
of the information presented. However, the information contained in this book is
sold without warranty, either express or implied. Neither the author, nor Packt
Publishing, and its dealers and distributors will be held liable for any damages
caused or alleged to be caused directly or indirectly by this book.
Packt Publishing has endeavored to provide trademark information about all of the
companies and products mentioned in this book by the appropriate use of capitals.
However, Packt Publishing cannot guarantee the accuracy of this information.
ISBN 978-1-78439-812-5
www.packtpub.com
www.it-ebooks.info
Credits
Reviewers Proofreaders
Mizan Ali Sayed Safis Editing
Miroslav Králik Lauren E. Harkins
Heiko Lübbe Paul Hindle
Sabina Şerbu Joanna McMahon
Technical Editor
Saurabh Malhotra
Copy Editor
Charlotte Carneiro
www.it-ebooks.info
About the Author
He has worked in the Atlassian ecosystem for over 8 years, developing products and
solutions for the Atlassian platform and providing expert consulting services. He
is one of the top contributors to the Atlassian community, providing answers and
advices on forums such as Atlassian Answers and Quora.
He has extensive experience in designing and deploying Atlassian solutions from the
ground up and customizing existing deployments for clients across verticals, such as
healthcare, software engineering, financial services, and government agencies.
I would like to thank all the reviewers for their valuable feedback
and also the publishers and coordinators for their help and support
in making this happen. Lastly, I would like to thank my family,
especially my wife Katherine, for encouraging me along the way.
www.it-ebooks.info
About the Reviewers
He is active within the Atlassian community and has published free add-ons
on the Atlassian Marketplace. He has previously reviewed two books on JIRA
administration and development by Packt publishing. Mizan has won the Star
Employee Award for 3 consecutive years.
First and foremost, I would like to thank my wife. She has been my
inspiration and motivation for continuing to improve my knowledge
and moving my career forward. I also thank my wonderful daughter,
Aaminah, for always making me smile. I'd like to thank my parents
for allowing me to follow my ambitions throughout my childhood.
My co-workers, especially Amrut Bhonsle, showed me the ropes in
IT. Without this knowledge, I wouldn't have ventured into learning
about JIRA and other Atlassian tools.
He has been using, administrating, and developing custom plugins and scripts for
JIRA for 3 years at many different companies.
www.it-ebooks.info
He is also one of the cofounders of Next Kickoff, an SRO, a lean start-up company
based in Prague that focuses on solving specific domain problems.
Miroslav can be found on LinkedIn (https://www.linkedin.com/in/mikralik).
Heiko Lübbe has been working with JIRA, on a daily basis, since 2007. He has worked
in different roles, as an end user with ticket-based workflows, setting up and introducing
JIRA, JIRA administration, JIRA migration, as a project manager, and a Scrum master.
As a freelance consultant, Mr. Lübbe works with many different companies, from small
Internet companies to big multinational companies, but always with JIRA.
He presented "Using JIRA for project management" at the Berlin/Brandenburg PMI
Chapter meeting in 2012.
He is still working as a senior technical IT project manager on a freelance basis in
Berlin, Germany.
Sabina Şerbu has a PhD in distributed systems from the University of Neuchâtel,
Switzerland, and an MSc in computer science from the Politehnica University of
Bucharest, Romania.
Sabina has been working in the areas of networking and document management,
and she is often involved in academic projects. She has hands-on and managerial
experience with JIRA and has been an active reviewer for conferences and technical
documentation.
Sabina Şerbu can be found at www.sabinaserbu.ch.
www.it-ebooks.info
www.PacktPub.com
Did you know that Packt offers eBook versions of every book published, with PDF and ePub
files available? You can upgrade to the eBook version at www.PacktPub.com and as a print
book customer, you are entitled to a discount on the eBook copy. Get in touch with us at
[email protected] for more details.
At www.PacktPub.com, you can also read a collection of free technical articles, sign up for a
range of free newsletters and receive exclusive discounts and offers on Packt books and eBooks.
https://www2.packtpub.com/books/subscription/packtlib
Do you need instant solutions to your IT questions? PacktLib is Packt's online digital book
library. Here, you can search, access, and read Packt's entire library of books.
Why subscribe?
• Fully searchable across every book published by Packt
• Copy and paste, print, and bookmark content
• On demand and accessible via a web browser
www.it-ebooks.info
www.it-ebooks.info
Table of Contents
Preface xi
Chapter 1: Getting Started with JIRA 1
The JIRA architecture 1
High-level architecture 2
Web browsers 3
Application services 3
Data storage 3
The JIRA installation directory 3
The JIRA home directory 4
System requirements 5
Hardware requirements 5
Software requirements 6
Operating systems 6
Java platforms 7
Databases 7
Application servers 8
Installation options 8
Installing and configuring JIRA 9
Installing Java 10
Installing MySQL 12
Preparing MySQL for JIRA 12
Installing JIRA 14
Obtaining and installing JIRA 14
Installing MySQL driver 19
The JIRA setup wizard 19
Starting and stopping JIRA 26
Post-installation configurations 27
Increasing JIRA's memory 27
Changing JIRA's port number and context path 29
[i]
www.it-ebooks.info
Table of Contents
Configuring HTTPS 29
Summary 31
Chapter 2: Project Management 33
The JIRA hierarchy 33
Project category 34
Project 35
Issue 35
Field 35
Project permissions 36
Creating projects 37
Changing the project key format 39
Importing data into JIRA 40
Importing data through CSV 41
Project user interfaces 46
Project Browser 47
The Summary tab 48
The Issues tab 48
The Road Map tab 49
The Change Log tab 49
The Versions and Components tab 49
The Source and Reviews tab 50
Project Administration 50
The Summary tab 51
The Components tab 52
Creating components 53
Managing components 53
Component lead and default assignee 53
The Versions tab 54
Creating versions 54
Managing versions 55
Other tabs 56
The Help Desk project 57
Creating a new project category 57
Creating a new project 58
Assigning a project to a category 59
Creating new components 59
Putting it together 60
Summary 61
Chapter 3: Issue Management 63
Understanding issues 64
JIRA issue summary 64
[ ii ]
www.it-ebooks.info
Table of Contents
[ iii ]
www.it-ebooks.info
Table of Contents
[ iv ]
www.it-ebooks.info
Table of Contents
[v]
www.it-ebooks.info
Table of Contents
[ vi ]
www.it-ebooks.info
Table of Contents
[ vii ]
www.it-ebooks.info
Table of Contents
[ viii ]
www.it-ebooks.info
Table of Contents
Reports 293
Generating a report 294
Dashboard 297
Managing dashboards 297
Creating a dashboard 298
Editing and sharing a dashboard 299
Deleting a dashboard 299
Configuring a dashboard 299
Setting a layout for the dashboard 300
Gadgets 300
Placing a gadget on the dashboard 301
Moving a gadget 303
Editing a gadget 303
Deleting a gadget 304
The Help Desk project 304
Setting up filters 304
Setting up dashboards 305
Setting up gadgets 306
Putting it together 306
Summary 307
Chapter 10: JIRA Service Desk 309
Introducing JIRA Service Desk 309
Installing JIRA Service Desk 310
Getting started with JIRA Service Desk 311
Creating a new service desk 313
Branding your customer portal 315
Service desk users 316
Adding an agent to service desk 317
Adding a customer to service desk 318
Adding a collaborator to service desk 319
Request types 319
Setting up request types 319
Organizing request types into groups 320
Setting up fields 321
Setting up workflow 323
Service-level agreement 325
Setting up an SLA 325
Setting up custom calendars 328
Queues 329
Creating a new queue 330
Creating knowledge base articles 331
Summary 333
[ ix ]
www.it-ebooks.info
Table of Contents
[x]
www.it-ebooks.info
Preface
Over the years, JIRA has grown from a simple bug tracking system designed for
engineers to manage their projects to an all-purpose issue tracking solution. As it has
matured over time, JIRA has become more than an application, it has transformed
into a platform, with a suite of other products that are built on it, enabling it to adapt
and deliver value to a wide variety of use cases.
JIRA 6 is the latest major release of JIRA and its product family. It comes with new
features that include support for service desk applications and enhancements made
to existing features such as providing flexible and robust workflow design and agile
methodology support. In this book, we will cover all the basics of JIRA and its core
capabilities as a feature-rich, issue-tracking system, as well as add-ons that add
additional features to the JIRA platform.
Packed with real-life examples and step-by-step instructions, this book will help you
become a JIRA expert.
Chapter 1, Getting Started with JIRA, serves as the starting point of the book and aims
to guide you to set up a local copy of a JIRA application that will be used throughout
the book. For seasoned JIRA experts, this will both refresh your knowledge and also
introduce you to the changes in JIRA 6. By the end of this chapter, you should have a
running JIRA application.
[ xi ]
www.it-ebooks.info
Preface
Chapter 3, Issue Management, covers everything related to issue creation and the
operations that can be performed on an issue (excluding workflow transitions).
Furthermore, this chapter touches on the various aspects of issues, as they are the
focal point of JIRA. This chapter also serves as an opportunity to show and allow
you to set up dummy data that will be used by the sample project.
Chapter 4, Field Management, covers how JIRA collects data through the use of fields
and how to expand on this ability through the use of custom fields. This chapter then
continues with the various behaviors that can be configured for fields.
Chapter 5, Screen Management, builds on the preceding chapter and explores the
concept of screens and how users can create and manage their own screens. This
chapter ties in all the previous chapters to show the power behind JIRA's screen
design capabilities.
Chapter 6, Workflows and Business Processes, explores the most powerful feature
offered by JIRA, workflows. The concept of issue life cycles is introduced, and
various aspects of workflows explained. This chapter also explores the relationship
between workflows and other various JIRA aspects that have been previously
covered, such as screens. The concept of JIRA extensions is also briefly touched in the
sample project, using some popular free extensions.
Chapter 8, Securing JIRA, focuses on the different security control features offered
by JIRA. As this topic affects all aspects of JIRA, all previous topics are touched on,
explaining how security can be applied to each. It also covers LDAP integration,
where you can hook up your JIRA with an existing LDAP system for user
management.
Chapter 9, Searching, Reporting, and Analysis, focuses on how data captured in JIRA
can be retrieved to provide various types of reporting features. It also covers the
changes introduced in JIRA 6.
Chapter 10, JIRA Service Desk, covers the new JIRA Service Desk product, an add-on
to transform JIRA into a fully-fledged service desk solution. It looks at installing
add-ons, setting up service desks, and defining custom SLA metrics.
[ xii ]
www.it-ebooks.info
Preface
Chapter 11, Advanced Features, covers advanced features that can help to change your
JIRA into more than just a traditional issue tracking system. It looks at how you can
run agile projects with JIRA through the use of JIRA Agile and how you can turn
JIRA into an effective feedback collection system.
You will also need additional software, including Java SDK, which you can get from
http://www.oracle.com/technetwork/java/javase/downloads/index.html
and MySQL, which you can get from http://dev.mysql.com/downloads.
You will need to be familiar with basic computer operations, specifically the system
on which you will use JIRA, and software project management. Familiarity with
agile methodologies such as Scrum will also be useful. For the first chapter, we will
assume you are familiar with the operating system you are going to install JIRA on.
Conventions
In this book, you will find a number of text styles that distinguish between different
kinds of information. Here are some examples of these styles and an explanation of
their meaning.
Code words in text, database table names, folder names, filenames, file extensions,
pathnames, dummy URLs, user input, and Twitter handles are shown as follows:
"open the server.xml file in a text editor from the JIRA_INSTALL/conf directory."
[ xiii ]
www.it-ebooks.info
Preface
mail.smtp.auth="true"
mail.smtp.user="username"
password="password"
/>
New terms and important words are shown in bold. Words that you see on the
screen, for example, in menus or dialog boxes, appear in the text like this: "select the
Simple Issue Tracking project template and click on the Next button."
Reader feedback
Feedback from our readers is always welcome. Let us know what you think about
this book—what you liked or disliked. Reader feedback is important for us as it helps
us develop titles that you will really get the most out of.
If there is a topic that you have expertise in and you are interested in either writing
or contributing to a book, see our author guide at www.packtpub.com/authors.
Customer support
Now that you are the proud owner of a Packt book, we have a number of things to
help you to get the most from your purchase.
[ xiv ]
www.it-ebooks.info
Preface
Errata
Although we have taken every care to ensure the accuracy of our content, mistakes
do happen. If you find a mistake in one of our books—maybe a mistake in the text or
the code—we would be grateful if you could report this to us. By doing so, you can
save other readers from frustration and help us improve subsequent versions of this
book. If you find any errata, please report them by visiting http://www.packtpub.
com/submit-errata, selecting your book, clicking on the Errata Submission Form
link, and entering the details of your errata. Once your errata are verified, your
submission will be accepted and the errata will be uploaded to our website or added
to any list of existing errata under the Errata section of that title.
Piracy
Piracy of copyrighted material on the Internet is an ongoing problem across all
media. At Packt, we take the protection of our copyright and licenses very seriously.
If you come across any illegal copies of our works in any form on the Internet, please
provide us with the location address or website name immediately so that we can
pursue a remedy.
We appreciate your help in protecting our authors and our ability to bring you
valuable content.
Questions
If you have a problem with any aspect of this book, you can contact us at
[email protected], and we will do our best to address the problem.
[ xv ]
www.it-ebooks.info
www.it-ebooks.info
Getting Started with JIRA
In this chapter, we will start with a high-level view of JIRA, going through each
of the components that make up the overall application. We will then examine
the various deployment options, system requirements for JIRA 6, and platforms/
software that are supported. Finally, we will get our hands dirty by installing our
very own JIRA 6 from scratch, with the newly improved installation wizard. In the
end, we will also cover some post-installation steps, such as setting up SSL to secure
your new instance.
By the end of this chapter, you will have learned about the following:
[1]
www.it-ebooks.info
Getting Started with JIRA
High-level architecture
Atlassian provides a comprehensive overview of the JIRA architecture at https://
developer.atlassian.com/display/JIRADEV/JIRA+Architectural+Overview.
However, for day-to-day administration and usage of JIRA, we do not need to go
into details; the information provided can be overwhelming at first glance. For
this reason, we have summarized a high-level overview that highlights the most
important components in the architecture, as shown in the following figure:
[2]
www.it-ebooks.info
Chapter 1
Web browsers
JIRA is a web application, so there is no need for users to install anything on
their machines. All they need is a web browser that is compatible with JIRA. The
following table summarizes the browser requirements for JIRA:
Browsers Compatibility
Internet Explorer 8.0 (not supported with JIRA 6.3)
9.0, 10.0, 11.0
Mozilla Firefox Latest stable versions
Safari Latest stable versions on Mac OSX
Google Chrome Latest stable versions
Mobile Mobile Safari
Mobile Chrome
Application services
The application services layer contains all the functions and services provided by
JIRA. These services include various business functions, such as workflow and
notification, which will be discussed in depth in Chapter 6, Workflows and Business
Processes and Chapter 7, E-mails and Notifications, respectively. Other services such as
REST/Web Service provide integration points to other applications The OSGi service
provides the base add-on framework to extend JIRA's functionalities.
Data storage
The data storage layer stores persistent data in several places within JIRA. Most
business data, such as projects and issues, are stored in a relational database. Content
such as uploaded attachments and search indexes are stored in the filesystem in the
JIRA_HOME directory, which we will talk about in the next section. The underlying
relational database used is transparent to the users, and you can migrate from one
database to another with ease as referenced at https://confluence.atlassian.
com/display/JIRA/Switching+Databases.
[3]
www.it-ebooks.info
Getting Started with JIRA
There is a one-to-one relationship between JIRA and this directory. This means each
JIRA instance must and can have only one home directory, and each directory can
serve only one JIRA instance. In the old days, this directory was sometimes called the
data directory. It has now been standardized as the JIRA Home. It is for this reason
that, for the rest of the book, we will be referring to this directory as JIRA_HOME.
This separation of data and application makes tasks such as maintenance and future
upgrades an easier process. Within JIRA_HOME, there are several subdirectories that
contain vital data, as shown in the following table:
Directory Description
data This directory contains data that is not stored in the database. For
example, uploaded attachment files.
export This directory contains the automated backup archives created by
JIRA. This is different from a manual export executed by a user;
manual exports require the user to specify where to store the archive.
We will cover this in Chapter 10, JIRA Service Desk.
import This directory contains the backups that can be imported. JIRA will
only load the backup files from this directory.
log This directory contains the JIRA logs.
plugins This directory is where the installed add-ons are stored. In the previous
versions of JIRA, add-ons were installed by copying the add-on files
to this directory manually; however in JIRA 5, you will no longer need
to do this, unless specifically instructed to do so. Add-ons will be
discussed further in the later chapters.
caches This directory contains cache data that JIRA uses to improve its
performance at runtime. For example, search indexes are stored in this
directory.
tmp This directory contains temporary files created at runtime, such as file
uploads.
[4]
www.it-ebooks.info
Chapter 1
When JIRA is running, the JIRA_HOME directory is locked. When JIRA shuts down,
it is unlocked. This locking mechanism prevents multiple JIRA instances from
reading/writing to the same JIRA_HOME directory and causing data corruption.
JIRA locks the JIRA_HOME directory by writing a temporary file called jira-home.
lock into the root of the directory. During shutdown, this file will be removed.
However, sometimes JIRA may fail to remove this file, such as during an ungraceful
shutdown. In this case, you can manually remove this locked file to unlock the
directory so that you can start up JIRA again.
You can manually remove the locked file to unlock the JIRA_HOME
directory if JIRA fails to clean it up during shutdown.
System requirements
Just like any other software application, there is a set of base requirements that need
to be met before you can install and run JIRA. Therefore, it is important for you
to be familiar with these requirements so that you can plan out your deployment
successfully. Note that these requirements are for a behind-the-firewall deployment,
also known as the JIRA Server. Atlassian also offers a Cloud-based alternative called
JIRA Cloud, available at https://www.atlassian.com/software#cloud-products.
The cloud version of JIRA is similar to the behind-the-firewall JIRA deployment in most
areas, and it is perfect for organizations that do not want to have the overhead of the
initial setup and just want to get up and running quickly. One major limitation of JIRA
Cloud is that you cannot use many of the third-party add-ons available. If you want to
have all the power and flexibility of the JIRA Server and worry-free server management,
you may consider managed hosting for JIRA offered by third-party vendors.
Hardware requirements
For evaluation purposes, where there will only be a small number of users, JIRA will
run happily on any server that has a 1.5 GHz processor and 1 GB to 2 GB of RAM. As
your JIRA usage grows, a typical server will have a quad core 2 GHz CPU and 4 GB
of RAM dedicated to the JIRA application.
[5]
www.it-ebooks.info
Getting Started with JIRA
Officially, JIRA only supports x86 hardware and 64-bit derivatives of it. When
running JIRA on a 64-bit system, you will be able to allocate more than 4 GB of
memory to JIRA, a limit if you are using a 32-bit system. If you are planning to
deploy a large instance, it is recommended that you use a 64-bit system.
Software requirements
JIRA has four requirements when it comes to software. It needs a supported
operating system and a Java environment. It also needs an application server to host
and serve its contents and a database to store all of its data. In the following sections,
we will discuss each of these requirements and the options that you have to install
and run JIRA with.
Operating systems
JIRA supports most of the major operating systems, so the choice of which operating
system to run JIRA on becomes a matter of expertise, comfort, and in most cases,
existing organization's IT infrastructure and requirements.
The operating systems supported by Atlassian are Windows and Linux. There is a
JIRA distribution for Mac OSX, but it is not officially supported. With both Windows
and Linux, Atlassian provides an executable installer wizard package, which bundles
all the necessary components to simplify the installation process (only available for
standalone distribution).
[6]
www.it-ebooks.info
Chapter 1
Java platforms
JIRA is a Java-based web application, so it needs to have a Java environment
installed. This can be a Java Development Kit (JDK) or a Java Runtime
Environment (JRE). The executable installer that comes with Windows or Linux
contains the necessary files and will install and configure the JRE for you. However,
if you want to use the archive distributions, you will need to make sure that you
have the required Java environment installed and configured.
JIRA 6 requires Java 7 or later. If you run JIRA on an unsupported Java version,
including its patch version, you may run into unexpected errors. The following table
shows the supported Java versions for JIRA:
Databases
JIRA stores all its data in a relational database. While you can run JIRA with
HyperSQL Database (HSQLDB), the in-memory database that comes bundled
with JIRA, it is prone to data corruption. You should only use this to set up a new
instance quickly for evaluation purposes, where no important data will be stored.
For this reason, it is important that you use a proper database such as MySQL for
production systems.
Most relational databases available on the market today are supported by JIRA, and
there are no differences when you install and configure JIRA. Just like operating
systems, your choice of database will come down to your IT staff's expertise,
experience, and established corporate standards. If you run Windows as your
operating system, then you might probably want to go with the Microsoft SQL
Server. On the other hand, if you run Linux, then you should consider Oracle (if you
already have a license), MySQL, or PostgreSQL.
[7]
www.it-ebooks.info
Getting Started with JIRA
The following table summarizes the list of databases that are currently supported
by JIRA. It is worth mentioning that both MySQL and PostgreSQL are open source
products, so they are excellent options if you are looking to minimize your
initial investments.
Take a special note of the driver's requirement on each database, as some drivers
that come bundled with the database vendor (for example, the SQL Server) are
not supported.
Application servers
JIRA 6 officially only supports Apache Tomcat as the application server. While it is
possible to deploy JIRA into other application servers, you will be doing this at your
own risk, and is not recommended.
The following table shows the versions of Tomcat that are supported by JIRA 6:
Installation options
JIRA comes in two distributions: the standalone and WAR distributions. The only
difference is that the standalone distribution comes bundled with Apache Tomcat, an
in-memory database, and Java, if you use the executable installer version. The WAR
distribution, on the other hand, contains only the JIRA web application.
[8]
www.it-ebooks.info
Chapter 1
As you can see, the standalone distribution comes with everything required to get
JIRA installed. The standalone distribution comes in two flavors: an executable
installer and a ZIP archive. The executable installer provides a wizard-driven
interface that will walk you through the entire installation process. It even comes
with a Java installer to save you some time. The ZIP archive flavor contains
everything except for a Java installer, which means you will have to install Java
yourself. You will also need to perform some post-installation steps manually, such
as install JIRA as a service. However, you do get the advantage of learning what
really goes on under the hood.
The WAR distribution is for more advanced users who are familiar with the Java EE
application deployment model. With the WAR distribution, you have to make the
necessary changes to the configuration files, build your own deployable JIRA, and
then deploy it to an application server; in this case, Tomcat. The advantage of using
WAR distribution is that it is very easy for you to version control all the changes you
make to the standard distribution files, which makes future upgrades much easier.
We will continue to use this JIRA instance in our subsequent chapters and exercises
as we build up our help desk implementation.
[9]
www.it-ebooks.info
Getting Started with JIRA
Installing Java
Since we will be using the installer package with Java bundled, you can skip this
section. If you are using the ZIP archive or WAR distribution, you need to make sure
you have Java installed on your system.
JIRA 6 requires Java Runtime Environment (JRE) version 7 or a newer run. You
can verify the version of Java you have by running the following command in a
Command Prompt:
java -version
The preceding command tells us which version of Java is running on your system as
shown in the following screenshot:
If you do not see a similar output, then chances are you do not have Java installed.
You will need to perform the following steps to set up your Java environment:
[ 10 ]
www.it-ebooks.info
Chapter 1
4. Create a new environment variable named JAVA_HOME with the value set to
the full path of where you installed Java. You can do this as follows:
1. Open the System Properties window by holding down your Windows
key and press the Pause key on your keyboard.
2. Select the Advanced system settings option.
3. Click the Environment Variable button from the new popup.
5. Edit the PATH environment variable and append the following to the end
of its current value:
;%JAVA_HOME%\bin
[ 11 ]
www.it-ebooks.info
Getting Started with JIRA
This will display the version of Java installed if everything is done correctly. In
Windows, you have to start a new command prompt after you have added the
environment variable to see the change.
Installing MySQL
The next step is to prepare an enterprise database for your JIRA installation. JIRA
requires a fresh database. If during the installation process, JIRA detects that the
target database already contains any data, it will not proceed. If you already have a
database system installed, then you may skip this section.
[ 12 ]
www.it-ebooks.info
Chapter 1
4. Here, we are creating a database called jiradb. You can name the database
anything you like. As you will see later in this chapter, this name will be
referenced when you connect JIRA to MySQL. We have also set the database
to use UTF-8 character encoding, as this is a requirement for JIRA. You need
to ensure that the database uses the InnoDB storage engine to avoid data
corruption, by using the following command:
grant all on jiradb.* to 'jirauser'@'localhost' identified by
'jirauser';
5. We are doing several things here. First, we create a user called jirauser and
assign the password jirauser to him. You should change the username and
password to something else.
6. We have also granted all the privileges to the user for the jiradb database
that we just created so that the user can perform database operations, such as
create/drop tables and insert/delete data. If you have named your database
something other than jiradb in step 5, then make sure you change the
command so that it uses your database name.
7. This allows you to control the fact that only authorized users (specified in
the preceding command) are able to access the JIRA database to ensure data
security and integrity.
8. To verify your setup, exit the current interactive session by issuing the
following command:
quit;
10. You will be prompted for a password, which you have set up in the
preceding command as jirauser.
11. Use the following command:
show databases;
12. This will list all the databases that are currently accessible by the logged-in
user. You should see jiradb among the list of databases.
13. Examine the jiradb database by issuing the following commands:
use jiradb;
show tables;
[ 13 ]
www.it-ebooks.info
Getting Started with JIRA
14. The first command connects you to the jiradb database, so all of your
subsequent commands will be executed against the correct database.
15. The second command lists all the tables that exist in the jiradb database.
Right now, the list should be empty, since tables have been created for
JIRA, but don't worry— as soon as we connect to JIRA, all the tables will
automatically be created.
Installing JIRA
With the Java environment and database prepared, you can now move on to
installing JIRA. Normally, there are only two steps:
The Atlassian website will detect the operating system you are using and
automatically suggest the installation package for you to download. If you intend to
install JIRA on a different operating system than the one you are currently on, make
sure you select the correct operating system package.
[ 14 ]
www.it-ebooks.info
Chapter 1
2. Select the Custom Install option and click the Next button to continue. Using
the custom installation will let us decide where to install JIRA and also many
configuration options.
[ 15 ]
www.it-ebooks.info
Getting Started with JIRA
3. Select the directory where JIRA will be installed. This will become the JIRA_
INSTALL directory. Click the Next button to continue.
4. Select where JIRA will store its data files, such as attachments and log files.
This will become the JIRA_HOME directory. Click the Next button to continue.
[ 16 ]
www.it-ebooks.info
Chapter 1
5. Select where you would like to create shortcuts to the Start menu, and click
the Next button to continue.
6. In the Configure TCP Ports step, we need to select the port on which JIRA
will be listening for incoming connections. By default, JIRA will run on port
8080. If 8080 is already taken by another application or you want JIRA to run
on a different port such as port 80, select the Set custom value for HTTP and
Control ports option and specify the port numbers you want to use. Click the
Next button to continue.
7. For the last step, select whether you would like JIRA to run as a service. If
you enable this option, JIRA will be installed as a system service and can be
configured to start automatically with the server.
[ 17 ]
www.it-ebooks.info
Getting Started with JIRA
9. Once the installation is complete, check the Launch JIRA 6.3.1 in browser
option and click Finish. This will close the installation wizard and open up
your web browser to access JIRA. This might take a few minutes to load as
JIRA starts up for the first time.
[ 18 ]
www.it-ebooks.info
Chapter 1
Since we need to install the MySQL database driver for JIRA, we are
launching JIRA in the browser now to verify that the installation was
successful.
In the first step of the wizard, you will be asked to select Server Language and what
database JIRA should connect to.
The server language will determine what language will be used when users access
JIRA. You will see that as soon as you make a change from the drop-down list, JIRA
will automatically change its onscreen text to the selected language.
[ 19 ]
www.it-ebooks.info
Getting Started with JIRA
The database connection setting will determine what database JIRA will use. If you
select the Built In option, JIRA will use its bundled in-memory database, which is
good for evaluation purposes. If you want to use a proper database, such as in our
case, you should select the My Own Database option.
[ 20 ]
www.it-ebooks.info
Discovering Diverse Content Through
Random Scribd Documents
Sur la mitre du Roi, séparant les
bandelettes de justice, resplendit l’Étoile-
à-six-rayons, signe de puissance et de
lumière. L’Ecclésiaste, sur sa tunique de
byssus, porte le rational, parce qu’il peut
offrir les holocaustes expiatoires, l’éphod,
parce qu’il est le Pontife, et sur ses pieds
pacifiques se croise le lacis de bronze
des sandales de bataille, parce qu’il est
le Guerrier.
Il célèbre l’Anniversaire pascal, en
mémoire de ses pères guidés par Moïse
au sortir de Misraïm, la Maison de
servitude; l’anniversaire du grand soir
où, bravant les chars furieux et les
armées, ils s’enfuirent vers la Terre
promise; l’anniversaire du sinistre lever
de lune où Iahvè, l’Être-des-dieux,
confondit, au milieu des vagues de la
mer Rouge, le cheval et le cavalier.
Oui, le Roi consacre le festin du
soir!... Sa droite s’appuie sur l’épaule
séculaire du médiateur Helcias,
l’interprète des symboles, le ministre des
pouvoirs occultes.
Helcias, fils de Schellüm et de Holda,
la prophétesse, est pareil au désert, plus
stérile encore après les tombées de la
manne. Il a franchi les épreuves et les a
bénies comme l’arbre du Liban parfume
la hache qui le frappe; mais il porte, au-
dessus de ses larges orbites, la marque
de son œuvre accomplie: le temps a
dénudé ses sourcils, les sourcils accordés
à l’Homme seulement pour que la sueur
qui doit rouler de son front ne ruisselle
pas jusqu’en ses yeux et ne l’aveugle
pas.
Il attend!
Tout lui prouve la visitation de Dieu.
Il a souffert, pieusement, les
dernières minutes d’angoisses bénies qui
précèdent le salut.
Il va donc recevoir le prix de ses
épreuves!... Il goûte déjà, sans doute,
les joies suprêmes de l’Élection!
L’espérance de l’évasion prochaine le
transfigure à tel point que le long éclair
de ses prunelles, traversant la
profondeur des ombres, sous les voûtes,
suspend, un instant, le sommeil funèbre
de la foule.
Çà et là, dans la brume, des yeux
presque ressuscités le contemplent avec
une religieuse épouvante.
Une seconde encore et le terme sera
franchi de toute servitude!...
—Mais comment se fait-il que, la
seconde étant passée, il n’ait pu
s’évanouir en la Vision divine?
D’où vient que, à peine ranimée, la
foule de ces êtres muets défaille de
nouveau, et s’assombrisse, et
s’immobilise, et se confonde avec la nuit?
C’est que le vieil Initié a perdu, tout à
coup, la splendeur de sa sérénité. Il
s’émeut, en effet,—et l’étrange indécision
de son regard dénonce le vertige de ses
sensations.
—Ah! c’est qu’il se sent toujours
palpiter dans les entraves de la Vie!...
C’est que le divin anéantissement ne
s’est pas accompli.
Déjà les doutes l’assaillent; déjà,
pareils à la fumée d’une torche, les
hordes inquiètes des samaëls, qui
importunent les accesseurs du Parvis-
Occulte, s’émeuvent, tentateurs aux
suggestions désolatrices, autour de lui:
son front s’enténèbre au frôler de leurs
ailes mortes. Il se ressouvient, en un
désespoir jaloux, que des éternités le
séparent de cet état de pureté sublime
où, dès ce monde et à travers toutes les
joies, est parvenu Salomon.
Le sentiment de cette différence
entre sa consécration et celle du Royal-
Inspiré suscite en lui des terreurs
nouvelles dont l’intensité s’augmente à
chaque battement de ses tempes
glacées.
Comment l’horreur de ces instants lui
est-elle infligée, s’il a mérité la
Lumière!...
Il subit un intervalle inconnu.
Il est pareil à une pierre volcanique
qui, animée d’une impulsion terrible,
serait retenue au bord du cratère par la
vertu d’une loi miraculeuse, et qui se
consumerait de sa vitesse intérieure,
sans se désagréger ni se dissoudre.
L’heure passe, vague, lourde,
insaisissable...
Il s’interroge. Certes, un trouble se
produit, à son sujet, au fond des lois
divines?...
Épouvantée de l’hésitation du Ciel,
son intelligence retombe et tournoie
dans un délire d’inquiétudes
surnaturelles. Un vaste effroi neutralise
la vertu de ses pensées.
Ainsi l’influence d’Azraël immobile se
manifeste pour Helcias sous la forme de
ces anxiétés effroyables.
Le vieillard, maintenant éperdu,
ressemble à un prêtre qui survivrait à ses
dieux morts. Il ne peut déserter
l’habitacle charnel où il est surpris et rivé
par le regard d’un Être dont la
conception totale dépasse la hauteur de
son esprit. Le voici haletant comme une
victime. Ce qui le précipite du Seuil de
Domination et le replonge dans la vieille
poussière oubliée des sensations
humaines, ce n’est pas la présence de
l’Exterminateur même, c’est
l’impénétrable inaction, en son attribut
essentiel, d’un Être de cette origine.
Inconscient de ses actes, il agite
autour de lui le faisceau redoutable des
conjurations, oubliant leur vanité devant
ce Messager! Mais sa voix n’est déjà plus
celle qui obtient toujours sans jamais
prier.
Ses obsécrations, refoulées par les
Sept-Flammes de l’esplanade, retombent
autour de lui, peuplant l’air, tristement,
de larves et de fantômes! Son aspect
actuel annonce qu’il est né en des âges
plus anciens que l’heure de sa naissance
terrestre. Il ramène sur son front un pan
du manteau du Roi d’Israël et,
abandonnant sa volonté au sombre
Destin:
—Ellël! invoque-t-il,—si la foudre, en
frappant tes yeux, n’y devient qu’une
lueur de plus, soulève, de tes doigts
impérissables, les paupières du Roi!...
Tel, autrefois, sous les voûtes
d’Endor, sa mère Holda, sur le trépied
des évocations, aboya des formules qui
firent surgir devant la muraille, l’ombre
de Schemouël.
ebookgate.com