Jira アプリケーションのインストール (Linux)

Jira 10 以降は、手動でのインストール方法のみがサポートされています。

In this guide we'll run you through installing a Jira application in a production environment, with an external database, manually using a tar.gz file.

この方法では、インストールプロセスをユーザーが最大限制御できます。

Other ways to install Jira: 

  • 評価版 - 無料トライアルをすぐに利用できます。
  • Installer – install Jira using the Linux installer. 
  • Windows – install Jira on a Windows server. 



On this page:

はじめる前に

Before you install Jira, there are a few questions you need to answer. 


サポートされているオペレーティングシステムと Java のバージョンを使用していますか?
詳細を読む...

Check the Supported platforms page for the version of Jira you are installing. This will give you info on supported operating systems, databases and browsers.

参考情報

  • We don't support installing Jira on OS X or mac OS for production environments.
  • OpenJDK 、JDK (Java Development Kit) または JRE (Java Runtime Environment) を使用することができます。
  • サポートされるのは、Jira とバンドルされている Apache Tomcat のバージョンのみです。
32 bit のオペレーティング システムをお使いの場合
詳細を読む...

32 bit のシステムに Jira をインストールする場合、Jira で使用可能な最大ヒープ サイズを減らす必要があります。64 bit システム用の既定値は 2 GB ですが、これは 32 bit システムに対しては大きすぎる値であり、利用可能なメモリ量に対応できない可能性があります。


アーカイブからファイルを抽出し、Jira を起動する前に次の手順を完了します。

ステップ 1: 既定の setenv ファイルの名前を変更します。

  1. <Jira-install-directory>/bin に移動し、setenv.bat / .sh ファイルを削除 (または名前変更) します。

  2. setenv32.bat / .sh の名前を setenv.bat / .sh に変更します。Jira は起動時にこのファイルを使用します。

ステップ 2: jira-config.properties ファイルにプロパティを追加。

  1. Jiraの ホーム ディレクトリに移動し、jira-config.properties ファイルを編集します。ファイルがない場合は作成できます。

  2. 次のプロパティを追加します:

    jira.index.batch.maxrambuffermb=256
    jira.index.interactive.maxrambuffermb=256

Do you want to run Jira as a service?

詳細を読む...

Running Jira as a service means that your Jira application will automatically start up when your Linux server is started.

You should use the Linux installer if you want to run Jira as a service.

If you choose not to run Jira as a service:

  • You will start your Jira application by running the start-jira.sh file in your Jira installation directory.
  • We recommend creating a dedicated user to run Jira. This user must have full read, write and execute access to the installation directory and home directory.
  • Jira will need to be restarted manually if your server is restarted.
どのデータベースを使用することを計画していますか? 
詳細を読む...

To run Jira in production you'll need an external database. Check the Supported platforms page for the version you're installing for the list of databases we currently support. If you don't already have a database, PostgreSQL is free, easy to set up and has been extensively tested with Jira.

参考情報

  • 始める前に、データベースをセットアップします。サポート対象のすべてのデータベースのステップバイステップ ガイドを「Jira アプリケーションをデータベースに接続する」で利用できます。
  • UTF-8 文字エンコーディングを使用します。
  • Oracle または MySQL を使用している場合、ご使用のデータベース用のドライバをダウンロードする必要があります。
  • The embedded H2 database can be used for evaluating Jira, but you'll need to migrate to another database before running in production. You may find it easier to use external database from the start.

Jira ライセンスはありますか?

詳細を読む...

You'll need a valid Data Center license for Jira Software, Jira Core, or Jira Service Management to use Jira.

参考情報

  • If you have not yet purchased a Jira application license you'll be able to create an evaluation license during setup.
  • If you already have a license key you'll be prompted to log in to my.atlassian.com to retrieve it, or you can enter the key manually during setup.
  • If you're migrating from Jira Cloud, you'll need a new licenseJira

