Versions Compared

Old Version 1

changes.mady.by.user Kevin Wu

Saved on

compared with

New Version Current

changes.mady.by.user Felicity Borrelli

Saved on

Key

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

This command is used to:

  • list, add, or delete EC groups

  • view pico instances

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

This command is used to:

...

title

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
    Note
    		Note!
    -
    ...
    list
    usage: pico -list <ip/host> ...pico 
    Use pico -list  to list configured pico instances to list available EC groups.
     Info
    title
    Example - 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_standardecgroup2    ec 
ecgroup1  10.0.0.48 
ec_standard    ec    10.46.100.26 
    -view
    usage: pico -view <pico name>
    Use pico -view to view the status of pico instances in the  systemsystem.
    title
     Info
    Example - pico -view
    The following displays the status for all pico instances in the system.
     Code Block
    theme
    languagetextEclipse
    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 https://infozone.atlassian.net/wiki/x/krSqBg. 
    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
    languagetextthemeEclipse
    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  systemsystem.
     Info
    title
    Example - pico -add
    The following command adds an EC named ec1 to host 10.0.0.48.group named ecgroup1.
     Code Block
    theme
    languagetextEclipse
    mzsh <username>/<password> pico -add ec1 ec 10.0.0.48 ecgroup1
    Output:
     Code Block
    languagetext
    Group ecgroup1 added      
    -delete
    usage: pico -delete <ec group name> <EC> <ip/host>
    Use pico -delete to delete a pico instance an EC group from the system.
    title
     Info
    Example - 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 ecgroup1
    Output:
     Code Block
    languagetext
    Group ecgroup1 deleted      
    -mark_for_shutdown
    usage: pico -mark_for_shutdown  <ec name> <EC> <ip/host> <true | false> <ec1 localhost true>
    Use pico -mark_for_shutdown to signal to the Platform that an EC is EC is scheduled to be shut down. As a result, the Platform will no not assign workflows to the EC/ECSA.
     Info
    title
    Example - 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 pico -mark_for_shutdown ec1 ec 10.0.0.48 true localhost true
    Output:
     Code Block
    languagetext
    OK       
    Return Codes
    Listed below are the different return codes for the pico command:
    Code
    Description
    0
    Will be returned if the command was successful, or if arguments are missing.
    1
    Will be returned if arguments 
     could 
    can not be parsed
    2
    Will be returned if the communication with the Platform 
     failed
    fails.
    3
    Will be returned if checking of user privileges failed, or if pico already exists when trying to add a new pico.
    4
    Will be returned if the user does not have permission to add or delete picos.
    5
    Will be returned if an unexpected error 
     occurred
    occurs.