Versions Compared

Old Version 1

changes.mady.by.user Kevin Wu

Saved on

compared with

New Version 2

changes.mady.by.user Former user

Saved on

Key

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

...

Code Block
Usage: pico -list <ip/host> ... | -view <pico name> | -add <ec name> <EC> <ip/host>group name> | -delete <ec name> <EC> <ip/host> | -mark_for_shutdown <ec name> <EC> <ip/host> <true | false>group name>

This command is used to:

  • Listlist, view, add add, or delete pico instancesSignal to the Platform that an EC is scheduled to be shut down
Note
titleNote!

With the introduction of STR, it is typically no longer required to add pico instances. Provided that the value of the property pico.rcp.server.host is set to its default value or that the value can be found in the address attribute of the container, EC, and SCs are implicitly added via the STR.

If pico.rcp.server.host does not match with any of the container addresses you can grant access to the system by:

  • Adding the missing address in the container attribute additional-addresses in the STR.
  • Setting the Platform property mz.pico.skip-registration-check to true. This will grant access for any pico host.
  • Adding a new pico host in the Pico Manager.

...

  • EC groups
  • view pico instances

-list

usage: pico -list <ip/host> ...pico 

Use pico -list  to list configured pico instances to list available EC groups.
Info
titleExample - pico -list

The following commands lists all pico hosts and pico instanceslist all EC groups.

Code Block
languagetext
themeEclipse
mzsh <username>/<password> pico -list


Output:

Code Block
languagetext
themeEclipse
ec_standard  ecgroup2  ec 
  10.0.0.48ecgroup1  ec_standard    ec    10.46.100.26


-view

usage: pico -view <pico name>

...

Info
titleExample - pico -view

The following displays the status for all pico instances in the system.

Code Block
languagetext
themeEclipse
mzsh <username>/<password> pico -view

Output:

Code Block
languagetext
themeEclipse
Pico                 Start       Memory                 Response      Error    Marked For
Name                 Time        (Used, Commited, Max)  Time (ms)     Status   Shutdown
ec1 (ip:port)        <time>      1.1, 24.2, 27.6        1             OK       true             
ec2 (ip:port)        <time>      1.2, 23.3, 28.7        1             OK            
MZSH:45881 (ip:port) <time>      5.9, 15.5, 47.5        2             OK                    
Platform (ip:port)   <time>      8.2, 20.0, 27.6        2             OK

The Memory column is a comma-separated list of Used, Committed and Maximum memory, and Response Time is measured in milliseconds.

If Error Status indicates "Error", an OutOfMemoryError has occurred and additional information will be included in the output. For example, in case of an OutOfMemoryError on the Platform, the following could be shown:

Code Block
languagetext
themeEclipse
Platform: Mon Jan 23 09:59:47 CET 2012 OutOfMemoryError on platform at platform-e6410. 
See log/platform.log for more information

OutOfMemoryError is further described in Out of Memory Info in System Log.

If Error Status indicates "Connection failure", an RCP error has occurred.

If Marked for Shutdown is set to true, the EC is scheduled to be shut down and will not be assigned workflows.

The following command displays the status of the pico instance named ec1.

Code Block
languagetext
themeEclipse
mzsh <username>/<password> pico -view ec1

Output:

Code Block
languagetext
themeEclipse
Pico Name:        ec1 (10.0.0.8:37197)
OS:               LINUX
OS Version:       2.6.38-11-generic-pae
Architecture:     I386
Processors:       8
Java Version:     1.8.0_121
Loaded Classes:   2854


-add

usage: pico -add <ec group name> <EC> <ip/host>

Use pico -add to add a pico instance an EC group to the  system.

Info
titleExample - pico -add

The following command adds an EC group named ec1 to host 10.0.0.48.ecgroup1.

Code Block
languagetext
themeEclipse
mzsh <username>/<password> pico -add ec1 ec 10.0.0.48ecgroup1


-delete

usage: pico -delete <ec group name> <EC> <ip/host>

Use pico -delete to delete a pico instance an EC group from the system.

Info
titleExample - pico -delete

The following command deletes an EC named ec1 from host 10.0.0.48group named ecgroup1.

Code Block
languagetext
themeEclipse
mzsh <username>/<password> pico -delete ec1 ec 10.0.0.48

mark_for_shutdown

usage: pico -mark_for_shutdown <ec name> <EC> <ip/host> <true | false>

Use pico -mark_for_shutdown to signal to the Platform that an EC is scheduled to be shut down. As a result, the Platform will no assign workflows to the EC.

Info
titleExample - pico -mark_for_shutdown

The following command signals that the EC named EC1 on 10.0.0.48 should not be assigned workflows.

Code Block
languagetext
themeEclipse
mzsh <username>/<password> pico -mark_for_shutdown ec1 ec 10.0.0.48 trueecgroup1



Return Codes

Listed below are the different return codes for the pico command:

...