Difference between revisions of "App Appliance"

From Univention Wiki

Jump to: navigation, search
(Add settings options for the screenshots.)
(Update)
Line 80: Line 80:
  
 
= Branding Showcase =
 
= Branding Showcase =
 +
 +
The branding can be defined in the provider portal in the app at the tab "Appliance".
  
 
{| class="wikitable" |
 
{| class="wikitable" |
 
! Screenshot
 
! Screenshot
 
! Settings
 
! Settings
 +
|-
 +
| [[Image:Appliance_Branding_Bootloader.png|800px]]
 +
| style="vertical-align:top" | In the INI file:
 +
# AppliancePrimaryColor
 +
 +
In the provider Portal:
 +
# Primary appliance color
 
|-
 
|-
 
| [[Image:Appliance_Branding_Bootsplash.png|800px]]
 
| [[Image:Appliance_Branding_Bootsplash.png|800px]]
|
+
| style="vertical-align:top" | In the INI file:
* ApplianceBootsplashLogo
+
# ApplianceBootsplashLogo
* ApplianceCssBackground
+
# ApplianceCssBackground
* AppliancePrimaryColor
+
# AppliancePrimaryColor
 +
 
 +
In the provider Portal:
 +
# Logo in the setup wizard
 +
# CSS definition of the appliance background
 +
# Primary appliance color
 
|-
 
|-
 
| [[Image:Appliance_Branding_Setup_Wizard.png|800px]]
 
| [[Image:Appliance_Branding_Setup_Wizard.png|800px]]
|
+
| style="vertical-align:top" | In the INI file:
* ApplianceLogo
+
# ApplianceLogo
* AppliancePrimaryColor
+
# AppliancePrimaryColor
* ApplianceUmcHeaderLogo
+
# ApplianceUmcHeaderLogo
* ApplianceName
+
# ApplianceName
 +
In the provider Portal:
 +
# Logo for the setup wizard
 +
# Primary appliance color
 +
# Logo for UMC header
 +
# Appliance name
 
|-
 
|-
 
| [[Image:Appliance_Branding_UMC.png|800px]]
 
| [[Image:Appliance_Branding_UMC.png|800px]]
|
+
| style="vertical-align:top" | In the INI file:
* AppliancePrimaryColor
+
# AppliancePrimaryColor
* ApplianceSecondaryColor
+
# ApplianceSecondaryColor
* ApplianceUmcHeaderLogo
+
# ApplianceUmcHeaderLogo
 +
 
 +
In the provider Portal:
 +
# Primary appliance color
 +
# Secondary appliance color
 +
# Logo for UMC header
 
|-
 
|-
 
| [[Image:Appliance_Branding_Welcome_Screen.png|800px]]
 
| [[Image:Appliance_Branding_Welcome_Screen.png|800px]]
|  
+
| style="vertical-align:top" | In the INI file:
* ApplianceWelcomeScreenLogo
+
# ApplianceWelcomeScreenLogo
* ApplianceCssBackground
+
# ApplianceCssBackground
* ApplianceName
+
# ApplianceName
* ApplianceWelcomeScreenFontColor
+
# ApplianceWelcomeScreenFontColor
 +
 
 +
In the provider Portal:
 +
# Logo displayed in the welcome screen
 +
# CSS definition of the appliance background
 +
# Appliance name
 +
# Font color for welcome screen
 +
|-
 +
| [[Image:Appliance_Branding_First_steps_overlay.png|800px]]
 +
| style="vertical-align:top" |
 +
#  README_APPLIANCE
 +
 
 +
In the provider Portal:
 +
# First steps information
 +
|-
 +
| [[Image:Appliance_Branding_License_Dialog.png|800px]]
 +
| style="vertical-align:top" | In the INI file:
 +
# AppliancePrimaryColor
 +
# ApplianceUmcHeaderLogo
 +
 
 +
In the provider Portal:
 +
# Primary appliance color
 +
# Logo for UMC header
 
|-
 
|-
 
| [[Image:Appliance_Branding_Portal_Page.png|800px]]
 
| [[Image:Appliance_Branding_Portal_Page.png|800px]]
|
+
| style="vertical-align:top" | In the INI file:
* AppliancePortalTitle
+
# AppliancePortalTitle
* AppliancePortalLogo
+
# AppliancePortalLogo
* AppliancePortalFontColor
+
# AppliancePortalFontColor
* AppliancePortalBackgroundImage
+
# AppliancePortalBackgroundImage
* AppliancePortalCssBackground
+
# AppliancePortalCssBackground
 +
 
 +
In the provider Portal:
 +
# Title as shown on the portal page
 +
# Logo for the portal page
 +
# Color of the heading font on the portal page
 +
# Background image for the portal page (PNG or JPEG)
 +
# CSS definition of the background on the portal page
 
|}
 
|}
  
 
[[Category:App Center Developer Guide]]
 
[[Category:App Center Developer Guide]]

Revision as of 08:45, 19 October 2017

App Appliances are predefined images which consists of the App, the UCS management system and the UCS runtime environment. These App Appliances are currently provided as VMware, VirtualBox and KVM images. By default the UCS branding is used, but it is possible to use a special branding.

INI variables

The variables described below can be added to the App Center INI file to define the App Appliance of an App.

Appliance creation

ApplianceCreate
Boolean value if an Appliance should be created for this App.
ApplianceName
The name of the App Appliance.
ApplianceLogo
The logo of the Appliance which is shown in the first page of the setup wizard. This graphic needs to be in the SVG format.
ApplianceAllowPreconfiguredSetup
It activates the fast demo mode for the App Appliance. That means the system (as well as the App) is configured and pre-joned with a pre-defined domainname. When activating this feature, the correct functioning of the App in this mode needs to be ensured. (Boolean value)
ApplianceMemory
The Appliance is created with this memory size.
ApplianceAdditionalApps
A list of App IDs which should be installed into the App Appliance as well.
AppliancePreInstalledPackages
A list of packages which should be installed while the Appliance is built.

Black listing pages/fields in the setup wizard

AppliancePagesBlackList
A list of setup pages which shouldn't be displayed. By default, it should be set to software otherwise the whole software packages have to be shipped with the Appliance. Possible values are software and role.
ApplianceFieldsBlackList
Some fields in the Appliance setup dialog can be removed. Possible values are password, network, nameservers, proxy, hostname, locale, basesystem, ad, preconfigured_system, domaincontroller_backup, domaincontroller_slave, memberserver.

Black/white listing Apps in the App Center

ApplianceBlackList
A list of App IDs which are not shown in the App Center once the Appliances has been configured.
ApplianceWhiteList
Instead of blacklisting the App IDs via ApplianceBlacklist it is possible to define a positive list of App IDs which are shown in the App Center once the Appliance is configured.

UMC favorites category

For an App Appliance, particular UMC modules may be added to the UMC category __Favorites__.

