OpenSimulator - User contributions [en]

Configuring Regions

2013-03-22T06:20:53Z

Tonyguards: Undo revision 32193 by Kenearlg (talk)

{{Languages}}
= OpenSimulator 0.7 and later =

By default, regions are configured in a file named Regions.ini in the bin/Regions directory. If you started a completely fresh installation of OpenSim, it will ask you a series of questions to set up your first region.

Here's an example of a Regions.ini file

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2

This is a list of settings that must be present for a region to operate. When you start OpenSimulator for the first time without an existing Regions.ini file, you'll be asked for an entry for each setting in order to set up your initial region. For more details, see [[Configuration#Running OpenSimulator for the first time]].

{| cellspacing="0" cellpadding="5" border="1" align="center" class="sortable" width="90%"
|-
! Attribute
! Description
|-
| [Big Fat Region]
| The name of the region.
|-
| RegionUUID
| The unique ID of the region.
|-
| Location
| The (x, y) location of the region on the grid.
|-
| InternalAddress
| 0.0.0.0 if you have more than one NIC on the server and you don't care which IP address OpenSimulator listens on (this is the usual setting). Alternatively, you can set to a specific IP.
|-
| InternalPort
| IP port for all incoming client connections.
|-
| AllowAlternatePorts
| Not Used. Leave it always False.
|-
| ExternalHostName
| External IP Address of the router or FQDN.
|}

If you want to add another region you can

