Crowd Data Center のインストール

To install Crowd Data Center, you'll create a cluster of Crowd instances that will make sure your users have uninterrupted access both to Crowd, and all other systems that are connected to it. We recommend that you start with the prerequisite information, listed on this page, to understand what Data Center is, and to know exactly what you'll need to complete the installation.


はじめる前に

Before you install Crowd Data Center, take a look at the specifics below.


What is Crowd Data Center?

詳細を読む...

You should first understand what Crowd Data Center is, and how it works. We've gathered some resources that will help you get to know the high-level overview of Data Center, and its architecture.

Take a look at Crowd Data Center.

入手方法
詳細を読む...

You'll need two things to get started—an installer, and a license.

There's no special installer for Data Center—you just install Crowd, and then enable Data Center features in it.

As for the license, you can purchase it or get a trial.

A trial license gives you access to a full instance of Jira Data Center for 30 days. At the end of the trial period your Jira Data Center site will become read-only and you’ll have the option to buy a full license to continue using it, so you won’t lose any of your projects or data.

前提条件は何ですか。

詳細を読む...

サポート対象プラットフォーム

Supported operating systems, databases, etc., are the same as for the Server installation, and you can see them here: Supported platforms. You need to use an external database—HSQLDB is not supported.

ノード要件

Those specific to Data Center include requirements for nodes that create the cluster:

  • 各ノードが別のマシンである (物理または仮想)。同一でなくても構いませんが、パフォーマンスを一貫させるためには、可能な限り同じにする必要があります。
  • All nodes are running the same version of Crowd. You'll be copying Crowd from one node to another, so this shouldn't be a problem.
  • They use the same timezone, and have the current time synced. You can use ntpd to set this up.
  • すべてのノードは共通のデータベースを共有し、別のマシンにインストールされている。
  • All nodes can access the shared home directory. You can set it up using NFS or a similar solution. We'll mention it in this guide.
ロード バランサは必要ですか?
詳細を読む...

Yes. Crowd Data Center relies on a load balancer to balance the traffic between the nodes, and this guide assumes that you already have one set up. You can use a load balancer of your choice, just make sure it meets these requirements:

  • "クッキー ベースのセッション アフィニティ" ("スティッキー セッション" としても知られる) をサポートする必要があります。
  • 利用可能なノードのいずれかへ HTTP/HTTPS トラフィックをルーティングできる。
  • ノードが利用可能かどうかを決定し、必要に応じてリクエストを他のノードへルーティングできる。
  • すべてのアトラシアン アプリケーションやその他の REST クライアントは、ロード バランサ経由でノードにアクセスする必要があります。

または、プロキシをロード バランサに変えてもかまいません。

Many bigger installations of Crowd already have a reverse proxy configured, and many reverse proxies can do load balancing as well. We've provided some examples on how to use your proxy as a load balancer. See Load balancer examples.

1. Install Crowd

Crowd Data Center is available for Crowd 3.0, or later. If you're not on this version yet, install or upgrade your Crowd instance. See Crowd installation and upgrade guide.

After you've installed Crowd and applied your license, you can verify that Data Center is available by going to Administration  > Licensing.

2. 共有ディレクトリのセットアップ

クラスター内のすべてのノードで読み取り/書き込み可能なリモート ディレクトリを作成する必要があります。これを行うには複数の方法がありますが、もっとも簡単な方法は、NFS 共有を使用することです。

  1. Stop Crowd.

  2. Go to Crowd's home directory, and check whether it already has the shared sub-directory, which might have been created after starting Crowd. If it's there, you'll need to copy its contents to the new shared directory that you'll create in the next steps. If you can't find it, just omit this step.
  3. Create a remote directory, accessible by all nodes in the cluster, and name it shared
  4. Mount shared as a sub-directory of the Crowd home directory.

    <home-directory>/shared

3. Add the first Crowd node to your load balancer

はじめる前に 

You must enable clustering in Crowd first. To do that, in your shared directory edit the crowd.cfg.xml file and set the crowd.clustering.enabled property to true and restart Crowd.


ロード バランサはノード間のトラフィックを分散させます。ノードが動作を停止すると、残りのノードがワークロードを引き継ぐため、ユーザーは気付くこともありません。

  1. First, add your load balancer as a trusted proxy server in Crowd. See Configuring Trusted Proxy Servers.
  2. 最初のノードをロード バランサに追加します。

  3. Restart the node, and then try opening different pages in Crowd. If the load balancer is working properly, you should have no problems with accessing Crowd.
  4. In Crowd, go to > Clustering. The node should be listed as part of the cluster. 

    tip/resting Created with Sketch.

    If your load balancer supports health checks, configure it to perform a check on http://<crowd-node>:8095/<context-path>/status, where <crowd-node> is the node's hostname or IP address, and <context-path> is the Crowd's context path (e.g. /crowd). If the node doesn't respond with a 200 OK response within a reasonable time, the load balancer shouldn't direct any traffic to this node.

  5. After you've added the node to the load balancer, configure the Crowd's base URL to also point to the load balancer. Go to > General, and enter the URL of your load balancer as Base URL.

4. 残りのノードをクラスターに追加します。

  1. Copy the Crowd installation directory to the new node. 
  2. Create a home directory, like you did for the first node, and mount shared as its sub-directory.
  3. Edit crowd-init.properties, and enter the path to the home directory that you just created. 

    Where can I find crowd-init.properties?

    The crowd-init.properties file is in <installation-directory>\crowd-webapp\WEB-INF\classes\.

  4. Go to <installation-directory>/apache-tomcat/conf/Catalina/localhost, and delete the openidserver.xml file. This is needed because currently the CrowdID component doesn't support clustering, and it must be enabled only on the first node. The component will work as usual.
  5. Start Crowd. It will read the configuration from the shared directory, and start without any extra setup.
  6. Take a look around the new Crowd instance. Verify that user and group management, directory synchronization, and any custom integrations all work as expected.
  7. Again, verify that the node was added to the cluster. In Crowd, go to  > Clustering.

     
  8. If everything looks fine, you can configure your load balancer to start routing traffic to the new node. Once you do this, you can make a couple of changes in one Crowd instance to see if they're visible in other instances as well.

その他

Adding node names

When displaying information about your nodes in the Crowd footer or on the  > Clustering page, Crowd Data Center uses random IDs that were generated for your nodes. Instead, you can give them more persistent and readable names by setting the cluster.node.name system property, like in the following example:

CATALINA_OPTS=-Dcluster.node.name=node-1

Well done! Crowd Data Center is now at your service. Learn more about what Crowd Data Center provides

最終更新日 2023 年 9 月 29 日

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

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