From 296f85b6a637a248029621956a771621815aaeda Mon Sep 17 00:00:00 2001 From: Ekaterina Fedorova Date: Tue, 24 Sep 2013 15:03:44 +0400 Subject: [PATCH] Update and upgrade are required Change-Id: Ie113b002251d08e74d4d56638a760286a9dff626 --- src/administrators-guide/pom.xml | 4 + .../src/docbkx/administrators-guide.xml.orig | 956 ------------------ .../src/docbkx/content/installation-guide.xml | 19 +- 3 files changed, 10 insertions(+), 969 deletions(-) delete mode 100644 src/administrators-guide/src/docbkx/administrators-guide.xml.orig diff --git a/src/administrators-guide/pom.xml b/src/administrators-guide/pom.xml index 96ad0aa..fdf1c78 100644 --- a/src/administrators-guide/pom.xml +++ b/src/administrators-guide/pom.xml @@ -38,6 +38,10 @@ + ../style/config.xsl + + ../style/administrators-guide.css + true 100 diff --git a/src/administrators-guide/src/docbkx/administrators-guide.xml.orig b/src/administrators-guide/src/docbkx/administrators-guide.xml.orig deleted file mode 100644 index dcd0aff..0000000 --- a/src/administrators-guide/src/docbkx/administrators-guide.xml.orig +++ /dev/null @@ -1,956 +0,0 @@ - - - - - Murano Administrator's Guide - - - - - - - - - - v0.2 - Murano - 2013-09-09 - - - Copyright details are filled in by the template. Change the value of the - role attribute on the legalnotice element to change the license. - - - - This document is intended for individuals who wish to install and use our product - or intend to contribute. - - - this is a placeholder for the front cover - - - this is a placeholder for the back cover - - - - General Deployment Steps -
- Prepare A Lab For Murano - This section provides basic information about lab's system requirements. It also - contains a description of a test which you may use to check if your hadrware fits - the requirements. To do this, run the test and compare the results with baseline - data provided. -
- Lab Requirements - - Hardware requirements - - - - - - - Criteria - Minimal - Recommended - - - - - CPU - 4 core @ 2.4 GHz - 24 core @ 2.67 GHz - - - RAM - 8 GB - 24 GB or more - - - HDD - 2 x 500 GB (7200 rpm) - 4 x 500 GB (7200 rpm) - - - RAID - Software RAID-1 (use mdadm as it will improve read - performance almost two times) - - Hardware RAID-10 - - - -
- There are a few possible storage configurations except the shown above. All of - them were tested and were working well. - - - - 1x SSD 500+ GB - - - 1x HDD (7200 rpm) 500+ GB and 1x SSD 250+ GB (install the system - onto the HDD and mount the SSD drive to folder where VM images - are) - - - 1x HDD (15000 rpm) 500+ GB - - - - The list of OSes which we used in our lab is shown below. - - OS Requirements - - - - - List - - - - - Ubuntu Server 12.04 LTS - - - -
-
-
- Test Your Lab Host Performance - We have measured time required to boot 1 to 5 instances of Windows system simultaneously. You - can use this data as the baseline to check if your system is fast enough. - - You should use sysprepped images for this test, to simulate VM first boot. - Steps to reproduce test: - - - - Prepare Windows 2012 Standard (with GUI) image in QCOW2 format. Let's assume that its - name is ws-2012-std.qcow2 - - - - Ensure that there is NO KVM PROCESSES on the host. To do this, run - command: - ># ps aux | grep kvm - - - - Make 5 copies of Windows image file: - - ># for i in $(seq 5); do cp ws-2012-std.qcow2 ws-2012-std-$i.qcow2; done - - - - Create script start-vm.sh in the folder with .qcow2 files: - - #!/bin/bash -[ -z $1 ] || echo "VM count not provided!"; exit 1 -for i in $(seq $1); do - echo "Starting VM $i ..." - kvm \ - -m 1024 \ - -drive file=ws-2012-std-$i.qcow2,if=virtio \ - -net user -net nic,model=virtio \ - -nographic \ - -usbdevice tablet \ - -vnc :$i & -done - - - - Start ONE instance with command below (as root) and measure time between VM’s launch - and the moment when Server Manager window appears. To view VM’s desktop, connect with - VNC viewer to your host to VNC screen :1 (port 5901): - - ># ./start-vm.sh 1 - - - - Turn VM off. You may simply kill all KVM processes by - - ># killall kvm - - - - Start FIVE instances with command below (as root) and measure time interval between ALL VM’s - launch and the moment when LAST Server Manager window appears. To view VM’s desktops, - connect with VNC viewer to your host to VNC screens :1 thru :5 (ports 5901-5905): - - ># ./start-vm.sh 5 - - - - Turn VMs off. You may simply kill all KVM processes by - - ># killall kvm - - -
-
- Baseline Bata - The table below provides baseline data which we've got in our - environment. - Avg. Time refers to the lab with recommended - hardware configuration, while Max. Time refers - to minimal hardware configuration. - - - - - - - - - Boot ONE instance - Boot FIVE instances - - - - - - Avg. Time - - - 3m:40s - - - 8m - - - - - Max. Time - - - 5m - - - 20m - - - - - -
-
- Host Optimizations - Default KVM installation could be improved to provide better - performance. - The following optimizations may improve host performance up to 30%: - - - - change default scheduler from - CFQ - to - Deadline - - - - - use - ksm - - - - - use - vhost-net - - - -
-
-
- Install OpenStack - Currently we use Devstack (http://devstack.org/) to - build our lab environment. - - Use Devstack's guide to install single VM OpenStack ( - http://devstack.org/guides/single-vm.html) - - localrc example - - HOST_IP= -FLAT_INTERFACE= -FLOATING_RANGE= - -ADMIN_PASSWORD=swordfish -MYSQL_PASSWORD=swordfish -RABBIT_PASSWORD=swordfish -SERVICE_PASSWORD=swordfish -SERVICE_TOKEN=tokentoken - -ENABLED_SERVICES+=,heat,h-api,h-api-cfn,h-api-cw,h-eng - -# Image's cache is in $TOP_DIR/files -IMAGE_URLS+=",http://fedorapeople.org/groups/heat/prebuilt-jeos-images/F17-x86_64-cfntools.qcow2" - -# /etc/nova/nova.conf -EXTRA_OPTS=(force_config_drive=true libvirt_images_type=qcow2 force_raw_images=false) - -# Logging -SCREEN_LOGDIR=/opt/stack/log/ -LOGFILE=$SCREEN_LOGDIR/stack.sh.log - - - If you need to image builder only, then install only packages required to run - KVM - . - -
-
- Configure OpenStack - New OpenStack installation requires configuration. However, if you are using - Devstack, then it's have been done. - Otherwise, configure your OpenStack before proceed. -
- - - Install Murano Components - Murano Components installation notes are described in Murano developer's guide. Please - consult that document. - - - Prepare Image Builder - Murano requires a Windows Image in QCOW2 format to be builded and uploaded into - Glance. - The easiest way to build Windows image for use with Murano is to build it right on the - host where your OpenStack is installed. -
- Image Builder - The following packages should be installed on any host which will be used to build - Windows Image. -
- Install Required Packages - - Please check that hardware virtualization supported and enabled in - BIOS. - - - Required Packages - - - - - - Package Name - Package Version - - - - - - ipxe-qemu - - - 1.0.0+git-4.d6b0b76-0ubuntu2 - - - - - kvm-ipxe - - - 1.0.0+git-4.d6b0b76-0ubuntu2 - - - - - qemu-kvm - - - 1.4.0+dfsg-1expubuntu4 - - - - - munin-libvirt-plugins - - - 0.0.6-1 - - - - - python-libvirt - - - 1.0.2-0ubuntu11 - - - - - libvirt-bin - - - 1.0.2-0ubuntu11 - - - - - libvirt0 - - - 1.0.2-0ubuntu11 - - - - - munin-libvirt-plugins - - - 0.0.6-1 - - - - - python-libvirt - - - 1.0.2-0ubuntu11 - - - - - virt-goodies - - - 0.4-2 - - - - - virt-manager - - - 0.9.4-2ubuntu3 - - - - - virt-top - - - 1.0.7-1 - - - - - virt-what - - - 1.12-1 - - - - - virtinst - - - 0.600.3-3ubuntu1 - - - - - python - - - 2.7.4-0ubuntu1 - - - - -
- ># apt-get install ipxe-qemu kvm-ipxe qemu-kvm virt-goodies \ - virtinst virt-manager libvirt0 libvirt-bin \ - munin-libvirt-plugins python python-libvirt \ - python-libxml2 python-minimal python-pycurl \ - python-pyorbit python-requests python-six \ - samba samba-common openssh-server virt-top virt-what -
-
- Configure Shared Resource - - Configure samba based share - - ># mkdir -p /opt/samba/share -># chown -R nobody:nogroup /opt/samba/share - - - - Configure samba server (/etc/samba/smb.conf) - - ... -[global] - ... - security = user -... -[share] - comment = Deployment Share - path = /opt/samba/share - browsable = yes - read only = no - create mask = 0755 - guest ok = yes - guest account = nobody -... - - - - Restart services - - ># service smbd restart -># service nmbd restart - - -
-
-
- Additional Software - This section describes additional software which is required to build an Windows - Image. -
- Windows ADK - Windows Assessment and Deployment Kit (ADK) for - Windows® 8 is required to build your own answer files for auto - unattended Windows installation. - You can dowload it from - http://www.microsoft.com/en-us/download/details.aspx?id=30652 - . -
-
- Putty - PuTTY is a useful tool to manage your Linux boxes via SSH. - You can download it from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html - -
-
- Windows Server 2012 ISO image - We use the following Windows installation images: - - - - - - - Windows Version - Image Name - - - - - - Windows Server 2008 R2 - - - 7601.17514.101119-1850_x64fre_server_eval_en-us-GRMSXEVAL_EN_DVD.iso - - - - - - Windows Server 2012 - - - - 9200.16384.WIN8_RTM.120725-1247_X64FRE_SERVER_EVAL_EN-US-HRM_SSS_X64FREE_EN-US_DV5.iso - - - - - - - You may download them using one of the following links: - - - - - - - Windows Version - Download Link - - - - - - Windows Server 2008 R2 - - - - - http://www.microsoft.com/en-us/download/details.aspx?id=11093 - - - - - - - Windows Server 2012 - - - - - http://technet.microsoft.com/en-US/evalcenter/hh670538.aspx?ocid=&wt.mc_id=TEC_108_1_33 - - - - - - - -
-
- VirtIO Red Hat drivers ISO image - Download drivers from - http://alt.fedoraproject.org/pub/alt/virtio-win/stable/ - - Please, choose stable version instead of latest, we’ve got errors with - unstable drivers during guest unattended install. -
-
- Floppy Image With Unattended File - Run following commands as root: - - - Create empty floppy image in your home folder - ># dd bs=512 count=2880 \ - if=/dev/zero of=~/floppy.img \ - mkfs.msdos ~/floppy.img - - - Mount the image to /media/floppy - - ># mkdir /media/floppy mount -o loop \ - ~/floppy.img /media/floppy - - - Download autounattend.xml file - from - https://raw.github.com/stackforge/murano-deployment/master/image-builder/share/files/ws-2012-std/autounattend.xml - - - ># cd ~ -># wget https://raw.github.com/stackforge/murano-deployment\ -/master/image-builder/share/files/ws-2012-std/autounattend.xml - - - Copy our autounattend.xml to - /media/floppy - - ># cp ~/autounattend.xml /media/floppy - - - Unmount the image - ># umount /media/floppy - - -
-
- - - Build Windows Image (Automatic Way) - - - Clone murano-deployment repository - ># git clone git://github.com/stackforge/murano-deployment.git - - - Change directory to murano-deployment/image-builder folder. - - - Create folder structure for image builder - ># make build-root - - - Create shared resource - - Add to /etc/samba/smb.conf - - [image-builder-share] -comment = Image Builder Share -browsable = yes -path = /opt/image-builder/share -guest ok = yes -guest user = nobody -read only = no -create mask = 0755 - - - - Restart samba services - - ># restart smbd && restart nmbd - - - - - Test that all required files are in place - ># make test-build-files - - - Get list of available images - ># make - - - Run image build process - ># make ws-2012-std - - - Wait until process finishes - - - The image file ws-2012-std.qcow2 should be - stored under /opt/image-builder/share/images - folder. - - - - - Build Windows Image (Manual Way) - - Please note that the preferred way to build images is to use Automated Build described later in this book. - -
- Get Windows Post Install script - All post-install actions are performed by script named wpi.ps1. You may download it using the link - https://raw.github.com/stackforge/murano-deployment/master/image-builder/share/scripts/ws-2012-std/wpi.ps1 - - - To finish image preparation Start-Sysprep.ps1 - script is used. You may download it using the link - https://raw.github.com/stackforge/murano-deployment/master/image-builder/share/scripts/ws-2012-std/Start-Sysprep.ps1 - - - - There are a few scripts named wpi.ps1, each - supports only one version of Windows image. The script above is intended to be - used to create Windows Server 2012 Standard. To build other version of Windows - please use appropriate script from scripts - folder. - -
-
- Copy scripts to the shared folder - All scripts should be copied to the shared resource folder, subfolder Scripts. -
-
- Create guest VM -
- Way 1 - from console - Run all commands as root. - - Preallocate disk image - - ># qemu-img create -f qcow2 -o preallocation=metadata \ - /var/lib/libvirt/images/winserv_vio.qcow2 20G - - - - Start guest install - - ># virt-install --connect qemu:///system --hvm --name WinServ \ - --ram 2048 --vcpus 2 --cdrom /opt/samba/share/9200.16384.WIN8_RTM\ -.120725-1247_X64FRE_SERVER_EVAL_EN-US-HRM_SSS_X64FREE_EN-US_DV5.ISO \ - --disk path=/opt/samba/share/virtio-win-0.1-52.iso,device=cdrom \ - --disk path=/opt/samba/share/flop.img,device=floppy \ - --disk path=/var/lib/libvirt/images/winserv_vio.qcow2\ -,format=qcow2,bus=virtio,cache=none \ - --network network=default,model=virtio \ - --memballoon model=virtio --vnc --os-type=windows \ - --os-variant=win2k8 --noautoconsole \ - --accelerate --noapic --keymap=en-us --video=cirrus --force - - -
-
- Way 2 - from virt-manager UI - - - launch virt-manager from shell as root - - - set Guest VM name and Local install media - - - add 1 cdrom - Windows Server ISO image - - - set OS type: Windows and version: Windows Server 2008 - - - set CPU and RAM amount - - - deselect Enable storage for this virtual machine - - - select Customize configuration before install - - - add 2 cdrom - virtio ISO image - - - add floppy - our floppy image - - - add/or create HDD image with Disk bus: VirtIO and storage format: - QCOW2 - - - set network device model: VirtIO - - - If everything OK - start installation process, guest vm screen - accessible through Console button - - -
-
-
- Finish process - After install process finished for reference image compression run as root - ># qemu-img convert -O qcow2 /var/lib/libvirt/images/winserv_vio.qcow2 \ - /var/lib/libvirt/images/winserv_vio_ref.qcow2 -
- - - Upload Image Into Glance - - Services deployed by Murano require specially prepared images, that can be created manually or via - automated scripts. Please refer to corresponding chapters of this book to create image. After images are - created they should be registered in Openstack Glance - image operation service. - - - - Use the glance image-create command to import your disk image to Glance: -<<<<<<< HEAD - >$ glance image-create --name <NAME> --is-public true \ - --disk-format qcow2 --container-format bare --file <IMAGE_FILE> \ - --property <IMAGE_METADATA> -======= - >$ glance image-create --name <NAME> --is-public true \ - --disk-format qcow2 --container-format bare --file <IMAGE_FILE> \ - --property <IMAGE_METADATA> ->>>>>>> 33f5a6d52739bea6bc661c7b12c37b0b4dcb5b84 - - - Replace the command line arguments to glance image-create with the - appropriate values for your environment and disk image: - - - - Replace <NAME> with the name that - users will refer to the disk image by. E.g. 'ws-2012-std' - - - Replace <IMAGE_FILE> with the - local path to the image file to upload. E.g. 'ws-2012-std.qcow2'. - - - Replace IMAGE_METADATA with the following property string -<<<<<<< HEAD - murano_image_info='{"title": "Windows 2012 Core Edition", "type": "ws-2012-core"}where -======= - murano_image_info='{"title": "Windows 2012 Core Edition", "type": "ws-2012-core"}where ->>>>>>> 33f5a6d52739bea6bc661c7b12c37b0b4dcb5b84 - - title - user-friendly description of the image - - - type - one of possible image types - - ws-2012-std - Windows Server 2012 Standart - Edition - - - ws-2012-core - Windows 2012 Core - Edition - - - ws-2008r2-std - Windows Server 2008R2 Standart - Edition - - - ws-2008r2 - Windows Server 2012R2 - - - - - Setting murano_image_info property is - required to pick up image from Murano Dashboard. - - - - - - - To update metadata of the existing image run the command: - >$ glance image-update <IMAGE-ID> --property <IMAGE_MATADATA> - - - Replace <IMAGE-ID> with image id - from the previous command output. - - - Replace <IMAGE_METADATA> with - murano_image_info property, -<<<<<<< HEAD - e.g.murano_image_info='{"title": "Windows 2012 Core Edition","type": "ws-2012-core"}' -======= - e.g.murano_image_info='{"title": "Windows 2012 Core Edition","type": "ws-2012-core"}' ->>>>>>> 33f5a6d52739bea6bc661c7b12c37b0b4dcb5b84 - - - - - After these steps desired image can be chosen in Murano dashboard and used for services platform. - - diff --git a/src/administrators-guide/src/docbkx/content/installation-guide.xml b/src/administrators-guide/src/docbkx/content/installation-guide.xml index ed50922..1efe2a7 100644 --- a/src/administrators-guide/src/docbkx/content/installation-guide.xml +++ b/src/administrators-guide/src/docbkx/content/installation-guide.xml @@ -441,19 +441,13 @@ rabbitmqctl set_permissions -p muranovhost muranouser ".*" ".*" ".*" - Register murano-api service in Openstack. - Note: you need to be authorized in Openstack to run this commands. To do this, you can run something like (having changed variables to appropriate values) + Register murano-api service in Openstack. To do that perform the folowwing commands: + You need to be authorized in Openstack to run this commands - - - - Make sure that additional repositories are installed. - See the appendix - for information about preparing a virtual machine for murano installation. + Make sure that additional repositories are installed and your system is updated and upgraded. + Please check from with steps in the appendix.