Skip to content

fixpoint/kompira-v16-package

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Kompira: シンプルで軽量な次世代運用自動化プラットフォーム

1. Kompiraとは

Kompira は IT 運用管理業務の自動化を支援するための基盤システムです。 ジョブフローを記述することで、様々な運用業務、管理業務、さらには障害の復旧処理まで自動化することができます。

2. 動作環境

Kompira 1.6 の動作環境は以下の通りです。

2.1. 対応システム

  • アーキテクチャ: x86_64

  • オペレーティングシステム:

    • Red Hat Enterprise Linux (RHEL) 8 / 9 / 10
    • Rocky Linux 8 / 9 / 10
    • AlmaLinux OS 8 / 9 / 10
    • MIRACLE LINUX 8 / 9
    • CentOS Stream 9 / 10
    • AmazonLinux 2023 (ただし現状では冗長構成には未対応です)
  • Python バージョン:

    • Python 3.12
  • PostgreSQL バージョン:

    • PostgreSQL 14 .. 18
  • RabbitMQ バージョン:

    • RabbitMQ 3.8 .. 3.13
  • ネットワークインタフェース: 1つ以上

※ Python 3.9 以前のバージョンはサポート対象外となりました。Python 3.9 以前の /opt/kompira 環境をアップデートすると Python 3.12 で Kompira 環境を構築しなおします。 ※ CentOS Linux 7.x/8.x 系および CentOS Stream 8 は EOL に伴いサポート外となりました(インストールに失敗します)。RHEL 互換 OS のご利用をご検討ください。 ※ RHEL 7.x 系および Amazon Linux 2 は、erlang/rabbitmq-server のサポート対象外となったため新規インストールできなくなりました。

2.2. ハードウェア要件

  • CPU:2GHz以上
  • メモリ:8GB以上
  • HDD:250GB以上

※ 必要なスペックは Kompira 上で動作するジョブフロー規模、自動化の処理要件によって異なります。都度ご相談ください。 ※ 記載要件は最低レベルで記載しております。お客様の運用環境によっては異なる場合がございますのでご了承ください。

2.3. 利用するポート

Kompira が利用するポート番号は以下の通りです。

2.3.1. 外部から内部への方向

  • Kompira GUI, REST APIへのアクセス: http(80), https(443)
  • kompira_jobmngrd によるリモート連携: amqps(5671), amqp(5672)
  • kompira_sendevt によるイベント送信: amqps(5671), amqp(5672)

2.3.2. 内部から外部への方向

  • Kompira からメール受信: POP(110), IMAP(143), POPS(995), IMAPS(993)
  • Kompira からメール送信: SMTP(25), SMTP-TLS(587), SMTPS(465)
  • Kompira から外部機器へのアクセス: ssh(22), telnet(23), wsman-http(5985), wsman-https(5986)
  • Kompira から外部 API の呼び出し: http(80), https(443)
  • Kompira から AD/LDAP 連携: LDAP(389), LDAPS(636)

2.3.3. 冗長構成の場合の ACT/SBY 間通信

  • rabbitmq(4369, 5672, 25672)
  • postgresql(5432)
  • pcsd(2224)
  • corosync(UDP/5404, UDP/5405)

3. インストール

3.1. パッケージのダウンロード

リリースページ から各リリースの内容確認と、パッケージ (Assets にある kompira-1.6.xx-bin.tar.gz) のダウンロードができます。

インストールしたいリリースのパッケージをダウンロードしたら、イン ストール先のサーバの任意のディレクトリに配置してください。

3.2. インストール手順

パッケージを展開してディレクトリの中に移動して、root 権限で ./install.sh を実行してください。

# tar zxf kompira-1.6.xx-bin.tar.gz
# cd kompira-1.6.xx-bin
# ./install.sh
  • インストール先のサーバは、OS が新規インストール状態であることを推奨します。
  • Kompira のインストールには、インターネット接続環境が必要です。
  • RedHat にインストールする場合は、事前にサブスクリプションを登録しておく必要があります。

インストールに成功したサーバにブラウザでアクセスするとログイン画面が表示されますので、以下のアカウントでログインすることで Kompira をはじめることができます。

  • ユーザ名: root
  • パスワード: root

ログイン後の画面の右上にある「ヘルプ」をクリックすると、オンラインマニュアルが表示されますので使い方の参考にしてください。

3.3. proxy 環境下でのインストール

以下のように --proxy オプションを付けて install.sh を実行してください。

# ./install.sh --proxy proxy:3128
  • オプションに渡す "proxy" や "3128" の部分は導入環境のプロキシサーバのホスト名(またはIPアドレス)やポート番号に合わせてください。

認証付きプロキシサーバの場合は、以下のように "user" にユーザー名を、"password" にパスワードを指定して install.sh を実行してください。

# ./install.sh --proxy user:password@proxy:3128

3.4. インストール時の言語設定

デフォルトではインストール先の Linux サーバのシステムの言語設定に合わせてインストールされます。(ただし、対応する言語は日本語と英語のみで、エンコーディング指定は UTF-8 のみサポートしています)

