From 330e7974a09b1bd3b9c1902fed3ac9f9d48b3f2e Mon Sep 17 00:00:00 2001
From: asaroyan <alexsaroyan@gmail.com>
Date: Tue, 1 Oct 2024 14:18:18 -0700
Subject: [PATCH] Create using-netris-cloudsim.rst (#264)

---
 try-learn/using-netris-cloudsim.rst | 60 +++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 try-learn/using-netris-cloudsim.rst

diff --git a/try-learn/using-netris-cloudsim.rst b/try-learn/using-netris-cloudsim.rst
new file mode 100644
index 000000000..f9dcd58bf
--- /dev/null
+++ b/try-learn/using-netris-cloudsim.rst
@@ -0,0 +1,60 @@
+==================================================
+Netris Test Controller & Infrastructure Simulation
+==================================================
+
+This document provides general tips and tricks for using the Netris test controller and Netris infrastructure simulation. Please refer to individual scenarios in this section to experiment around a specific use case.
+
+Once your Try & Learn through Netris Infrastructure Simulation platform is approved you will receive credentials for accessing a Netris controller with a trial license hosted in Netris Infrastructure Simulation platform.
+
+Controller FQDN: example-ctl.netris.dev
+Password: NetrisProvidedPassword
+
+
+Web Console
+===========
+
+Navigate your browser to the Controller FQDN then use 
+username: netris
+password: <NetrisProvidedPassword>
+
+SSH
+===
+
+Controller initialization modules and simulation control packages are installed on the Netris controller server.
+
+Connect to the controller server using ssh. Username: ubuntu Password: <NetrisProvidedPassword>
+
+.. code-block:: shell-session
+
+ ssh ubuntu@<Controller FQDN>
+
+
+Netris Init Modules
+===================
+
+Netris init modules are designed to generate Inventory, IPAM, and Topology data based on simple arguments. Most init modules are written using Terraform/HCL. 
+
+Netris test environment may come with a module that is relevant to your use case. If you can't find the right module for your use case, please contact your SA (Solutions Architect) 
+
+Init modules are stored in the ``/home/ubuntu/netris-init/`` directory.
+
+Each module is stored in its own subdirectory. To use a module 'cd' to the appropriate subdirectory, review ``terraform.tfvars`` file, make changes to the arguments if needed, and save.
+
+Execute ``tofu-apply`` or ``tofu-destroy`` in the init module subdirectory to apply/destroy the Netris controller configuration.
+
+Start/Stop a Simulation
+=======================
+
+Once the topology blueprint, Inventory, and IPAM data are created in Netris -- basically, Netris controller is describing an infrastructure - you can start its simulation.
+
+Go to:
+
+.. code-block:: shell-session
+
+ cd /home/ubuntu/netris-cloudsim
+
+Execute ``pulumi up`` or ``pulumi destroy`` to start/stop a simulation of what's described in the Netris Controller
+
+
+
+