switch to helium v0.2.1

README.md

@@ -6,9 +6,9 @@ This repository contains the artifacts of the paper _HElium: Scalable MPC among
     - The HElium repository
         - contains: the code for the HElium system 
         - hosted at [https://github.com/ChristianMct/helium]
-        - mirrored at [TODO]
+        - mirrored at https://zenodo.org/doi/10.5281/zenodo.11045945
     - The present artifact repository
-        - imports HElium at `v0.2.0`
+        - imports HElium at `v0.2.1`
         - contains:
             - an HElium application implementing the paper's experiment
             - an MP-SPDZ application implementing the paper's experiment
@@ -27,7 +27,12 @@ The following software are required on the machine(s) running the experiments:
  - [Python 3.x](https://www.python.org/downloads/)
  - `make`
 
- An Ansible playbook is provided to setup servers from SSH.
+The following Python packages are also required:
+ - `docker`
+ - `paramiko`
+
+ An Ansible playbook is provided to setup servers from SSH. [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) must be installed on your local
+ system in order to use it.
 
 ### Running locally
 1. Clone the artifact repository: `git clone https://github.com/ChristianMct/helium-artifacts && cd helium-artifacts`
@@ -45,10 +50,7 @@ with host names `<host1>` and `<host2>`, and that `<host1>` has publickey SSH ac
 the experiment and run the session nodes, while `<host2>` will run the helper "cloud". 
 
 1. Setup the servers with Ansible: `ansible-playbook -i <host1>,<host2> ../conf/ansible/setup_server.pb.yml`
-3. SSH into `<host2>`
-2. Build the image on `<host2>`: TODO
 3. SSH into `<host1>`
-2. Build the image on `<host2>`: TODO
 3. Open the experiment runner script `./helium/exp_runner/main.py`
 4. Change the docker host name for the cloud: `CLOUD_HOST = 'localhost'` => `CLOUD_HOST = '<host2>'`
 1. Run the experiment: `python3 exp_runner/main.py >> results`

conf/ansible/setup_server.pb.yml

@@ -62,8 +62,6 @@
         version: main
 
     - name: Build the helium experiment image
-      community.docker.docker_image:
-        build:
-          path: ./helium-artifacts/helium
-        tag: exp:helium
-        source: build
+      community.docker.docker_image_build:
+        name: exp:helium
+        path: ./helium-artifacts/helium

helium/go.mod

@@ -5,7 +5,7 @@ go 1.21
 toolchain go1.22.2
 
 require (
-	github.com/ChristianMct/helium v0.2.0
+	github.com/ChristianMct/helium v0.2.1
 	github.com/stretchr/testify v1.9.0
 	github.com/tuneinsight/lattigo/v5 v5.0.2
 	golang.org/x/exp v0.0.0-20240314144324-c7f7c6466f7f

helium/go.sum

@@ -2,8 +2,8 @@ cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMT
 github.com/ALTree/bigfloat v0.2.0 h1:AwNzawrpFuw55/YDVlcPw0F0cmmXrmngBHhVrvdXPvM=
 github.com/ALTree/bigfloat v0.2.0/go.mod h1:+NaH2gLeY6RPBPPQf4aRotPPStg+eXc8f9ZaE4vRfD4=
 github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
-github.com/ChristianMct/helium v0.2.0 h1:Z6RZXUiY2kXnFJccb8lJ1UR6C2bHt9sIPHDCOynnPeg=
-github.com/ChristianMct/helium v0.2.0/go.mod h1:rmv8iBic97NZhEv4/ZnoKEeiQcu8qi+cSfCoVU3ZREo=
+github.com/ChristianMct/helium v0.2.1 h1:z5+DSMBL+lrHVh8LJ9r+uzbJjtxfn3DPD8URKmYVQfY=
+github.com/ChristianMct/helium v0.2.1/go.mod h1:rmv8iBic97NZhEv4/ZnoKEeiQcu8qi+cSfCoVU3ZREo=
 github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU=
 github.com/cespare/xxhash/v2 v2.1.1/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=
 github.com/cespare/xxhash/v2 v2.2.0 h1:DC2CZ1Ep5Y4k3ZQ899DldepgrayRUGE6BBZ/cd9Cj44=