システムの言語設定と異なる言語でインストールしたい場合は、--locale-lang オプションを指定してインストールしてください。たとえば、英語モードでインストールする場合は、以下のように指定します。

# ./install.sh --locale-lang en_US.UTF-8

4. 注意点

4.1. 利用上の注意点

  • v1.6.13 から新規インストールでは Python 3.12 で Kompira 環境が構築されます。v1.6.12 までの Python 3.9 で構築された環境とは細部が異なりますのでご注意ください。
  • v1.6.11 から新規インストールでは Python 3.9 で Kompira 環境が構築されます。v1.6.10 までの Python 3.8 で構築された環境とは細部が異なりますのでご注意ください。
  • v1.6.10 から新規インストールでは PostgreSQL は対応する最新バージョン (17.x など) がインストールされます。v1.6.9 までは PostgreSQL 12.x 固定でしたが、環境やバージョンによってデータベースクラスタの位置などが異なるなど、差異がありますのでご注意ください。
  • v1.6.9 から新規インストールでは Python 3.8 で Kompira 環境が構築されます。v1.6.8 までの Python 3.6 で構築された環境とは細部が異なりますのでご注意ください。
  • v1.6.4 から添付ファイルがデータベースに保存されるようになり、また合わせてサイズ制限が緩和されました。データベース上では添付ファイルの実サイズより大きい容量を必要とするため、大きな添付ファイルを扱う場合はディスクの空き容量にご注意ください。
  • v1.6.4 からサーバ上に添付ファイルの実体は保持しなくなりますので、サーバ上に添付ファイルの実体が存在することを前提としたジョブフローなどは正常に動作しなくなります。

4.2. アップデート時の注意点

  • v1.6.12 以前から v1.6.13 以降にアップデートした場合、既存の /opt/kompira 環境はバックアップしたうえで、新たに Python 3.12 で /opt/kompira 環境を作り直します。
  • v1.6.10 以前から v1.6.11 以降にアップデートした場合、既存の /opt/kompira 環境にインストール済みの Python 3.8 が継続して利用されます。自動的には Python 3.9 へアップデートされませんのでご注意ください。
  • v1.6.10 以降で PostgreSQL のアップグレードに対応しました。詳しくは管理ガイドの「1.2.3.3. PostgreSQL のアップグレード」をご参照ください。
  • v1.6.9 以前から v1.6.10 以降にアップデートした場合、既存の PostgreSQL はメジャーバージョンを維持します。自動的には PostgreSQL 13 以上にアップグレードされませんのでご注意ください。
  • v1.6.8 以前から v1.6.9 以降にアップデートした場合、既存の /opt/kompira 環境にインストール済みの Python 3.6 が継続して利用されます。自動的には Python 3.8 へアップデートされませんのでご注意ください。
  • v1.6.3 以前から v1.6.4 以降にアップデートした場合、既存の添付ファイルは kompirad 起動時に自動的にデータベースに保存されます。そのため、添付ファイルの数が多い場合は起動に時間がかかる場合があります。また、データベース保存に移行した後も、添付ファイルに対応するサーバ上の実ファイルはそのまま残っていますので、不要な場合は手動で /var/opt/kompira/upload を削除してください。

その他の、過去のリリースでの注意点については「アップデート時の注意点」を参照してください。

4.3. 冗長構成での注意点

  • v1.6.10 以降で冗長構成での PostgreSQL アップグレードに対応しました。詳しくは管理ガイドの「1.9.3.3. PostgreSQL アップグレードを伴う両系停止アップデート手順」をご参照ください。

  • v1.6.6 以降で冗長構成時のアップデート手順が変更され、install.sh の後の pcs cluster start が不要になりました。詳しくは管理ガイドの「1.9.3.アップデート」をご参照ください。

  • CentOS 7 環境における冗長構成アップデートについて

  • 冗長構成を v1.6.3 以前から v1.6.4 以降にアップデートした場合、pacemaker 配下で lsyncd サービスが動作する設定のままとなっています。v1.6.4 環境で lsyncd が動作していても影響はありませんが、lsyncd サービスを停止させる場合は冗長構成のアップデートが正常に終えたあとに、root 権限で以下のコマンドを実行してください。

    # pcs resource delete res_lsyncd
    

5. Kompira 関連の情報

5.1. Kompira ニュース

Kompira の最新情報については お知らせ をご参照ください。

5.2. Kompira 運用自動化コラム

Kompira の実践的な使い方やジョブフローの書き方についてはサポートサイトの 課題解決方法 を参考にしてみてください。

5.3. Kompira コミュニティサイト

Kompira の使い方が分からない場合などは、コミュニティサイトの KompiraEnterprise関連 を参考にしてみてください。同じような質問や回答が見つからない場合は、新たに投稿してみてください。

About

Repository for distributing Kompira Enterprise releases.

Resources

License

Stars

Watchers

Forks

Contributors