aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/doc/configuration.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/configuration.html')
-rw-r--r--doc/configuration.html130
1 files changed, 129 insertions, 1 deletions
diff --git a/doc/configuration.html b/doc/configuration.html
index 9844414..0f42529 100644
--- a/doc/configuration.html
+++ b/doc/configuration.html
@@ -3,6 +3,134 @@
3<head> 3<head>
4</head> 4</head>
5<body bgcolor="black" text="white" alink="red" link="blue" vlink="purple"> 5<body bgcolor="black" text="white" alink="red" link="blue" vlink="purple">
6<p>&nbsp;</p> 6
7<p>opensim-SC uses the same configurations as <a
8href="http://opensimulator.org/wiki/Main_Page">OpenSim</a>, with some
9small changes, so please refer to their <a
10href="http://opensimulator.org/wiki/Configuration">documentation</a>.
11Only the differences will be detailed here.</p>
12
13<p>OpenSim ships with some pre-compiled executables and libraries, plus
14other files in it's own bin/ directory, and wants to write the rest of
15it's files there as well. Some existing configuration options let you
16move some of those writable areas out of the tree, but not all.
17opensim-SC tries to move all writable stuff and configuration out of
18tree, to make updates easier. InstallItAll.sh builds this structure in
19/opt/opensim_SC, and copies itself to /opt/opensim_SC/opensim-SC.</p>
20
21<p>The two main configuration files are
22/opt/opensim_SC/opensim-SC/bin/Robust.ini and
23/opt/opensim_SC/opensim-SC/bin/OpenSimDefaults.ini. You should not modify
24those. They include files from
25/opt/opensim_SC/opensim-SC/bin/config-include, which you should also not
26modify. Instead there are various directories and config files in
27/opt/opensim_SC/config where you can over ride the configuration options
28you want to change.</p>
29
30<h1>/opt/opensim_SC/config/config.ini</h1>
31
32<p>This will start as a copy of one of the
33/opt/opensim_SC/opensim-SC/bin/config-include/config_*.ini files. Copy
34config_localhost.ini if you want to run your own grid, or one of the
35others if you want to connect to IG or MG. It is used by both ROBUST and
36by sims. It must be NOT world readable, as it contains your database
37login details.</p>
38
39<p>By default this file includes two sections. [Paths] and [Const], but
40you can add more sections in this file if you need to override those
41sections from the configuration files in the bin/ directory.</p>
42
43<p>[Paths] is the paths to the various movable directories, relative to
44the /opt/opensim_SC/opensim-SC/bin/ directory.
45
46<ul>
47<li>AssetsPath - where your assets are stored.</li>
48<li>BackupPath - where IAR and OAR backup files are created.</li>
49<li>CachePath - the directory that holds various caches.</li>
50<li>ConfigPath - this /opt/opensim_SC/config/ directory that we are describing.</li>
51<li>DbPath - a directory with some small statistics databases.</li>
52<li>LogPath - where the logs and console history are kept.</li>
53<li>WebPath - where the various web pages are served from.</li>
54</ul>
55
56<p>[Const] is various constants used in the rest of the configuration
57files, so you can define these here once.</p>
58
59<ul>
60<li>MOTD - the message that is shown to people when they log on.</li>
61<li>GridName - the name of the grid.</li>
62<li>ShortGridName - the short name of the grid, usually the initials of GridName.</li>
63<li>BaseHostName - a HTTP URL that is used as the base of all other URLs.</li>
64<li>HostName - the domain name of your grid.</li>
65<li>BaseURL - built from BaseHostName usually.</li>
66<li>GridURL - built from BaseHostName usually.</li>
67<li>SSLURL - built from HostName usually.</li>
68<li>PublicPort - public port used by ROBUST services.</li>
69<li>PrivatePort - private port used by ROBUST services.</li>
70<li>PublicSSLPort - public port used by ROBUST services in SSL mode.</li>
71<li>AssetServerPort - public port used by the ROBUST asset service.</li>
72<li>DataProvider - used to select between the various SQL backends, though opensim-SC only supports MariaDB / MySQL.</li>
73<li>ConnectionString - the details of how to connect to your SQL backend. This contains credentials that need to be protected from others reading them.</li>
74</ul>
75
76<p>NOTE - though SSL is mentioned above, SSL is not well supported in
77OpenSims own web server. They wrote their own, the SSL parts are not
78well tested, being rarely used. Probably best to not use SSL now. In
79the next major version of opensim-SC I intend to use an external web
80server, and shift things over to it. Lighttpd is the likely choice.</p>
81
82<h1>/opt/opensim_SC/config/ROBUST/RobustExtra.ini</h1>
83
84<p>This is where you would override ROBUST specific configuration options. By default it will be empty.</p>
85
86<h1>/opt/opensim_SC/config/simXX/ThisSim.ini</h1>
87
88<p>For each sim you need to specify certain options, and you can override
89others. /opt/opensim_SC/config/sim_skeleton/ThisSim.ini is a template
90used by the create_sim script to create this file. Newer versions of
91create_sim might give this file the name of the sim, My_New_Sim.ini.</p>
92
93<p>The "SIM_*" bits get replaced with actual information for each sim.
94It has it's own [Const] section, which only contains mysim, the number of
95this sim. The [Startup] section defines various file locations. The
96[Network] section defines the public port for this sim.</p>
97
98<p>OpenSim had the [Region] section in different files, in two
99different formats, instead opensim-SC includes that info here so it's all
100in one place per sim. RegionName is the name of your sim, the rest are
101described in OpenSims <a
102href="http://opensimulator.org/wiki/Configuring_Regions">Configuring
103Regions</a> page.</p>
104
105<p>The [Performance] section is new to opensim-SC. It includes one of the
106/opt/opensim_SC/opensim-SC/bin/config-include/Sim*.ini files that give
107you a choice of performance trade offs.</p>
108
109<h1>New options.</h1>
110
111<p>There have been some additional options added to support new features. Some have been mentioned above.</p>
112
113<ul>
114 <li>[AuthorizationService]</li>
115 <ul>
116 <li>DefaultRegionAccess - Set the default access restriction for any sim not otherwise mentioned in this section.</li>
117 </ul>
118 <li>[Groups]</li>
119 <ul>
120 <li>AddDefaultGroup - automatically add any members of your grid to this | separated list of groups.</li>
121 <li>AddHGDefaultGroup_othergrid.com - same as above, but for hypergrid visitors from a specific grid.</li>
122 </ul>
123 <li>[GodNames]</li>
124 <ul>
125 <li>FirstNames - similar to the other GodNames options, but this is a list of first names that designate gods for viewers. Note that viewers may not support this.</li>
126 </ul>
127</ul>
128
129<h1>Removed options.</h1>
130
131<p>Some options have been removed. Mostly limitations, or useless cruft.
132You wont miss them. In one instance a viewer bug that had been fixed a
133decade ago, was still being forbidden in OpenSim.</p>
134
7</body> 135</body>
8</html> 136</html>
generated by cgit v1.1 at 2024-06-26 13:05:53 +0000