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