README

******** Clone Repositories *********

-- Clone Palacios --
git clone http://essex.cs.pitt.edu/git/palacios.git

-- Clone Pisces --
git clone http://essex.cs.pitt.edu/git/pisces.git

-- Clone PetLib --
git clone http://essex.cs.pitt.edu/git/petlib.git

-- Clone XEMEM --
git clone http://essex.cs.pitt.edu/git/xpmem.git

-- Clone Kitten --
git clone  https://software.sandia.gov/git/kitten



******** Set Configs *********

-- Kitten configuration parameters --
Target Configuration -->System Architecture -->  Multi-instance environment
CONFIG_PISCES=y

Virtualization --> Include Palacios virtual machine monitor -->
    Internal/External Palacios libirary --> Link in Palacios as a self contained module
CONFIG_PALACIOS=y
# CONFIG_PALACIOS_INTERNAL is not set
CONFIG_PALACIOS_EXTERNAL=y
CONFIG_PALACIOS_PATH="/path/to/palacios"


-- Palacios configuration parameters --
V3_CONFIG_KITTEN=y
V3_CONFIG_KITTEN_KERN="/path/to/kitten"



******** Building *********

-- Building Environment -
(1) Build PetLib
(2) Build XEMEM
(3) Build Kitten
(4) Build Palacios
(5) Build Kitten again to link Palacios lib
(6) Build Pisces


******** Pisces Enclave Control *********

-- Launching Pisces Enclave --
From xpmem directory run 'insmod xpmem.ko'
From pisces directory run 'insmod pisces.ko'

(In pisces/linux_usr)
./pisces_load /path/to/vmlwk.bin /path/to/pisces_init_task 'console=pisces'
./pisces_launch [-n <numa_node>] [-c <cpu_id>] /dev/pisces-enclave0


-- Add memory/cpus to enclave --
./pisces_add [-n <numa_node>] -m <num memory blocks> /dev/pisces-enclave0
./pisces_add [-n <numa_node>] -c <num cpus> /dev/pisces-enclave0


-- Add PCI devices to enclave --
./v3_pci -a <device_name> <bus>:<dev>.<fn> /dev/pisces-enclave0


-- Connecting to Pisces console --
./pisces_cons /dev/pisces-enclave0


******** Palacios VM Control *********

-- Create Palacios VM --
./v3_create /dev/pisces-enclave0 -b /path/to/vm/config <vm name> /dev/pisces-enclave0


-- Launch Palacios VM
./v3_launch /dev/pisces-enclave0 0


-- Connecting to Palacios VM Console --
./v3_cons_sc /dev/pisces-enclave0 0