MINCS installation - mhiramat/mincs GitHub Wiki
Installation HOWTO
As written in README.md, install.sh is all what you need. However, there are some options which is not clearly explained (yet). So, here shows what each options does.
Normal Install
See README.md. ./install.sh
will install MINCS under /usr/local, and PREFIX=/usr ./install.sh
will install it under /usr.
Minimum Install
To install minimum set of scripts, you can specify --minimum option to install.sh
With minimum install option, only minc
command without netns/qemu/etc support is installed. Thus, it is very small (>20KB), but feature is limited.
Ermine Install
With --ermine, install.sh
will kick ermine-breeder before install. Note that it may build only host-arch ermine. Anyway, this option is just for build ermine while installation.
So before running install.sh
, you can manually build ermine images to install, because install.sh
installs all existing ermine images under libexec/ermine/ without any option.
Uninstall MINCS
To uninstall minc scripts, you can pass --uninstall option. This stops mincbr0 and remove iptables rules too.
Note that if you installed MINCS under /usr or any other directory, you need to pass same PREFIX= setting to install.sh; e.g. PREFIX=/usr ./install.sh --uninstall
will uninstall(remove) MINCS from /usr, instead of /usr/local.
Stop MINCS Network Bridge
install.sh
also supports stopping mincbr0 network bridge and iptable rules. If you would NOT like to keep it on your network, you can stop it by ./install.sh --stop-mincbr
.
Installation Size
type | size |
---|---|
normal | ~80KB |
minimal | ~32KB |
ermine(all) | ~30MB |