Merge pull request #48 from KorelU/GNS3-Remote-Server

Doc: Using DENT in GNS3 with a Remote Server
dentproject · Jun 12, 2024 · c4d98dd · c4d98dd
2 parents 5d7ddd2 + 70b41c9
commit c4d98dd
Show file tree

Hide file tree

Showing 13 changed files with 134 additions and 2 deletions.
diff --git a/Images/ImagesForGNS3/ImageEightOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageEightOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageElevenOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageElevenOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageFiveOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageFiveOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageFourOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageFourOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageNineOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageNineOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageOneOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageOneOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageSevenOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageSevenOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageSixOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageSixOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageTenOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageTenOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageThreeOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageThreeOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageTwelveOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageTwelveOfRemoteServerUsage.png
diff --git a/Images/ImagesForGNS3/ImageTwoOfRemoteServerUsage.png b/Images/ImagesForGNS3/ImageTwoOfRemoteServerUsage.png
diff --git a/Installation/Server.md b/Installation/Server.md
@@ -5,6 +5,138 @@ nav_order: 4
 layout: default
 ---
 
-## Using a remote server
+## Using a Remote Server
 
-(TODO)
+### Introduction
+
+In this example, we will show how to run the GNS3 VM on a remote server.
+
+Running the GNS3 VM on a remote server
+is useful when you need more resources for more extensive network topologies.
+
+### 1. Download DENT NOS Files
+
+To run GNS3 on a remote server, first install the
+DENT GNS3 appliance file and the disk
+image for the dent Virtual Machine. You can find the required files
+here: **[DENT Image and gns3a file](https://1drv.ms/f/s!AkTUp6FU_dW0gt4dlXatZOhyr8boog?e=Ltqpa5.)**
+
+![ImageOneOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageOneOfRemoteServerUsage.png)
+
+### 2. Download the GNS3 VM for the Server
+
+On the Remote Server, install and load
+the GNS3 VM associated with the Server, using VMware or another hypervisor.
+
+![ImageTwoOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageTwoOfRemoteServerUsage.png)
+
+Run the GNS3 VM and make sure the
+network settings on the GNS3 VM are based on the Server's network.
+Your local PC must be able to reach the server to be able to
+use GNS3 with a Remote Server.
+In VMware, this can be done by ensuring the GNS3 VM is Bridged.
+
+![ImageThreeOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageThreeOfRemoteServerUsage.png)
+
+### 3. Ensure PC is connected to Server
+
+**NOTE: Use A VPN if Exposed to the Internet!**
+
+It is highly recommended to use a VPN if your
+remote server is exposed to
+the internet. The GNS3 website has a few recommended free VPNs:
+[VPNS](https://docs.gns3.com/docs/getting-started/installation/remote-server/#why-a-vpn).
+Install one of the VPNs before booting GNS3 on your remote server
+and attempting to access it.
+
+Once GNS3 is finished booting on the remote server
+it may look like the following:
+
+![ImageFourOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageFourOfRemoteServerUsage.png)
+
+To test you are able to reach the server a simple ping command will do:
+
+```
+C:\Users\Thinkpad>ping 172.28.64.228
+
+Pinging 172.28.64.228 with 32 bytes of data:
+Reply from 172.28.64.228: bytes=32 time<1ms TTL=64
+Reply from 172.28.64.2286: bytes=32 time<1ms TTL=64
+Reply from 172.28.64.228: bytes=32 time<1ms TTL=64
+Reply from 172.28.64.228: bytes=32 time<1ms TTL=64
+
+Ping statistics for 172.28.64.228:
+Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
+Approximate round trip times in milli-seconds:
+Minimum = 15ms, Maximum = 24ms, Average = 20ms
+```
+
+### 4. Add new Server to GNS3
+
+Now Open GNS3, go to Edit -> Preferences -> Server -> Remote Server
+and select the 'Add' option. Proceed to pick a "Name" and include
+the Remote Server's IP Address and the port listed.
+You may also enable authentication by including a username
+and password.
+
+![ImageFiveOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageFiveOfRemoteServerUsage.png)
+
+When ready, click 'OK' to see an Additional Server Listed under Server Summary.
+
+![ImageSixOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageSixOfRemoteServerUsage.png)
+
+### 5. Import new Appliance on Remote Server
+
+Now, import the appliance as usual.
+Go to File -> Import Appliance and select the appliance file.
+In this scenario, we will choose one of the previously downloaded
+files, “DENT - 3.2”.
+
+![ImageSevenOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageSevenOfRemoteServerUsage.png)
+
+Then select the remote server option from the Server Type and
+select the newly specified Server.
+
+![ImageEightOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageEightOfRemoteServerUsage.png)
+
+Hit next. The QEMU binary that we will run in this appliance is
+as /bin/qemu-system-x86_64(v4.2.1).
+
+![ImageNineOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageNineOfRemoteServerUsage.png)
+
+Import the DENT image file by selecting again
+one of the previously downloaded files, “dent-vm.qcow2” and clicking
+import.
+
+**Wait for the upload to finish. It may take some time.**
+
+Once the upload is finished, you may click next and yes to
+install DENT
+
+![ImageTenOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageTenOfRemoteServerUsage.png)
+
+---
+
+## Completion
+
+Once Installed, you may now use the DENT appliance in GNS3 on
+the remote Server.
+
+The example below demonstrates three dent appliances connecting to
+each other
+
+![ImageElevenOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageElevenOfRemoteServerUsage.png)
+
+After starting the simulation, you may right-click on any DENT
+appliance and select _console_ to log-in.
+
+**The default credentials are:**
+
+- **Localhost login: root**
+- **Password: onl**
+
+![ImageTwelveOfRemoteServerUsage.png](../Images/ImagesForGNS3/ImageTwelveOfRemoteServerUsage.png)
+
+### You have now successfully set up DENT in GNS3 with a remote server
+
+For more information, visit [dent.dev](https://dent.dev).