...
| Info |
|---|
The details for these commands is in Yarnman Photon Powered (YM-PH) - Deployment and InstallationInstallation and Upgrade Guide |
ym-set-static-ip.sh
| Code Block |
|---|
sudo ym-set-static-ip.sh |
ym-generate-certs.sh
| Code Block |
|---|
sudo ym-generate-certs.sh |
ym-install.sh
| Code Block |
|---|
sudo ym-install.sh |
Upgrade
| Note |
|---|
All yarnman upgrade commands need to be run with sudo |
...
| Info |
|---|
This command upgrades yarnman |
| Warning |
|---|
Take a vmware snapshot before starting the upgrade process |
Copy the upgrade file into /var/opt/yarnlab/upgrade eg wget http or if Web access from Yarnman type wget https://xxxxxxxx or sftp/scp the file onto the yldev.blob.core.windows.net/yl-ph-staging-updates/<update file package name> or sftp/ftp/scp the file onto the server
SSH into the yarnman host and change into the directory /var/opt/yarnlab/upgrade
run the command yarnman@host [ ~ ]$ sudo ym-upgrade.sh upgradefile.tar.gz
| Code Block |
|---|
Yarnman Upgrade file found /var/opt/yarnlab/upgrade/| Info |
|---|
Note that you may need to rename the file to the following format if you ssh client cannot accept : ym-registry:package-upgrade- ylmaster- ph<version>- 8023676b<build>.tar.gz
Do you want to upgrade yarnman to i.e. ym-registry:package-upgrade-master-2.6.5-81d5809c.tar.gz |
run the command yarnman@host [ ~ ]$ sudo ym-upgrade.sh ym-registry:package-upgrade-master-2.6.5-81d5809c.tar.gz
| Code Block |
|---|
Yarnman Upgrade file found /var/opt/yarnlab/upgrade/ym-registry:package-upgrade-yl-ph-8023676b.tar.gz
? Do you want to upgrade yarnman to ym-registry:package-upgrade-yl-ph-8023676b.tar.gz ? Y or Ny
Upgrade yarnman
Stopping yarnman services
Stopping local registry containers
Removing local registry images
Loading local registry package tgz
Loaded image: ym-registry:package
Launching yarnman registry
f39ac12322df9a3add72c0ad135e691c6fc3ca0fc7be463a5b4534b88e8e68e6
Loading upgrade pre-req script from registry container
Starting upgrade pre-req script
TEMP upgrade script
Setting up tang
groupadd: group 'ym-tang-app-gp' already exists
Showing package container registry catalog
{"repositories":["ym-couchdb","ym-ostree-upgrade","ym-redis","ym-tang","ym-yarnman"]}
{"name":"ym-ostree-upgrade","tags":["yl-ph-8023676b"]}
{"name":"ym-yarnman","tags":["yl-ph-8023676b"]}
[+] Running 2/4
*** lots of docker pull output ***
*** lots of ostree output ***
State: idle
Deployments:
photon:photon/4.0/x86_64/yarnman
Version: 4.0_yarnman (2022-11-16T23:54:09Z)
Commit: 9941830a095f3a8630eabca846414afa03a935e95462845f7e71cc17f8437438
GPGSignature: Valid signature by 352365935446AC840528AF8703F9C95608035F3C
Diff: 15 added
● photon:photon/4.0/x86_64/yarnman
Version: 4.0_yarnman (2022-11-14T04:04:13Z)
Commit: 7fe66e8afc639d7a006b60208b5981748426ef4487581924e897d69a7b7c87cd
GPGSignature: Valid signature by 352365935446AC840528AF8703F9C95608035F3C
Do you want to remove upgrade file ? Y or N
Removing :ym-registry:package-upgrade-yl-ph-n18-a23846af.tar.gz
Removing old containers
Removing old yarnman image :localhost:5000/ym-yarnman:yl-ph-n18-475aac7a
Removing old couchdb image :localhost:5000/ym-couchdb:yl-ph-n18-475aac7a
Removing old redis image :localhost:5000/ym-redis:yl-ph-n18-475aac7a
Removing old tang image :localhost:5000/ym-tang:yl-ph-n18-475aac7a
Do you want to reboot yarnman ? Y or N
Reboot yarnman |
| Note |
|---|
A reboot may be required to apply OS patches if they are bundled into the update. |
Service Commands
| Note |
|---|
All yarnman service commands need to be run with sudo |
ym-service-commands.sh start
| Info |
|---|
This command starts the yarnman | Note |
|---|
Ensure that the database upgrade is completed Yarnman database version updated to latest version x.y.z and is ready. if the database upgrade has not completed run https://yarnlab.atlassian.net/wiki/spaces/YSP/pages/2916745332/Yarnman+Photon+Powered+YM-PH+-+Command+Line+Interface+Guide+CLI#ym-service-commands.sh-update-yarnman-database |
Service Commands
| Note |
|---|
All yarnman service commands need to be run with sudo |
ym-service-commands.sh start
| Info |
|---|
This command starts the yarnman services |
| Code Block |
|---|
yarnman@yarnman-test [ ~ ]$ sudo ym-service-commands.sh start
starting yarnman.service
● yarnman.service - yarnman
Loaded: loaded (/usr/lib/systemd/system/yarnman.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2022-08-17 08:24:21 UTC; 5ms ago
Process: 56027 ExecStartPre=/usr/bin/docker-compose -f docker-compose.yml down (code=exited, status=0/SUCCESS)
Main PID: 56037 (docker-compose)
Tasks: 5 (limit: 4694)
Memory: 5.0M
CGroup: /system.slice/yarnman.service
└─56037 /usr/bin/docker-compose -f docker-compose.yml -f docker-compose-override.yml up --remove-orphans |
...
| Code Block |
|---|
yarnman@yarnman-test [ ~ ]$ sudo ym-service-commands.sh restart
restarting yarnman.service
● yarnman.service - yarnman
Loaded: loaded (/usr/lib/systemd/system/yarnman.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2022-08-17 08:27:36 UTC; 6ms ago
Process: 63277 ExecStartPre=/usr/bin/docker-compose -f docker-compose.yml down (code=exited, status=0/SUCCESS)
Main PID: 63287 (docker-compose)
Tasks: 6 (limit: 4694)
Memory: 4.9M
CGroup: /system.slice/yarnman.service
└─63287 /usr/bin/docker-compose -f docker-compose.yml -f docker-compose-override.yml up --remove-orphans
Aug 17 08:27:36 yarnman-test systemd[1]: Starting yarnman...
Aug 17 08:27:36 yarnman-test docker-compose[63277]: yarnman Warning: No resource found to remove
Aug 17 08:27:36 yarnman-test systemd[1]: Started yarnman.
|
ym-service-commands.sh reboot
| Info |
|---|
this command reboots the yarnman appliance |
| Code Block |
|---|
sudo ym-service-commands.sh reboot
rebooting yarnman |
ym-service-commands.sh status
| Info |
|---|
this command shows the systemd service status |
...
| Info |
|---|
This command shows the tag thp used for setting up configuration encryption |
| Code Block |
|---|
yarnman@ym-ph-test [ ~ ]$ sudo ym-service-commands.sh tang-adv
9_CZiwV9PKBlQfehPKZO7cd5ZpM |
ym-service-commands.sh update-jtapi
| Info |
|---|
This command updates jtapi for test_mate |
ym-service-commands.sh update-jtapi-local
| Info |
|---|
This command updates jtapi for test_mate |
ym-service-commands.sh update-jtapi-local
| Info |
|---|
This command updates jtapi for test_mate locally |
ym-service-commands.sh update-yarnman-database
| Info |
|---|
This command runs a manual database update |
| Code Block |
|---|
sudo ym-service-commands.sh update-yarnman-database
!! ommitted
1712036279860 INFO Yarnman database version record is currently at 2.6.6.
1712036279860 INFO Yarnman database version already updated to latest version 2.6.6 and is ready |
ym-service-commands.sh stig-hardening-check
ym-service-commands.sh
...
ym-service-commands.sh show-tech-support
| Info |
|---|
This command provides an overview of the system for yarnlab tech support |
...
| Info |
|---|
This command allocates 8vcpu and 16gb ram which is required for large wrangler_ migrations |
| Note |
|---|
Note that this command does check if there are 8vCPU and 16vGB RAM present |
| Code Block |
|---|
sudo ym-edit-config.sh set-hw-8vcpu-16gb |
...