Bug 978863

Summary: [Install] [Docs] Migrate ovirt-engine-setup and AIO plugin to otopi
Product: Red Hat Enterprise Virtualization Manager Reporter: Tim Hildred <thildred>
Component: DocumentationAssignee: Andrew Dahms <adahms>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.3.0CC: aburden, acathrow, adahms, gklein, mwest, yeylon
Target Milestone: ---Keywords: FutureFeature
Target Release: 3.3.0   
Hardware: Unspecified   
OS: Unspecified   
URL: http://www.ovirt.org/Features/Otopi_Infra_Migration
Whiteboard: integration
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: 975668 Environment:
Last Closed: 2014-04-07 03:06:35 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 967508, 975668    
Bug Blocks:    

Description Tim Hildred 2013-06-27 08:51:45 UTC
+++ This bug was initially created as a clone of Bug #975668 +++

May impact:
* Install
* Admin
* Quick Start?


+++ This bug was initially created as a clone of Bug #967508 +++

cloned for RHEV-M 3.3 tracking

+++ This bug was initially created as a clone of Bug #911191 +++

engine-setup, engine-cleanup, engine-upgrade and the AIO plugin should be migrated to otopi.

--- Additional comment from Alon Bar-Lev on 2013-05-09 07:52:32 EDT ---

packaging: setup: re-write using otopi

OUTLINE

We introduce a complete rewrite of ovirt-engine setup, which includes
engine-setup, engine-upgrade, engine-cleanup.

The new implementation is installed side-by-side, user may have a choice
which implementation to use.

COMPATIBILITY

Implementation are incompatible, once setup using legacy, upgrade and
cleanup will not work using the new implementation and vise versa.
Answer file is not compatible between implementations.

Implementation is not feature complete, setup is is almost complete,
cleanup needs more work to clean files that where partially modified,
currently, setup is not able to upgrade non-new implementation setup.

MAJOR FEATURES

Fully support development environment installation.

Up until now, developers had maintained parallel environment, manually
customized, partial featured.
Now, developers may setup product much like production using unprivileged
user, custom location and custom database. For more information refer to
README.developer file.

Platform independent implementation

The new implementation can/should be able to run in multiple
distributions, setting up valid engine environment. So far tested
fedora, rhel, centos, gentoo, ubuntu.

Database access

Split between host provisioning and database setup.

Host provisioning is the part setup can configure the database package on
host to be able to serve the application. The provisioning phase is now
completely optional and is supported only at legacy distributions.

Database setup is the part that a schema is created in existing
database. This enables the dba to provide ovirt administration
unprivileged database user and database for his use.

Implementation

Pluggable, mission centric, consistent, modern, customizable implementation.
Reuse the otopi infrastructure that is also used for host-deploy, and
future reuse of setup for dwh and reports components.

Change-Id: Id587977be496f979f692ee5fd06a4e264d3f9197
Bug-Url: https://bugzilla.redhat.com/show_bug.cgi?id=911191
Signed-off-by: Alon Bar-Lev <alonbl>
Signed-off-by: Sandro Bonazzola <sbonazzo>
Signed-off-by: Alex Lourie <alourie>

--- Additional comment from Alon Bar-Lev on 2013-05-10 05:19:35 EDT ---

During implementation, the pki configuration were moved from vdc_options to /etc/ovirt-engine/engine.conf[.d/*].

These are determine by setup and should not be changed, so there is no reason to store them in database, and handle setup/upgrade that are database related.

Another reason was that the root application (/) should serve some of these resources, and having root access database is undesired.

---

vdc_options (removed)

CACertificatePath
CABaseDirectory
CertificateFileName
keystoreUrl
keystorePass
TruststoreUrl
TruststorePass
SignScriptName
CertAlias

engine.conf (added)

ENIGNE_PKI=/etc/pki/ovirt-engine
ENGINE_PKI_CA=${ENGINE_PKI}/ca.pem
ENGINE_PKI_ENGINE_CERT=${ENGINE_PKI}/certs/engine.cer
ENGINE_PKI_TRUST_STORE=${ENGINE_PKI}/.truststore
ENGINE_PKI_TRUST_STORE_PASSWORD=
ENGINE_PKI_ENGINE_STORE=${ENGINE_PKI}/keys/engine.p12
ENGINE_PKI_ENGINE_STORE_PASSWORD=
ENGINE_PKI_ENGINE_STORE_ALIAS=1

Comment 1 Tim Hildred 2013-10-28 00:04:25 UTC
Reassigning to Jodi Biddle (jbiddle) as I am no longer working on Red Hat Enterprise Virtualization documentation.

Comment 2 Andrew Dahms 2013-11-25 13:26:41 UTC
Documentation Link
------------------------------
http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#Upgrading_to_Red_Hat_Enterprise_Virtualization_Manager_3.3

http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#Upgrading_between_Minor_Releases

http://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Virtualization/3.3/html-single/Installation_Guide/index.html#Checking_for_Red_Hat_Enterprise_Virtualization_Manager_Updates

What Changed
------------------------------
Edited topic Upgrading to Red Hat Virtualization Manager 3.3 [ 22421-558744 ] and added a note on the migration to otopi. Also changed the commands to 'engine-setup' to reflect the new command syntax. The screen output of step 4. was also updated to that actually seen on screen.

Edited topic Updating Red Hat Enterprise Virtualization Manager [ 7524-558768 ] and added a note on the migration to otopi. Also changed the commands to 'engine-setup' to reflect the new command syntax.

Edited topic Checking for Red Hat Enterprise Virtualization Manager Updates [ 9941-558748 ] and changed all screen output to that actually seen on screen. Also changed the update command to 'engine-upgrade-check' to reflect the new command syntax.

Updated revision history [ 21134-558761 ]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Installation_Guide-3.3-en-US-3.3-23

Moving to ON_QA.

Comment 3 Marcus West 2013-12-22 05:05:02 UTC
looks good