RSのセットアップ

RSのインストール

環境構成による手順の違い

RSのインストールはRSとMCを別端末で運用する場合に必要な作業です。RSとMCが同一端末の場合は、すでにインストールされていますので本作業は不要です。MCとの接続設定に進んで下さい。

RoboServerのインストール手順を説明します。

RSをインストールするサーバーに、RSのインストーラーをダウンロードします。

RSのインストーラーはBizRobo! Basicのインストーラーに同梱されています。以下のリンクから、MCと同じバージョンのBizRobo! Basicのインストーラーをダウンロードします。

BizRobo! Basic のインストーラーはこちら
ダウンロードしたフォルダを解凍します。解凍後「BizRobo_Basic11.5.0.5 JP.msi」を実行して、インストールを開始します。
セットアップウィザードが表示されるので、［次へ］をクリックします。
使用許諾契約書を確認の上チェックを入れ、［次へ］をクリックします。
［カスタム］をクリックします。
RSのみインストールするため、DS、MC、APIはインストール対象から除きます。
［Design Studio］、［Manaement Console WAR］、［API］は［ ▼ ］をクリックし［インストールしない］を選択します。

［RoboServer］のみ［ローカルドライブにインストールする］を選択します。
以下の状態になった事を確認の上［次へ］をクリックします。
［インストール］をクリックします。
［完了］をクリックします。

以上でRSのインストールは完了です。

MCとの接続設定

RSをインストールした端末で、「RoboServerSettings」の設定を行い、以下の機能を利用可能にします。

ロボットを使用した各種ファイルの書き込み
コマンドラインの利用
Connectorの活用

設定はユーザー毎に保持

本設定はWindowsにログインしているユーザー毎に保存されます。
起動するユーザーでログインし設定を行ってください。

Win + Q を押し、検索ボックスに①「RoboServer Settings」と入力し、表示された②［RoboServer Settings11.5.0.5］をクリックします。
「エンドユーザーライセンス使用許諾契約書」が表示されます。内容を確認してから［同意する］をクリックします。
「RoboServerの設定」が表示されます。「Management Console に登録」のチェックボックスをクリックし［一般］タブ内に以下のMCの設定情報を入力します。

接続タイプにより手順が異なります。

下記のタブで表示を切り替えて、手順をご参照ください。

サービス接続クライアント接続

項目	値
RoboServerの接続	クラスタの接続タイプが「サービスとしてのRoboServer」の場合ソケットサービス/ポート：50000 クラスタの接続タイプが「サービスとしてのRoboServer（SSL）」の場合ソケットSSLサービス/ポート：50001
サーバー名	RS端末のホスト名_ログインユーザー名を入力例：PC001_User001
Management Console に登録	☑(チェック)
Management Console URL	http://＜MCのホスト名 or IPアドレス＞:8080/mc
共有シークレット	MCから取得した共有シークレットを入力します。手順は下記「共有シークレット取得方法」をご参照ください。
クラスタ	例　`Non Production` RSを登録するクラスタ名を入力します。

サーバー名の設定について

問題発生時の調査に備え、RSを特定できるよう、サーバー名を「ホスト名_ログインユーザー名」の形式で設定することを推奨します。

ホスト名の確認方法はこちらを参照ください。

共有シークレット取得方法

共有シークレットはRSを接続するMCから取得します。
MCにログインし①［管理］＞②［サービス認証］＞③［3点リーダー］＞④［共有シークレットを表示］をクリックします。
［クリップボードにコピー］をクリックしてRoboServer Settingsの該当欄に貼り付けてください。

項目	値
RoboServerの接続	クラスタの接続タイプが「クライアントとしてのRoboServer」クライアント接続
サーバー名	RS端末のホスト名_ログインユーザー名を入力例：PC001_User001
Management Console に登録	☑(チェック)
Management Console URL	http://＜MCのホスト名 or IPアドレス＞:8080/mc
共有シークレット	MCから取得した共有シークレットを入力します。手順は下記「共有シークレット取得方法」をご参照ください。
クラスタ	例　`Non Production` RSを登録するクラスタ名を入力します。

サーバー名の設定について

問題発生時の調査に備え、RSを特定できるよう、サーバー名を「ホスト名_ログインユーザー名」の形式で設定することを推奨します。

ホスト名の確認方法はこちらを参照ください。

共有シークレット取得方法

共有シークレットはRSを接続するMCから取得します。
MCにログインし①［管理］＞②［サービス認証］＞③［3点リーダー］＞④［共有シークレットを表示］をクリックします。
［クリップボードにコピー］をクリックしてRoboServer Settingsの該当欄に貼り付けてください。

