create process executable

create process name executable exe {start [auto | on-demand]} {node node} {vr vr-name} {description description} {arg1 {arg2 { arg3 { arg4 { arg5 { arg6 { arg7 { arg8 { arg9 }}}}}}}}}

Description

Adds a C executable process compiled using the C-based SDK.

Syntax Description

process User application process.
name Name of the user application process. Range 1-31.
executable Executable.
exe Name of the executable relative to /usr/local/cfg.
start Startup behavior.
auto Create a daemon process and start it immediately
on-demand Create a run-to-completion process and use \"start process\.
node Node in stack in which to create the process.
node Primary node, backup node, or both (default is primary).
vr Virtual router in which to start the process.
vr-name Virtual router name (Default is VR-Mgmt).
description Description.
arg1-9 Variable value.

Default

VR-Mgmt is the default VR used if not specified.

If no selection is made, the process runs on-demand.

If no node is selected, the default is the primary node.

Usage Guidelines

The executable must be uploaded to /usr/local/cfg using the normal mechanisms (for example, TFTP).

Fields are provided by the user and passed directly into an epmrc entry. Not all epmrc fields are available.

This command adds C executable processes. To add a Python module, use the create process python-module command.

A process must first exist on the primary node if you are creating it only on the backup node, If a process already exists on the primary node, you cannot create it on both the primary and secondary node. Also, if the backup node is down, a new process cannot be created on it.

Example

create process foo_userd executable foobard start auto vr VR-Default description “Run foobard on the default VR” “arg1” “arg2 with spaces”
The following error is displayed if an attempt is made to create a process with an invalid name:
Error: Process name %s is invalid.  Process names must begin with a letter, contain only alphanumeric and
“_” characters, and be less than 32 characters long.

History

This command was first available in ExtremeXOS 15.7.

Platform Availability

This command is available on all Universal switches supported in this document.