Difference between revisions of "Vnx-install-root fs"

From VNX
Jump to: navigation, search
(Downloading instructions)
(Downloading instructions)
Line 15: Line 15:
 
  vnx_download_rootfs
 
  vnx_download_rootfs
 
<li>The tool will show you the root filesystems available and allow to choose the ones you want to download and install.</li>
 
<li>The tool will show you the root filesystems available and allow to choose the ones you want to download and install.</li>
<li>Use '-p string' option to show only the root filesystems with 'string' in their name. For example</li>
+
<li>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</li>
 
<li>Use '-s' option to show the root filesystems available in VNX repository.</li>
 
<li>Use '-s' option to show the root filesystems available in VNX repository.</li>
 
<li>Use '-l' option if you want the tool to create the 'rootfs_*' soft links used by VNX example scenarios.</li>
 
<li>Use '-l' option if you want the tool to create the 'rootfs_*' soft links used by VNX example scenarios.</li>

Revision as of 16:53, 19 February 2018

Downloading VNX root filesystems

You can download VNX preconfigured root filesystems from VNX repository at http://vnx.dit.upm.es/vnx/filesystems.

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
      vnx_download_rootfs
      
    • 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 show the root filesystems available in VNX repository.
    • 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 http://vnx.dit.upm.es/vnx/filesystems (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 http://vnx.dit.upm.es/download/vnx/filesystems/vnx_rootfs_uml_debian-6.0-v024.img.bz2
bunzip2 vnx_rootfs_uml_debian-6.0-v024.img.bz2
ln -s vnx_rootfs_uml_debian-6.0-v024.img rootfs_uml
wget -N http://vnx.dit.upm.es/download/vnx/filesystems/vnx_rootfs_uml-n3vlr-0.11-v022.img.bz2
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
wget http://vnx.dit.upm.es/vnx/kernels/linux-um-3.3.8.tgz
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:

vnx_rootfs_<virtplatform>_<osname>-<osversion>-[gui-]<rootfsversion>.<ext>

being:

  • <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.

Example:

  • 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.