3.［セキュリティ］タブをクリックし、赤枠内のすべてのチェックボックスにチェックを入れ［OK］をクリックします。

以上でRoboServerSettingsの設定は完了です。

RS使用メモリを拡張

RSが使用するJavaHeapMemoryを増やすことでOutOfMemoryを回避します。

また、ロボットがコマンドプロンプトや PowerShell コマンドを使用できるようにするための設定も行います。

設定するメモリの値について

設定するメモリの値は、サーバーに搭載しているメモリの1/4～1/3程度を目安に設定してください。（本手順では4GBを割り当てています。）運用時にOutOfMemoryエラーが発生する場合はメモリ設定値を大きくしてください。

以下フォルダにある「RoboServer.conf」をコピーします。binフォルダ内では上書きできないため、デスクトップに貼り付けます。
※ 下記フォルダパスはご利用のバージョンに合わせてください。
```
C:\Program Files\BizRobo Basic 11.5.0.5\bin
```
デスクトップに貼り付けたRoboServer.confをテキストエディターで開きます。

以下「変更前」の文字列を検索し、「変更後」の文字列に書き換えます。書き換え後、変更前の文字列にある「#」が削除されていることをご確認ください。

変更前　#wrapper.java.maxmemory=1024
変更後　wrapper.java.maxmemory=4096

変更後コード
```
wrapper.java.maxmemory=4096
```
書き換えた行のすぐ下の行に以下の文字列を追記し、ファイルを保存します。

追加文字列
```
wrapper.java.additional.20=-Djdk.lang.Process.allowAmbiguousCommands=true
```
編集したRoboServer.confを元の「RoboServer.conf」に上書き保存します。

以上で、RoboServer.confの設定は完了です。

RS用50000ポートの予約

49152～65535のポートは「動的ポート」範囲です。
動的ポートは他のアプリが自由に使用できるため、なにも設定しない状態では50000ポートを他のアプリで使用され、RSとMCが通信できなくなる可能性があります。本手順ではそれを回避するため、RSが使用する50000ポートを予約し、他のアプリが使用できないようにします。

接続タイプによる手順の違い

クラスタの接続タイプを「クライアントとしてのRoboServer」（クライアント接続）としている場合、本手順は不要です。Windowsサービスに登録にお進みください。

コマンドプロンプトを管理者として起動します。

Win + R を押して、検索ボックスに「cmd」と入力します。 Ctrl + Shift + Enterを押し、管理者権限で開きます。
以下のコマンドを実行して、binフォルダに移動します。
※下記コマンドはご利用のバージョンに合わせてください。
```
cd C:\Program Files\BizRobo Basic 11.5.0.5\bin
```
50000ポートを予約するため、以下コマンドをコピーしてコマンドプロンプトに貼り付け、Enterを押します。
```
netsh int ipv4 add excludedportrange protocol=tcp startport=50000 numberofports=1 store=persistent
```
「OK」が表示されることを確認してください。
設定の確認をします。以下コマンドを実行します。
```
netsh int ipv4 show excludedportrange tcp
```
［開始ポート］および［終了ポート］に［50000］が表示されることを確認してください。

以上で、50000ポートの予約は完了です。

Windowsサービスに登録

RSをWindowsサービスに登録し、サーバー起動時に自動起動する設定を行います。

「サービスとしてログオン」で実行ユーザーまたはグループを確認する

Windowsサービスを実行するには、実行ユーザーまたはグループが「サービスとしてログオン」に登録されている必要があります。Windowsサービスに登録する前に実行ユーザーまたはグループが追加されているか確認をします。

Win + R を押して検索ボックスに「secpol.msc」と入力します。Enterを押します。
「ローカルセキュリティポリシー」が開きます。
左側のナビゲーションで、①［ローカルポリシー］＞②［ユーザー権利の割り当て］＞③［サービスとしてログオン］をダブルクリックします。
「サービスとしてログオンのプロパティ」が表示されます。
実行ユーザーまたはグループが追加されているか確認します。追加されていない場合は、ユーザーまたはグループの追加を行ってください。
ユーザーまたはグループの追加方法

ユーザーやグループを「サービスとしてログオン」権限に追加する手順は以下になります。
1. ［ユーザーまたはグループの追加］ボタンをクリックします。
2. 「ユーザーまたはグループの選択」が表示されます。［詳細設定］をクリックします。
3. ［検索］ボタンをクリックをクリックします。
4. 検索結果から、追加したい実行ユーザーまたはグループを選択し「OK」をクリックします。
5. 「ユーザーまたはグループの選択」画面に戻ります。「選択するオブジェクト名を入力してください」に追加したユーザーまたはグループが表示されていることを確認し、［OK］をクリックします。
6. 「サービスとしてログオンのプロパティ」画面に戻ります。選択したユーザーまたはグループが表示されたことを確認し、［OK］をクリックします。

