ziti-doc
ziti-doc copied to clipboard
Documentation discrepancies for Quickstart #1 - Local - No Docker
When attempting the first quickstart with no docker I ran into t a few issues that hung me up for a bit as I was not seeing what the documentation was telling me I should see. Ziti and all the functionality seemed to work fine. In the below steps, #4, 6, 8 were the areas that I believe have the discrepancies. Here are the steps I took:
1. Confirmed WSL2 installed using Ubuntu 20.04.4 LTS
2. Confirmed JQ installed so first command worked
3. Ran First command: source /dev/stdin <<< "$(wget -qO- https://raw.githubusercontent.com/openziti/ziti/release-next/quickstart/docker/image/ziti-cli-functions.sh)"; expressInstall
4. Ran 'startZitiController' - first bug is that that PID # does not show up as I see the following: root@NetFoundry-Laptop: startZitiController ziti-controller started as process id: . log located at: /root/.ziti/quickstart/NetFoundry-Laptop/NetFoundry-Laptop.log
5. Ran a 'cat /root/.ziti/quickstart/NetFoundry-Laptop/NetFoundry-Laptop.log' and the log shows up fine here.
6. "Verify the controller is running' section does not come back as the documentation states. I ran command 'echo $ZITI_EDGE_CONTROLLER_API' and nothing showed up as the endpoint with port, it was blank.
7. I then ran ' env | grep ZITI_EDGE' to see if that env variable is set and sure enough it was not there:
root@NetFoundry-Laptop:~# env | grep ZITI_EDGE
ZITI_EDGE_CTRL_IDENTITY_CA=/root/.ziti/quickstart/NetFoundry-Laptop/pki/NetFoundry-Laptop-intermediate/certs/NetFoundry-Laptop-intermediate.cert
ZITI_EDGE_CTRL_IDENTITY_SERVER_CERT=/root/.ziti/quickstart/NetFoundry-Laptop/pki/NetFoundry-Laptop-intermediate/certs/NetFoundry-Laptop-server.chain.pem
ZITI_EDGE_CONTROLLER_RAWNAME=NetFoundry-Laptop
ZITI_EDGE_CTRL_ADVERTISED=NetFoundry-Laptop:1280
ZITI_EDGE_CTRL_IDENTITY_CERT=/root/.ziti/quickstart/NetFoundry-Laptop/pki/NetFoundry-Laptop-intermediate/certs/NetFoundry-Laptop-client.cert
ZITI_EDGE_CTRL_IDENTITY_KEY=/root/.ziti/quickstart/NetFoundry-Laptop/pki/NetFoundry-Laptop-intermediate/keys/NetFoundry-Laptop-server.key
ZITI_EDGE_CONTROLLER_INTERMEDIATE_NAME=NetFoundry-Laptop-intermediate
ZITI_EDGE_CONTROLLER_HOSTNAME=NetFoundry-Laptop
ZITI_EDGE_CONTROLLER_ROOTCA_NAME=NetFoundry-Laptop-root-ca
ZITI_EDGE_CONTROLLER_PORT=1280
ZITI_EDGE_CTRL_ADVERTISED_HOST_PORT=NetFoundry-Laptop:1280
8. Ran 'startExpressEdgeRouter' and everything looked fine, except for the verifying edge router as those hostname:port env variables did not exist as running 'env | grep ZITI_EDGE_ROUTER' showed nothing.
9. Ran 'zitiLogin' - Everything looks good here.
10. Ran '${ZITI_BIN_DIR-}/ziti edge list edge-routers' and that looked fine as well.
11. Everything from here on out with the service tutorial was fine.