DISTEM

NAME

distem - manual page for distem 1.2

SYNOPSIS

distem --coordinator [host=HOSTNAME,[port=PORT]] option

DESCRIPTION

-h, --help

Display this screen

--coordinator host=HOST[,port=PORT]

Specify the HOST and the PORT of the coordinator

Physical node management:
--init-pnode PNODE1[,PNODE2,...,PNODEN]

Init the physical node(s)

--max-vifaces NB

Set the maximum number of vifaces on a physical node (used only with --init-pnode)

--quit [PNODE]

Close the given PNODE or all the physical nodes

Virtual node management:
--create-vnode
vnode=VNODE,rootfs=FILE[,pnode=PNODE,sshprivkey=FILE,sshpubkey=FILE]

Create the virtual node VNODE deploying FILE

--start-vnode VNODE

Start the virtual node VNODE

--stop-vnode VNODE

Stop the virtual node VNODE

--remove-vnode [VNODE]

Remove VNODE or all the vnodes if VNODE is not specified

File system management:
--copy-to vnode=VNODE,src=SRC,dest=DEST[,user=USER]

Copy the file SRC on host to DEST on VNODE

--copy-from vnode=VNODE,src=SRC,dest=DEST[,user=USER]

Copy the file SRC on VNODE to DEST on host

--get-image vnode=VNODE[,dest=DIRECTORY]

Get a compressed image file of the filesystem of VNODE

--shell VNODE

Open a shell on VNODE

--execute vnode=VNODE,command=COMMAND[,user=USER]

Execute a command COMMAND on VNODE

Network management:
--create-vnetwork vnetwork=VNET,address=ADDRESS

Create VNET with ADDRESS (ip/mask or ip/prefix)

--remove-vnetwork [VNET]

Remove VNET or all the vnetworks if VNET is not specified

--create-viface
vnode=VNODE,iface=IFACE[,vnetwork=VNET,address=ADDRESS,default=true|false]

Create VIFACE on VNODE

--remove-viface vnode=VNODE,iface=IFACE

Remove VIFACE on VNODE

--create-vroute vnetsrc=VNETSRC,vnetdest=VNETDEST,gateway=IP

Create a route between VNETSRC et VNETDST (names) using IP as a gateway (affect all the vnodes in VNETSRC)

--complete-vroutes

Create every possible route for each vnode

--config-viface
vnode=VNODE,iface=IFACE[,bw=VALUE|unlimited,latency=VALUE|none,direction=INPUT|OUTPUT]

Set a bandwidth or a latency limitation on IFACE with a given value and eventually a given direction

Memory management:
--set-vmem vnode=VNODE,mem=SIZE,swap=SIZE

Set a memory limitation (SIZE is supposed to be specified in MB)

CPU management:
--set-vcpu vnode=VNODE,corenb=NB,cpu_speed=VAL|unlimited,unit=mhz|ratio

Set a virtual CPU on VNODE with NB cores clocked at SPEED mhz or percent (if not specified, unit is mhz)

--config-vcpu vnode=VNODE,cpu_speed=VAL|unlimited,unit=mhz|ratio

Update the clock of the virtual CPU on VNODE (if not specified, unit is mhz)

Getting some information:
--get-pnode-info [PNODE]

Show information about PNODE if specified, or about all the physical nodes

--get-vnode-info [VNODE]

Show information about VNODE if specified, or about all the virtual nodes

--get-vnetwork-info [VNET]

Show information about VNET if specified, or about all the virtual networks

Global platform management:
--set-global-etchosts

Set a global /etc/hosts file on every virtual nodes

--set-global-arptable

Set a global ARP table on every virtual nodes

--save-config [configfile=FILE]

Save the virtual platform in JSON (if configfile is not specified, save to STDOUT)

--load-config format=JSON|SIMGRID[,configfile=FILE,rootfs=FILE]

Load the virtual platform from the given format(if configfile is not specified, load from STDIN)