+++ /dev/null
-##
-# Copyright 2016-2019 VMware Inc.
-# This file is part of ETSI OSM
-# All Rights Reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License"); you may
-# not use this file except in compliance with the License. You may obtain
-# a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-# License for the specific language governing permissions and limitations
-# under the License.
-#
-# For those usages not covered by the Apache License, Version 2.0 please
-# contact: osslegalrouting@vmware.com
-##
-
-
-This README file explains how to use OVF Converter Tool to generate OVF file from .qcow2, .img (raw) disk images.
-
-CONTENTS OF THIS FILE
-=====================
-This readme file contains the following sections:
-
-o Introduction
-o Tool Requirements
-o Installation
-o Usage
-o Trouble shooting
-o Release History
-
-
-Introduction
-==================
-OVF Converter Tool is a Command Line Interface (CLI) basically designed to generate OVF files from disk image such as
-.qcow2, and .img (raw format) which are other than .vmdk. Given a path to .qcow2 image this tool can generate .vmdk
-and .ovf files.
-
-The user can optionally specify name and location of ovf file. Also, one can use command line options to give disk
-size (GB), memory (MB), number of cpus, OS type, disk controller required for VM which will get deployed using
-generated OVF.
-
-Generated OVF file can be used to deploy VM in Vmware vSphere or vCloud Director.
-
-Note- Currently this tool supports only Ubuntu platform.
-
-
-Tool Requirements
-==================
-
-This tool requires the following software package:
-o apt-get package manager
-o qemu-utils
-o python 2.7
-o python-lxml
-o libxml2-dev
-o libxslt-dev
-o python-dev
-o python-pip
-
-Install.sh script in this folder will install all of these software packages.
-
-
-Installation
-==================
-User needs root privileges to install OVF Generator Tool.
-Follow below setups for installation of OVF Converter Tool.
-1. Make install.sh script in this folder executable by running below command
- chmod a+x install.sh
-2. Run install.sh script as:
- ./install.sh
-
- Sample output -
- #################################################################
- ##### Installing Require Packages #####
- #################################################################
- Hit:1 http://us.archive.ubuntu.com/ubuntu xenial InRelease
- Get:2 http://us.archive.ubuntu.com/ubuntu xenial-updates InRelease [102 kB]
- Get:3 http://security.ubuntu.com/ubuntu xenial-security InRelease [102 kB]
- Get:4 http://us.archive.ubuntu.com/ubuntu xenial-backports InRelease [102 kB]
- Fetched 306 kB in 1s (286 kB/s)
- Reading package lists... Done
- Reading package lists... Done
- Building dependency tree
- Reading state information... Done
- Note, selecting 'libxslt1-dev' instead of 'libxslt-dev'
- libxslt1-dev is already the newest version (1.1.28-2.1).
- python-dev is already the newest version (2.7.11-1).
- python-lxml is already the newest version (3.5.0-1build1).
- libxml2-dev is already the newest version (2.9.3+dfsg1-1ubuntu0.1).
-
- t version (1:2.5+dfsg-5ubuntu10.6).
- 0 upgraded, 0 newly installed, 0 to remove and 72 not upgraded.
-
- #################################################################
- ##### Done #####
- #################################################################
- root@ubuntu:/home/vmware/OVF_converter#
- root@ubuntu:/home/vmware/OVF_converter#
-
-3. Now tool is installed at /usr/local/bin and available for all users
-4. User can access commands of OVF Generator Tool as:
- ovf_converter path [output location] [ovf name][memory][cpu][disk][ostype][disk_controller]
-
-
-Usage
-===================
-o Get version of tool as:
-
- Command - ovf_converter -v
- Sample output -
- root@ubuntu:/home/vmware/OVF_converter# ovf_converter -v
- 1.0 - Initial Realse
- root@ubuntu:/home/vmware/OVF_converter#
-
-o See all command line options of tool as:
- Command - ovf_converter -h
- Sample output -
- root@ubuntu:/home/vmware/OVF_converter#
- root@ubuntu:/home/vmware/OVF_converter# ovf_converter -h
- Usage: ovf_converter_cli.py [-h] [-v] [-o OUTPUT_LOCATION] [-n OVF_NAME]
- [-m MEMORY] [-c CPU] [-d DISK] [-s OSTYPE]
- [-dc DISK_CONTROLLER] [--cdrom] [-w 14]
- path
-
- OVF converter to convert .qcow2 or raw image into OVF
-
- positional arguments:
- path absolute path to source image which will get convert
- into ovf
-
- optional arguments:
- -h, --help show this help message and exit
- -v, --version shows version of OVF Converter tool
- -o OUTPUT_LOCATION, --output_location OUTPUT_LOCATION
- location where created OVF will be kept. This location
- should have write access. If not given file will get
- created at source location (optional)
- -n OVF_NAME, --ovf_name OVF_NAME
- name of output ovf file. If not given source image
- name will be used (optional)
- -m MEMORY, --memory MEMORY
- required memory for VM in MB (default 1 GB)(optional)
- -c CPU, --cpu CPU required number of virtual cpus for VM (default 1 cpu)
- (optional)
- -d DISK, --disk DISK required size of disk for VM in GB (default as
- in source disk img) (optional)
- -s OSTYPE, --osType OSTYPE
- required operating system type as specified in user
- document (default os type other 32 bit) (optional)
- -dc DISK_CONTROLLER, --disk_Controller DISK_CONTROLLER
- required disk controller type (default controller SCSI
- with lsilogicsas) (SATA, IDE, Paravirtual, Buslogic,
- lsilogic, lsilogicsas) (optional)
- --cdrom whether to include a cd/dvd device (optional)
- -hw VERSION, --hwversion VERSION
- VMware ESXi hardware family version (optional)
-
-
-o Create OVF file from qcow2 or raw disk image as:
- Command - ovf_converter /home/vmware/centos_ovf/CentOS-7-x86_64-GenericCloud-1503.qcow2 -n centos_qcow2.ovf -m 2048 -c 4 -d 10 -s "Centos 32-bit" -dc "SATA"
- Sample output -
- root@ubuntu:/home/vmware/OVF_converter# ovf_converter /home/vmware/centos_ovf/CentOS-7-x86_64-GenericCloud-1503.qcow2 -n centos_qcow2.ovf -m 2048 -c 4 -d 10
- #### Start OVF conversion ####
- Getting source image information
- Converting source disk image to .vmdk
- .....................................................
- Creating OVF
- Output OVF is at: /home/vmware/centos_ovf/centos_qcow2.ovf
- #### Completed OVF conversion ####
-
-
-Trouble shooting
-==================
-After installation of tool logs will get created at /usr/local/bin/OVF_converter/logs/ovf_converter.log file.
-User can use these logs for debugging or trouble shooting.
-
-
-Release History
-===============
-
-Version 1.0
--------------
-
-Initial release
-
-Version 1.1
--------------
-
-Adds support for cdrom
-
-Version 1.2
--------------
-
-Adds support for hardware version
-Improves progress indicator