moctl: オンプレミスサービス管理ガイド

---

miniOrangeオンプレミスIDサーバーには、管理者がIDプラットフォームをより効率的に管理・運用するのに役立つ、moctlと呼ばれるコマンドラインユーティリティが含まれています。

このガイドは、miniOrange 5.0.0をサーバーにインストール済みのITチームおよびシステム管理者、またはmoctlを新規に導入したい方を対象としています。導入、サービス管理、ログ、診断、トラブルシューティングについて解説します。

前提条件

インストール、展開、および運用を開始する前に必要となる要素の一覧を以下に示します。

必要となる環境は以下のとおりです。

• root または sudo アクセス
• 製品パスは以下からアクセスできます /opt/tomcat/latest
• systemdサービス mo-idp-*.service 形式でアーカイブしたプロジェクトを保存します．
• ランタイム設定 /etc/mo-idp-server.env （デプロイ済みサーバー上のプライマリ構成）

インストール、構成、および運用

1. インストールと展開

• If モクトル まだサーバー上に存在しないため、パッケージを転送してインストールしてください。

パッケージを転送する

          scp moctl.zip admin@<server-ip>:/opt/
        

解凍してインストールする

          
            cd /opt
            ├── unzip moctl.zip
            ├── cd /opt/moctl
            ├── sudo bash install-moctl.sh
          
        




注意：

install-moctl.sh 読み込み /etc/mo-idp-server.env 存在する場合は、それに応じてランタイム構成を更新します。

ユーザーは以下の設定を行っています。

• 実行可能： /usr/local/bin/moctl
• サポートファイル: /opt/miniorange/moctl
• 実行時設定: /etc/mo-idp-server.env （作成または更新）

2. インストール済みパッケージの検証

• ファイルが正しく配置されていることを確認してください。

          
            which moctl
            ls -l /usr/local/bin/moctl
            cat /etc/mo-idp-server.env
        

• ツールが正しく応答することを確認してください。

          
            moctl version
            moctl service status
            moctl diagnose full
          
        

3. サービス管理

• 次のステップは、ステータスを確認することです。

          moctl service status
        




ステータス	意味
Running:	サービスは活発で健全である。
登録	現在アクティブでEurekaが管理しており、登録処理中です。30～60秒お待ちください。
停止	サービスは停止中です。
Failed:	サービスがクラッシュしました。すぐにログを確認してください。

注意：

バージョン5.0.0では、eurekaserverとminiOrangeはEurekaの外部で動作します。これらは実行中と表示されますが、登録されることはありません。



• 開始／停止／再起動

Command	何それがありません
moctlサービス開始	すべてのサービスを正しい順序で起動してください。
moctl サービス停止	すべてのサービスを逆順に停止してください。
moctl service restart	すべてのサービスを再起動してください。
moctl service start gatekeeper	単一の名前付きサービスを開始します。
moctl service restart miniorange	指定された単一のサービスを再起動します。




注意：

コアサービスが最初に起動します：configserver → eurekaserver → gatekeeper → miniOrange。セカンダリサービスは自動的に起動します。サブコマンドを指定せずに moctl service または moctl diagnose を実行すると、提案が表示されます。

4. ログアクセスと監視

Command	何それがありません
moctl log minirange	すべてのサービスを正しい順序で起動してください。
moctl log miniorange -f Follow	ログをリアルタイムで表示します（停止するにはCtrl+Cを押してください）。
moctl log miniorange -n 500	最後の500行を表示します。
moctl log miniorange --since 1h	過去1時間のログを表示します。
moctl log gatekeeper --since 30min	指定されたサービスに関するログを表示します。

5。 診断

• このステップでは、完全なチェックを実行できます。

          moctl diagnose full
        



• チェック項目：サービスの状態、コアポート、メモリ、ディスク、Nginx、Java、環境ファイル、シンボリックリンク。

Command	何それがありません
moctl診断サービス	サービス提供状況のみ。
moctl diagnose ports	コアポートの可用性。
moctl 診断リソース	メモリとディスク使用量。
moctl 診断 deps	Nginx、Javaの依存関係。
moctl診断	利用可能なサブコマンドと使用方法のヘルプを表示します。

6. システムおよびJVMの検査

Command	何それがありません
moctl システムメモリ	メモリ使用量を表示する
moctl システム CPU	CPU使用率を表示する
moctl システムディスク	ディスク使用量を表示する
moctl jvm miniorange	JVMバージョン、ヒープ、フラグ、スレッド、ファイルディスクリプタ

7. 推奨ワークフロー

• ログイン時のルーチンチェック

          
            moctl diagnose full
            moctl service status
          
        



• サービス上の問題を調査しています。

          
            moctl service status
            moctl log miniorange --since 30min  
          
        



• 影響を受けたサービスを再起動し、復旧を確認してください。

          
            moctl service restart gatekeeper
            moctl service status
            moctl diagnose services  
          
        




注意：

可能な限り、サービス全体の再起動よりも、単一サービスの再起動を優先してください。

8。 トラブルシューティング

トラブルシューティングに関する問題が発生した場合、以下の手順をお試しください。

• moctl が見つかりません

          
          ls -l /usr/local/bin/moctl  
            echo $PATH
          
        



• 見つからない場合は、インストーラーを再実行してください。

            
            sudo bash install-moctl.sh
          



• サービスが検出されませんでした

          
          systemctl list-unit-files 'mo-idp-*.service'
        



• 想定されるサービス名:
• mo-idp-configserver.service
• mo-idp-eurekaserver.service
• mo-idp-gatekeeperサービス
• mo-idp-miniorangeサービス
• 製品パスが間違っている場合

          
          cat /etc/mo-idp-server.env
          ls -ld /opt/tomcat/latest
        




パスを修正します /etc/mo-idp-server.env そしてインストーラーを再実行してください。

• サービスが登録中に停止しています

          
          moctl diagnose services  
          moctl log gatekeeper --since 30min  
          curl -u registry_client:'Eureka2025_Client!' http://localhost:8070
        




確認: Eureka の利用可能性、認証情報 /etc/mo-idp-server.envログには起動エラーも記録されます。

注意：

SchedulerとminiOrangeは5.0.0ではEurekaで管理されないため、登録中とは表示されません。これらのサービスで登録中と表示される場合は、表示または設定に問題があることを示しています。



• 環境ファイルまたはシンボリックリンクが見つかりません

            
            test -f /etc/mo-idp-server.env && echo ok
            test -L /opt/tomcat/latest && readlink -f /opt/tomcat/latest  
          




失敗した値を修正してインストーラーを再実行してください。ランタイム構成は次の場所にあります。 /etc/mo-idp-server.env が信頼できる情報源です。