Vnx-install-root fs

From VNX
Jump to: navigation, search

Downloading VNX root filesystems

You can download VNX preconfigured root filesystems from VNX repository at

All root filesystems but Fedora and CentOS ones have a "root" and a "vnx" account with password "xxxx". Fedora and CentOS systems have password "xxxxxx" (a minimum of six chars are needed in this case).

Downloading instructions

You can use two methods to download and install VNX root filesystems:

  • Use the vnx_download_rootfs tools distributed with VNX:
    • Type:
    • cd /usr/share/vnx/filesystems
    • The tool will show you the root filesystems available and allow to choose the ones you want to download and install.
    • Use '-p string' option to show only the root filesystems with 'string' in their name. For example, to see lxc root filesystems type: vnx_download_rootfs -p lxc
    • Use '-s' option to just show the root filesystems available in VNX repository and exit.
    • Use '-l' option if you want the tool to create the 'rootfs_*' soft links used by VNX example scenarios.
    • Use '-r <rootfsfilename>' if you want to download a specific root filesystem in no interactive way.
  • Download them manually form the VNX repository.
    • To uncompress a KVM rootfs use:
    • bunzip2 vnx_rootfs_kvm_...
    • To uncompress an LXC rootfs use:
    • tar --numeric-owner -xzpf vnx_rootfs_lxc_...

IMPORTANT: KVM root filesystems are not updated any time VNX version changes. So, after download and install a rootfs, it is highly recomended to update the VNXACE daemon following the procedure described here.

KVM root fylesystems available

See the current open source filesystems available VNX repository at (see 'old' directory for old outdated filesystems).

For legal reasons we cannot distribute Windows XP, Windows 7, Dynamips or Olive root filesystems. See VNX documentation for detailed recipes to create or use these type of root filesystems.

UML root filesystems

If you plan to use the old UML root filesystems created for VNUML, you have to download the rootfs itself:

cd /usr/share/vnx/filesystems
wget -N
bunzip2 vnx_rootfs_uml_debian-6.0-v024.img.bz2
ln -s vnx_rootfs_uml_debian-6.0-v024.img rootfs_uml
wget -N
bunzip2 vnx_rootfs_uml-n3vlr-0.11-v022.img.bz2
ln -s vnx_rootfs_uml-n3vlr-0.11-v022.img rootfs_light

And the associated kernel:

cd /usr/share/vnx/kernels
tar xfvz linux-um-3.3.8.tgz 
ln -s linux-um-3.3.8-src/linux-um-3.3.8

Optionally, set the link to make this kernel the default one:

ln -s linux-um-3.3.8 linux

Naming convention

Root filesystems names follow this format:



  • <virtplatform>: the virtualization platform the root filesystem was created for (kvm, uml, etc).
  • <osname>: the name of the operating system (or distribution in the case of Linux). Ej: ubuntu, freebsd, win7, etc.
  • <osversion>: the version of the OS.
  • gui: included if the root filesystem has a graphical user interface
  • <rootfsversion>: the version of the rootfs itself.
  • <ext>: the extension of the image. For example: qcow2.


  • vnx_rootfs_kvm-ubuntu-11.04-v022.qcow2 is a VNX root filesystem created with KVM, with an Ubuntu 11.04 without gui installed. The version of the rootfs is v022 and the format is qcow2.