This topic provides is a short description of the VEN command-line tools that you commonly use for various operations, and some useful native OS commands. Syntax for the VEN-provided commands is detailed throughout this guide, and in the help of the commands themselves.
Additionally, this topic lists the availability of the VEN commands across operating systems.
Verify VEN Version Number
You can verify the version of the VEN software in several different ways:
- View the VEN version in the PCE web console.
-
Run the following command on the workload:
# /opt/illumio_ven/illumio-ven-ctlversion 21.5.0-xxxx -
Run the following command on a Windows workload:
PS C:\Users\Administrator> & 'C:\Program Files\Illumio\illumio-ven-ctl.ps1' version21.5.0-xxxx - Examine the columns in Add or remove programs or Task Manager.
- Examine the Properties > Details tab of
venAgentMgr.exeorvenPlatformHandler.exe. - Use the Illumio Core REST API. With the REST API, the
agent-versionkey and value are returned in the payload of every response.
Commonly Used VEN Commands
|
Platform |
Command |
Description |
|---|---|---|
|
Linux |
/opt/illumio_ven/illumio-ven-ctl
|
VEN Linux shell control script to control VEN control VEN settings and functions |
/opt/illumio_ven/bin/agent_status.sh
|
Alternative to |
|
ps
|
Native OS command to list all system processes |
|
chkconfig
|
Native OS command to update and query runlevel information for system services |
|
|
Windows |
C:\Program Files\Illumio\illumio-ven-ctl.ps1
|
VEN PowerShell script to control VEN settings and functions |
Get-Service
|
Native OS PowerShell command to display system services |
|
tasklist /svc
|
Native OS command to display system services |
|
wf.msc
|
Native OS command to manage the Windows firewall |
|
| AIX/Solaris | /opt/illumio_ven/illumio-ven-ctl
|
VEN AIX/Solaris shell control script to control VEN control VEN settings and functions |
/opt/illumio_ven/bin/agent_status.sh
|
Alternative to |
|
/opt/illumio_ven/bin/agent_status.sh
|
Alternative to |
|
ps
|
Native OS command to list all system processes |
|
| AIX | lssrc
|
Native OS command to list OS subsystem status |
| Solaris | svcs
|
Native OS command to list OS service status |
illumio-ven-ctl Command Options by OS
The following tables details the illumio-ven-ctl command support by operating system:
|
Command |
Description |
AIX |
CentOS | Debian | RHEL |
Solaris |
SUSE | Ubuntu | Windows |
|---|---|---|---|---|---|---|---|---|---|
|
|
Activate VEN. |
Y |
Y | Y | Y | Y | Y | Y | Y |
backup
|
Backup VEN data. | — | Y | Y | Y | — | Y | Y | Y |
check-env
|
Check VEN runtime_env.yml settings. |
Y | Y | Y | Y | Y | Y | Y | Y |
conncheck
|
Query VEN policy. | Y | Y | Y | Y | Y | Y | Y | |
connectivity-test
|
Test connectivity with PCE. | Y | Y | Y | Y | Y | Y | Y | Y |
deactivate <options>
|
Deactivate VEN without uninstalling. | Y | Y | Y | Y | Y | Y | Y | Y |
gen-supportreport <options>
|
Generate VEN support reports. | Y | Y | Y | Y | Y | Y | Y | Y |
prepare
|
Prepare VEN image. | Y | Y | Y | Y | Y | Y | Y | Y |
restart
|
Restart VEN services. | Y | Y | Y | Y | Y | Y | Y | Y |
restore
|
Restore VEN dataillumio-ven-ctl. |
— | Y | Y | Y | — | Y | Y | Y |
start
|
Start VEN services. | Y | Y | Y | Y | Y | Y | Y | Y |
status
|
Report VEN status. | Y | Y | Y | Y | Y | Y | Y | Y |
stop
|
Stop VEN services. | Y | Y | Y | Y | Y | Y | Y | Y |
suspend
|
Suspend VEN (enter emergency state). | Y | Y | Y | Y | Y | Y | Y | Y |
unpair <options>
|
Unpair VEN. | — | Y | Y | Y | Y | Y | Y | Y |
unsuspend
|
Unsuspend VEN (exit emergency state). | Y | Y | Y | Y | Y | Y | Y | Y |
version
|
Display VEN version. | Y | Y | Y | Y | Y | Y | Y | Y |
|
|
Report VEN workload status. | — | Y | Y | — | — | Y | Y | — |