#author("2023-12-30T10:15:12+00:00","default:iseki","iseki")
#author("2023-12-30T10:39:47+00:00","default:iseki","iseki")
** 共通初期設定 [#o2e2ab89]
- [[English is here>OpenSim/Web Interface/Simple Settings]]

- 以下,'''MOODLE_URL'' は MoodleのトップサイトのURLを示す.
- また ''CMS_MODULE_PATH'' は Modlos をインストールしたディレクトリを指す.


*** 画像処理用プログラム  [#c4b6383b]
- Modlos のアバタープロフィールに画像を表示させるには,JPEG2000の処理のために,''一般設定'' で以下のいずれかのプログラムを指定する必要がある.
- この機能は,MS Windowsでは恐らく動作しない.MS Windowsでの JPEG2000のプロセッサ(変換コマンド)についてご存知の方が居られましたら,是非教授ください.

**** [[Imagick>imagick]] of PHP [#lf7823ca]
- PHP で ImageMagickの機能を使用するための
- ディストリビューションのパッケージに無い場合は [[Peclを使用してインストールする>imagick]]
- 運がよければ,MS Windows でも動くかもしれない

**** [[ImageMagick]] [#i1b3fcb5]
- 殆どの Linux ディストリビューションに存在すると思われるが,JPEG2000 の処理機能が含まれているとは限らない.
- CentOS の ImageMagickには JPEG2000の処理機能はない.

**** JasPer [#te539309]
- JPEG2000用ツール&ライブラリ
- ImageMagick のJPEG2000処理機能も,このライブラリを利用している.
- ImageMagick でJPEG2000が使用できない場合は,このプログラムをインストールする必要がある.(必ずしも ImageMagickは再コンパイルする必要は無い)
- OpenSimの透過型の JPEG2000 を処理しようとすると,タイプ判別でエラーが出る.
- [[JasPer のインストール方法はここ>JasPer]]

- もし透過型のイメージも扱いたい場合は,[[JasPer]] と [[OpenJpeg]] の [[j2k_to_image>OpenJpeg]] コマンドをインストールすれば良い.


*** Helper URI [#dc39f157]
- Second Life Viwerを使用している場合は,起動時の引数として ''-helperuri'' に下記のような URIを指定する.
-- 例)''-helperuri MOODLE_URL/blocks/modlos/helper/''

- Hippo ビューアなどを使用している場合,下記URIを Gridの設定画面で ''Helper URI''として設定する.
-- ''MOODLE_URL/blocks/modlos/helper/''

- Hippo ビューアのように ''Get Grid Info''機能を持つビューアでは,Robust.ini の [GridInfoService]セクションの ''economy''に Helper URIを指定すれば,自動的にViewerがこの情報を獲得することができるようになる.

**** Helper URI を指定した場合の追加機能 [#d22343c1]
+ currency helper 機能:
-- L$0 でのオブジェクト,土地の販売が可能になる.
-- 所持金の表示部分をクリックした時に現れる L$購入画面においてエラーが発生しない(L$の購入は不可能)
+ landtool helper 機能:
-- 土地の分割,統合が可能となる.
-- 土地の販売設定が可能となる.


*** ログイン スクリーン [#he6d6e76]
- Modlos のv1.5.0以降ではログインスクリーンをサポートしている.

- SL Viwerを使用している場合は,起動時の引数として ''-loginpage'' に下記のような URIを指定する.
-- 例)''-loginpage MOODLE_URL/blocks/modlos/helper/loginpage.php''

- Hippo ビューアなどを使用している場合,下記URIを Gridの設定画面で ''Login Page''として設定する. 
-- Modlosの場合: ''MOODLE_URL/blocks/modlos/helper/loginpage.php''

- Hippo ビューアのように ''Get Grid Info''機能を持つビューアでは,Robust.ini の [GridInfoService]セクションの ''welcome''に Login Pageを指定すれば,自動的にViewerがこの情報を獲得することができるようになる.
-- Modlosでの例
 [GridInfoService]
    ; login page: optional: if it exists it will be used to tell the client to use
    ;                       this as splash page
    ; currently unused
    welcome = http://el.nsl.tuis.ac.jp/moodle/blocks/modlos/helper/loginpage.php

- Modlosの管理画面から,ログインスクリーンの [[''アラート情報ボックス''の内容を変更>#e19f4713]] することが可能である.
- ログイン スクリーンの画像ファイルは ''CMS_MODULE_PATH/opensimwiredux/images/login_screens'' ディレクトリの ''login1.jpg~login4.jpg'' であるので,このファイルを取り替えれば,ログイン スクリーンの画像を変更することが可能である.
- また,ロゴファイルは ''CMS_MODULE_PATH/opensimwiredux/images/login_screens/logo.png'' である.



*** World Map [#eb123180]
- OpenSim.ini で下記のモジュールを有効にする
 WorldMapModule = "WorldMap"
 MapImageModule = "MapImageModule"


*** Region Statistics [#hfe8e460]
- OpenSim.ini で ''[WebStats]''セクションで以下の設定を有効にすると,リージョンリストの ''IPアドレスのリンク(管理者にのみ表示)'' からリージョンサーバの統計情報を表示させることが可能となる.
- ただし,IPアドレスのリンクは管理者にのみ表示されるが,URLを直に入力すれば,一般ユーザでも見ることが可能である.
 [WebStats]
     enabled=true




*** [[Flotsam Group 機能>/OpenSim/Config/Group]] [#e6cf5b7c]
*** [[Flotsam Group 機能>/OpenSim/flotsam_Group]] [#e6cf5b7c]
- OpenSimでグループ機能が使用できるようになる.
- グループ用のDBテーブルは Modlosのインストール時に自動的に生成される.
- 一般設定で 「Flotsam グループデータベース読み込み/書き込みアクセスキー」を設定し,そこで設定したものと同じキーを OpenSim.ini の [Groups]セクションの「読み込み/書き込みアクセスキー」 に指定する.



**** 設定 (0.7) [#a74f8944]
- [[OpenSim.ini>/OpenSim/Config/OpenSim.ini]]の ''[Groups]セクション''に Modlos の一般設定で指定した「読み込み/書き込みアクセスキー」と ''xmlgroups.php''のURIを指定する
 [Groups]
    Enabled = true
    Module  = GroupsModule
    NoticesEnabled   = true
 
    MessagingModule = GroupsMessagingModule
    MessagingEnabled = true
 
    ServicesConnectorModule = XmlRpcGroupsServicesConnector
    GroupsServerURI       = MOODLE_URL/blocks/modlos//helper/xmlgroups.php
    XmlRpcServiceReadKey  = "読み込みキー"
    XmlRpcServiceWriteKey = "書き込みキー"
- Modlos の場合の GroupsServerURI は以下のようになる,
    GroupsServerURI       = MOODLE_URL/blocks/modlos/helper/xmlgroups.php

**** 設定 (0.6.9) [#mebf31ba]
- [[OpenSim.ini>/OpenSim/Config/OpenSim.ini]]の ''[Group]セクション''に Modlosの一般設定で指定した「読み込み/書き込みアクセスキー」と ''xmlgroups.php''のURLを指定する
 [Groups]
    Enabled = true
    Module  = GroupsModule
    NoticesEnabled   = true
 
    MessagingModule = GroupsMessagingModule
    MessagingEnabled = true
 
    XmlRpcServiceURL      = MOODLE_URL/blocks/modlos//helper/xmlgroups.php
    XmlRpcServiceReadKey  = "読み込みキー"
    XmlRpcServiceWriteKey = "書き込みキー"
- ModlosではこのバージョンのGroup機能は未検証です.


*** Offline メッセージとMute リスト機能 [#kc02653a]
- offlineメッセージ,Muteリストの設定は,OpenSim.ini の ''[Messaging]セクション'' で行う. 
- MuteList機能を使用する場合は,Modlos の ''nsl.modules/bin'' の中の ''NSLModules.Messaging.MuteList.dll''を OpenSimの binディレクトリにコピーする.

- offlineメッセージ,Muteリスト用のDBテーブルは Modlosのインストール時に自動的に生成される.


**** OpenSim.ini の設定 [#od53f1e1]
- NSLのMuteListモジュールを使用する場合の MuteListModule のモジュール名は ''NSLMuteListModule'' となるので注意する.
 [Messaging]
    InstantMessageModule = InstantMessageModule
    MessageTransferModule = MessageTransferModule
    OfflineMessageModule = OfflineMessageModule
    OfflineMessageURL = MOODLE_URL/blocks/modlos//helper/offline.php
    MuteListModule = NSLMuteListModule
    MuteListURL = MOODLE_URL/blocks/modlos//helper/mute.php

**** モジュールの再コンパイル [#l153d5ab]
- ''NSLModules.Messaging.MuteList.dll'' を再コンパイルする場合は,''nsl.modules'' を OpenSimのインストールディレクトリにコピーし,''build.sh'' コマンドを実行する.
 # cp -Rpd nsl.modules  OPENSIM_INSTALL_DIR
 # cd OPENSIM_INSTALL_DIR/nsl.modules
 # ./build.sh


*** Osprofile 機能 [#sdf5d7bf]
- osprofile 機能を使用するには,OpenSimのリージョンサーバにモジュールを追加する必要がある.
- モジュールのバイナリ ''OpenSimProfile.Modules.dll'' は ''osprofile/bin'' または ''nsl.modules/bin'' に存在する.これを OpenSim の bin ディレクトリにコピーする.

- osprofile用のDBテーブルは Modlosのインストール時に自動的に生成される.



**** OpenSimの設定 [#w13e95ec]
- OpenSim.ini に ''[Profile]セクション'' を追加し,''ProfileURL'' を以下のように設定する.
 [Profile]
    ProfileURL = MOODLE_URL/blocks/modlos//helper/profile.php

**** モジュールの再コンパイル [#t64970c4]
- ''OpenSimProfile.Modules.dll'' を再コンパイルする場合は,''osprofile'' を OpenSimのインストールディレクトリにコピーし,''build.sh'' コマンドを実行する.
 # cp -Rpd osprofile OPENSIM_INSTALL_DIR
 # cd OPENSIM_INSTALL_DIR/osprofile
 # ./build.sh

**** 注意 [#yc2ef0fd]
- 全てのプロフィール機能が使用できるわけではない.



*** Ossearch 機能 [#n0801b3a]
- ossearch 機能を使用するには,OpenSimのリージョンサーバにモジュールを追加する必要がある.
- モジュールのバイナリ ''OpenSimSearch.Modules.dll'' は ''osprofile/bin'' または ''nsl.modules/bin'' に存在する.これを OpenSim の bin ディレクトリにコピーする.

- osprofile用のDBテーブルは Modlosのインストール時に自動的に生成される.


**** OpenSim.ini の設定 [#nd80b4bd]
- OpenSim.ini の [DataSnapshot],[Modules],[Search]セクションを以下のように設定する([SEARCH]セクションは追加する).
 [DataSnapshot]
    index_sims = true
    gridname = "Your Grid Name"
    data_services = "MOODLE_URL/blocks/modlos/helper/register.php"
 
 [Modules]
    LandServices = "RemoteLandServicesConnector"
 
 [Search]
    SearchURL = "MOODLE_URL/blocks/modlos//helper/query.php"

- 0.7.1Dev では [Modules]セクションの ''LoandService'' は設定する必要はない(他で設定済み)


**** RemoteLandServicesConnector [#z974dfdb]
- 0.7, 0.7.0.x では [Modules]セクションに ''LandServices = "RemoteLandServicesConnector"'' を指定すると,実行時にエラーを起こす.
 09:26:23 - [REGIONMODULE]: Adding scene TEST to shared module RemoteLandServicesConnector
 09:26:23 - [APPLICATION]: 
 APPLICATION EXCEPTION DETECTED: System.UnhandledExceptionEventArgs
 
 Exception: System.Exception: No IGridService available. This could happen if the config_include folder doesn't exist or if the OpenSim.ini [Architecture] section isn't set.  Please also check that you have the correct version of your inventory service dll.  Sometimes old versions of this dll will still exist.  Do a clean checkout and re-create the opensim.ini from the opensim.ini.example.
  at OpenSim.Region.Framework.Scenes.Scene.get_GridService () [0x00000] in <filename unknown>:0 
  at OpenSim.Region.CoreModules.ServiceConnectorsOut.Land.RemoteLandServicesConnector.AddRegion (OpenSim.Region.Framework.Scenes.Scene scene) [0x00000] in <filename unknown>:0 
  at OpenSim.ApplicationPlugins.RegionModulesController.RegionModulesControllerPlugin.AddRegionToModules (OpenSim.Region.Framework.Scenes.Scene scene) [0x00000] in <filename unknown>:0 
  at OpenSim.OpenSimBase.CreateRegion (OpenSim.Framework.RegionInfo regionInfo, Boolean portadd_flag, Boolean do_post_init, IScene& mscene) [0x00000] in <filename unknown>:0 
  at OpenSim.OpenSimBase.CreateRegion (OpenSim.Framework.RegionInfo regionInfo, Boolean portadd_flag, IScene& scene) [0x00000] in <filename unknown>:0 
  at OpenSim.ApplicationPlugins.LoadRegions.LoadRegionsPlugin.PostInitialise () [0x00000] in <filename unknown>:0 
  at OpenSim.OpenSimBase.StartupSpecific () [0x00000] in <filename unknown>:0 
  at OpenSim.OpenSim.StartupSpecific () [0x00000] in <filename unknown>:0 
  at OpenSim.Framework.Servers.BaseOpenSimServer.Startup () [0x00000] in <filename unknown>:0 
  at OpenSim.Application.Main (System.String[] args) [0x00000] in <filename unknown>:0

- この場合は,次のパッチをソースコードに適用してから,OpenSimを最コンパイルすること [[patch code:http://www.nsl.tuis.ac.jp/DownLoad/SoftWare/OpenSim/opensim_nsl_0.7_remoteland.patch]]. このパッチは,[[NSLで公開している 0.7用パッチ>http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=8&lid=17]] にも含まれている.
- このパッチを 0.7.0.2 に適用すると rejファイルが生成されるが,必要な変更は行われているので,問題はない.

- 0.7.1Dev では config-inculde/Grid.ini などで RemoteLandServicesConnector は既に読み込まれているので,OpenSim.ini で指定する必要はない.


**** モジュールの再コンパイル [#nd46b393]
- ''OpenSimSearch.Modules.dll'' を再コンパイルする場合は,''ossearch'' を OpenSimのインストールディレクトリにコピーし,''build.sh'' コマンドを実行する.
 # cp -Rpd ossearch OPENSIM_INSTALL_DIR
 # cd OPENSIM_INSTALL_DIR/ossearch
 # ./build.sh

**** 注意 [#z974dfdb]
- 全ての検索機能が使用できるわけではない.



*** データベースの同期 [#c1c3cdfd]
- v1.40 以降では,ModlosのDBとOpenSimのDBとは自動的に同期します.
- アバター情報の同期
-- OpenSim/Modlos側にアバターのデータがある場合は,Modlos側のアバターのデータを OpenSim側に合わせる.
-- OpenSim側にModlos側のアバターと対応するアバターデータが無い場合は,Modlos側のアバターのデータを削除する.


*** エステート(リージョン)のオーナの変更 [#x86a9447]
- リージョンリスト画面でリージョン名をクリックした場合,管理ユーザはリージョン(エステート)のオーナを変更することができる.
- DBの操作では,リージョンとエステートの両方のオーナを変更している.ただし,最近のOpenSimではregionsテーブルのオーナより,estate_settingsテーブルのオーナ(エステートオーナ)をリージョンのオーナとして処理しているようだ.
- OpenSim.ini の[StartUp]セクションの ''storage_plugin'' に ''[[SQLite]]'' を指定している場合は,当然のことながら,この機能は使用できない.


*** ボイスチャットのモードの設定 [#d92cd364]
- リージョンリスト画面でリージョン名をクリックした場合,管理ユーザはそのリージョンでのボイスチャットのモードを設定できる.
- 一つのリージョンには複数のパーセルが存在し,ボイスチャットの設定は正確にはパーセル単位で行われるので,リージョン単位での設定は非常に大雑把な設定である.
- リージョン情報画面で表示されるモードは,複数のパーセルのモードの論理積(つまり複数のパーセルの中で一番下のモード)である.
- リージョン情報画面でボイスチャットのモードを設定した場合,リージョンに含まれるパーセル全てがそのボイスチャットのモードになる.
- この処理で変更されるのはデータベース上の情報のみなので,実際にボイスチャットのモードの変更を反映させるには,リージョンの再起動が必要である.
- SL Viewerの V1.23ではボイスチャットのモードを変更できなくなっているので,Modlosにこの機能が追加された.
- OpenSim.ini の[StartUp]セクションの ''storage_plugin'' に ''[[SQLite]]'' を指定している場合は,当然のことながら,この機能は使用できない.
- ''注)'' ボイスチャットを行うには別途 [[FreeSwitch]](SIP Server) のインストールが必要.


*** スタンドアロンモードのサポート (0.7以降) [#edfeccee]
- 0.7以降では,スタンドアロンモードでも Modlos を使用することが可能である.
- 0.7以降のスタンドアロンモードでも Modlos を使用できるようにするには''bin/config-include/StandaloneCommon.ini'' の ''[GridService]'' セクションの''StorageProvider'' を以下のように変更して,DBとしてMySQLを使用するように設定する.
 [GridService]
 ;; For in-memory region storage (default)
 ; StorageProvider = "OpenSim.Data.Null.dll:NullRegionData"
 ;;--- For MySql region storage (alternative)
 StorageProvider = "OpenSim.Data.MySQL.dll:MySqlRegionData"


*** マネーサーバ [#tfb14120]
- マネーサーバは Modlos とは別の機能なので,マネーサーバについては [[こちら>OpenSim%2FMoneyServer]] を参照すること.


** 管理メニュー [#fceee892]

*** データベース変換 [#j827e86c]
- 0.6.x から 0.7のデータベースへアップデートを行う
- 0.6.x から 0.7へのデータベースアップデート機能は次のように動作する.

- データベース移行対応 (0.6.7/0.6.8/0.6.9 -> 0.7)
-- 可能な限り 0.6.7/0.6.8/0.6.9 のデータベース上の情報を 0.7のデータベースにコピーする.対応するデータがすでに0.7のデータベース上にある場合はコピーしない.
-- OpenSim を0.7にした後,ログインすると(現状では)そのアバタの情報が中途半端に0.7のデータベースにコピーされる.OpenSimを0.7にした場合は,R.O.B.U.S.T.サーバとリージョンサーバ立ち上げ後,ユーザがログインする前にデータベースのアップデートを行うことをお勧めする.(可能なら 0.7にする前にデータベースのバックアップを!!)

**** アップデート手順 [#ra21b358]
- DBをアップデートする前に必ず一度は Robustサーバを起動すること.また,リージョンサーバを起動する前に実行しなければならない.
+ Robustサーバ(0.7) の起動
+ Robustサーバ(0.7) の停止 (安全のため,念を入れて一度停止させる)
+ データベースのアップデート
+ Robustサーバ(0.7) の起動
+ リージョンサーバ(0.7) の起動


*** テクスチャキャッシュのクリア [#r8a5776e]
- Modlos でOpenSim からロードしたテクスチャのキャッシュをクリアする.[[画像処理用プログラム>#c4b6383b]] を変更した場合や,テクスチャの表示がおかしくなった場合に実行する.


*** ログイン情報のクリア [#rb982a6a]
- リージョンサーバやビューアが異常終了した場合に,アバタがログインした状態のままデータベース上に残る場合がある(アバタリストなどでログインしていないのにログインしていると表示される).この場合に,このコマンドを実行すると,アバタのログイン情報を格納したデータベースのテーブルをクリアすることができる.


*** ログインスクリーン 管理 [#e19f4713]
- ログインスクリーンのアラート情報Boxの内容を修正することができる.


*** ラストネーム管理 [#p914ff0f]
- 一般設定の「ラストネーム管理 」で「はい」を選択した場合,この画面で,使用できるラストネームの 登録,一時使用停止,削除 ができる.

&ref(XoopenSim/LastName.jpg);



** 設定ファイル のまとめ [#p920f065]
*** Robust.ini [#d689b5f9]
- Modlos の場合
 [GridInfoService]
    login = http://......:8002/
    gridname = "Your Grid Name"
    economy  = MODLOS_URL/blocks/modlos/helper/
    welcome  = MODLOS_URL/blocks/modlos/helper/loginpage.php

*** OpenSim.ini [#l708e770]
- Modlos の場合
 [Startup]
    WorldMapModule = "WorldMap"
    MapImageModule = "MapImageModule"
 
 [Groups]
    Enabled = true
    Module  = GroupsModule
    NoticesEnabled   = true
 
    MessagingModule  = GroupsMessagingModule
    MessagingEnabled = true
 
    ServicesConnectorModule = XmlRpcGroupsServicesConnector
    GroupsServerURI       = MODLOS_URL/blocks/modlos/helper/xmlgroups.php
    XmlRpcServiceReadKey  = "読み込みキー"
    XmlRpcServiceWriteKey = "書き込みキー"
 
 [Messaging]
    InstantMessageModule = InstantMessageModule
    MessageTransferModule = MessageTransferModule
    OfflineMessageModule = OfflineMessageModule
    OfflineMessageURL = MODLOS_URL/blocks/modlos/helper/offline.php
    MuteListModule = NSLMuteListModule
    MuteListURL = MODLOS_URL/blocks/modlos/helper/mute.php
 
 [WebStats]
    enabled=true
 
 [DataSnapshot]
    index_sims = true
    gridname = "Your Grid Name"
    data_services = "MODLOS_URL/blocks/modlos/helper/register.php"
 
 [Modules]
    LandServices = "RemoteLandServicesConnector"
 
 [Profile]
    ProfileURL = "MODLOS_URL/blocks/modlos/helper/profile.php"
 
 [Search]
    SearchURL  = "MODLOS_URL/blocks/modlos/helper/query.php"

#br

トップ   編集 差分 バックアップ 添付 複製 名前変更 リロード   新規 ページ一覧 検索 最終更新   ヘルプ   最終更新のRSS