Skip to content

Commit da413f7

Browse files
authored
Remove processes (#4271)
1 parent 8a1eede commit da413f7

File tree

5 files changed

+19
-137
lines changed

5 files changed

+19
-137
lines changed

docs/dev/reference/changelog.md

+11-1
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,9 @@ aliases:
3030
- "/components/sensor/bme280/"
3131
- "/components/sensor/ds18b20/"
3232
- "/components/sensor/sensirion-sht3xd/"
33+
- /build/configure/processes/
34+
- /configure/processes/
35+
- /manage/reference/processes
3336
- /appendix/changelog/
3437
layout: "changelog"
3538
outputs:
@@ -41,6 +44,13 @@ date: "2024-09-18"
4144

4245
<!-- If there is no concrete date for a change that makes sense, use the end of the month it was released in. -->
4346

47+
{{% changelog color="removed" title="Processes" date="2025-05-06" %}}
48+
49+
Processes were removed in `viam-server` v0.74.0.
50+
Instead [use modules for control logic](/manage/software/control-logic/#add-control-logic-to-your-module).
51+
52+
{{% /changelog %}}
53+
4454
{{% changelog color="changed" title="Viam provisioning" date="2025-03-24" %}}
4555

4656
You can now set any `viam-agent` configuration values to customized defaults.
@@ -154,7 +164,7 @@ Backward compatibility is maintained for existing configurations.
154164

155165
{{% changelog color="removed" title="Managed Processes" date="2025-02-01" %}}
156166

157-
[Managed Processes](/manage/reference/processes/) are now deprecated and will be removed in a future version of `viam-server`.
167+
Managed Processes are now deprecated and will be removed in a future version of `viam-server`.
158168
Instead [use modules for control logic](/manage/software/control-logic/#add-control-logic-to-your-module).
159169

160170
{{% /changelog %}}

docs/manage/reference/processes.md

-86
This file was deleted.

docs/operate/reference/advanced-modules/custom-components-remotes.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ To add a custom resource as a [remote part](/operate/reference/architecture/part
3636
The new model must implement any functions of the built-in resource type marked as required in its [RDK API definition](/dev/reference/apis/).
3737
2. Register the custom component on a new gRPC server instance and start the server.
3838
3. Add the server as a [remote part](/operate/reference/architecture/parts/) of your machine.
39-
4. (Optional) [Configure a process](/manage/reference/processes/) to launch this remote server to ensure the remote server is always running alongside the rest of your machine.
39+
4. (Optional) Ensure the remote server automatically starts when the machine boots.
4040

4141
Each remote server can host one or many custom components.
4242

@@ -53,7 +53,7 @@ For more detailed instructions, see the full example in the [Python SDK document
5353
1. Register the custom component on a new gRPC server instance and start the server.
5454
You can do this with the [`viam.rpc` library](https://python.viam.dev/autoapi/viam/rpc/index.html) by creating a new `rpc.server.Server` instance.
5555
1. Add the server as a [remote part](/operate/reference/architecture/parts/) of your machine.
56-
1. (Optional) [Configure a process](/manage/reference/processes/) to launch this remote server to ensure the remote server is always running alongside the rest of your machine.
56+
1. (Optional) Ensure the remote server automatically starts when the machine boots.
5757

5858
Each remote server can host one or many custom components.
5959

docs/tutorials/custom/custom-base-dog.md

+5-47
Original file line numberDiff line numberDiff line change
@@ -423,59 +423,17 @@ Your local component configuration should look similar to the following:
423423
## Start the Freenove server
424424
425425
To operate the dog, you need to start the Freenove robot dog server (which you saved as <file>/home/fido/Freenove_Robot_Dog_Kit_for_Raspberry_Pi/Code/Server/main.py</file>).
426+
You can do this manually by SSHing into the Pi and running the following command from the <file>home/fido/Freenove_Robot_Dog_Kit_for_Raspberry_Pi/Code/Server/</file> directory:
426427
427-
Configure a [_process_](/manage/reference/processes/) to automatically start the server on boot so it is ready to receive commands from `viam-server`.
428-
429-
Click the **+** (Create) button next to your main part in the left-hand menu and select **Process**.
430-
431-
In the process configuration panel that appears, click on the name in the top left corner and rename it to `freenove`.
432-
Fill out the configuration panel as follows:
433-
434-
- **Executable**: The path to Python on your Pi, for example `/usr/bin/python`.
435-
If you're not sure what this path should be, run `which python` on your Pi command line to find it.
436-
- **Arguments**: Type in `main.py` and click **Add argument**.
437-
Then type `-tn` and click **Add argument** again.
438-
This flag starts the Freenove server without launching Freenove's GUI (which you don't need for this use case).
439-
- **Working directory**: `/home/fido/Freenove_Robot_Dog_Kit_for_Raspberry_Pi/Code/Server` (changing "/home/fido" to the name of your home directory where you downloaded the Freenove code).
440-
- **Logging**: Toggle to the **on** position so you can view logs for this server process.
441-
- **Execute once**: Leave this **off** so that the Freenove server will continue to run, and will restart if it crashes.
442-
443-
Click **Save**.
444-
445-
{{<imgproc src="/tutorials/custom-base-dog/process-config.png" resize="400x" declaredimensions=true alt="Screenshot of the Processes subtab of the Config tab, showing a process configured as detailed above." class="shadow">}}
446-
<br>
447-
448-
{{% expand "Click to see what the processes config looks like in JSON mode." %}}
449-
450-
```json
451-
"processes": [
452-
{
453-
"log": true,
454-
"name": "/usr/bin/python",
455-
"cwd": "/home/fido/Freenove_Robot_Dog_Kit_for_Raspberry_Pi/Code/Server",
456-
"args": [
457-
"main.py",
458-
"-tn"
459-
],
460-
"one_shot": false,
461-
"id": "freenove"
462-
}
463-
]
428+
```sh {class="command-line" data-prompt="$"}
429+
sudo python main.py -tn
464430
```
465431
466-
{{% /expand %}}
432+
Alternatively you can add this command to your module's `run.sh` file.
433+
That way the Freenove robot dog server will start running when the module starts.
467434

468435
{{% alert title="Tip" color="tip" %}}
469436

470-
If you prefer not to start the Freenove server every time the machine boots, you can instead start it manually from your command line.
471-
472-
SSH into the Pi.
473-
From the <file>home/fido/Freenove_Robot_Dog_Kit_for_Raspberry_Pi/Code/Server/</file> directory, start the Freenove robot dog server:
474-
475-
```sh {class="command-line" data-prompt="$"}
476-
sudo python main.py -tn
477-
```
478-
479437
{{% /alert %}}
480438

481439
## Driving the robot from the Viam app

netlify.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@
5757
[plugins.inputs]
5858

5959
# change this key to a new one any time you need to restart from scratch
60-
cacheKey = ["Apr242025"]
60+
cacheKey = ["May022025"]
6161
# either "warn" or "error"
6262
failBuildOnError = true
6363

0 commit comments

Comments
 (0)