Revision as of 09:04, 30 November 2009

Linux/Unix

MySQL Server

• MySQL で OpenSim用データベースを作成し，OpenSimの管理ユーザを登録しておく．
• 例：データベース名 opensim, OpenSim管理ユーザ openwim_user, OpenSim管理パスワード opensim_pass の場合．

$ mysql -u root -p
Enter password: データベース全体の管理者のパスワード
mysql> create database opensim;
mysql> grant all on opensim.* to opensim_user identified by 'opensim_pass';
mysql> flush privileges;
mysql> exit

• グループ理念などで日本語を表示できるようにするには，/etc/my.cnf を編集して文字コードを utf8 にする

# cat /etc/my.cnf
[mysql]
default-character-set=utf8

[mysqld]
default-character-set=utf8

OpenSim Grid用サーバ群

UGAIM　

UGRM　

URM　

Region Server

設定

bin/OpenSim.ini

# cd OPENSIM_TOP_DIR/bin
# cp OpenSim.ini.example OpenSim.ini
# vi OpenSim.ini

• 最小限の変更例 (変更箇所のみ)

   [Startup]
     gridmode = true
     ;storage_plugin = "OpenSim.Data.SQLite.dll"
     ;storage_connection_string="URI=file:OpenSim.db,version=3";
     storage_plugin="OpenSim.Data.MySQL.dll"
     storage_connection_string="Data Source=localhost;Database=opensim;User ID=opensim_user;Password=opensim_pass;";
   [Network]
     inventory_server_url = "http://127.0.0.1:8003"
   [Architecture]
     ;Include-Standalone  = "config-include/Standalone.ini"
     Include-Grid         = "config-include/Grid.ini"

• 他のサーバ類がリモートマシンで作動している場合には，各サーバのURIを指定する．

   [Network]
     grid_server_url = "http://グリッドサーバの名前またはIPアドレス:8001"
     user_server_url = "http://ユーザサーバの名前またはIPアドレス:8002"
     asset_server_url = "http://ROBUSTサーバの名前またはIPアドレス:8003"
     inventory_server_url = "http://ROBUSTサーバの名前またはIPアドレス:8003"
     messaging_server_url = "http://メッセージングサーバの名前またはIPアドレス:8006"

bin/config-include/GridCommon.ini

# cd OPENSIM_TOP_DIR/bin
# cp config-include/GridCommon.ini.example config-include/GridCommon.ini
# vi config-include/GridCommon.ini

• GridCommon.iniの変更例　（ポート番号を8003にするのは ROBUST Server を使用するため）

     AssetServerURI = "http://localhost:8003"
     InventoryServerURI = "http://localhost:8003"

• ROBUSTサーバがリモートマシンで作動している場合には，該当サーバのURIを指定する．

     AssetServerURI = "http://ROBUSTサーバの名前またはIPアドレス:8003"
     InventoryServerURI = "http://ROBUSTサーバの名前またはIPアドレス:8003"

bin/config-include/FlotsamCache.ini

# cd OPENSIM_TOP_DIR/bin
# cp config-include/FlotsamCache.ini.example config-include/FlotsamCache.ini

• 内容の変更は無し．

起動

# cd OPENSIM_TOP_DIR/bin
# mono OpenSim.exe

初回起動時の設定

• 初回起動時のみ，リージョンの設定のために幾つかの質問が表示され，結果として bin/Regions/Regions.ini が生成される
• 事前に　bin/Regions/Regions.ini を作成した場合は，質問は表示されない．

New region name []: TEST_SIM                                     SIM の名前を入力．
Region UUID [3afa2e4b-9dcd-4476-91a5-ca7f0046aa45]:              SIM のUUID. 通常はデフォルト値を使う．
Region Location [1000,1000]:                                     SIM の位置．通常はデフォルト値を使う．
Internal IP address [0.0.0.0]:                                   通常はデフォルト値を使う． 注1)
Internal port [9000]:                                            サーバのポート番号．通常はデフォルト値を使う．
Allow alternate ports [False]:                                   他のポート．通常は使用しない（デフォルト値を使う）
External host name [SYSTEMIP]: 202.26.159.214                    サーバの名前(FQDN)またはIPアドレス 注1) 
Master Avatar UUID [00000000-0000-0000-0000-000000000000]:       管理用アバタのUUID．ここではデフォルト値（UUID無効）を使う．注2)
Master Avatar first name (enter for no master avatar) []: TEST   管理用アバタのファーストネーム 注3)
Master Avatar last name []: AVATAR                               管理用アバタのセカンドネーム  
Master Avatar sandbox password []:                               管理用アバタのパスワード．Grid Modeの場合は指定しても無意味

• 注1） NAT(NAPT)を利用して外部にサービスを提供する場合は以下のように設定する．ただし，NAT(NAPT)内部から接続する場合は，この設定を行ってはいけない．
  • Internal IP address : サーバの（プライベート）IPアドレス
  • External host name : NAT(NAPT)によって変換されるグローバルIPアドレス
• 注2) 管理用アバタのUUIDと名前の両方を指定した場合は UUIDの方が優先される．ただし，初回設定時はアバタのUUIDは不明であるので，名前の方を使用する．
• 注3) Grid Modeでは，ここに記述された管理アバタの名前は，自動的にはデータベースに登録されない．同じ名前のアバタを User Serverで登録する必要がある．

• 上記のように入力した場合，bin/Regions/Regions.ini が下記のように作られる．

[TEST_SIM]
RegionUUID = 3afa2e4b-9dcd-4476-91a5-ca7f0046aa45
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 202.26.159.214
MasterAvatarFirstName = TEST
MasterAvatarLastName = AVATAR
MasterAvatarSandboxPassword =

（管理）アバタの登録

• 少なくとも，bin/Regions/Regions.ini で指定した管理アバタを User Server から登録する必要がある．

User# create user
First name [Default]: TEST
Last name [User]: AVATAR
Password Passwd
Start Region X [1000]: 
Start Region Y [1000]: 
Email []:

Viewer（クライアント）の設定

Second Life™ の Viewerの場合

• Viewer のショートカットのプロパティを表示させ，「リンク先」にコマンドの引数として 　-loginuri http://サーバの名前またはIPアドレス:8002/ 　を追加する．

または

• Ctrl+Shift+g を入力すると，ログインボタンの横にグリッド指定用の入力フィールドが表示されるので，そこに 「サーバの名前またはIPアドレス:8002」 を入力し，ログインボタンをクリックする．（ただし入力字数制限あり）

MS Windows

メインページ