Versions Compared

Key

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

Starting the System

  1. Login as mzadmin on the host where the Platform Container is installed.

...

  1. Ensure that the environment variables are set correctly:

Variable

Description

MZ_CONTAINER

Example value: container0

This environment variable specifies an identifier for the installed container. Each container in your

...

MediationZone system must have a unique identifier.

MZ_HOME

Example value: /opt/mz

This environment variable specifies where the

...

MediationZone software is installed.

JAVA_HOME

Example value: /opt/jdk/jdk-17.0.2

This environment variable specifies where the JDK is installed.

PATH

This environment variable specifies the search path.

The search path must contain the following directories: $JAVA_HOME/bin:$MZ_HOME/bin

 

  1. Start the Platform by entering the mzsh startup command:

    Code Block
    languagetext

...

  1. $ mzsh startup platform 

    If you have configured SCs or ECs in the Platform container, you can add the names of these pico instances to the startup command. The Platform must be started before any ECs or SCs.

Info

...

Example - How to

...

Start the

...

System

Enter the following command to start the Platform and an EC (ec1) in the Platform Container:

Code Block

...

$ mzsh startup platform ec1

 

  1. Start other pico instances  that are required for execution, i e ECs or SCs.

    If you have enabled remote access to the containers in your system, you can start pico instances on other containers with the the mzsh system start command:

    Code Block
    languagetext

...

  1. $ mzsh system start container:<container regexp>/pico:<pico name regexp>
Tip

...

Hint!

The Platform will be started if it is not already running.

...

Note!

Set your desired environment variables in $MZ_HOME/bin/mzshr.env as this file will be loaded with local variables. Add the desired profiles, such as ". /home/mzadmin/.profile_mz".

Info

...

Example - mzsh system start

Enter the following command to start all pico instances in a container:

Code Block

...

...

$ mzsh system start container:<container>/pico:.*

Repeat this command for all containers in the system to start all pico instances. You can also start all pico instances by omitting the target path:

Code Block

...

...

$ mzsh system start

This is equivavalent to:

Code Block

...

...

$ mzsh system start container:.*/pico:.*

Add the --tag option to the system command to start a group of pico instances:

Code Block

...

$ mzsh system start --tag tag1 container:.*/pico:.*

For further information about the system command and how to add tags to pico instances, see system.

If you have not enabled remote access, you must login to each container host and start the pico instances with the mzsh startup command.

Code Block
languagetext

...

$ mzsh startup <pico-name-1> <pico-name-2> <...>

Stopping the System

  1. Log in as mzadmin on the host where the Platform Container is installed.

  2. Make sure that the environment variables are set correctly:

Variable

Description

MZ_CONTAINER

Example value: container0

This environment variable specifies an identifier for the installed container. Each container in

...

your MediationZone system must have a unique identifier.

MZ_HOME

Example value: /opt/mz

This environment variable specifies where the

...

MediationZone software is installed.

JAVA_HOME

Example value: /opt/jdk/jdk-17.0.2

This environment variable specifies where the JDK is installed.

PATH

This environment variable specifies the search path.

The search path must contain the following directories: $JAVA_HOME/bin:$MZ_HOME/bin

  1. Stop all ECs, and SCs.

...

Note!

It is recommended that you stop workflows that depend on the specified pico instances before you run the mzsh shutdown command. Workflows that are active during shutdown, may remain in an active state or enter an unreachable state. In both these cases, the workflows may need manual attention to ensure that they are deactivated.Set your desired environment variables in $MZ_HOME/bin/mzshr.env as this file will be loaded with local variables. Add the desired profiles, such as ". /home/mzadmin/.profile_mz".

If you have enabled remote access to the containers in your system, you can stop pico instances on other containers with the the mzsh system stop command:

Code Block
languagetext

...

$ mzsh system stop container:<container regexp>/pico:<pico regexp>
Info

...

Example - mzsh system stop

Enter the following command to stop all pico instances in a container:

Code Block

...

$ mzsh system stop container:<container>/pico:.*

Repeat this command for all containers in the system to stop all pico instances. You can also stop all pico instances by omitting the target path:

Code Block

...

...

$ mzsh system stop

This is equivavalent to:

Code Block

...

languagetext
themeEclipse
$ mzsh system stop container:.*/pico:.*

Add the --tag option to the system command to stop a group of pico instances:

Code Block

...

languagetext
themeEclipse
$ mzsh system stop --tag tag1 container:.*/pico:.*

For further information about the the system command and how to add tags to pico instances, see system.

If you have not enabled remote access, you must login to each container and stop the pico instances with the mzsh shutdown command.

Code Block
languagetext

...

$ mzsh shutdown <pico-name-1> <pico-name-2> <...>

 

  1. Stop the Platform by entering the mzsh shutdown command:

    Code Block
    languagetext

...

  1. $ mzsh shutdown platform  

    The Platform must be the last of the pico instances to shut down. The reason for this is that the mzsh shutdown and mzsh system stop commands are issued through the Platform.

...

Note!

The Unix command kill should only be used when the shutdown command is not working, since it will force interruption of all processing instead of waiting until the next End Batch message is issued for each workflow. The use of this command may be necessary if the Platform is accidentally shut down prior to an Execution Context, for example.It is recommended that you stop workflows that depend on the specified pico instances before you run the mzsh shutdown command. Workflows that are active during shutdown, may remain in an active state or enter an unreachable state.

...

In both these cases, the workflows may need manual attention to ensure that they are deactivated.Set your desired environment variables in $MZ_HOME/bin/mzshr.env as this file will be loaded with local variables. Add the desired profiles, such as ". /home/mzadmin/.profile_mz".

Tip

Hint!

Use the following mzsh command to retrieve the running status of pico instances in the system:

Code Block
$ mzsh topo show status