StandAlone External Access
De DigiWiki.
Standalone with External Access (Release 0.3)
Aurora-Sim by default is Standalone so there is minimal configuration.
If using SQlite as your Database then you can skip the parts to do with MySQL. If using binary then you can skip the section on Build and Compile.
Install Requirements
Firstly ensure you have the basics, which are outlined in detail at Requirements
We require:
A Windows Operating System and that .NET 3.5 framework is installed.
or:
Linux / Mac OS Operating Systems require at least MONO Version 2.4.3 or better installed. At present MONO 2.10.2 is our recommended version, See Mono-Project and install according to your Operating System.
Downloading Aurora-Sim
Source :- https://github.com/aurora-sim/Aurora-Sim
Release :- https://github.com/aurora-sim/Aurora-Sim/downloads OR direct download zip tar.gz (current release 0.3)
Build and Compile (Linux)
apt-get install mono-xbuild
apt-get install nant
apt-get install git-core
aptitude install mysql-server
cd /home/
git clone git://github.com/aurora-sim/Aurora-Sim.git
cd /home/Aurora-Sim chmod -R 777 runprebuild.sh
./runprebuild.sh
xbuild Aurora.sln
Build and Compile (Windows)
Download Aurora-Sim from master source
1) Goto Aurora-Sim folder
2) Double Click runprebuild.bat
3) Double Click compile.bat
Build and Compile (Mac)
TO BE DONE
Router Ports
You can either google your router on how to portforward your router or theres a great site that may help you portforward.com
| Default External Port | Service | Config Location |
| 8002 | Login | <install folder>/bin/Configuration/Main.ini |
| 8003 | Asset | <install folder>/bin/Configuration/Main.ini |
| 8005 | MapService | <install folder>/bin/Configuration/Main.ini [MapService] config |
| 8007 | CAPS Service | <install folder>/bin/Configuration/Main.ini |
| 9000 | Region | <install folder>/bin/Regions/*.ini |
MySQL Database Setup
mysql -u root -p
create database DBName;
create user DBUser;
GRANT ALL PRIVILEGES ON DBName.* TO DBUser@'localhost' IDENTIFIED BY 'Password';
flush privileges;
exit
NOTE 5.5.x MySQL you will need to add max_allowed_packet= xxxM manually to your my.ini
MySQL/SQLite Configuration
If Using MySQL instead of SQLite you will need to change two files OR leave as default for SQLite.
- bin > Configuration > Data > Data.ini
;Include-SQLite = Configuration/Data/SQLite.ini Include-MySQL = Configuration/Data/MySQL.ini
- bin > Configuration > Data > MySQL.ini
Change Database, UserID & Password to what you created in the MySQL Database Setup section.
ConnectionString = "Data Source=localhost;Port=3306;Database=opensim;UserID=opensim;Password=***;"
Aurora.ini
[Network] http_listener_port = 9000
127.0.0.1 should be your IP address or DNS
Define-HostName = http://IP address or DNS
bin > Configuration > Standalone > StandaloneCommon.ini
- [GridInfoService]
login uri: for grid this is the login server
URI login = http://IP address or DNS:9000/
long grid name: the long name of your grid
gridname = "Your_Grid_Name"
short grid name: the short name of your grid
gridnick = "Your_Short_Grid_Name" this must be all lower case
(And other information you wish to provide , the above is just the basics)
- [LoginService]
DefaultHomeRegion = "YOUR_REGION_NAME"
Starting Aurora-Sim (Windows)
/Aurora-Sim/bin
Double Click Aurora.exe
(Note: Vista users should ensure that they are in Admin mode, before completing the next steps)
Starting Aurora-Sim (Linux)
cd /home/Aurora-Sim/bin
mono Aurora.exe
Starting Aurora-Sim (Mac)
TO BE DONE
Starting Aurora-Sim-SQLite (Linux)
cd /home/Aurora-Sim/bin
LD_LIBRARY_PATH=. mono Aurora.exe (Only if using SQLite as database for the Region Server).
bin > Regions > RegionConfig.ini.example (You can let Aurora do this on startup by following console questions)
This will be setup when you startup the server, you can also manually make if you wish and rename it as RegionConfig.ini. If you need a RegionUUID heres a UUID generator http://www.guidgenerator.com/online-guid-generator.aspx .
Console
A DOS-like server control window will open, and various status messages will scroll by. Once it has stopped it will ask for the basic settings it will use to create your first region, with the default settings in square brackets. To accept a default setting, just hit the Enter key:
Region Name [Test] name your region here, anything you like *
Region UUID [UUID] do not change
Grid Location (X- Y) [1000,1000] do not change
RegionSizeX [256] : keep it for now
RegionSizeY [256] : keep it for now
Internal IP address [0.0.0.0] or Internal IP
External Host Name [YOU IP] change to your "SYSTEMIP or IP address or DNS"
Estate Owner [Test Default] : provide the Firstname and Lastname you wish for your avatar and it will ask for creating it, even asking for password, email etc. Fill the infos you wish. All the parameters marked * you should make a note of, as you will need them later when setting up your viewer. After entering the last parameter the Server creates your region, and when you see the line,
Region (root) #
Viewer Setup
Installing and Setting up the Imprudence/Kokua (Viewer) Launch the Imprudence/Kokua viewer, and you will notice a Grids button, next to the Connect button. In here you can choose which grid to connect to, add new grid details, etc. Let me walk you through setting this up for your own region you just created.
Click on the Grids button, you will see in the 'Select a Grid' drop-down box that connection details to 3rd Rock, openlife, osgrid and secondlife have already been set up. So, to create your own, click on the Add button.
Set the details as follows:
Loginuri: http://IP address or DNS:9000/ (this is the External Host Name parameter and Port)
Platform: Opensim Grid Nickname: same as the Region Name in the server setup above.
Grid Name: same as the Grid Nickname
Click on Apply.
If you want your region to be the default region that Imprudence/Kokua Viewver connects to when it starts up, just choose your region from the Select a Grid drop-down box, and click the Default button. Ok, you are now good to connect to your sim. Enter the Avatar details you provided earlier to the server, and click on the Connect button. You should now be standing in your very own standalone Aurora-sim!
Var Regions (Variable Sized)
If you wish to make regions over the 256x256 size you will need to use either Astra Viewer http://astraviewer.com/ or Imprudence 1.4 exp 03/20 or above http://wiki.kokuaviewer.org/wiki/Downloads as these have been coded to use Var Regions.
