-
Notifications
You must be signed in to change notification settings - Fork 34
/
WhiteCore Seperate Grid Region mode build Ubuntu 20.04 .txt
187 lines (130 loc) · 6.1 KB
/
WhiteCore Seperate Grid Region mode build Ubuntu 20.04 .txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
WhiteCore build - Ubuntu 20.04
Greythane
June 2021
These details are for a grid connected region setup - separate grid and region servers
Clean install on a new VM of Ubuntu server 20.04 LTS
Single user entered at creation
# install build environment
sudo apt install mono-complete
# Copy/get WhiteCore repository
# The code used for testing is the current latest development code at
# https://github.com/greythane/WhiteCore-Dev.git
# Clone if required
# git clone https://github.com/greythane/WhiteCore-Dev.git
#
# Note: This is still development code so some new functionality make be missing
# All existing functionality as per the main repo exists
#
# Procedures shown should also be the same for the main repository
# git clone https://github.com/WhiteCoreSim/WhiteCore-Dev.git
# Note: the main repo does not yet contain all updates as of June 2021
# change to the code main directory for building
cd WhiteCore-Dev
# !!Important!! - Ensure that the library submodules are present and the latest
git submodule update --init --recursive
# Note msbuild is not included in the focal repos yet so xbuild is needed
... edit 'autobuild.sh' and replace 'msbuild' with 'xbuild' or comment/uncomment the appropriate compile option
( Line 104 in the BUILD section at the bottom )
# make scripts executable if necessary
chmod +x *.sh
# build WhiteCoreSim
# Note: This should be executed as a (normal) user, NOT sudo or the root user
./autobuild.sh
... complie output
... probable warnings but there should be no errors
# Copy entire WhiteCoreSim directory to the home directory
cp -r WhiteCoreSim ~/WhiteCoreSim
# change to the copied WhiteCoreSim directory
cd ~/WhiteCoreSim
# If the scripts are NOT executable, then update
chmod +x *.sh
## Setup of the individual servers ##
--------------------------------------
# change to the 'bin' directory for the initial setup
cd ./bin
# Configure the WhiteCore grid server
mono WhiteCore.Server.exe --reconfigure
# Initial startup and loading will be shown
# Note:
If WhiteCore has ben configured previously then the new startup options will be shown
If no configuration has been done, the the 'configurator' will be run to specify database, address etc.
The trial instance was installed on a virtual machine and uses the SqLite database
# Initial input requiring user input
... Do you want to configure WhiteCore-Sim now - yes
... make sure - yes
... select the database to use
# if MySql is chosen, some additional questions need details
... enter the MySQl server address
... database port - accept the default unless another port is used
... enter the database name
... enter the database user
... enter the db user password
... enter the grid name
... accept/modify the greeting message
... create accounts automatically y/n
... choose asset service - accept the default - File based [1]
... enter sim access address
... server port - accept the default
# the grid server configuration is now complete
# Re run the server to setup required data and assets
mono WhiteCore.Server.exe
# The grid server will run, create and install the default assets into the database
... enter the user name of the grid owner - suggested or input as required
... enter password and confirmation...
... enter an email for password recovery (if desired)
... Select an avatar or none (for the default)
... The UID of the grid owner will be shown,
... accept or enter a specific UUID if required
.. Enter the name of the grid owners' estate
(a suggested default will be shown but it's a good idea to create the inital 'grid' estate that will be used - eg. MyGridEstate etc)
# Further output as the system users are created
# Wait until initial setup has been completed and the 'quit' the server
... quit
Restart the grid server in a screen session ready for configuring the region server next
cd ..
./run_gridservice.sh (executed from the'bin' directory)
# Output indicating screen session is running
## Configure the region server ##
__________________________________
# Continue in the 'bin' directory
cd ./bin
mono WhiteCore.exe --reconfigure
# Check and confirm re-configure
... select standalone or grid operation - 2 (grid operation)
... address of the grid server (set as per above)
... access port - accept default
... access address of the sim
# Region server configuration is complete
# Restart region server to complete configuration
mono WhiteCore.exe
# First region setup (home landing region)
... enter the region's name
... enter the region's X and Y location (default 1000,1000)
... enter the region's size (default 256, 256)
... select the region type (default Estate)
... select the region type (default Full Region)
... select the region's terrain (default grassland)
# The region will be created ... region info...
>Your region '<region name>' is not part of an estate
... enter the owner of an estate (default RealEstate owner)
... use the grid owner's user name as created prior to this
(The only user (other then system users) is the grid owner that was created before)
# further system output as the region is created and assigned to the <grid owner's> estate
# Exit the region
... quit
# restart the region server in a 'screen' session
cd .. (change back to the main WhiteCoreSim directory)
# startup the region server in a sesion
./run_simservice.sh
# Output indicating screen session is running
# Login to the WhiteCore sim is now possible
You should now be able to use your favourite client to login with the user and password you set in the region setup.
Note: You will need to add your new grid to the client's grid options
You can check that the servers are up and running correctly by accessing the appropriate screen session
screen -r Grid
screen -r Sim
You can use the combined startup script to run both the grid and region server
> ./run_gridmode.sh
This will run the grid server and the region server in seperate sessions
# Note: If using SQLite, removing all the *.db files in Data/SQLite/ will reset so that the next time WhiteCore is run, the initial startup details will be requested.
i.e. Removing the database will re-initialise the Sim to a 'clean' state