Fabric-API

This repository contains the code for construct Fabric-testbed environment on local desktops/Palmetto.

Install the FABRIC Python API

The FABRIC API is available in the following github repo Please refer more information at Fabric document

# create conda environment named fabrictestbed
conda env create -f environment.yml

# activate the conda environment 
conda activate fabrictestbed

Bastion Key and sliver key

Download your Bastion SSH key and Sliver key from the Fabric Portal

Tokens

Download your tokens from the Fabric Portal

Run the experiment

Jupyter Notebook

If your shell support Jupyter Notebook to launch, it could install Jupyter in the conda environment using pip3.

pip3 install jupyter
# Clone the github repo that include the example notebooks.
git clone https://github.com/fabric-testbed/jupyter-examples.git
# Some of the examples use bash. You can install the Jupyter bash kernel if you want to use these notebooks.
pip3 install bash_kernel
python -m bash_kernel.install
# Run the FABRIC table of contents notebook.
jupyter-notebook jupyter-examples/start_here.ipynb

The data transfer can be achieved by the example Jupyter Notebook upload_and_execute.ipynb

Terminal

If your shell only can run python scripts, please refer the python scripts under bin floders. Please fill up the required information in env_set

• Bastion username
• Project ID
• Bastion private key
• Sliver private key
• Sliver public key
• Tokens
• Fabric log file

# submit the slice request 
./bin/create_slice.py
# print the node information
./bin/print_node_info.py
# upload or download data 
./bin/transfer_data.py