Metaverse, Tivoli Cloud, Tutorials

Set up a Tivoli Cloud world server on DigitalOcean

Tutorial - Set up a Tivoli Cloud world server on DigitalOcean

In this tutorial I want to show you how to set up your own world server quickly and cheaply for the metaverse of Tivoli Cloud, using the cloud service of DigitalOcean.

DigitalOcean is an American cloud infrastructure provider headquartered in New York City with 13 data centers worldwide.

I personally use DigitalOcean because it’s easy to set up (although a bit intimidating at first if you’ve never done it before), it’s cheap (starting at $10 a month), and it’s easy to scale. If you ever need more power because there’s an event coming up in your world and you’re expecting a lot of users, a few clicks is all it takes to switch to a plan with a stronger processor, more processors, or more memory. After the event you can switch back to your normal tariff just as quickly.

You don’t need any special knowledge for this tutorial. All steps from creating an account to starting the world server are presented with pictures and short descriptions.

And now, let’s get started!

Welcome 🎈

This tutorial is intended for beginners. No knowledge of setting up a server is required. Although a little adventurousness and curiosity are helpful.

30 minutes

Set up a Tivoli Cloud world server on DigitalOcean

1. Setting up an account on DigitalOcean

Step one! To install an online world server on DigitalOcean, you need an account there. If you already have a DigitalOcean account, log in and skip this step and continue with the next step.

I am sure you know how to open an account. The following seven steps will show you in detail which clicks you have to do.

Tip

If you are new to DigitalOcean and create an account through one of the links provided here, you will receive a starting credit of 100 USD from DigitalOcean, usable for 60 days from the day of registration. An email address and credit card, or a Paypal account is required for legitimation.

Create an account on DigitalOcean

With this chapter completed
15%
1
Open a new tab in your browser and surf to the DigitalOcean homepage, or just click on this link . Once there, click on ‘sign up’ in the upper right corner.
2
Enter your name, email address and a strong password . Hit the ‘sign up’ Button
3

“You got mail”. Check your email inbox and confirm your email address.

4

DigitalOcean wants to remain a safe and sustainable platform and requires new members to verify their identity with a payment method.

5

In this case, I provided my credit card information. For a Paypal verification please follow the appropriate indicate.

6

And we are in! Click on ‘Explore our control panel’ next.

7

Wasn’t that difficult, was it? Here you can see your DigitalOcean Dashboard.

Set up a Tivoli Cloud world server on DigitalOcean

2. Creating a Droplet

DigitalOcean Droplets are Linux-based virtual machines (VMs) that run on virtualized hardware. Each Droplet you create is a new server that you can use. However, to host one or more worlds for Tivoli Cloud, you only need one Droplet. How you create it is what we’ll look at now.

In the next 8 steps, we determine which operating system to use, how powerful the Droplet should be (CPU, RAM, and hard disk), and on which of the locations available worldwide it should be hosted.

The closer the Droplet location is to your home address, the faster the world will build up for you later when you go online. Here you should consider who you want to reach with your world. If your users are mostly from India, a location in Bengaluru (Bangalore) might be better.

Then go on…

Tip

For most static projects, a Basic Droplet like the one we create here in the tutorial is sufficient. If your worlds require more power, you can also choose a more powerful Droplet. In general, the more memory, the better. Disk space is not important, as we will be hosting our assets on the Tivoli Cloud server later.

The specifications of the SKIMI 3D Droplet running 10 worlds are:

  • 2 vCPU
  • 4 GB Ram
  • 4 TB Traffic
With this chapter completed
31%
1

In the DigitalOcean Dashboard, click on ‘Droplets’ in the column on the left.

2

And once again confirm ‘Get Started with a Droplet’.

3

At ‘Choose an image’ select Ubuntu.

Scroll down the page a little.

4

For ‘Choose a plan’ click Basic. For CPU option select Regular Intel with SSD and then $10 USD ($0.015/hour) for 2 GB Ram, 50 GB SSD and 2 TB Traffic.

Scroll down the page a little.

5

Now select the location where you want your Droplet to be hosted.

Scroll down the page a little.

6
Select Password and then select a strong password . Please make a note of the password, we will need it again later for the SFTP client. Scroll down the page a little.
7

Your project should already be selected. Finally, confirm with ‘Create Droplet’.

8

Whoopee, your droplet is created! After a little moment you are back on the dashboard of your DigitalOcean account.

Make a note of the IP address. We will need it later.

Set up a Tivoli Cloud world server on DigitalOcean

3. Install Docker

Now we come to the heart of our tutorial. After we have created an account at DigitalOcean and our virtual server is installed – we still need to bring it to life 🧙

However, this is not magic. And not difficult either. Even if it seems a bit intimidating at first glance. You don’t have to be a server administrator to do it, although you’ll do a fantastic job of administering your server with it.

Just follow each step exactly as indicated. After a few minutes your server will be ready to receive your first world.

