When you start the launcher for the first time, you will be 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, it matches the value of the platform property  mz.wi.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 Desktop Launcher will download version information and binaries from the Platform. 
   You now have the following options: 
   
   1. Click Login to log into the newly added instance. There is a dropdown list above the Username field from which you can select the space that you want to work in. If you have not configured any configuration spaces the active space will be used. For further information about configuration spaces, see the Configuration Spaces documentation.
   2. Click Add Instance to add another instance.
   
   
   List of instances and login dialog
   
   

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

   Note!

   Parts of the 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 Desktop has connected to are available in the status area at the bottom of Desktop.

Login Banner

Using the mz.security.login.banner property, you will be able to display any information that you will want users to see before logging into the Desktop, Web Desktop or Web UI. 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 the location and filename of the file that contains the information you want to be displayed on the banner.

Example of the banner being used with a hyperlink.

Adding a banner

The following steps will guide you on how to enable and add your own banner.

1. Create a simple file containing the content that you want to be displayed on the banner. The banner will 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 the properties section.

   Example - Adding the property into Platform.conf

       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 enabled, the changes will be reflected on the banner when the Desktop Launcher selection or the Web Desktop or Web UI login page is refreshed.