#author("2023-12-30T10:37:13+00:00","default:iseki","iseki")
#author("2023-12-30T10:37:57+00:00","default:iseki","iseki")
** Simple Initial Settings of [[Modlos>Modlos]] [#rf5583ad]
- [[日本語 はここ>../Simple Settings (J)]]

- Explanatory notes
-- ''MOODLE_URL'' is top site URL of Moodle.
-- ''CMS_MODULE_PATH'' is directory path that [[Modlos>Modlos]] is installed.


*** Program for image processing  [#c4b6383b]
- It is necessary to specify either of the following programs by ''preferences'' for the processing of JPEG2000 to display the image in the avatar profile of [[Modlos]]. 
- Perhaps, this function doesn't operate in MS Windows. Please teach us, if there is a person who knows the processor of JPEG2000 (conversion commands) in MS Windows.

**** [[Imagick>imagick]] of PHP [#z66b7283]
- [[Imagick>imagick]] is PHP module for ImageMagick
- When imagick module is not in the package of the distribution, it is installed by using [[Pecl]]. 
- If you are lucky, it might work at MS Windows.

**** ImageMagick [#sde27726]
- It seems that package of ImageMagick exists in most Linux distributions. However, the processing function of JPEG2000 is not necessarily included in ImageMagick.
- At CentOS, ImageMagick has not the processing function for JPEG2000.

**** [[JasPer]] [#pd3b38ae]
- [[JasPer]] is tool and library for JPEG2000 
- The processing function for JPEG2000 of ImageMagick uses library of JasPer, too. 
- If ImageMagick has not the processing function for JPEG2000, you should install JasPer
- But, current JasPer has bug about alpha channel of JPEG2000. JasPer can not process JPEG2000 that has alpha channel.

- If you want to process image with alpha channel,  you should install JasPer and [[''j2k_to_image''>OpenJpeg]] command of ''OpenJpeg''.
- If you want to process image with alpha channel,  you should install JasPer and [[''j2k_to_image''>OpenJpeg]] command of ''[[OpenJpeg]]''.


*** Helper URI [#t56a6685]
- When SL Viwer is used, following URI is specified for ''-helperuri'' for starting option. 
-- ex.) ''-helperuri MOODLE_URL/blocks/modlos/helper/''

- When Hippo Viewer or other 3rd party viewer is used, following URI are set as ''Helper URI'' on setting screen of Grid. 
-- ex.) ''MOODLE_URL/blocks/modlos/helper/''

- In the viewer with the ''Get Grid Info'' function like the Hippo Viewer, if ''Helper URI'' is specified for ''economy'' of the [GridInfoService] section of Robust.ini, Viewer is able to set this information automatically.
-- ex.) Robust.ini
 [GridInfoService]
    ; helper uri: optional: if it exists if will be used to tell the client to use
    ;                       this for all economy related things
    ; currently unused
    economy = http://www.nsl.tuis.ac.jp/moodle/blocks/modlos/helper/

**** added functions by "Helper URL" [#p272f90f]
- Helper Function of currency:
-- Sales of the object and land with L$0 become possible. 
-- ''Banker Avatar is available'' with DTL/NSL Currency Server
- Helper Function of landtool:
-- The land subdividing and integration become possible. 
-- The sales setting of land becomes possible. 


*** Login Screen [#k26dcfea]
- The ''Login Screen'' function is supported since v1.5.0 of Modlos. 

- When SL Viwer is used, following URI is specified for ''-loginpage'' for starting option. 
-- ex.) ''-helperuri MOODLE_URL/blocks/modlos/helper/loginpage.php''

- When Hippo Viewer or other 3rd party viewer is used, following URI are set as ''Lgoin Page'' on setting screen of Grid. 
-- ex.) ''MOODLE_URL/blocks/modlos/helper/loginpage.php''

- In the viewer with the ''Get Grid Info'' function like the Hippo Viewer, if ''Login Page'' is specified for ''welcome'' of the [GridInfoService] section of Robust.ini, Viewer is able to set this information automatically.
-- ex.) Robust.ini for 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

- You can edit ''[[Alert Infomation Box>#sfc1c498]]'' at management screen
- Login Screen image files are ''login1.jpg - login4.jpg'' in ''CMS_MODULE_PATH/opensimwiredux/images/login_screens'' directory. So, you can change thoes image files.
- Logo image file is ''CMS_MODULE_PATH/opensimwiredux/images/login_screens/logo.png'' 


*** World Map [#h2a424c2]
- Enable Map modules in OpenSim.ini
 WorldMapModule = "WorldMap"
 MapImageModule = "MapImageModule" 


*** Region Statistics [#j8ee7a51]
- When the following settings are specified in OpenSim.ini at the [WebStats] section, the stats of the region server can be displayed from the link of IP Addresses of the ''Regions List'' (Link is displayed for manager only).
- However, if URL is manual input, even the guest user can see stats of region server, though the link of IP addresses is displayed for manager only. 
 [WebStats]
     enabled=true


*** Flotsam Group Function [#nad989a8]
- It is possible to use Group Function at OpenSim
- When Modlos is installed, needed DB is installed automatically.
- You should set OpenSim.ini with same read/write key that be set in ''preference''. 

**** Settings (0.7) [#d469f5c9]

 [Groups]
    Enabled = true
    Module  = GroupsModule
    NoticesEnabled   = true
 
    MessagingModule = GroupsMessagingModule
    MessagingEnabled = true
 
    ServicesConnectorModule = XmlRpcGroupsServicesConnector
    GroupsServerURI       = MOODLE_URL/blocks/modlos/helper/xmlgroups.php
    XmlRpcServiceReadKey  = "Read Key"
    XmlRpcServiceWriteKey = "Write Key"

**** Settings (0.6.x) [#n6144386]

 [Groups]
    Enabled = true
    Module  = GroupsModule
    DebugEnabled     = false
 
    ServicesConnectorModule = XmlRpcGroupsServicesConnector
    XmlRpcServiceURL        = MOODLE_URL/blocks/modlos/helper/xmlgroups.php
    XmlRpcServiceReadKey    = "Read Key"
    XmlRpcServiceWriteKey   = "Write Key"
- The Group function of this version is a unverification in Modlos. 



*** Offline Message and Mute List [#re3a5103]
- The Offline message and the Mute list function are set in the [Messaging] section of OpenSim.ini. 
- When the Mute list function is used, ''NSLModules.Messaging.MuteList.dll'' in ''nsl.modules/bin'' of Modlos should be copied onto the ''bin'' directory of OpenSim.


**** Setting of OpenSim.ini [#s54822ac]
- When you use NSL Mute list moudle, value of ''MuteListModule'' is ''NSLMuteListModule''
 [Messaging]
    InstantMessageModule = InstantMessageModule
    MessageTransferModule = MessageTransferModule
    OfflineMessageModule = OfflineMessageModule
    OfflineMessageURL = MOODLE_URL/blocks/modlos/helper/offline.php
    MuteListModule = NSLMuteListModule
    MuteListURL = XOOPS_URL/modules/xoopensim/helper/mute.php
**** Recompile of module [#a8b75fd1]
- When ''NSLModules.Messaging.MuteListEdit.dll'' is compiled again, copy ''nsl.modules''  onto the installation directory of OpenSim, and  execute ''build.sh'' command. 
 # cp -Rpd nsl.modules  OPENSIM_INSTALL_DIR
 # cd OPENSIM_INSTALL_DIR/nsl.modules
 # ./build.sh

*** Osprofile Function [#ob18ff08]
- It is necessary to add the module to the region server of OpenSim to use the osprofile function. 
- Binary of ''OpenSimProfile.Modules.dll'' module exists in ''osprofile/bin'' or ''nsl.modules/bin''. This module should be copied onto the ''bin'' directory of OpenSim. 
- When Modlos is installed, needed DB is installed automatically.


**** Setting of OpenSim.ini [#m2128776]
- ''[Profile] section'' is added to OpenSim.ini, and ''ProfileURL'' is set as below. 
- Example
 [Profile]
    ; Change it to your own HTTP server to have the Profile server work
    ProfileURL = http://el.nsl.tuis.ac.jp/moodle/blocks/modlos/helper/profile.php


**** config-include/Grid.ini [#f43dd953]
- Change ''[Profile] section'' from BasicProfileModule to ''OpenProfileModule'' as below. 
 [Profile]
    Module = "OpenProfileModule"

**** Recompile of module [#rf8e414b]
- When ''OpenSimProfile.Modules.dll'' is compiled again, copy ''osprofile'' onto the installation directory of OpenSim, and execute ''build.sh'' command. 
 # cp -Rpd osprofile OPENSIM_INSTALL_DIR
 # cd OPENSIM_INSTALL_DIR/osprofile
 # ./build.sh

**** Attention [#z98490b5]
- All the profile functions are not able  to be used.


*** Ossearch Function [#zd8eccbb]
- It is necessary to add the module to the region server of OpenSim to use the ossearch function. 
- Binary of ''OpenSimSearch.Modules.dll'' module exists in ''ossearch/bin'' or ''nsl.modules/bin''. This module should be copied onto the ''bin'' directory of OpenSim. 

- When Modlos is installed, needed DB is installed automatically.


**** Setting of OpenSim.ini [#pa840bdf]
- [DataSnapshot],[Modules] and [Search] section in OpenSim.ini are set as follows (The [Search] section is added). 
 [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"

- After 0.7.1,  ''LoandService'' of the [Modules] section need not be set. It is set at ''config-include/*.ini'' setting file.


**** RemoteLandServicesConnector [#u484bdd5]
- At 0.7, 0.7.0.x, execution of OpenSim.exe will be error, when ''LandServices = "RemoteLandServicesConnector"'' is specified at the [Modules] section. 

 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

- In this case, please patch to the source code with [[patch code:http://www.nsl.tuis.ac.jp/DownLoad/SoftWare/OpenSim/opensim_nsl_0.7_remoteland.patch]] and recompile OpenSim. This patch is included in our OpenSim Patches for 0.7, too. 
- If you apply this patch to 0.7.0.2, rej file is created. But, do not worry because it is a normal result. 
- At 0.7.1Dev, becase ''RemoteLandServicesConnector'' is already set in config-inculde/Grid.ini, It need not be specified with OpenSim.ini.


**** Recompile of module [#daed1754]
- When ''OpenSimSearch.Modules.dll'' is compiled again, copy ''ossearch'' onto the installation directory of OpenSim, and execute ''build.sh'' command. 
 # cp -Rpd ossearch OPENSIM_INSTALL_DIR
 # cd OPENSIM_INSTALL_DIR/ossearch
 # ./build.sh

**** Attention [#dfc8f2f0]
- All the search functions are not able  to be used. 


*** Auto DB Synchronization with OpenSim DB [#c1c3cdfd]
- It automatically synchronizes with DB of Modlos and DB of OpenSim since v1.40.
- Synchronization of Avatar
-- If there is data of avatar on the OpenSim side, the data of avatar on the Moodle side is copied from OpenSim side. 
-- If there is no data of avatar that corresponds to avatar on the OpenSim side, the data of avatar on the Modlos side is deleted. 


*** Chage of Estate (Region) Owner [#df69e193]
- When the region name is clicked on the region list screen, the admin user can change the owner in the region (estate). 
- In the operation of DB, both the region and the estate owners have been changed. .
- It is necessary to reboot the Region server to change effectively. 


*** Change of Voice Chat Mode [#h4b27791]
- When the region name is clicked on the region list screen, the admin user can set the mode of the voice chat in the region. 
- Two or more Percel exists in one region, and the voice chat is set accurately by the unit of Percel. 
- The mode displayed on the region information screen is a logical product of two or more Percel's modes (It is ,in a word, the nether mode in two or more Percel). 
- When the mode of the voice chat is set on the region information screen, all Percel included in the region becomes the same chat mode. 
- It is necessary to reboot the Region server to change effectively. 
- ''[[FreeSwitch>OpenSim/FreeSwitch]]'' is necessary for doing Voice chat on OpenSim. 

&ref(/Modlos/Modlos_RegionInfo_e.jpg);
*** Support of StandAlone mode [#v6a1253e]
- You can not use [[Modlos>Modlos]] with SQLite.
- If you want to execute [[Modlos>Modlos]] with StandAlone mode, you should use ''MySQL'' DB.
- In addition, you must setup ''[GridService] section'' in StandaloneCommon.ini and ''[PresenceService] section'' in Standalone.ini.



**** [[for 0.7>./StandAlone for 0.7]] [#c440d7a6]


**** for 0.7.1.x and 0.7.2 Dev [#p23b04de]

- StandaloneCommon.ini
 [DatabaseService]
    ;
    ; ### Choose the DB
    ;    ; SQLite
    ;Include-Storage = "config-include/storage/SQLiteStandalone.ini";    ; MySql
    ; Uncomment these lines if you want to use mysql storage
    ; Change the connection string to your db details
    StorageProvider = "OpenSim.Data.MySQL.dll"
    ConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;Old Guids=true;"
    ; Uncomment this line if you are using MySQL and want to use a different database for estates
    ;EstateConnectionString = "Data Source=localhost;Database=opensim;User ID=opensim;Password=***;Old Guids=true;"

- And you should change ''[GridService]'' section at ''bin/config-include/StandaloneCommon.ini''.
- Please enable ''StorageProvider = "OpenSim.Data.MySQL.dll:MySqlRegionData"'' line.
 [GridService]
    ;; For in-memory region storage (default)
    ;StorageProvider = "OpenSim.Data.Null.dll:NullRegionData"
    ;;--- For MySql region storage (alternative)
    StorageProvider = "OpenSim.Data.MySQL.dll:MySqlRegionData"

- In addition, please chage [PresenceService]section at ''bin/config-include/Standalone.ini'', too.
- Please add ''StorageProvider = "OpenSim.Data.MySQL.dll:MySqlRegionData"'' line.
 [PresenceService]
    LocalServiceModule = "OpenSim.Services.PresenceService.dll:PresenceService"
    ;;StorageProvider = "OpenSim.Data.Null.dll"
    StorageProvider = "OpenSim.Data.MySQL.dll:MySqlRegionData"

*** Money Server [#m98b39a2]
- Money Server and [[Modlos>Modlos]]  are different functions. Therefore, Please refer to [[here>https://polaris.star-dust.jp/pukiwiki/?OpenSim/MoneyServer]] for Money Server.  


** Menu for Management [#v3da3dd8]
*** Convert DB from 0.6.x to 0.7 [#n8bcbb13]
**** Convert Sequence from 0.6.x to 0.7 [#sc479c1c]
+ Information in the DB of 0.6.7/0.6.8/0.6.9 as much as possible is copied into the DB of 0.7.
+ It doesn't copy it when there is already corresponding data in the DB of 0.7.
**** Procedure of Convert [#e0880c3a]
- DB update must be executed after ROBUST server execution and before Region Server execution.
+ start Robust Server (0.7)
+ stop Robust Server (For safety)
+ execute DB conversion by Modlos
+ start Robust Server (0.7)
+ start Region Server (0.7)


*** Clear Texture Cache [#ec5a0b89]
- The cash of the texture loaded from OpenSim with Modlos is cleared. When the program for the image processing is changed, and the display of the texture becomes amusing, you should execute this. 


*** Clear Login Table [#rf1f7024]
- When the region server or the viewer terminate abnormally, it is likely to remain the state in DB that avatar logged in (In this case, ''Avatars List'' displays that avatar logins now, though it doesn't login).
- The table of the DB that stores log in information on avatar can be cleared in this case by executing this command.


*** Login Screen Management [#sfc1c498]
- You can edit ''Alert Information Box'' in Login Screen.


*** Lastnames Management [#d06de012]
- If ''Last Name Activation'' at setting page is checked in ''preference'', last name that can be used is registered, use stopped temporarily, and is deleted on this page.


** Summary of setting files for Modlos [#r020674b]

*** Robust.ini [#c9df2413]
- for 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 [#v4a5e160]
- for 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  = "Read Key"
    XmlRpcServiceWriteKey = "Write Key"
 
 [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