Gain trust

I have created a video for each command prompt to install Docker. You don’t have to watch these videos. But if you’re thinking, “Wait a minute, why is this taking so long?” or “Is this even right, what I’m doing here?”, the videos will give you a little more confidence.

With this chapter completed
63%
1

In your DigitalOcean dashboard, look to the right of the row with your Droplet for the three dots, click on them and open the menu. Here you select ‘Access console’.

2

Click on ‘Console’ on the right to open the console window (terminal window).

3

Here we are. This is the Hall of Power, the Holy Grail…. okay, it’s just a boring terminal window, and you have to log in. By default, your login name is: root. Click enter after that. Now you will be asked for your password that you wrote down before (Step 2 picture 6). Type it in and hit enter again.

4

If you entered everything correctly, you are logged in at the command entry level of your vServer. Your terminal window should look like the one above. The cursor is blinking at the end of the line, awaiting your input.

				
					sudo apt-get update -y
				
			

What we do now in the next steps is just copy, paste and press enter. Piece of cake, right?

Let’s start: copy the first command (if you hover the mouse over the field, a copy button appears at the end of the line, click it).

Now switch to the terminal window, click on it to be sure it is active and paste the command with CTRL+V (alternatively right click and choose Paste).

After that just hit the Enter key. Wait until the command is completely executed (about 12 seconds).

You want to be sure that you did everything right? Watch the little video here on the right.

				
					sudo apt-get install -y curl python3-pip libffi-dev
				
			

Awesome! You have control over your vServer. Good feeling, isn’t it?

Second step. Copy the next command, paste it into your terminal window and press Enter.

Wait until the command is completely executed. It will need some time (about 1:22 minutes). Be patient.

				
					curl -fsSL https://get.docker.com -o get-docker.sh
				
			

Great Job!

Next step. Copy the next command, paste it into your terminal window and press Enter.

Wait until the command is completely executed (about 4 seconds).

				
					sudo sh get-docker.sh
				
			

Well, it’s getting good, right?

You know what comes next! Copy the next command, paste it into your terminal window and press Enter.

Wait until the command is completely executed (about 46 seconds).

				
					sudo pip3 install docker-compose
				
			

Ah, there you are again 😉

Copy the next command, paste it into your terminal window and press Enter.

Wait until the command is completely executed (about 10 seconds).

				
					sudo systemctl enable docker
				
			

And now we are getting faster and faster.

Copy the next command, paste it into your terminal window and press Enter.

Wait until the command is completely executed (about 3 seconds).

				
					sudo systemctl start docker
				
			

Immediately made.

Copy the next command, paste it into your terminal window and press Enter.

Now you don’t have to wait anymore, the last two commands will be executed immediately.

				
					sudo usermod -aG docker $USER
				
			

We are approaching the destination.

Copy the next command, paste it into your terminal window and press Enter.

This command will be executed immediately.

Yippie, the hell ride is over! You can be proud of yourself. Everything went smoothly up to here. Now you have to log out and log back in, Docker knows that your user is part of the Docker group.

Good to know

This tutorial is based on the original tutorial by Maki, published on Tivoli Cloud
				
					mkdir worlds

				
			
				
					cd worlds

				
			

Finally, a few steps:

  1. Type: logout and hit Enter.
  2. Type your login: root and hit Enter
  3. Enter your strong password and hit Enter.

When the prompt appears, type:

mkdir worlds and press Enter
cd worlds and hit Enter.

That’s it. Your vServer is ready and waiting for your worlds. You can leave the terminal window open, we will need it one last time in a moment.

Set up a Tivoli Cloud world server on DigitalOcean

4. Your Worlds

After we have configured our vServer and everything is ready, we still need to tell our vServer how many worlds it should provide for us.

All we need for this is a docker-compose.yml file and an appropriate command.

You also need a SFTP client to easily upload the file to the vServer. A free version of FileZilla is available for Windows and Mac. You can also use any other capable SFTP client.

Download the ready-to-use docker-compose file for one world, for 2-, for 5- or 10 worlds. To do this, click on the icon, the file comes zipped to your computer. Please unzip the file. The content is: docker-compose.yml

If you want to write it yourself, you can find the base for one world in the link “Content of docker-compose.yml”.

With this chapter completed
80%
1
Go to the FileZilla website download and install the appropriate (Win or Mac) free FileZilla client.
2

Click on ‘File’ in the top menu and then on ‘Site Manager’.

3

First click on ‘New Site’ and enter a unique server name in the upper left corner, e.g. DigitalOcean. Then enter your access data on the right.

Select ‘SFTP – SSH File Transfer Protocol‘ from the Protocol menu. Under Host you enter your vServer IP address (Step 2 picture 8) and the strong password (Step 2 picture 6).

Click on ‘Connect’.

4

Your SFTP client will now connect to your vServer. If this is the first time, a security message will appear, which you can confirm with OK.

5

