OBProxyの起動

OBProxyのデプロイが完了したら、コマンドを使用して個々のobproxyプロセスを起動できます。

前提条件

OBProxyがデプロイ済みであることを確認してください。OBProxyのデプロイ手順については、OBProxyのデプロイを参照してください。

背景

obproxyプロセスを起動するには、以下の2つの方法があります。

• 起動コマンドに-rパラメータを指定し、OceanBaseクラスタのRootServer情報を指定します。この起動方法は追加の設定が不要で、通常は開発デバッグ段階で使用されます。

• 起動コマンドにobproxy_config_server_urlパラメータを指定し、OceanBaseクラスタのRootServer情報を取得します。この方法ではobproxy_config_server_urlの設定が必要なため、Config Serverの起動に依存します。OBProxyの起動には、この方法の使用を推奨します。

手順

1. adminユーザーで、起動対象のOBProxyがインストールされているマシンにログインします。

   注意

   OBProxyを起動する際は、adminユーザーでログインし、OBProxyソフトウェアのホームディレクトリで起動コマンドを実行してください。他のユーザーを使用したり、他のディレクトリでOBProxyを起動したりすると、問題が発生する可能性があります。

2. OBProxyのインストールディレクトリに移動します。

3. 以下のコマンドを実行して、OBProxyを起動します。

   説明

   OBProxyを起動する前に、./bin/obproxy -h コマンドを実行して、OBProxy起動に関連するパラメータを確認できます。

   • 起動コマンドに -r パラメータを指定する

     コマンドは以下のとおりです：

     $./bin/obproxy -p6789 -r'ip:port' -e -n appname -o obproxy_config_server_url='' -c cluster_name
     

     パラメータの説明：

     • -p は、OBProxyがリスニングするポート番号を指定するために使用されます。クライアントはMySQL接続を介してこのポートにアクセスし、OceanBaseデータベースに接続します。このパラメータは初回起動時にのみ指定する必要があり、その後の日常的な起動やアップグレードでは追加する必要はありません。

     • -r'ip:port'：指定されたOceanBaseクラスタのRoot Server情報、IPアドレスとポート番号を含みます。ここで言うPortとはOBServerノードのSQL Portを指し、RPC Portではありません。

     • -e はテーブル作成操作を指定するために使用されます。OBProxyの初回起動時にのみ実行することを推奨し、その後の日常的な起動やアップグレードでは追加する必要はありません。

     • -n（オプション）：起動対象のOBProxyのアプリケーション名を指定するために使用されます。

       OBProxyのアプリケーション名は app_name 設定パラメータで変更でき、デフォルトは undefined です。

     • -o はハードウェアまたはカーネルパラメータ設定を指定するために使用されます。指定しない場合、システムのデフォルト設定が使用されます。

       obproxy_config_server_url='' はConfig Serverなしで起動することを意味します。

     • -c cluster_name はOceanBaseクラスタを指定するために使用されます。

     例：

     $./bin/obproxy -r'10.10.10.1:26506;10.10.10.2:26506' -n test -c mycluster
     

   • 起動コマンドに obproxy_config_server_url パラメータを指定する

     コマンドは以下のとおりです：

     $./bin/obproxy -p6789 -e -n appname -o obproxy_config_server_url='your_config_url'
     

     ここで：

     • -p は、OBProxyがリスニングするポート番号を指定するために使用されます。クライアントはMySQL接続を介してこのポートにアクセスし、OceanBaseデータベースに接続します。このパラメータは初回起動時にのみ指定する必要があり、その後の日常的な起動やアップグレードでは追加する必要はありません。

     • -e はテーブル作成操作を指定するために使用されます。OBProxyの初回起動時にのみ実行することを推奨し、その後の日常的な起動やアップグレードでは追加する必要はありません。

     • -n：アプリケーション名を指定するために使用されます。

       OBProxyのアプリケーション名は app_name 設定パラメータで変更でき、デフォルトは undefined です。

     • -o はハードウェアまたはカーネルパラメータ設定を指定するために使用されます。指定しない場合、システムのデフォルト設定が使用されます。

     • obproxy_config_server_url はConfig Serverのアクセスアドレスを指定するために使用されます。

     例：

     $./bin/obproxy -n test -o obproxy_config_server_url='http://xx.xx.xx.xx:8877/obproxy_config'
     

4. 起動後、以下のコマンドを実行して、obproxyプロセスが存在するかどうかを確認します。

   $ps -ef|grep obproxy