Linux Ubuntu

スクリプトをダウンロードする

スクリプトをこちらのリンク からダウンロードします。

スクリプトを一時ディレクトリに移動する

ダウンロードしたスクリプトを一時ディレクトリ（ユーザーのホームディレクトリ）に移動します。

サービスの zip とライセンスファイルを追加する

Babel サービスの zip ファイル（名前は babel_service_net100_x.y.z.w.zip で、x.y.z.w はバージョンです）とライセンスファイル（babel.licenses）を、スクリプトと同じ一時ディレクトリに置きます。

スクリプトを実行する

次のコマンドを実行して、インストールを開始します。

chmod +x ./BabelLicensingService.sh
sudo <a data-footnote-ref href="#user-content-fn-1">./BabelLicensingService.sh</a>

ファイルを babel ユーザーのホームディレクトリにコピーする

ターミナルを開き、次のコマンドを実行して、ZIP ファイルとライセンスファイルを目的の場所にコピーします。

cp babel_service_net100_x.y.z.w.zip /home/babel/
cp babel.licenses /home/babel/

これで、Babel Licensing Service のアセンブリを含む ZIP ファイルが、「babel」ユーザーのホームディレクトリ（/home/babel）に置かれます。このディレクトリのファイルを使って、Babel Licensing Service のインストールと設定に進めます。

インストールディレクトリを作成してアーカイブを展開する

「/var/www」の下に「svc/babel」ディレクトリを作成し、ZIP アーカイブの内容を展開します。

1. ターミナルウィンドウで次のコマンドを実行して、「/var/www」の下に「svc/babel」ディレクトリを作成します。

sudo mkdir -p /var/www/svc/babel

「sudo」は、システムディレクトリの下にディレクトリを作成するための管理者権限を与えるので、パスワードの入力を求められます。

2. 現在の作業ディレクトリを、新しく作成した「babel」ディレクトリに変更します。

cd /var/www/svc/babel

3. ZIP アーカイブの内容を、現在のディレクトリ（「/var/www/svc/babel」）に展開します。

sudo unzip /home/babel/babel_service_net100_x.y.z.w.zip

この手順により、必要なディレクトリ構造が作成され、ZIP アーカイブの内容が「/var/www/svc/babel」ディレクトリに展開されます。これで、適切な場所で Babel Licensing Service のインストールと設定に進めます。

ライセンスファイルをコピーする

次のコマンドで、ライセンスファイル「babel.licenses」を「/var/www/svc/babel」ディレクトリにコピーします。

sudo cp /home/babel/babel.licenses /var/www/svc/babel/

これで、ライセンスファイル「babel.licenses」が「/var/www/svc/babel」ディレクトリにインストールされました。続いて、Babel Licensing Service を実行するユーザーを設定します。

アプリケーションの所有者を設定する

ライセンスファイル「babel.licenses」を「/var/www/svc/babel」ディレクトリにインストールしたら、次に Babel Licensing Service を実行するユーザーを設定します。ここでは、ユーザーを「www-data」に設定します。

ユーザーを設定するには、ターミナルで次のコマンドを実行します。

sudo chown www-data:www-data -R /var/www/svc/babel

このコマンドは、「/var/www/svc/babel」ディレクトリとその内容の所有者を、「www-data」ユーザーとグループに変更します。所有者を正しく設定すると、Babel Licensing Service を適切なユーザーで実行でき、サービスが必要なファイルとディレクトリにアクセスして操作できるようになります。

サービスを設定する

Babel Licensing Service を設定し、appsettings.json ファイルにデータベース接続の設定やその他のアプリケーション構成を記述するには、次の手順に従います。

1. ターミナルウィンドウで次のコマンドを使用して、appsettings.json ファイルをテキストエディター Nano で開きます。

sudo nano /var/www/svc/babel/appsettings.json

2. appsettings.json ファイルで "Database" セクションを探します。"Provider" の値を "MySQL" に設定して、データベースプロバイダーとして MySQL を使用することを指定します。

"Database": {
  "Provider": "MySQL"
},

3. "ConnectionStrings" セクションを探します。"MySQL" キーの接続文字列を、お使いの MySQL サーバーの構成に合わせて変更します。server、User、Password、Database の値を適宜更新します。

"ConnectionStrings": {
  "SQLServer": "",
  "MySQL": "Server=127.0.0.1;User=babel;Password=YourUniquePassword;Database=licenses",
  "SQLite": ""
},

"YourUniquePassword" は、必ず任意の強力なパスワードに置き換えてください。安全なパスワードにするために、大文字、小文字、数字、特殊文字を組み合わせることを強くお勧めします。このパスワードは、後でデータベースを設定するときに使うので、控えておいてください。

4. 必要に応じて、その他のアプリケーション設定をカスタマイズできます。たとえば、"Serilog" セクションでは、ログの設定を行い、最小ログレベルを調整できます。

"Serilog": {
  "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.File" ],
  "MinimumLevel": {
    "Default": "Information",
    "Override": {
      "Microsoft": "Debug",
      "System": "Debug",
      "Grpc": "Debug"
    }
  },
  ...
},

インストールの問題を調べるときは、最小ログレベルを Debug に設定すると役立つことがあります。サービスが動作するようになったら、ログレベルを Information または Warning に戻せます。

5. さらに下の "Application" セクションでは、"LicenseFile"（babel.licenses）を指定し、"SigningKey" と "TokenExpiration" の値を要件に合わせてカスタマイズできます。

