Change on the readme and the port number
authorJosué Rodríguez <jrpc@google.com>
Sat, 22 Jul 2023 03:50:23 +0000 (03:50 +0000)
committerJosué Rodríguez <jrpc@google.com>
Sat, 22 Jul 2023 03:50:23 +0000 (03:50 +0000)
README.md
exporter.sh
monospace.json
vscpweb.go

index a09976420db10d3164b4170a44e45757d04de671..b548a1154fd45b9a9ea12493c55b9c05a1aacf45 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,73 @@
-# VSCPweb
-web for the Virtual SDN Clustered Playground (based on the original VSoRC project)
+## VSCPweb
+
+VSCPweb is a web based software defined networking playground that uses openvswitches (OVS) and a modified version of [mininet](https://github.com/mininet/mininet).
+It is a tool that allows you to:
++ Create different OVS topologies
++ Connect SDN controllers to the virtual network
++ Use linux namespace based lightweight containers as hosts or servers in the network
++ Monitor the health of all of the worker servers
++ Have CLI access to all of the hosts of the virtual network
++ Have CLI access to mininet
+
+## Table of Contents
+
+* Introduction: #introduction
+* Installation: #installation
+* Usage: #usage
+* Contributing: #contributing
+* License: #license
+
+## Introduction
+
+VSCPweb is a web based network simulator that can be used to learn about and experiment with different network topologies and configurations. It is a valuable tool for anyone who wants to learn more about networking or who needs to test out new network configurations.
+
+VSCPweb is made with golang and htmx. It uses openvswitches as the underlying network virtualization layer. This allows VSCPweb to create realistic and scalable network simulations.
+
+## Installation
+
+To install VSCPweb, you will need to have the following dependencies installed:
+
++ golang
++ HTMX
++ mininet
+
+We are making all of the effort possible into later making distributuion packages that are as distro agnostic as possible but we woul likely not work on window or mac versions (you can still install in a linux VM and access the web console with your browser)
+
+Once you have the dependencies installed, you can install VSCPweb by running the following command:
+
+```
+THIS IS NOT READY YET
+```
+
+## Usage
+
+To start VSCPweb, run the following command:
+
+```
+vscpweb
+```
+
+VSCPweb will start a web server on port 8080. You can access the VSCPweb interface at http://localhost:8080.
+
+## Contributing
+
+VSCPweb is an open source project and we welcome contributions from everyone. If you find a bug or have an idea for a new feature, please open an issue or submit a pull request.
+
+## Demo
+
+We plan to have a small limited demo running in https://vscp.josue.xyz but it is not yet public due to the extent of control that vscp can excert over the host system.
+
+## License
+
+VSCPweb is licensed under the GPLv3 License.
++ The GPLv3 license is published by the Free Software Foundation (FSF).
++ The GPLv3 license is version 3 of the GNU General Public License (GPL).
++ The GPLv3 license is a copyleft license.
++ The GPLv3 license prohibits patent claims on the software.
++ The GPLv3 license has stronger copyleft provisions than the GPLv2 license.
++ The GPLv3 license prohibits the use of DRM technologies in the software.
+See the LICENSE file for more information.
+
+## Contact
+
+If you have any questions or concerns, please contact leave an issue on GitHub.
\ No newline at end of file
index 284cc7787b233531c54f37736502ca4d8e03523f..360cdfbc46dd9fc8d8aa6637501c57e7af7bbdd4 100755 (executable)
@@ -2,6 +2,7 @@
 #
 #
 #This is a bit of a setup to export the server
-export port=8000
-export API_SERVICE="${port}-${HOSTNAME}.cluster-lknrrkkitbcdsvoir6wqg4mwt6.cloudworkstations.dev"
+export port=8001
+#export API_SERVICE="${port}-${HOSTNAME}.cluster-lknrrkkitbcdsvoir6wqg4mwt6.cloudworkstations.dev"
+export API_SERVICE="${port}-${WEB_HOST}"
 echo $API_SERVICE
index 610b206ed00b2693ef7af729e2584c9fc5b397ce..2b03351e01cd5219d07c17858b092be155815860 100644 (file)
@@ -1,7 +1,7 @@
 {
     "previews": [
       {
-        "command": ["go","run","vscpweb.go"],
+        "command": ["./getter.sh;","go","run","vscpweb.go"],
         "id": "web",
         "manager": "web"
       }
index 23a07ab6cd6a8b914d258254b17eb393485ceafa..47e3479304bb429b2be7178dfe8fab04836afc6f 100644 (file)
@@ -23,7 +23,7 @@ func main() {
        s := CreateNewServer()
        s.MountHandlers()
        //staring up the server:
-       http.ListenAndServe(":8000", s.Router)
+       http.ListenAndServe(":8001", s.Router)
 }
 
 type server struct {