JAVA_HOME 変数が正しく設定されていますか?
詳細を読む...

Before you install Jira, check that you're running a supported Java version and that the JAVA_HOME environment variable is set correctly.

Jira applications can run with OpenJDK, Oracle JDK or JRE.

ご使用の Java バージョンを確認するには:

$ java -version

JAVA_HOME 変数が正しく設定されていることを確認するには:

$ echo $JAVA_HOME

If you see a path to your Java installation directory, the JAVA_Home environment variable has been set correctly. If a path is not returned you'll need to set your JAVA_HOME environment variable manually before installing Jira.

Have you created a dedicated user to run Jira?

詳細を読む...

We strongly recommend running Jira as a dedicated user.

開始する前にこのユーザーを作成してください。こにより、インストールディレクトリおよびホームディレクトリの作成時に、このユーザーに適切な読み取りおよび書き込み権限を付与できます。

この例では、jira というユーザーを作成します。

$ sudo /usr/sbin/useradd --create-home --comment "Account for running Jira Software" --shell /bin/bash jira


Install a Jira application

1. Download Jira

ご利用のオペレーティング システムに対応した tar.gz ファイルをダウンロードします。

2. インストールディレクトリの作成

  1. Create your installation directory – this is where Jira will be installed. Avoid using spaces or special characters in the path. We'll refer to this directory as your <installation-directory>
     

    手順について

    この例では、インストール ディレクトリを jirasoftware と呼びます。

    $ mkdir jirasoftware
  2. Extract the Jira tar.gz file to your <installation-directory>. We recommend using a GNU version of the archive utility, especially on Solaris.
     

    手順について

    Change to the directory where you downloaded Jira then execute these commands:

    $ tar -xzf atlassian-jira-software-X.X.X.tar.gz -C <installation-directory>
    $ cd <installation-directory>

    Replace x.x.x with your Jira version and <installation-directory> with the full path to the directory you created in the last step.

  3. Give your dedicated Jira user read, write and execute permission to your <installation-directory>
     

    手順について

    この例では、インストール ディレクトリの所有権を変更し、ユーザー jira に読み取り、書き込み、および実行権限を付与しています。

    $ chown -R jira <installation-directory>
    $ chmod -R u=rwx,go-rwx <installation-directory>

3. ホームディレクトリの作成

  1. Create your home directory – this is where Jira application data like logs, search indexes and files will be stored. This should be separate to your installation directory, with no spaces or special characters in the path. Each Jira application needs its own home directory. 

    We'll refer to this directory as your <home-directory>
     

    手順について

    この例では、ホーム ディレクトリを jirasoftware-home と呼びます。

    $ mkdir jirasoftware-home
  2. Give your dedicated Jira user read, write and execute permissions to the <home-directory>.

    手順について

    この例では、ホーム ディレクトリの所有権を変更して、ユーザー jira に読み取り、書き込み、および実行権限を付与しています。

    $ chown -R jira <home-directory>
    $ chmod -R u=rwx,go-rwx <home-directory>
  3. Tell Jira where to find your <home-directory> when it starts up.  There are two ways to do this:
      

    (推奨) 環境変数を設定する...

    お使いのオペレーティング システムで、<home-directory> への絶対パスを持つ環境変数 JIRA_HOME を設定できます。

    ターミナルで以下を実行します。

    export JIRA_HOME=/path/to/home-directory

    You can then specify the command above in a script used to start Jira.

    jira-application.properties ファイルを編集...

    任意のテキスト エディタで <installation-directory>\atlassian-jira\WEB-INF\classes\jira-application.properties を編集します。

    jira.home の後に、ホーム ディレクトリへの絶対パス (symlink ではない) を追加します。例:

    jira.home=/var/jirasoftware-home

4. ポートの確認

By default Jira listens on port 8080. If you have another application running on your server that uses the same ports, you'll need to tell Jira to use a different port. 
 