"Application": {
  "AdminUsername": "your-admin-user",
  "AdminEmail": "admin@example.com",
  "AdminPassword": "<strong-initial-password>",
  "LicenseFile": "babel.licenses",
  "SigningKey": "Secret Token Key",
  "TokenExpiration": "00:30:00"
},

Secret Token Key を独自のキーに置き換えます。このキーは、アプリケーションクライアントと Babel Licensing Service の間の通信を保護するために使用されます。

6. 変更を保存して Nano を終了するには、Ctrl + X を押し、次に Y を押して変更を確定し、最後に Enter を押してファイルを保存します。

この手順で、appsettings.json ファイルを編集して Babel サービスを設定できました。更新された構成には、正しいデータベース接続の設定と、行ったその他のカスタマイズが含まれています。

Babel Licensing Service の構成ファイルについて詳しくは、構成のセクションを参照してください。

データベースを作成する

Babel Licensing Service に設定した接続文字列で指定されている「licenses」データベースを作成する必要があります。続いて「babel」ユーザーを作成し、データベースに対する権限を付与して、ユーザーの権限を確認します。

1. ターミナルを開きます。
2. 次のコマンドで、root ユーザーとして MariaDB コンソールにログインします。

sudo mariadb -u root -p

root のパスワードの入力を求められます。

3. MariaDB コンソールにログインしたら、次のコマンドを実行して、既存のデータベースをすべて一覧表示できます。

SHOW DATABASES;

4. 既存のユーザーをすべて一覧表示するには、次のクエリを実行します。

SELECT User FROM mysql.user;

5. 次のコマンドで「licenses」データベースを作成します。

CREATE DATABASE licenses;

6. 次のコマンドを実行して「babel」ユーザーを作成し、「licenses」データベースに対するすべての権限を付与します。

CREATE USER babel@localhost IDENTIFIED BY 'YourUniquePassword';
GRANT ALL PRIVILEGES ON licenses.* TO babel@localhost;
FLUSH PRIVILEGES;

'YourUniquePassword' は、Babel Licensing Service の MySQL 接続文字列に設定したパスワードに置き換えます。

7. 「babel」ユーザーに適切な権限があることを確認するには、次のステートメントを使用します。

SHOW GRANTS FOR babel@localhost;

quit コマンドを入力して ENTER を押すと、MariaDB コンソールを終了できます。

この手順で、「licenses」データベースの作成、「babel」ユーザーの作成、データベースに対する権限の付与、ユーザーの権限の確認ができました。

ターミナルを開く

ターミナルウィンドウを開きます。

サービスのディレクトリに移動する

Babel Licensing Service があるディレクトリに移動します。たとえば、次のようにします。

cd /var/www/svc/babel

サービスを実行する

次のコマンドを実行して、Babel Licensing Service を起動します。

dotnet Babel.Licensing.Service.dll

すべてが正しく設定されていれば、サービスが起動する様子が表示されます。ターミナルのログには、appsettings.json ファイルで選択したログレベルに応じて、データベースのテーブルの作成など、サービスの初期化に関する情報が表示されます。

ターミナルのログにエラーや警告が出ていないか確認してください。問題がある場合は、構成、データベース接続の設定、権限を見直し、正しく設定されていることを確認します。

Babel Licensing Service が正常に起動すると、ライセンス管理の操作を処理し、アプリケーションにライセンスサービスを提供できる状態になります。

サービスファイルを開く

ターミナルを開き、次のコマンドを実行して、サービスファイルを作成して編集します。

sudo nano /etc/systemd/system/babel.licensing.service

サービスの構成を貼り付ける

次の構成をファイルに貼り付けます。

[Unit]
Description=Babel Licensing Service
 
[Service]
WorkingDirectory=/var/www/svc/babel/
ExecStart=/usr/bin/dotnet /var/www/svc/babel/Babel.Licensing.Service.dll
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=babel-licensing-svc
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
 
[Install]
WantedBy=multi-user.target

サービスファイルを保存する

Ctrl+O を押してファイルを保存し、Ctrl+X を押してエディターを終了します。

サービスを起動する

次のコマンドを実行して、Babel Licensing Service を起動します。

sudo systemctl start babel.licensing

サービスの状態を確認する

サービスの状態を確認するには、次のコマンドを使用します。

systemctl status babel.licensing

このコマンドは、エラーメッセージや警告を含め、サービスの現在の状態を表示します。

● babel.service - Babel Licensing Service
     Loaded: loaded (/etc/systemd/system/babel.licensing.service; disabled; vendor preset: enabled)
     Active: active (running) since Fri 2023-05-19 09:24:53 UTC; 1s ago
   Main PID: 2710499 (dotnet)
      Tasks: 17 (limit: 4392)
     Memory: 28.0M
        CPU: 903ms
     CGroup: /system.slice/babel.licensing
             └─2710499 /usr/bin/dotnet /var/www/svc/babel/Babel.Licensing.Service.dll
 
May 19 09:24:57 babel-licensing-svc[2710499]: [09:24:57 DBG] Hosting started

自動起動を有効にする

既定では、サービスはサーバーの起動時に自動的に起動するようには設定されていません。サービスが自動的に起動するようにするには、次のコマンドを実行します。

sudo systemctl enable babel.licensing

サービスを有効にすると、サーバーの再起動後に自動的に起動するようになります。