sherysheng / infrasim-compute Goto Github PK

Infrasim package can be installed in any physical machine or virtual machines hosted by Virtualbox, ESXi, Parallel Desktop or cloud provider like AWS, Linode and etc.

The basic installation system requirements are:

1. Ubuntu Linux 64bit OS (14.04/15.04/16.04)
2. at least 4GB memory
3. at least 16GB disk size

1. Ensure sources.list integrity then install dependency:

   sudo apt-get update
   sudo apt-get install python-pip libpython-dev libssl-dev libaio-dev
   

2. Upgrade pip and install setuptools:

   sudo pip install --upgrade pip
   sudo pip install setuptools
   

3. Two ways to install infrasim:

   • install infrasim from source code:

     git clone https://github.com/InfraSIM/infrasim-compute.git
     
     cd infrasim-compute
     
     sudo pip install -r requirements.txt
     
     sudo python setup.py install
     

   • install infrasim from python library:

     sudo pip install infrasim-compute
     

1. Initialization (you need do it once)

   sudo infrasim init
   

   Optional arguments:

   • -s, --skip-installation Ignore qemu/openipmi package installation
   • -f, --force Destroy existing Nodes
   • -c [CONFIG_FILE], --config-file [CONFIG_FILE] Use customized yaml file for the default node
   • -t [TYPE], --type [TYPE] Render specified node type for the default node

2. Infrasim Service Version:

   sudo infrasim version
   

3. Infrasim Node Configuration Management:

   • Add configuration mapping to a node

   sudo infrasim config add <node name> <config path>
   

   • Delete configuration mapping of a node

   sudo infrasim config delete <node name>
   

   • Update configuration mapping of a node

   sudo infrasim config update <node name> <config path>
   

   • Edit configuration mapping with environment editor

   sudo infrasim config edit
   

   • List all configuration mappings

   sudo infrasim config list
   

4. Infrasim Service Node Commands

   • Start a node

   sudo infrasim node start [node name]
   

   • Check node status

   sudo infrasim node status [node name]
   

   • Stop a node

   sudo infrasim node stop [node name]
   

   • Restart a node

   sudo infrasim node restart [node name]
   

   • Stop a node and detroy its runtime workspace

   sudo infrasim node destroy [node name]
   

   The default node configuration is already added to configuration mapping during infrasim init. In node commands, argument [node name] is optional. If it's not specified, it's treated as node "default".

Notice: You can use VNC to access the emulated legacy hardware, the default VNC port is 5901