Skip to main content

Illumio Core 23.5 Administration Guide

Useful VEN and OS Commands

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.exe or venPlatformHandler.exe.

  • Use the Illumio Core REST API. With the REST API, the agent-version key 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 illumio-ven-ctl status

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 illumio-ven-ctl status

/opt/illumio_ven/bin/agent_status.sh

Alternative to illumio-ven-ctl status

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 <options>

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

workloads

Report VEN workload status.

—

Y

Y

—

—

Y

Y

—

See also: