Skip to main content
Contact support

empower® Suite setup

Updated to 8.6

Integrated Products and Components

  • slides
  • docs
  • charts
  • mails
  • unsplash slides Plugin

  • sync

General Information

The suite installer contains a product chooser dialog in which the user can choose which products to install.

 

mceclip0.png


The selection can be changed afterwards ("Manage" in Windows Settings).

mceclip2.png

mceclip1.png
The sync does not have to be installed specifically since it is part of any product which depends on the sync.


empower® suite installer now also supports the uninstallation of branding customizings. At uninstallation time all files in the directory except the Userpreferences.db are deleted.
What happens with the branding customizing files is determined by the following rules:

  • If the sync is installed the customizing is installed
  • If the sync is installed again or updated the logic checks if a new customizing is provided. If this is the case the old customizing is removed and the new customizing is installed. This happens to remove all the old binary data.
  • If the sync is removed the customizing is also removed
  • If a product which uses the sync is already installed (i.e. slides) and another product is installed which depends on the sync (i.e. docs) than the same logic as in the reinstall/update path happens

Types of Setup

Type
Description
Last changed comment
perUser A per User Installer, which allows to choose which products to install. No product is automatically selected for installation.  
personal A per User Installer which installs slides, charts und unsplash installiert. In this version no product selection dialogue is shown. changed in empower® 8.6.
no longer contains icons8 but charts instead.
Because of changes to the included products. Older versions have to be uninstalled previously.
express A per User Installer which installs slides, charts, icons8 and unsplash. In this version no product selection dialogue is shown.  
perMachine

A per Machine Installer, which allows to choose which products to install. No product is automatically selected for installation.

  

 

Additional Files

Additional files are located in a payload folder beside the setup. The files are located in the payload folder in subfolders by product.
i.e. Payload\sync\RemoteserviceConfig.xml

slides

  • license.key (if offline license is needed also for branding edition)
  • NoStartScreen.dat (optional)

charts

  • licensekey.txt or license.key (if offline license is needed also for branding edition)
  • Holidays.xml (not optional, if charts is installed)
  • Customizing

sync

  • Branding (directory with the branding customizing)
  • RemoteserviceConfig.xml (This file also has to be available if autoupdates should be configured for charts)

docs

  • license.key (needed for online and offline activation)
  • licensekey.txt (needed for online and offline activation)

mails

  • license.key (needed for online and offline activation)
  • licensekey.txt (needed for online and offline activation)

suite

  • DisableExternalProcessStarts.flag (optional)

 

More Information on the files (incomplete)

File Name
Description
File content
Example
NoStartScreen.dat

If this file is available in the payload directory, empower® slides will prevent the display of the "empower® is preparing in the background" window.

 Empty  
DisableExternalProcessStarts.flag Disabled the start of external programs i.e. sync, etc.
If this file is used it must be in the payload directory on every update.		 Empty  

 

 

Setup Parameter

Parameter
Allowed Values
Default Value
(if not defined)
Definition
EXAMPLE
/q
 
 
Set the installation as a silent install
msiexec /i empowerSuite-perMachine.msi /q
ENABLE_PAYLOAD_CHECK 0,1 1

Defines if the payload directory should be checked.
It is only checked if a folder with the name payload is available besides the setup.
To check if the content is available is still in the resposibilities of the products.
This parameter is only for the check of the suiteinstaller. Checks which are performed by the products (i.e. charts) are not affected.

 msiexec /i empower.msi ENABLE_PAYLOAD_CHECK=0
SLIDES_EMPOWERRIBBONINSERTAFTERIDMSO IdMso of RibbonTabs as string empty Defines if slides should be shown behind another ribbon tab. msiexec /i empower.msi SLIDES_EMPOWERRIBBONINSERTAFTERIDMSO=HomeTab
EXECUTINGDIRECTORY Path empty

With this property the path in which the msi is located can be defined.
This is needed if you want to execute the msi using the command line from a different directory.

msiexec /i empower.msi EXECUTINGDIRECTORY="C:\Temp\empowerInstall"

 

 

 

Setup Bundles

Setup bundle files are .exe files which contain the msi and the payload. Setup bundles are available from 8.6 onword.
Bundles will extract the content to the local system and then run the msi.

Location

Bundles are located in the same directory as the msi installers.

Supported Editions

As of this moment only the following editions are supported:

  • personal
  • express

Payloads

Payloads have to be provided from the customizing team after the internal release and before the final release to the customers.
Payloads are located in Q:\empower Suite\InstallFiles\Payloads in a subfolder for each version (i.e. 8.6, 8.7, and so on) and have to be added for each release.
This is needed because branding customizings are only fully compatible with the version which was used to create the customzing.

Validation

Each package has to be confirmed/denied by a QA member before a new package can be created. New packages are enqueued in a pipeline as long as other packages approvals are still outstanding.

License Updates

Licensing files are part of the payload directory. After changing the files on Q, a new bundle package can be created using our in house build server.

 

Installation using the command line

To install products per command line the ADDLOCAL property of the MSI should be used (https://docs.microsoft.com/en-us/windows/win32/msi/addlocal)
If you want to remove a part of the products using the command line the REMOVE property of the MSI should be used (https://docs.microsoft.com/en-us/windows/win32/msi/remove)

If the setup does not define a standard set of products to install, the definition of ADDLOCAL is mandatory on the first installation.

Allowed product names for ADDLOCAL and REMOVE:

  • slides
  • unsplash
  • docs
  • mails
  • charts
  • autoupdater (only perUser, personal, express). This value is mandatory, if perUser, personal oder express is installed per command line.
  • icons8

Examples:

  • msiexec /i "empowerSuite-perUser.msi" /qn ADDLOCAL=slides,charts,autoupdater
  • msiexec /i empowerSuite-perMachine.msi /q /l*v installer.log REMOVE=unsplash,charts

 

Please note

  • If charts standalone was installed and a suite installer is installed, the previous version of charts should be removed. If not a few previous files will be left in the previous installation path.

Related articles

Comments

0 comments

Article is closed for comments.