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:
- Ubuntu Linux 64bit OS (14.04/15.04/16.04)
- at least 4GB memory
- at least 16GB disk size
Ensure sources.list integrity then install dependency:
sudo apt-get update sudo apt-get install python-pip libpython-dev libssl-dev libaio-dev
Upgrade pip and install setuptools:
sudo pip install --upgrade pip sudo pip install setuptools
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
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
Infrasim Service Version:
sudo infrasim version
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
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