ziti-doc icon indicating copy to clipboard operation
ziti-doc copied to clipboard

Documentation discrepancies for Quickstart #1 - Local - No Docker

Open padibona opened this issue 1 year ago • 0 comments

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.

padibona avatar Oct 27 '22 01:10 padibona