手順について

ポートを変更する方法

  1. <installation-directory>\conf\server.xml を編集します。

  2. サーバーポート (8005) およびコネクタポート (8080) を変更してサーバー上のポートを解放します。

    以下の例では、サーバーポートを 5005、コネクタポートを 5050 に変更しました。

    <Server port="5005" shutdown="SHUTDOWN">
    ...
       <Service name="Catalina">
          <Connector port="5050"
             maxThreads="150"
             minSpareThreads="25"
             connectionTimeout="20000"
             enableLookups="false"
             maxHttpHeaderSize="8192"
             protocol="HTTP/1.1"
             useBodyEncodingForURI="true"
             redirectPort="8443"
             acceptCount="100"
             disableUploadTimeout="true"/>

If you are running on a Unix server and bind the ports below 1024 (such as port 80 for example), you will need to start Jira as root in order to successfully bind to the port.

5. Start Jira

  1. <installation-directory>/bin/start-jira.sh を実行してセットアップ プロセスを開始します。
     

    手順について

    We recommend running Jira as your dedicated user.

    $ su -u <user>
    $ ./start-jira.sh

    Ubuntu を使用している場合は、コマンドは次のように少し異なります。

    $ sudo su <user>
    $ ./start-jira.sh
  2. Go to http://localhost:8080/ to launch Jira in your browser (change the port if you've updated the Connector port).


JIRA の起動で問題が発生していますか?
  • JAVA_HOME 変数が正しく設定されていることを確認します。

Set up your Jira application

6. セットアップ方法の選択

自分で設定するを選択します。

7. データベースへの接続

  1. データベースをまだ作成していない場合、ここで作成します。詳細については、このページの「はじめる前に」セクションを参照してください。 
  2. 独自データベースを選択します。 
  3. データベースのタイプを選択してから、データベースの詳細を入力します。 
      

    手順について

    Jira は標準 JDBC データベース接続を使用してデータベースに接続します。接続プールは Jira 内で処理され、Jira 設定ツールを使用して後から変更できます。

    Oracle または MySQL を使用している場合、追加の手順があります。 

    • 適切なデータベース JDBC ドライバをダウンロードして解凍します。適切なバーションを確認するには、「サポートされているプラットフォーム」を参照してください。
    • セットアップ ウィザードを使用して続行する前に、JAR ファイルを <jira-installation>/lib フォルダにドロップします。

    セットアップウィザードにて :

    • Driver Class Name – データベース ドライバの Java クラス名です。不明な場合は、データベースのドキュメント確認してください。
    • データベース URL – データベースの JDBC URL。不明な場合は、データベースのドキュメント確認してください。
    • ユーザー名パスワード – Jira がユーザーのデータベースにアクセスするために使用できる有効なユーザー名とパスワードです。

8. アプリケーション プロパティを設定する

  1. Give your Jira site a name.
  2. サイトを非公開にするか、だれでもサインアップできるようにするかを選択します。この設定はあとから変更できます。 
  3. Enter your base URL - this is the address people will use to access your Jira site. 

9. ライセンスの入力

Follow the prompts to log in to my.atlassian.com to retrieve your license, or enter a license key.

10. 管理者アカウントの作成

管理者アカウントの詳細を入力します。セットアップの完了後に管理者を追加することができます。

11. メール通知の設定

Enter details of your mail server.  This will allow Jira to send notifications when issues change.

12. Jira の使用を開始する

That's it! Your Jira site is accessible from your base URL or a URL like this: http://<computer_name_or_IP_address>:<port>

チームの立ち上げと運営に役立つ情報を以下に挙げます。

トラブルシューティング

Jira のインストールで問題が生じていますか?
  • JAVA_HOME が正しく設定されていることを確認します。

 詳細は、ナレッジベースの「インストールのトラブルシューティング」を参照してください。  

最終更新日 2024 年 9 月 6 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.