Trying to install openziti & keep failing at 1 step

Support General Questions
1

In Ziti Admin Console | OpenZiti

In Step 5 it says to restart the ziti-controller.service but I continue to get the following error?

$ sudo systemctl restart ziti-controller.service
Failed to restart ziti-controller.service: Unit ziti-controller.service not found.

I don't think I've missed any steps up to Step 5

But I've now tried to install openziti 3 times and each ends up failing in Step 5

Any ideas where to look?

2

Had exactly same issue as you did. Looks like documentation for "Local - no Docker" missing some steps.
To solve the issue you need to fallow some steps from Host OpenZiti Anywhere section. To generate and start requested services fallow systemd command sets:

createControllerSystemdFile
createRouterSystemdFile "${ZITI_ROUTER_NAME}"

Once generated stop Router and Controller (if started):

stopRouter
stopController

Copy newly generated services into /etc/systemd/system/ folder with fallowing commands:

sudo cp "${ZITI_HOME}/${ZITI_CTRL_NAME}.service" /etc/systemd/system/ziti-controller.service
sudo cp "${ZITI_HOME}/${ZITI_ROUTER_NAME}.service" /etc/systemd/system/ziti-router.service

Finally start the services:

sudo systemctl daemon-reload
sudo systemctl enable --now ziti-controller
sudo systemctl enable --now ziti-router

Then try to access zac over port 1280
That worked for me, hope it will work for you as well.
Good luck.

3

Geez thank you so much I'll give this a try this afternoon.

It was make me crazy because I kept thinking I must have missed some step some place

4

Thanks so much @danielhanaj for noticing this post and helping out @bmullan! I wouldn't say it's missing a step, but I can see why it's confusing for sure. Maybe there should be some words at the top telling the reader to use the proper section instead. I'll file an issue to clarify this. (filed: add clarity around ZAC when using docker · Issue #1003 · openziti/ziti-doc · GitHub)

@bmullan - let me know if you still need help, but hopefully you figured out what you needed to.

5

I think openziti has extensive documentation, more than most projects I've seen in my years.

But there is always a battle against "mego" (my eyes glaze over) re. where an author unintentionally makes assumptions about what the reader "just understands" when reading the text.

Example: for a user installing "Server Anywhere" and setting the environment variables.

Do they need to be aware of running as sudo/root or their normal UserID to avoid a mistake?

Or should those ENVs be set in /etc/profile for "all" users?

In Cloud servers or Container environments (Docker, LXD, Incus, Kubernetes) when you login in initially you are "root"? If later, non-root Users are added, those ENVs might be required for their use.

Do later openziti installation commands by root/sudo utilize those ENVs or are just command executed as "non-root"?

Anyway thanks for all your dedication to openziti.