readne

4 years ago · 5844b51401
1 changed files with 203 additions and 1 deletions
--- a/README.md
+++ b/README.md
@ -1,2 +1,204 @@
-# venus-client
+
+
+<img align="right" width="300" height="300" src="https://git.swarmlab.io:3000/zeus/swarmlab-hybrid/raw/branch/master/docs/images/hybrid-1.png">
+
+# Swarmlab Venus
+
+### **Welcome to Swarmlab.io** <br>
+
+## Swarmlab-venus Network Virtualization
+### on-demand network environments
+
+### private - public - hybrid <br>
+
+# on-demand sandbox environments
+
+   
+
+  *  Virtual Labroom
+  *  Virtual Classroom
+  * Proof-of-Concept (POC)
+<br>
+### Table of contents
+  
+1. [Features](#introduction)
+2. [System requirements ](#systemrequirements)
+3. [Prerequisites](#prerequisites)
+4. [Installation](#installation)
+5. [More info](#moreinfo)
+
+<br>
+
+### <a name="introduction"></a>
+## <b>Swarmlab VEnus</b> is Swarmlabs hybrid younger, more -network virtual- tech savvy brother.  
+
+Swarmlab venus provides the user with the unique abillity to create **Network Virtualization** and use them to project as  Virtual Classroom, POC expanding you system or the simple swarmlab Labrooms to full-blown system. An all of that <b>using onlly the browser</b> of their system.
+  
+## Why?
+
+Ever imagined having a network perivallon gia na dokimaseis things me tous simfitites sou etsi just for fun as you ar in a labroom  in the University from the comfort of your livingroom?  
+
+Ever created a service that you would like to test on a real-world network?  
+
+Ever designed an Labroom/application you would like to distribute to your students/applications?  
+
+Swarmlab venus comes to bridge the gap between you, you network/computer, the coder/developer of a service and the and user and at the same time meet the needs for a real-world testing environment.   
+
+With venus you can now as part of the cloud work <b>independantly</b> but also stay <b>connected</b>.  
+The venus format allows us to utilize the power of Swarmlab itself but also combine it with the practiaclly unlimited computing of our own machines.
+
+## How?
+How does Swarmlab Venus differ from Swarmlab Hybrid? Well...den to kanei apla to kanei extend! me to nevus mporeis na dimiourgissis ta save network me tous beteiligte pou theleis kai na diamirasis ta labrooms h apps pou exeis ftiaxei me to hubrid. save kai just with one click, etsi for fun, fir learn or for POC  
+Easy enough right? But what does that mean in practice?  
+Well for us it means a couple million more lines of code. For you it means a few more installation steps and the newfound access to YOUR OWN RESOURCES!
+
+You will be connected to the net pou tha dimioyrgissis proskalontas toys summetexontes pou theleis kai na  you will be able to use your own storage(move files around, delete/copy etc),your own networking and computational power(cpu/graphics etc) and create a system exactly the way you need it.  
+
+This way you will be able to :
+- <b>create</b> images for testing.  
+- <b>Run</b> them using docker.  
+- <b>Share</b> them for others to use and develop.  
+- Finally <b>browse the cloud</b> for shared images to <b>integrate</b> into your project and make it even better.  
+
+
+
+## Venus vs Hybrid in a nutshell
+
+### Venus
+
+- Create Networks (VPN)
+- Connect multiple users through that network.
+
+
+### Hybrid
+- Create Labrooms/Applications
+- Run and manage said rooms and application
+- create once - scale up or down without rebuilding
+- Connect multiple computers through a network.
+- Move Labs between environments
+- Create your own labs 
+- open source barebone -> <b>Share them with your friends</b>
+
+
+### In any case students can:  
+- join the created labrooms according to their interrests
+- run the evailable labs at will
+- create their own rooms for exercising  
+
+
+## System requirements<a name="systemrequirements"></a>
+  
+  
+**Before** you create and configure a hybrid deployment using the swarmlab-agent client, your Local Machines need to meet certain requirements.
+  
+
+> If you don't meet those requirements, you won't be able to complete the steps within the swarmlab-agent client and you won't be able to configure a network deployment between your Local Enviroment and Swarmlab Online Enviroment.
+   
+
+- A Linux Server (Virtual or Physical) 	
+ - You must have super user privileges (root/sudo)
+- Docker Engine- Community version 18 or later is required. 	
+ -  Docker Engine is supported on x86_64 (or amd64), armhf, and arm64 architectures.
+- RAM
+ - Absolute minimum to run the daemon and some very light containers - 512MB
+ - Minimum for “comfortable” usage – 2GB
+- CPU
+ - Minimum: 2
+ - Recommended 4+
+- Disk Space
+ - 10 GB for internal requirements.
+ - The amount of additional disk space soloemnly depends on you intended use.
+
+:warning: Since Docker uses hypervisor the host NEEDS TO HAVE VIRTUALIZATION ENABLED!
+
+
+ 
+
+## Prerequisites<a name="prerequisites"></a>
+
+* node version >15
+
+  ```sh
+  curl -sL https://deb.nodesource.com/setup_15.x | sudo -E bash -
+  sudo apt-get install -y nodejs
+  ```
+* docker 
+
+  ```sh
+  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
+  sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
+  sudo apt update
+  sudo apt install -y docker-ce
+  sudo usermod -aG docker [USERNAME] # Please replace [USERNAME] with the user you want to run docker on
+  ```
+
+:information_source: for kali specifically please visit the following link to install docker. 
+
+https://linuxhint.com/install_docker_kali_linux/
+
+
+* docker-compose
+
+  ```sh
+  sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
+  sudo chmod +x /usr/local/bin/docker-compose
+  sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
+  ```
+* pm2
+
+  ```sh
+  sudo npm install -g pm2
+  ```
+* wireguard
+
+  ```sh
+  sudo apt install wireguard jq
+
+  ```
+<br>
+###  **MORE Installation info here**
+
+
+[install docker](http://docs.swarmlab.io/SwarmLab-HowTos/labs/Howtos/docker/install-docker.adoc.html)
+
+[Install Wireguard](http://docs.swarmlab.io/SwarmLab-HowTos/labs/Howtos/wg/install-wg.adoc.html)
+
+[Install Node](http://docs.swarmlab.io/SwarmLab-HowTos/labs/Howtos/nodejs/install-nodejs.adoc.html)
+
+
+<br>
+## Installation<a name="installation"></a>
+  
+### for *nix
+  
+
+- Clone the repo
+
+   ```sh
+   git clone --recurse-submodules https://git.swarmlab.io:3000/swarmlab/venus-client.git
+   ```
+
+- Install it!
+
+   ```sh
+   cd venus-client
+   ./install.sh  <-- run it without root privileges
+   ```
+
+- Open URL __http://localhost:8085/index.html__ in browser 
+ - Get a Swarmlab account. 
+
+
+
+### for windows or if you wish to keep the environment contained
+
+You can find ready to run VM images <a href="https://uniwagr-my.sharepoint.com/:u:/g/personal/ice19390012_uniwa_gr/EbhjQIeiDeNFkfkSBWczRggBcJq2Pv6lAJs-NKkT4hXg-g?e=0VC0xa" target="_blank">here</a>.
+
+And instructions on how to use them <a href="https://git.swarmlab.io:3000/zeus/swarmlab-hybrid/src/branch/master/docs/windows_use_vm.md">here</a>.
+
+:information_source: Default password: swarmlab
+
+PLEASE CHANGE PASSWORD IMEDIATELLY AFTER FIRST LAUNCH!!!
+
+