ApplianceFavoriteModules
A comma separated list of modules (in the format <moduleID>[:<moduleFlavor>]) which are displayed in category __Favorites__ in UMC. (See the UCR variable umc/web/favorites/default or the UDM users property umcProperty: favorites=... as examples. Note that module IDs and flavors are also written into the URL after the hash (#) sign.)

First steps information via README_APPLIANCE files

The content of the App's README_APPLIANCE_DE and README_APPLIANCE_EN files will be shown prominently on the UCS portal page upon the user's first visit. They should contain guiding information of how to proceed when having set up the appliance and being redirected to the portal page for the first time.

Branding configuration of the Appliance

The following values need to be specified in order to

ApplianceCssBackground
A CSS definition for the background image on the Web overview site. CSS gradient definitions can be used herein, as well.
AppliancePrimaryColor
The primary color of the App Appliance. In general, this should be the main product color. This color will be used, e.g., as filling color of the header background during the setup wizard. If the primary color is dark, the font color (for text on the ApplianceCssBackground) of the branding will be white, if the primary color is bright, the font color of the branding will be black.
ApplianceSecondaryColor
The secondary color of the App Appliance which is used to accompany and contrast the primary color in the branding.
ApplianceBootsplashLogo
The logo which is shown during the system boot process in SVG format. It will be placed over the background as defined by ApplianceCssBackground.
ApplianceUmcHeaderLogo
This graphic need to be in SVG format. It will be placed on the top left in the header of the setup wizard, the welcome screen, and the overview site. Its height should be about 14px and the icon color should be either white or black (more precisely #282828) depending on the background color.
ApplianceWelcomeScreenLogo
The SVG graphic which is displayed in the welcome screen (as shown directly after the boot process).
ApplianceWelcomeScreenFontColor
The font color to be used in the welcome screen (and also for the bootsplash screen and grub menu). Allowed values are white and black.

Branding configuration for the portal page of the Appliance

Since UCS 4.2, the concept of a central portal page has been implemented. For an App Appliance, it is possible to adjust the branding of the portal page via the INI file:

AppliancePortalTitle
Title which is displayed at the top of the portal page (defaults to "<AppName> Appliance").
AppliancePortalLogo
An SVG graphic which is displayed in the header of the portal page.
AppliancePortalFontColor
Font color (and color of header icons) to be used on the portal page. Allowed values are white and black.
AppliancePortalBackgroundImage
An image file with a rather large resolution (e.g., 1600x1200), yet a medium file size (e.g., 300 KB), that will be displayed as background on the portal page.
AppliancePortalCssBackground
A CSS definition for the background on the portal page. CSS gradient definitions can be used herein, as well. If a background image is given, the CSS definition will not take effect.

Example

This example is taken directly from the App Center. It describes the App Appliance of Kopano:

ApplianceCreate = True
ApplianceName = Kopano
ApplianceLogo = Kopano-logo.svg
AppliancePagesBlackList = software
ApplianceFieldsBlackList = basesystem
AppliancePrimaryColor = #348fcd
ApplianceSecondaryColor = #add2eb
ApplianceCssBackground = linear-gradient(to bottom, #9bb9d3 0%, #f0f5f9 100%)
ApplianceBootsplashLogo = Kopano-logo.svg
ApplianceUmcHeaderLogo = logo_umc_header.svg
ApplianceWelcomeScreenLogo = Kopano-logo.svg
ApplianceCategoryModules = udm:users/user,udm:groups/group
ApplianceUmcCategoryLogo = logo_umc_category.svg
ApplianceAllowPreconfiguredSetup = True
ApplianceBlackList = kolab-enterprise,oxseforucs,egroupware,horde,tine20
ApplianceMemory = 2048
ApplianceAdditionalApps = z-push-kopano,fetchmail,kopano-webmeetings,kopano-webapp

Branding Showcase

The branding can be defined in the provider portal in the app at the tab "Appliance".

Screenshot Settings
Appliance Branding Bootloader.png In the INI file:
  1. AppliancePrimaryColor

In the provider Portal:

  1. Primary appliance color
Appliance Branding Bootsplash.png In the INI file:
  1. ApplianceBootsplashLogo
  2. ApplianceCssBackground
  3. AppliancePrimaryColor

In the provider Portal:

  1. Logo in the setup wizard
  2. CSS definition of the appliance background
  3. Primary appliance color
Appliance Branding Setup Wizard.png In the INI file:
  1. ApplianceLogo
  2. AppliancePrimaryColor
  3. ApplianceUmcHeaderLogo
  4. ApplianceName

In the provider Portal:

  1. Logo for the setup wizard
  2. Primary appliance color
  3. Logo for UMC header
  4. Appliance name
Appliance Branding UMC.png In the INI file:
  1. AppliancePrimaryColor
  2. ApplianceSecondaryColor
  3. ApplianceUmcHeaderLogo

In the provider Portal:

  1. Primary appliance color
  2. Secondary appliance color
  3. Logo for UMC header
Appliance Branding Welcome Screen.png In the INI file:
  1. ApplianceWelcomeScreenLogo
  2. ApplianceCssBackground
  3. ApplianceName
  4. ApplianceWelcomeScreenFontColor

In the provider Portal:

  1. Logo displayed in the welcome screen
  2. CSS definition of the appliance background
  3. Appliance name
  4. Font color for welcome screen
Appliance Branding First steps overlay.png
  1. README_APPLIANCE

In the provider Portal:

  1. First steps information
Appliance Branding License Dialog.png In the INI file:
  1. AppliancePrimaryColor
  2. ApplianceUmcHeaderLogo

In the provider Portal:

  1. Primary appliance color
  2. Logo for UMC header
Appliance Branding Portal Page.png In the INI file:
  1. AppliancePortalTitle
  2. AppliancePortalLogo
  3. AppliancePortalFontColor
  4. AppliancePortalBackgroundImage
  5. AppliancePortalCssBackground

In the provider Portal:

  1. Title as shown on the portal page
  2. Logo for the portal page
  3. Color of the heading font on the portal page
  4. Background image for the portal page (PNG or JPEG)
  5. CSS definition of the background on the portal page
Personal tools