Bug 972974

# Extract the plugin files to the ui-plugins directory.
tar -C /usr/share/ovirt-engine/ui-plugins -xvf /path/where/downloaded/Space-shooter-ui-plugin-06062013.tar

# Make the files world readable.
chmod -R a+r space-shooter-resources

# Make the *directories* world executable.
find /usr/share/ovirt-engine/ui-plugins/space-shooter-resources -type d -exec chmod a+x {} \;

# If the UI plugins directory does not already exist, create it in
# /etc/ovirt-engine (or wherever ovirt etc files are stored).
mkdir /etc/ovirt-engine/ui-plugins

# Create a local configuration file for the plugin in the new
# /etc/../ui-plugin.  List the domain(s) and IP(s) that
# you plan to use.  The plugin will not work if this configuration lists 
# https://domainA.com and you navigate to that page via https://domainB.com. 
# Remember that the format for non-standard ports is http://domain.com:8000 or
# https://domain.com:8080. For http traffic on port 80 or https on port 443, it is
# not necessary to include a port. The current ovirt documentation shows this 
# file without the surrounding '{}', this is an error. The file must be proper JSON, 
# as it is here.

echo '{"config":{"allowedOrigins": ["https://manager.example.com","https://xx.xx.xx.xx"]}}' > /etc/ovirt-engine/ui-plugins/space-shooter-config.json

# Properly label the new directory and files.
restorecon /etc/ovirt-engine/ui-plugins
restorecon /etc/ovirt-engine/ui-plugins/space-shooter-config.json

# Restart the ovirt-engine. This isn't *always* necessary, but the how and when
# of when you need to and don't is complicated and restarting the engine is easy.
service ovirt-engine restart

# Enjoy your plugin at https://manager.example.com/
# 
# Caveats: 
# * some aspects of plugins don't work in Chrome
# * depending on browser security settings, plugins may not work unless you
#   install the SSL cert for the ovirt engine webadmin

The Space Shooters plugin should not be in the Administration Guide, despite what this bug says. The Space Shooters plugin should be in the Developer Guide, probably in an appendix that explains how to deploy UI Plugins.

The section in the Administration Guide describing the Shell-in-a-Box plugin will be replaced in the Administration Guide with a section describing the GSS UI plugin. The GSS UI Plugin is included in RHEV 3.3 by default (so I am told, though I have not yet confirmed it), so installation instructions will not be necessary in RHEV 3.3 documentation.

It is necessary to write instructions explaining how to install the GSS UI Plugin on RHEV 3.2, however. The section describing the Shell-in-a-Box plugin will be replaced in the RHEV 3.2 documentation with a section describing the GSS UI Plugin. Because the GSS UI Plugin is not installed by default in RHEV 3.2, a section explaining its installation and configuration must be written. This section will be released as a part of the 3.2.z release upcoming in mid-August.

See also:
https://bugzilla.redhat.com/show_bug.cgi?id=965337

RHEV 3.3 Admin Guide will require the "Using Red Hat Support Plugin" topic to be included in its content map.

Documentation Link
------------------
https://documentation-devel.engineering.redhat.com/docs/en-US/Red_Hat_Enterprise_Virtualization/3.3/html/Administration_Guide/Using_Red_Hat_Support_Plugin.html

NVR
---
Red_Hat_Enterprise_Virtualization-Administration_Guide-3.3-en-US-3.3-5

What Changed
------------
Previously, "Using Red Hat Support Plugin" was not in the RHEV 3.3 Admin Guide.
Now, "Using Red Hat Support Plugin" is in the RHEV 3.3 Admin Guide.

Moving to ON_QA.