Your screen should now look similar to the one above. The right client window shows the file structure of your vServer. And look. Do you see the directory ‘worlds’? You set that up yourself in the terminal window earlier. Double click on it, we want to open this directory.

6

And finally, drag the docker-compose.yml file you downloaded earlier into the right SFTP client window. It will then be transferred to your vServer and appear as a file there.

You have also succeeded in this! Excellent!

				
					docker-compose up -d
				
			

And now we still need to run the docker-compose.yml file. Is your Server console (terminal window) still open? Go there and click on it to activate it.

Make sure the path at the end of the prompt is ‘/worlds#’. If this is not the case because you had to log in again, change to the directory with cd worlds and hit Enter.

You already know how to proceed now. Copy the command above and paste it into your console window and hit Enter.

Now this takes some time, depending on how many worlds your vServer should provide. Have a little patience.

The good thing is that you only have to do everything we have done so far once.

If there are updates that Tivoli Cloud provides, it will happen automatically.

Set up a Tivoli Cloud world server on DigitalOcean

5. Firewall Settings

Well, safety is important. Your vServer has a strong firewall setting. However, to make your worlds accessible to visitors, we need to open some ports of your vServer. How to do that, I will show you now. It is done quickly.

Important

Do not delete the default port 22 settings. If you do, your vServer will no longer be accessible via the SFTP client.

With this chapter completed
85%
1

Go to your DigitalOcean Dashboard and click on ‘Networking’ in the left menu column, then click on ‘Firewalls’. Finally hit ‘Create Firewall’.

2

Click New Rule, select Custom, select TCP, and enter 40100-40110 for Ports.

Click New Rule again, select Custom, select UDP, and enter 48000-48010 for Ports.

Important note! These settings are for 1 world. If you have 2 worlds, change the TCP to “40100-40120” and UDP to “48000-48020”. If you have more worlds increase the value by 10.

Set up a Tivoli Cloud world server on DigitalOcean

6. Configure world server

Look, when you have finished this chapter, 100% of the tutorial is done. Good job!

Now we need to connect our worlds on the vServer to Tivoli Cloud. Let’s go!

 

 

Tip

If you have multiple worlds, you must repeat these steps for each world. The URL for each world consists of the IP address of your Droplet (Step 2 picture 8) and the shared TCP port number, e.g. 40100 for the first world. 40110 for the second and so on.

With this chapter completed
100%
1

Open your web browser and enter the IP number of your vServer (step 2 picture 8) in the address line, followed by a colon : and the first TCP port number 40100.

2

Voilà, the setup wizard reports. And you see, you have done everything right so far. Click on ‘Connect your Tivoli world’.

3
A small window opens and waits for an input. Keep this window open, open another browser window and log in with your Tivoli Cloud account on the tivolicloud.com website.
4

If you don’t have a Tivoli Cloud account yet, create one, otherwise sign up.

5

Open the Apps menu at the top right and click on ‘My Worlds’. Then click on the ‘Create new world’ button.

6

Give your world a nice name. It will appear later in the World Explorer. You can also enter a short description of what others can expect in your world. If you already have an image, upload it. You can also do that later. And then click on ‘Add world’.

7

Your world now appears in the ‘My Worlds’ overview. You can see that you are not online yet. Click on ‘Generate a new access token. A small window will pop up. Click again on the button ‘Generate a new access token’.

8

The content of the small popup changes and he token appears. Click on ‘Copy to clipboard’ and close the popup.

9

Return to your other browser window with the wizard open. The token should already appear in the small popup. If it doesn’t, paste it from the clipboard with CTRL-V. Click OK.

10

In the next step, enter your Tivoli Cloud username. This ensures that you have administrator rights in your world.

Next, select who has access to your world. You can also define who can create and modify objects in your world.

You can always change these settings later.

Click on ‘Finish’.

11

Next, we need to make a few more settings. Click on ‘Settings’ at the top of the menu. Then click on ‘Advanced Settings’ and finally on ‘Choose from my worlds’. A window pops up.

12

In this small popup your gerate should appear on Tivoli Cloud set up world. Confirm this with ‘Choose domain’.

Scroll down the page a little.

13

And finally, we need to protect your world server from unauthorized access. Enter a Login name and a strong password . Repeat the password.

Please write Login and Password down. You will need this information if you want to change these world server settings later.

Your world server can always be reached via your vServer IP followed by a colon : and 40100 for the first world, 40110 for the second etc.

When you are done, hit ‘Save and restart’.

Set up a Tivoli Cloud world server on DigitalOcean

7. Hello World

You did it! It wasn’t that hard, right? Now you can use the Tivoli Cloud Client, log in. Your world will now appear in the World Explorer (unless you set it to private).

Thank you for taking the time to read through the tutorial. I hope I was able to make it a little easier for you to start your own world on Tivoli Cloud.

See you soon!

Stay tuned

Next I will show you how to fill your own world with objects in no time.

Leave a Reply