Adding Instances and Login

Owned by Kevin Wu
Last updated: May 30, 2024
3 min read

When you start the launcher for the first time, you are prompted to add a Platform instance. 

 Adding an instance 

  1. Enter the hostname or IP address of the Platform Container.

  2. Enter the web interface port of the platform. This is the value of the platform property  mz.webserver.port.

  3. Enter an arbitrary name for the instance or keep the default value, which is based on the Host field.

  4. Select Secured Connection for HTTPS.

  5. Click OK. The Desktop Launcher downloads version information and binaries from the Platform. 
    You now have the following options: 

    1. Click Login to log into the newly added instance. 

    2. Click Add Instance to add another instance.

List of instances and login dialog

The Legacy Desktop opens. Depending on the logged in user, access is granted to different parts of the system. 

Note!

Part of the Legacy Desktop, configuration, and operation options may be disabled or not visible as a result of permisson restrictions.

The name of the logged-in user and the name of the Platform that the Legacy Desktop has connected to are displayed in the status area at the bottom of Legacy Desktop.

Login Banner

If you use the mz.security.login.banner property, you are able to display any information that you want users to see before logging into the Legacy Desktop, or regular Desktop. The content of the banner is derived from a text file that can contain HTML-tag formatting and links. To enable the banner, you need to insert the property into the Platform.conf with the property value set to the location and filename of the file that contains the information you want to display on the banner.

Info!

Enabling the mz.security.login.banner property not only displays the property on the Desktop Launcher, but also in the regular Desktop login screen.

Example of the banner used with a hyperlink.

Adding a banner

To enable and add your own banner:

  1. Create a simple file with the content that you want to display on the banner. The banner does not adopt the standard text format in your file, so use HTML tags like <p> or <br> to format your content.

  2. Add the file into your Platform server in a directory that can be accessed by the UNIX user used during the installation of the Platform.

  3. Add the mz.security.login.banner property into the Platform.conf in the properties section.

Example - Adding the property into Platform.conf

properties { mz.security.login.banner="/opt/mz/banner.html" }

  1. Restart the Platform. Should any content be changed in the file after the property is enabled, the changes are reflected on the banner when the Desktop Launcher selection, or Desktop login page is refreshed.