diff --git a/docs/usage/pro/frame/tutorials/day-1/remote-assistance/machine-admin-home.png b/docs/usage/pro/frame/tutorials/day-1/remote-assistance/machine-admin-home.png index f10004e8b..0a02aea48 100644 Binary files a/docs/usage/pro/frame/tutorials/day-1/remote-assistance/machine-admin-home.png and b/docs/usage/pro/frame/tutorials/day-1/remote-assistance/machine-admin-home.png differ diff --git a/docs/usage/pro/frame/tutorials/day-1/shutdown/README.md b/docs/usage/pro/frame/tutorials/day-1/shutdown/README.md index be9ca4ac7..956c93b3e 100644 --- a/docs/usage/pro/frame/tutorials/day-1/shutdown/README.md +++ b/docs/usage/pro/frame/tutorials/day-1/shutdown/README.md @@ -4,29 +4,57 @@ sidebar_position: 60 # Safe Shutdown -In this tutorial, we will shut down your FRAME machine without causing data corruption on your FRAME when unplugging it from power. +In this tutorial, we will shut down your FRAME machine and unplug it from power without causing data corruption on your FRAME. ## Shut down the operating system -First, let's open the FRAME's landing page in your web browser (we learned how to do this [in the First Connection tutorial](../first-connection/README.md#open-the-frames-web-browser-landing-page)): +First, let's open the FRAME's landing page in your web browser (we learned how to do this [in the First Connection tutorial](../first-connection/README.md#open-the-frames-web-browser-landing-page)). +Next, open the Machine Administration app from the landing page (we learned how to do this [in the Remote Assistance tutorial](../remote-assistance/README.md#connect-your-frame-to-the-internet-via-wi-fi)). +You should now see the homepage of the Machine Administration app: ![Machine Admin app homepage](./machine-admin-home.png) -In the screenshot above, we can see three buttons: "Soft reboot", "Full reboot", and "Shut down". +At the bottom of the screenshot above, we can see three buttons: "Soft reboot", "Full reboot", and "Shut down". These buttons allow you to reboot or shut down the operating system which is running on your FRAME's RPi computer; the operating system, called "[openUC2 OS](../../../../../components/os/README.md)", is responsible for: -- running all software on your FRAME +- running all software on your FRAME (including the Machine Administration app) - managing your FRAME's data storage devices and network interfaces -Now press the "Shut down" button to shut down the operating system. -When you do this, the operating system will: +Now press the "Shut down" button in order to shut down the operating system: -- finish writing and saving any files it was in the middle of creating/modifying, to avoid data loss or data corruption +![Machine Admin app homepage: Boot section: Shut down button](./machine-admin-home-shutdown.png) + +Then you will see an indefinite progress bar under the "Shut down" button, as well as a message indicating that the operating system is shutting down: + +![Machine Admin app homepage: Boot section: Shutting down message](./machine-admin-home-shutting-down.png) + +Now the operating system will: + +- stop all programs it was running (including the Machine Administration app) +- finish writing and saving any files it was in the middle of creating/modifying, in order to avoid data loss or data corruption - clean up after itself -This shutdown process will usually be complete within 30 seconds. +If you refresh the webpage in your web browser, then after several seconds your web browser will show you an error page indicating that it can't reach your FRAME: + +![Web browser: unreachable site error](./error-unreachable.png) + +You should expect to see some error similar to what's shown in the above screenshot (though your exact error message may be different), because your FRAME is now in the process of shutting down. + +The shutdown process will usually be complete within 30 seconds. Afterwards, it will be safe to unplug power from your FRAME. +:::info + +The "Shutting down..." message and progress bar (visible in the above screenshot) will continue to be displayed even after your FRAME has finished shutting down. + +::: + +:::tip + +You can also access the "Soft reboot", "Full reboot", and "Shut down" buttons from the System Settings page of ImSwitch. + +::: + ## Unplug power Now we will fully cut off power by unplugging the power adapter from the FRAME's power jack, which we had previously seen in the [first connection tutorial](../first-connection/README.md#turn-on-the-frame). diff --git a/docs/usage/pro/frame/tutorials/day-1/shutdown/error-unreachable.png b/docs/usage/pro/frame/tutorials/day-1/shutdown/error-unreachable.png new file mode 100644 index 000000000..7090ad444 Binary files /dev/null and b/docs/usage/pro/frame/tutorials/day-1/shutdown/error-unreachable.png differ diff --git a/docs/usage/pro/frame/tutorials/day-1/shutdown/machine-admin-home-shutdown.png b/docs/usage/pro/frame/tutorials/day-1/shutdown/machine-admin-home-shutdown.png new file mode 100644 index 000000000..f555dd215 Binary files /dev/null and b/docs/usage/pro/frame/tutorials/day-1/shutdown/machine-admin-home-shutdown.png differ diff --git a/docs/usage/pro/frame/tutorials/day-1/shutdown/machine-admin-home-shutting-down.png b/docs/usage/pro/frame/tutorials/day-1/shutdown/machine-admin-home-shutting-down.png new file mode 100644 index 000000000..c714e3041 Binary files /dev/null and b/docs/usage/pro/frame/tutorials/day-1/shutdown/machine-admin-home-shutting-down.png differ