Skip to content

Commit df20da5

Browse files
author
Bryan Fu
authored
Merge pull request #14 from XiaowenJiang/docs-infrasim-compute
Add OVA/BOX Stuff in getting start chapter
2 parents e00bb30 + fac20fc commit df20da5

2 files changed

Lines changed: 84 additions & 10 deletions

File tree

‎docs/_static/networking_bridge_multiple.PNG‎

-21.1 KB
Loading

‎docs/get_start.rst‎

Lines changed: 84 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,13 @@ Command interfaces
2626

2727
sudo infrasim-main stop
2828

29+
#. Start IPMI Console::
30+
31+
sudo ipmi-console start
32+
33+
#. Stop IPMI Console::
34+
35+
sudo ipmi-console stop
2936

3037
Interface to access virtual server
3138
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -77,17 +84,84 @@ Interface to access virtual server
7784
Current Virtual PDU implementation only supports running entire virutal infrastructure on VMWare ESXi because it only supports functionality of simulating power control chassis through VMWare SDK.
7885

7986

80-
Setup a mini InfraSIM Virtual infrastructure on ESXi
87+
Setup an InfraSIM Virtual Server on ESXi
8188
---------------------------------------------------------
8289

83-
Combining virtual server, virtual PDU and virtual switch, you can quickly deploy a small virtual infrastructure system. Here's a expamle to explicitly list to to setup one small virtual rack with 2 Dell R630 nodes and 1 virtual PDU on VMWare ESXi:
90+
To setup an InfraSIM Server on ESXi, you should have an OVA with necessary environment prepared. You can consult the InfraSIM team to get the image or build one with the `packer build image <https://github.com/InfraSIM/tools/blob/master/packer/README.md>`_. Below are the steps to deploy and run InfraSIM on ESXi:
91+
92+
#. Get ESXi environment prepared by following `instruction <how_to.html#how-to-install-vmware-esxi-on-physical-server>`_
93+
#. Spin up a virtual machine by choosing "Deploy OVF Template". Specify the URL of the OVA image.
94+
#. Map the networks used in the OVA. The networking configured inside OVA is multi-bridge mode:
95+
96+
* .. image:: _static/networking_bridge_multiple.PNG
97+
:align: center
98+
99+
#. Modify YAML configuration file as you need. The default configuration for OVA is `infrasim.yml <https://github.com/InfraSIM/tools/blob/master/packer/scripts/infrasim.yml>`_. The path is::
100+
101+
/usr/local/infrasim/etc/infrasim.yml
102+
103+
#. Kick off all InfraSIM `services <get_start.html#command-interfaces>`_.
104+
105+
#. Done, enjoy this virtual server!
106+
107+
.. note:: No need to run **infrasim-init** because it's already done during image build.
108+
109+
Configuration for OVA can be refered on `Packer OVA Configuration <https://github.com/InfraSIM/tools/blob/master/packer/infrasim-vmware.json>`_. Below are the major parameters::
110+
111+
Disk Size: 40G
112+
Memory: 8G
113+
Number of CPUs: 2
114+
Number of NICs: 4
115+
Type of NICs: VMXNET 3
116+
NIC0:
117+
Name: ens160
118+
networkName: ADMIN
119+
NIC1:
120+
Name: ens192
121+
networkName: BMC
122+
NIC2:
123+
Name: ens224
124+
networkName: CONTROL
125+
Promiscuous Mode: on
126+
NIC3:
127+
Name: ens256
128+
networkName: DATA
129+
Promiscuous Mode: on
130+
131+
Setup an InfraSIM Virtual Server in VirtualBox
132+
---------------------------------------------------------
84133

85-
#. Get ESXi environment prepared by following `instruction <how_to.html#how-to-install-vmware-esxi-on-physical-server>`_
86-
#. Spin up 3 virtual machines with satisfying `resrouces <installation.html#resource-requirement>`_ - 2 for hosting virtual Dell servers and the other one for virtual PDU
87-
#. Configure virtual switch to compose desired data network topology. `Virtual server networking <configuration.html#networking>`_ only covers virtual nodes networking; for configuring "outside network", you need to refer to VMWare ESXi manual in order to properly connect these 3 virtual machines together.
88-
#. Install InfraSIM application by following `intallation guide <installation.html#installation>`_
89-
#. Modify YAML configuration file as specified in `Configuration file <configuration.html#virtual-server-configuration-file>`_
90-
#. Kick off all InfraSIM `services <get_start.html#command-interfaces>`_
91-
#. Done, enjoy this virtual stack!
134+
Virtualbox is available on multiple platforms. To get an InfraSIM BOX image, refer to `packer build image <https://github.com/InfraSIM/tools/blob/master/packer/README.md>`_
135+
136+
#. Install virtualbox on the host.
137+
#. Create a directory for the VM and move the BOX image along with `Vagrantfile <https://github.com/InfraSIM/tools/blob/master/packer/Vagrantfile>`_ under the directory.
138+
#. CD to the directory and run commands::
139+
140+
vagrant box add --name infrasim-compute <YOUR_BOX_IMAGE>
141+
vagrant up
142+
vagrant ssh
143+
144+
#. Modify YML configuration if you need.
145+
#. Start InfraSIM `services <get_start.html#command-interfaces>`_. No **"infrasim-init"** needed.
146+
147+
BOX configuration can be refered on `Packer BOX Configuration <https://github.com/InfraSIM/tools/blob/master/packer/infrasim-box.json>`_ and `Vagrantfile <https://github.com/InfraSIM/tools/blob/master/packer/Vagrantfile>`_. The major parameters are::
148+
149+
Disk Size: 40G
150+
Memory: 5G
151+
Number of CPUs: 2
152+
Number of NICs: 4
153+
NIC0:
154+
Name: enp0s3
155+
Network Adapter: NAT
156+
NIC1:
157+
Name: enp0s8
158+
Network Adapter: Internal Network
159+
NIC2:
160+
Name: enp0s9
161+
Network Adapter: Internal Network
162+
Promiscuous Mode: on
163+
NIC3:
164+
Name: enp0s10
165+
Network Adapter: Bridged Adapter
166+
Promiscuous Mode: on
92167

93-
.. image:: _static/vrack.png

0 commit comments

Comments
 (0)