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

 Adding an instance 

1. Enter the hostname or IP address of the Platform Container.
   
   
2. Enter the web interface port of the platform which . This is the value of the platform property  mz.webserver.port.
   
   
3. Enter an arbitrary name for the instance or keep the default value based on the Host field.
   
   
4. Select Secured Connection for HTTPS.
    
5. Click OK.  The The Desktop Launcher will download 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
   
   

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

   Note
   title Note!
   Parts of the Legacy Desktop, configuration, and operation options may be disabled or not visible as a result of permission restrictions.

   The name of the logged in user and the name of the system 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 will be are able to display any information that you want users to see before logging into the Legacy Desktop, Web 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 will need to insert the property into the Platform.conf with the value for the property as property value set to the location and filename of the file that contains the information you want to be displayed display on the banner.

Example of the banner being used with a hyperlink.

Adding a banner

To enable and add your own banner:

1. Create a simple file containing with the content that you want to be displayed display on the banner. The banner will does not adopt the standard text format in your file, so you can 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.
   
   

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

   Info
   title Example - Adding the property into Platform.conf
   Code Block properties { mz.security.login.banner="/opt/mz/banner.html" }

   
   

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