Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Prerequisite: Download and install Java 17 on the PC that you will use the Desktop on. Both JRE and JDK work.

  2. If LoadBalancer going to be used, special considerations concerning ports are needed, for more information see: https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/

  3. Only for Private Cloud installations, adaption of the Ports are needed.

    Note
    titlePrivate Cloud - handlig of Ports

    In the case of Private Cloud, you cannot use the ports defined in the values.yaml file. Instead, you must use the NodePort number substitutes. You can see this by with the command kubectl get services. See the example below, for example 9000 will be substituted by 30707.

    Code Block
    languagetext
    titleExample of services for Private Cloud
    $ kubectl get services -n <namespace>
    
    NAME                                             TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                         AGE
    mz-operator-controller-manager-metrics-service   ClusterIP   10.102.178.52    <none>        8443/TCP                        154m
    mzonline                                         NodePort    10.100.195.106   <none>        80:31270/TCP                    154m
    platform                                         NodePort    10.111.174.222   <none>        9000:30707/TCP,6790:32481/TCP   154m
    wd                                               NodePort    10.101.51.191    <none>        9999:32073/TCP                  154m   
    
    # Note that in the case you use TLS, the Web interface, mzonline port will be 443.


  4. Only for AWS installations,  URLs are constructed like <function>.<domain>. See below:

Note

...

AWS -

...

Accessing the

...

Environment

If you use AWS you must always define the type of interface directly in the URL as

...

shown below:

  • Web interface: https://mzonline.<domain>/

  • Platform: https://platform.<domain>:9000/

  1. To download the Desktop Launcher, enter this URL in a web browser: http://<host>:<mz.webserver.port>/launch/desktop . The port is default 9000.

    Info
    titleExample - Desktop Launcher URL

    Examples. Enter the URL in a web browser. Use https if security is defined:

  2. A page with different files to install or start the Launcher will be available in the web browser.
    Image Modified

  3. To install the Desktop Launcher, for Windows, download the exe file and double-click to install it. Alternatively download the OS independent  jar file and use java -jar to install it.

    Info
    titleExample - Desktop Launcher via java -jar


    Code Block
    $ java -jar standard standard-mzx-launcher-1.1.4.jar


  4. The Launcher interface will be visible, and you can add the Instances you want to use.
    Image Modified   

    - Add the instance, by defining the Host, Port and a Name. Select Secured Connection if the platform's web interface is defined to use https.
    - For Private Cloud, set Port to the NodePort number substitute for 9000 and Host to the cluster node. Example below.
    - For AWS, define platform.<domain> For the Host.

  5. In the case you are using Private Cloud or pico.rcp.platform.port different from 6790, the Platform RCP port needs to be changed. Click settings    on the Desktop instance and update the pico.rcp.platform.port. For Private Cloud Use the NodePort number substitute for 6790. It is 32481 in the "kubectl get services" example above.

    Image Modified