StandAlone
De DigiWiki.
Standalone (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
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=***;"
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).
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] do not change Internal IP Port [9000] do not change
External Host Name [YOU IP] change it to your localhost 127.0.0.1 or keep it if you can loopback your router.
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) # :
you know the server is ready.
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://127.0.0.1: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 https://github.com/aurora-sim/AstraViewer/downloads or Imprudence 1.4 exp 03/20 or above http://wiki.kokuaviewer.org/wiki/Downloads as these have been coded to use Var Regions.