* enter another section in Regions.ini
* create another separate .ini file in bin/Regions
* create an old format OpenSimulator xml file (these still work with current OpenSim)
* or use the create region command on the region console (I don't recommend this since it seems to be a bit buggy).

Here's an example where a second region has been added to Regions.ini

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
 
[Greek Wedding]
RegionUUID = 5c445740-6460-43d3-ba4c-444444445555
Location = 1000,1001
InternalAddress = 0.0.0.0
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2

As you can see, the Second region is named Greek Wedding and has a different UUID. It has a different location (1000,1001) and a different InternalPort (9001). Other than that, the [http://www.doxapest.co.id/index.php/pest-control-dan-anti-rayapPest Control] details are the same.

To create a new [http://www.pbtaxand.com/our-services/tax-advisory-servicesKonsultan Pajak] UUID you can either tweak an existing one by hand (e.g. by changing one character so that the new one is in the range [0-9][A-F] or a [http://www.propertykita.com/rumah.htmlRumah Dijual] generator can be found at uuidgen webpage. On Unix, you can also use the <tt>uuidgen</tt> command.

As well as the critical entries above, there are some additional [http://vamostech.com/gps-trackingGPS Tracker] optional ones that can change the properties of a region. These are

{| cellspacing="0" cellpadding="5" border="1" align="center" class="sortable" width="90%"
|-
! Attribute
! Description
|-
| MaxAgents
| The maximum number of agents that can be in the in the region at any given time. The default is 100. As of 4/22/2011 this option only exists in the current git master.
|-
| MaxPrims
| The maximum number of prims that the region will be listed as supporting. However, this limit is not currently enforced by OpenSimulator. Due to LL protocol constraints, the maximum limit that can be shown is 45000.
|-
| PhysicalPrimMax
| The maximum dimensions of a physical prim. This is a single number which applies to X, Y and Z co-ordinates. This will affect resizing of existing prims. Default is 10. This setting can also be used in the [Startup] section of OpenSim.ini. If the region setting exists then it will override the OpenSim.ini setting.
|-
| NonphysicalPrimMax
| The maximum dimensions for a non-physical prim. This is a single number which applies to X, Y and Z co-ordinates. This will affect resizing of existing prims. Default is 256. This setting can also be used in the [Startup] section of OpenSim.ini. If the region setting exists then it will override the OpenSim.ini setting.
|-
| ClampPrimSize
| If true then if a viewer attempts to create a prim which has any dimension larger than the NonphysicalPrimMax, then that dimension is reduced to NonphysicalPrimMax. Default is false; This setting can also be used in the [Startup] section of OpenSim.ini. If the region setting exists then it will override the OpenSim.ini setting.
|-
| RegionType
| The region type as shown in the Covenant tab of the Region/Estate dialog in a standard Second Life viewer. Not sure what this can be used for.
|}

== Tools ==

RegionIniGenerator(RIG1.1): A decent (sort of) GUI based region ini creator for use with 0.7+ INI style region data. Built on .NET 4 framework.

== Other Tasks ==

=== Configuring Multiple Regions on a Single Server Instance ===

To configure multiple regions on one server (i.e. a 4x4 server), edit the Regions.ini file to include multiples of the single entry already there. Make sure the RegionUUID and InternalPort are different on each one, or it won't work. To load individual OAR files into each region, use the 'change region [regionname]' command and then 'load oar [oar-location]'.

= OpenSimulator 0.6.7 to OpenSimulator 0.6.9 =
By default, regions are configured in a file named Regions.ini in the bin/Regions directory. If you started a completely fresh installation of OpenSim, it will ask you a series of questions to set up your first region.

Here's an example of a Regions.ini

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
MasterAvatarFirstName = Justin
MasterAvatarLastName = Clark-Casey
MasterAvatarSandboxPassword = yeahokay

This is the list describing the relation between the entries in Regions.ini and the questions during setup. For detail about each question, see [[Configuration#Running OpenSimulator for the first time]].

{| cellspacing="0" cellpadding="5" border="1" align="center" class="sortable" width="90%"
|-
! Attribute
! Setup Console Question
! Description
|-
|[Big Fat Region]
|New region name
|The name of the region.
|-
|RegionUUID
|Region UUID
|The unique ID of the region.
|-
|Location
|Region Location
|The location of the region on the grid.
|-
|InternalAddress
|Internal IP address
|0.0.0.0 or static internal IP address.
|-
|InternalPort
|Internal port
|IP port for all incoming client connections.
|-
|AllowAlternatePorts
|Allow alternate ports
|Not Used. Leave it always False.
|-
|ExternalHostName
|External host name
|External IP Address of the router or FQDN.
|-
|MasterAvatarFirstName
|Master Avatar first name
|(0.6.9 or earlier) The first name of the master avatar.
|-
|MasterAvatarLastName
|Master Avatar last name
|(0.6.9 or earlier) The last name of the master avatar.
|-
|MasterAvatarSandboxPassword
|Master Avatar sandbox password
|(0.6.9 or earlier) The password of the master avatar.
|-
|}

If you want to add another region you can

* enter another section in Regions.ini
* create another separate .ini file in bin/Regions
* create an old format OpenSimulator xml file (these still work with OpenSimulator 0.6.7)
* or use the create region command on the region console (I don't recommend this since it seems to be a bit buggy in 0.6.7).

Here's an example where a second region has been added to Regions.ini

[Big Fat Region]
RegionUUID = 5ce85740-6460-43d3-ba4c-29207b010072
Location = 1000,1000
InternalAddress = 0.0.0.0
InternalPort = 9000
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
MasterAvatarFirstName = Justin
MasterAvatarLastName = Clark-Casey
MasterAvatarSandboxPassword = yeahokay
 
[Greek Wedding]
RegionUUID = 5c445740-6460-43d3-ba4c-444444445555
Location = 1000,1001
InternalAddress = 0.0.0.0
InternalPort = 9001
AllowAlternatePorts = False
ExternalHostName = 192.168.1.2
MasterAvatarFirstName = Justin
MasterAvatarLastName = Clark-Casey
MasterAvatarSandboxPassword = yeahokay

As you can see, the Second region is named Greek Wedding and has a different UUID. It has a different location (1000,1001) and a different InternalPort (9001). Other than that, the details are the same.

To create a new UUID you can either tweak an existing one by hand (e.g. by changing one character so that the new one is in the range [0-9][A-F] or a generator can be found at uidgen webpage. On Unix, you can also use the <tt>uuidgen</tt> command.

= OpenSimulator 0.6.6 and earlier =

For running multiple regions on the same box, you simply make multiple copies of the 'default.xml' file inside the <tt>bin/Regions/</tt> directory. You can do this by typing <tt>create region</tt> at the OpenSimulator command prompt, using the script <tt>make.php</tt> in <tt>share/regions</tt>, or you can generate the files by hand.

If you want to create the files by hand:

:first copy the default.xml file in the <tt>bin/Regions</tt> directory, and name them anything you want (I name mine region.x.y.xml, where region is the name of the region, and x and y are the grid coords.)
:Open each xml file and edit the uuid (a generator can be found at uuidgen webpage or on unix, use the uuidgen command), region name, x & y positions, and internal IP port.

'''IMPORTANT!''' Regardless of the method you use to create your new region, the UUID, name, and grid coordinates ''must'' be unique for each region on a grid. The port assignment must be unique for each region that is running on a particular machine. The internal IP ''address'' and external host name must be the same for all regions.

Note that <tt>sim_location_x</tt> and <tt>sim_location_y</tt> should be adjacent integers if you want your regions to be adjacent, so you can run back and forth between them. '''IMPORTANT: THESE GRID COORDINATES ARE ''NOT'' IN METERS. THEY ARE SIM POSITIONS.''' (1000, 1000) is next to (1001,1000), (1000, 1001), and so forth. 1256, 2000, 2048 and similar values are '''not''' adjacent to 1000, they are very far away, so you would not see your sims from one another.

Once you have 2 or more xml files in the bin/Regions folder, running a ''single'' copy of <tt>OpenSim.exe</tt> will start up all of your sims! If you come across any errors, there is most likely an error in your xml files.

== Tools ==

A powerful region generator is available at: [[RegionGenerator]]

[[Category:Configuration]]

Configuring Regions

2013-02-01T06:51:09Z

Tonyguards:

Jp2 batch converter for windows

2012-12-18T08:54:36Z

Tonyguards:

__NOTOC__
{{Quicklinks}}
 

== Description ==
For how, why and where it is made for: please refer to the wikipage of the [[jp2 batch converter|original script]].

This is a modification of that script to make the system commands work on windows systems.
Also a helpful /help explanation and optional /D command to delete the old files is added.

Note: these are some quick adjustments to the original, it may or may not work, depending on your setup. It did work here.

== Usage ==
=== Dependencies ===
* This script is a perl script, so you first should go and install that. ([http://www.perl.org/get.html www.perl.org])

* The ImageMagick executables for windows. ([http://www.imagemagick.org www.imagemagick.org])
Please note that the 'convert.exe' executable conflicts with the FAT-to-NTFS batch command of windows.
This script will therefor seek a 'imconvert.exe' file in the PATH. Please rename it, or adjust the lines that start with:
system("imconvert ...

* Openjpegs J2K Codec executables, more specifically: image_to_j2k.exe. ([http://www.openjpeg.org/index.php?menu=download www.openjpeg.org])

* References to all executables in the PATH environment variable.
This can be set trough Right-click My Computer->Properties: Advanced tab->Environment variables.

=== Arguments ===
The script takes 2 arguments

* An optional /D argument, if added the script will also delete the old image files

* A required directory specified.

* Or, you could start it with a /help command, which gives about the same info as this page.

=== Running ===
Execute this from command prompt, optionally adding a /D argument for also deleting the source images.
perl jp2batch.pl /D "c:\directory\with\images\"

== Code ==
<source lang="perl">
# jp2batch.pl
# OpenSimulator jp2 texture preparation script (for windows)
# Converts jpg/jpeg/bmp/tga files to valid jp2(jk2) files for SL
# Author: Phrearch, modified by Jeroen Waisman for Windows systems
# Credits: Tedd1, Phrearch

$dirs=0;
$files=0;
$delete=0;

sub Scan {
my ($dir) = @_;
local ($substr);
$substr = substr($dir, -1);
if(($substr eq "/") || ($substr eq "\\")) {
$dir = substr($dir, 0, -1);
}

if (-d $dir) {
&ScanDirectory($dir);
print "Directories scanned:$dirs\nFiles processed:$files\n";
}
else {
print "Non-existent directory $dir\n";
}
}
sub ScanDirectory {
my ($workdir) = @_;
local (@names);
$dirs++;
opendir(DIR, $workdir) or die "Unable to open $workdir:$!\n";
@names = readdir(DIR) or die "Unable to read $workdir:$!\n";
closedir(DIR);
foreach my $tmpName (@names) {
my $name = $workdir."\\".$tmpName;
#\. or \.. in directory
if ($tmpName =~ /^\.\.?$/) {
next;
}
#directory
elsif (-d $name) {
print "Entering directory $name\n";
&ScanDirectory($name);
next;
}
#jpg or jpeg
elsif ($tmpName =~ /^(.*)\.([jJ][pP][eE]?[gG]|[bB][mM][pP]|[tT][gG][aA]|[tT][iI][fF][fF]?|[rR][aA][wW])$/) {
$filename = $1;
$ext = lc($2);
$rawname = $workdir."\\".$filename;
$files++;
print "\n----- Processing $filename.$ext -----";
&Convert($rawname,$ext,$filename);
}
}
}
sub Convert {
my ($rawname, $ext, $filename) = @_;
my @imageXY = split('x',`identify -format "%wx%h" "$rawname.$ext"`);
my $imageX = pop(@imageXY);
my $imageY = pop(@imageXY);
my $optX;
my $optY;
my $ar;
my $optar;

#landscape or square, search for optimal X
if (($imageX >= $imageY) && ($imageX != 0)) {
$ar = sprintf("%.4f",$imageY / $imageX);
$optar = &supportedAR($ar);
$optX = &supportedXY($imageX);
$optY = $optX * $optar;
#both aspectratio and resolution are correct
if(($imageX!=$optRes) || ($ar!=$optar)) {
print "\nResizing ($imageX\xx$imageY => $optY\xx$optX)... ";
system("imconvert -resize ${optX}x${optY}! \"$rawname.$ext\" \"$rawname.$ext\"");
print "Done\n";
}
}
#portrait, search for optimal Y
elsif($imageY != 0) {
$ar = sprintf("%.4f",$imageX / $imageY);
$optar = &supportedAR($ar);
$optY = &supportedXY($imageY);
$optX = $optY * $optar;
#Needs conversion
if(($imageY!=$optRes) || ($ar!=$optar)) {
print "\nResizing ($imageX\xx$imageY => $optX\xx$optY)... ";
system("imconvert -resize ${optX}x${optY}! \"$rawname.$ext\" \"$rawname.$ext\"");
print "Done\n";
}
}

if ($ext =~ /^(?:[jJ][pP][eE]?[gG])$/) {
print "\nConverting $ext to valid openjpeg (tga) format to handle... ";
system("imconvert -format tga \"$rawname.$ext\" \"$rawname.tga\"");
print "Done\n";
if($delete==1) {
print "\nDeleting old file... ";
system("del \"$rawname.$ext\"");
print "Done\n";
$delete=3;
}
else {
$delete=2;
}
$ext="tga";
}
print "\nCreating .j2k (jpeg2000) file... ";
system("image_to_j2k -i \"$rawname.$ext\" -o \"$rawname.j2k\" -r 20,10,1");
print "Done\n";

print "\nRenaming .j2k file to .jp2... ";
# We cannot rename if there is already such an file, so find the file-number that CAN be named to
if(-e "$rawname.jp2") {
$num = 1;
while(-e "$rawname $num.jp2") {
$num++;
}
system("rename \"$rawname.j2k\" \"$filename $num.jp2\"");
}
print "Done\n";

if($delete>0) {
if($delete>1) {
print "Deleting temporary .tga file... ";
system("del \"$rawname.$ext\"");
print "Done\n";
if($delete==3) {
$delete=1;
}
else {
$delete=0;
}
}
else {
print "Deleting old file... ";
system("del \"$rawname.$ext\"");
print "Done\n";
}
}
print "--------------------------------\n";
}
sub supportedAR {
my ($ar) = @_;
my @arReference=(1.0,0.5,0.25,0.125,0.0625);
my $arOptimal;
my $arDivTemp=1.0;
my $arDiv;
#Get optimal aspect ratio
foreach (@arReference) {
$arDiv=abs($ar-$_);
if($arDiv < $arDivTemp) {
$arDivTemp=$arDiv;
$arOptimal=$_;
}
}
return $arOptimal;
}
sub supportedXY {
my ($res) = @_;
my @resReference=(64.0,128.0,256.0,512.0,1024.0);
my $resOptimal;
my $resDivTemp=4096.0;
my $resDiv;
#Get optimal axis resolution
foreach (@resReference) {
$resDiv=abs($res-$_);
if($resDiv < $resDivTemp) {
$resDivTemp=$resDiv;
$resOptimal=$_;
}
}
return $resOptimal;
}
if (@ARGV>1) {
if((@ARGV[0] eq "/D") || (@ARGV[0] eq "/d")) {
print "Processing ".@ARGV[1]."... (deleting old files) \n\n";
$delete = 1;
&Scan(@ARGV[1]);
}
elsif((@ARGV[1] eq "/D") || (@ARGV[1] eq "/d")) {
print "Processing ".@ARGV[0]."... (deleting old files) \n\n";
$delete = 1;
&Scan(@ARGV[0]);
}
else {
print "Syntax error\n";
print "Provide just one directory argument, optionally with a /D argument...\n";
}
}
elsif (@ARGV>0) {
if((@ARGV[0] eq "help") || (@ARGV[0] eq "?")) {
print "\nBatch convert images to opensim-compatible .jp2 files\nWorks for: .jpg/.jpeg, .bmp, .tga, .tif/.tiff or .raw files\n\n\n";
print "perl jp2batch.pl [/D] [station:][path]dir\n\n\n";
print " dir Directory (and sub-directories) to search for image files.\n";
print " -D If provided, old files will be deleted.\n\n\n\n\n";
print "Dependencies, these executables should be available in the PATH or directory of the script.\n\n";
print " ImageMagick library functions: (note that I renamed one executable)\n";
print " Available at http://www.imagemagick.org/\n\n";
print " imconvert.exe originaly named convert.exe, but renamed due to a Windows batch-command conflict.\n";
print " identify.exe\n\n\n";
print " OpenJpeg2000 library's J2K Codec: \n\n";
print " Available at http://www.openjpeg.org/\n";
print " image_to_j2k.exe\n\n\n";
}
elsif((@ARGV[1] eq "/D") || (@ARGV[1] eq "/d")) {
print "Syntax error\n";
print "You must provide a directory to process, optionally with a /D argument...\n";
}
else {
print "Processing ".@ARGV[0]."...\n\n";
$delete = 0;
&Scan(@ARGV[0]);
}
}
else {
print "Syntax error\n";
print "Provide a directory to process, optionally with '/D' argument...\n";
}
</source>

== Credits ==

Ofcourse almost all credit goes to the original author of this script. I just adjusted a few commands to make it work on Windows systems.
[http://saranasukses.com/outsourcing-indonesia.html Outsourcing Indonesia]