RSをWindowsサービスに登録する

接続タイプで異なるコマンドを実行

この設定は、クラスタの接続タイプが「クライアントとしてのRoboServer」（クライアント接続）と「サービスとしてのRoboServer」（サービス接続）では、コマンドが異なります。下記の各タブを選択してご参照ください。

サービス接続クライアント接続

コマンドプロンプトを管理者として起動します。

Win + R を押して、検索ボックスに「cmd」と入力します。Ctrl + Shift + Enterを押し、管理者権限で開きます。

コマンド編集のため、テキストエディタを開きます。以下のコマンドをコピーし、テキストエディタに貼り付け、コマンドの2、10行目を変更します。

コマンド

ServiceInstaller.exe -i RoboServer.conf ^
wrapper.ntservice.account=＜ドメイン＞\＜ユーザー名＞ ^
wrapper.ntservice.password.prompt=true ^
wrapper.ntservice.name="RoboServer11.5.0.5" ^
wrapper.ntservice.starttype=DELAY_START ^
wrapper.syslog.loglevel=INFO ^
wrapper.app.parameter.1="-p" ^
wrapper.app.parameter.2="50000"

項目	変更値	備考
＜ドメイン＞	参加しているドメイン名	ローカルユーザーでログインしている場合は . (ドット)を入力します。
＜ユーザー名＞	ログインしているユーザー名

上記コマンドの末尾に関する注意点

最終行以外の末尾にはスペースと^が入力されていることを確認してください。

確認後、テキストエディタのコマンドをコマンドプロンプトに張り付けます。パスワードの入力を求められますので、ログインしているユーザーのパスワードを入力してEnterを押します。
「RoboServer11.5.0.5 サービスがインストールされました。」と表示されたことを確認してください。
RoboServerのサービスを開始します。
Win + R を押して検索ボックスに「services.msc」と入力します。Enterを押し「サービス」を開きます。
①［RoboServer11.5.0.5］クリックし②［サービスの開始］をクリックします。
「状態」が「実行中」になった事を確認してください。

コマンドプロンプトを管理者として起動します。

Win + R を押して、検索ボックスに「cmd」と入力します。Ctrl + Shift + Enterを押し、管理者権限で開きます。

コマンド編集のため、テキストエディタを開きます。以下のコマンドをコピーし、テキストエディタに貼り付け、コマンドの2、10行目を変更します。

コマンド

ServiceInstaller.exe -i RoboServer.conf ^
wrapper.ntservice.account=＜ドメイン＞\＜ユーザー名＞ ^
wrapper.ntservice.password.prompt=true ^
wrapper.ntservice.name="RoboServer11.5.0.5 client" ^
wrapper.ntservice.password.prompt=true ^
wrapper.ntservice.starttype=DEMAND_START ^
wrapper.syslog.loglevel=INFO ^
wrapper.app.parameter.1="-client" ^
wrapper.app.parameter.2="-cl" ^
wrapper.app.parameter.3="＜クラスタ名＞"

項目	変更値	備考
＜ドメイン＞	参加しているドメイン名	ローカルユーザーでログインしている場合は . (ドット)を入力します。
＜ユーザー名＞	ログインしているユーザー名
＜クラスタ名＞	例 Non Production	接続するクラスタ名を入力します。

上記コマンドの末尾に関する注意点

最終行以外の末尾にはスペースと^が入力されていることを確認してください。

確認後、テキストエディタのコマンドをコマンドプロンプトに張り付けます。パスワードの入力を求められますので、ログインしているユーザーのパスワードを入力してEnterを押します。
「RoboServer11.5.0.5 client サービスがインストールされました。」と表示されたことを確認してください。
RoboServerのサービスを開始します。
Win + R を押して検索ボックスに「services.msc」と入力します。Enterを押し「サービス」を開きます。
①［RoboServer11.5.0.5 client］クリックし②［サービスの開始］をクリックします。
「状態」が「実行中」になった事を確認してください。

サービスの削除方法

問題がある場合は一度サービスを削除して登録しなおしてください。サービスを削除するためには、以下のコマンドを入力してください。

クライアント接続のサービス削除コマンド

ServiceInstaller.exe -r RoboServer.conf wrapper.ntservice.name="RoboServer11.5.0.5 client"

サービス接続のサービス削除コマンド

ServiceInstaller.exe -r RoboServer.conf wrapper.ntservice.name="RoboServer11.5.0.5"