Skip to content

Commit

Permalink
docs: Troubleshoot when /tmp is read-only in paratime-node
Browse files Browse the repository at this point in the history
  • Loading branch information
uscinski committed Nov 13, 2023
1 parent e80dfd3 commit 28f329a
Showing 1 changed file with 27 additions and 0 deletions.
27 changes: 27 additions & 0 deletions docs/node/run-your-node/paratime-node.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -421,6 +421,33 @@ In case of `bwrap` issues you need to adjust your Seccomp or AppArmor profiles t
--security-opt seccomp=unconfined \
```

### Bubblewrap Fails to Create Temporary Directory

If the `/tmp` directory is not writable by the user running the node, the
Bubblewrap sandbox may fail to start the ParaTimes. In the logs you will see
errors about creating a temporary directory, like:

```json
{"caller":"sandbox.go:546","err":"failed to create temporary directory: mkdir /tmp/oasis-runtime1152692396: read-only file system","level":"error","module":"runtime/host/sandbox","msg":"failed to start runtime","runtime_id":"000000000000000000000000000000000000000000000000a6d1e3ebf60dff6c","ts":"2023-11-09T14:08:50.554629545Z"}
```

The node might report in the status field that a runtime has not been
provisioned yet, like:

```
oasis-node control status -a unix:/node/data/internal.sock | grep status
"status": "waiting for hosted runtime provision",
```

This can happen, for example, in Kubernetes, when the `readOnlyRootFilesystem`
setting in a Pod or container security context is set to `true`.

To resolve the issue, please make sure that the `/tmp` directory is writable by
the user running the node. If you are running the node in Kubernetes, you can
set the `readOnlyRootFilesystem` setting to `false`, or better yet, mount a
dedicated volume into `/tmp`. It can be very small in size, e.g., `1 MiB` is
enough.

### Stake Requirement

Double check your node entity satisfies the staking requirements for a ParaTime node. For details see the [Stake Requirements](paratime-node.mdx#stake-requirements) section.
Expand Down

0 comments on commit 28f329a

Please sign in to comment.