studio/blender-studio-tools
13
32
Fork 19
Code Issues 22 Pull Requests 4 Projects Releases 1 Activity

Docs: Improve Workstation Section #95

Merged
Nick Alberelli merged 11 commits from docs/td-maintence-guide into main 2023-06-27 19:04:40 +02:00
Conversation 0 Commits 11 Files Changed 2 +6 -6
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 9efa25717e - Show all commits

12
docs/td-guide/workstations/maintaince.md
View File

@ -1,7 +1,7 @@
# Workstation System Maintenance
## How to Update Build Server & Clients
To update Client Workstations; the Build Server will pull all of the latest changes from the [main gentoo repository](https://wiki.gentoo.org/wiki/Ebuild_repository#:~:text=The%20Gentoo%20ebuild%20repository%20is%20the%20main%20ebuild%20repository%20for,to%20be%20available%20to%20Portage.) and compile a system update. When done, it will ask if you want to push out the compiled changes to the clients. The clients checks for updates every five minutes. If the build server signals that there are updates, the clients will perform a sync, downloading the compiled packages from the build server and installing all updated packages.
To update Client Workstations; the Build Server will pull all of the latest changes from the [main gentoo repository](https://wiki.gentoo.org/wiki/Ebuild_repository#:~:text=The%20Gentoo%20ebuild%20repository%20is%20the%20main%20ebuild%20repository%20for,to%20be%20available%20to%20Portage.) and compile a system update. When done, it will ask if you want to push out the compiled changes to the clients. The clients ask for updates to be pushed from the build server every five minutes. If the build server signals that there are updates, the clients will perform a sync, downloading the compiled packages from the build server and installing all updated packages.
1. `ssh user@build-server-addr` connect to your build server via ssh
2. Use `su` to Login as root or login as root directly
@ -10,7 +10,7 @@ To update Client Workstations; the Build Server will pull all of the latest chan
## Update Add-ons in `/shared/software/addons`
The software inside the `shared/software/addons` directory are the [Blender Studio Pipeline Add-ons](https://studio.blender.org/pipeline/Add-ons/overview), the [Flamenco](https://flamenco.blender.org/) Add-on and any other Add-ons that need to be distributed to all Blender Studio Users. These Add-ons are considered Live Packages. Live Packages are packages that fetch updates from the source repository directly and are not tied to a specific release.
The software inside the `shared/software/addons` directory are the [Blender Studio Pipeline Add-ons](/addons/overview), the [Flamenco](https://flamenco.blender.org/) Add-on and any other Add-ons that need to be distributed to all Blender Studio Users. These Add-ons are considered Live Packages. Live Packages are packages that fetch updates from the source repository directly and are not tied to a specific release. To update packages not included in `/shared/software/addons` see [Installing Software](/user-guide/workstations/installing-software)
::: warning Temporary Solution
This is a temporary solution that will be depreciated and replaced with project based Add-ons.
@ -18,11 +18,11 @@ This is a temporary solution that will be depreciated and replaced with project
1. `ssh user@build-server-addr` connect to your build server via ssh
2. Use `su` to Login as root or login as root directly
3. Run `emerge -1 {package-name}` to update a live package.
- Run `emerge -1 flamenco` to update the [Flamenco](https://flamenco.blender.org/) manager/add-on
- Run `emerge -1 blender-studio-tools` to update the studio Add-ons
3. Run `emerge --oneshot {package-name}` to update a live package.
- Run `emerge --oneshot flamenco` to update the [Flamenco](https://flamenco.blender.org/) manager/add-on
- Run `emerge --oneshot blender-studio-tools` to update the studio Add-ons
::: info Info
The command `emerge -1 {package-name}` compiles package, but does not add the packages to the [@world](https://wiki.gentoo.org/wiki/World_set_(Portage)), this means these packages will be removed when running `--depclean`. # TODO WHY
The command `emerge --oneshot {package-name}` compiles package, but does not add the packages to the [@world](https://wiki.gentoo.org/wiki/World_set_(Portage)), this means these packages will be removed when running `--depclean`. To learn more visit the [Gentoo Handbook](https://wiki.gentoo.org/wiki/Emerge#:~:text=fetchonly%20%2D%2Demptytree%20%40world-,Do%20not%20add%20dependencies%20to%20the%20world%20file,-If%20a%20dependency) # TODO WHY
:::
4. Run `date -R > /var/cache/update_info/timestamp.chk` to mark this update as the latest