Merge pull request #128 from lukemartinlogan/main

add passwordless ssh and long running

Author: lukemartinlogan

docs/11-iowarp/03-components/03-runtime/09-long-running.md

@@ -0,0 +1,51 @@
+# Long-Running Tasks
+
+Long-running (i.e., periodic) tasks are periodically scheduled on an interval.
+This can be used for things like monitoring and batching requests.
+
+Below is an example of PollStatsTask, which gets periodically scheduled.
+```cpp
+struct PollStatsTask : public Task, TaskFlags<TF_SRL_SYM> {
+  OUT BdevStats stats_;
+
+  /** SHM default constructor */
+  HSHM_INLINE_CROSS_FUN
+  explicit PollStatsTask(const hipc::CtxAllocator<CHI_ALLOC_T> &alloc)
+      : Task(alloc) {}
+
+  /** Emplace constructor */
+  HSHM_INLINE_CROSS_FUN
+  explicit PollStatsTask(const hipc::CtxAllocator<CHI_ALLOC_T> &alloc,
+                         const TaskNode &task_node, const PoolId &pool_id,
+                         const DomainQuery &dom_query, u32 period_ms)
+      : Task(alloc) {
+    // Initialize task
+    task_node_ = task_node;
+    pool_ = pool_id;
+    method_ = Method::kPollStats;
+    if (period_ms) {
+      task_flags_.SetBits(TASK_PERIODIC);
+      prio_ = TaskPrioOpt::kHighLatency;
+    } else {
+      task_flags_.SetBits(0);
+      prio_ = TaskPrioOpt::kLowLatency;
+    }
+    dom_query_ = dom_query;
+
+    SetPeriodMs(period_ms);
+    HILOG(kInfo, "PollStatsTask: period_ms={}", period_ms);
+  } 
+};
+```
+
+There are two things that make a task scheduled periodically.
+1. ``task_flags_.SetBits(TASK_PERIODIC)``: This will mark the task as periodically scheduled. There is now a
+``TASK_LONG_RUNNING`` flag which is an alias to ``TASK_PERIODIC``.
+1. ``SetPeriodMs(period_ms)``: This sets the minimum amount of time to elapse before rescheduling this task.
+
+There are several different timing functions:
+1. ``SetPeriodNs``
+1. ``SetPeriodUs``
+1. ``SetPeriodMs``
+1. ``SetPeriodSec``
+1. ``SetPeriodMin``

docs/81-jarvis/02-jarvis-cd/01-index.mdx

@@ -149,6 +149,29 @@ pipeline. Jarvis does not automatically detect changes to this file.
 jarvis ppl update
 ```
 
+## Set Up Passwordless SSH
+
+When working with more than one node, passwordless SSH is nice-to-have. While most
+HPC machines are already equipped with this, some types such as Chameleon Cloud,
+Cloudlab, and other bare-metal deployments do not. Jarvis comes with some tools to help
+bootstrap this. Here is an example for Chameleon.
+
+Let's say that your chameleon node is 129.127.0.124. First, we need to copy the SSH key there.
+```bash
+jarvis ssh copy ~/.ssh/id_ed25519 129.127.0.124
+```
+
+Next, you have to copy that key to all nodes. First, construct a hostfile containing all nodes
+you have allocated
+```bash
+jarvis hostfile set ~/hostfile.txt
+```
+
+Lastly, distribute the key. 
+```bash
+jarvis ssh distribute ~/.ssh/id_ed25519
+```
+
 ## Building a Resource Graph
 
 NOTE: This step only needs to be run if you did ``jarvis bootstrap from local`` or ``jarvis init``.