-
Notifications
You must be signed in to change notification settings - Fork 34
/
whitecore build Ubuntu 20.04.txt
132 lines (95 loc) · 4.7 KB
/
whitecore 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
WhiteCore build - Ubuntu 20.04
Greythane
June 2021
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 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
# Execute the 'run_standalone.sh' script to start WhiteCore
./run_standalone.sh
# Access the screen session to configure
screen -r Sim
# 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
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
# 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)
# Region creation 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
# 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
You will need to do these things before you have a full running setup….
> cd WhiteCoreSim
> ./grid_console.sh
This will ask for you grid owner name etc. This is only setting up the grid server
When completed, quit the grid server.
> ./run_gridservice.sh
This will restart the grid server in a screen session ready for configuring the region server next
You can check that the server is up and running correctly by accessing the screen session
>screen -r Grid
You should have no errors , exist with ctrl+a d
>./sim_console.sh
This will start the configuration of the region server
You will need to specify the details as per your setup, using the grid service at localhost, port 8002
Once completed quit the region server
Stop the grid server
>screen -r Grid and quit to shutdown
You are now ready to run the full setup
> ./run_gridmode.sh
This will run the grid server and the region server in seperate sessions
You can check each session using the screen - r Grid or screen -r Sim command
# Login to the WhiteCore sim is now possible
You should now be able to login with the user and password you set in the region setup.