Skip to content

Commit d186184

Browse files
dguidoclaude
andcommitted
Remove obsolete troubleshooting entries
Remove 3 troubleshooting entries that are no longer relevant: 1. DigitalOcean: error tagging resource - Fixed in 2018 when tagging was moved to droplet creation - The separate tagging step that caused this error no longer exists 2. Docker: Failed to connect to the host via ssh - 6+ years old workaround for control_path_dir - Modern Docker deployments don't exhibit this issue - The workaround was never added to ansible.cfg 3. Ubuntu Error: unable to write 'random state' - OpenSSL 3.x (Ubuntu 22.04) doesn't use .rnd files - Algo now uses Ansible community.crypto modules instead of shell openssl commands 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 59ee758 commit d186184

File tree

1 file changed

+0
-57
lines changed

1 file changed

+0
-57
lines changed

docs/troubleshooting.md

Lines changed: 0 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -11,14 +11,11 @@ First of all, check [this](https://github.com/trailofbits/algo#features) and ens
1111
* [AWS: SSH permission denied with an ECDSA key](#aws-ssh-permission-denied-with-an-ecdsa-key)
1212
* [AWS: "Deploy the template" fails with CREATE_FAILED](#aws-deploy-the-template-fails-with-create_failed)
1313
* [AWS: not authorized to perform: cloudformation:UpdateStack](#aws-not-authorized-to-perform-cloudformationupdatestack)
14-
* [DigitalOcean: error tagging resource 'xxxxxxxx': param is missing or the value is empty: resources](#digitalocean-error-tagging-resource)
1514
* [Azure: The client xxx with object id xxx does not have authorization to perform action Microsoft.Resources/subscriptions/resourcegroups/write' over scope](#azure-deployment-permissions-error)
1615
* [Windows: The value of parameter linuxConfiguration.ssh.publicKeys.keyData is invalid](#windows-the-value-of-parameter-linuxconfigurationsshpublickeyskeydata-is-invalid)
17-
* [Docker: Failed to connect to the host via ssh](#docker-failed-to-connect-to-the-host-via-ssh)
1816
* [Windows: "The parameter is incorrect" error when connecting](#windows-the-parameter-is-incorrect-error-when-connecting)
1917
* [Error: Failed to create symlinks for deploying to localhost](#error-failed-to-create-symlinks-for-deploying-to-localhost)
2018
* [Wireguard: Unable to find 'configs/...' in expected paths](#wireguard-unable-to-find-configs-in-expected-paths)
21-
* [Ubuntu Error: "unable to write 'random state'" when generating CA password](#ubuntu-error-unable-to-write-random-state-when-generating-ca-password)
2219
* [Timeout when waiting for search string OpenSSH in xxx.xxx.xxx.xxx:4160](#old-networking-firewall-in-place)
2320
* [Linode Error: "Unable to query the Linode API. Saw: 400: The requested distribution is not supported by this stackscript.; "](#linode-error-uable-to-query-the-linode-api-saw-400-the-requested-distribution-is-not-supported-by-this-stackscript)
2421
* [Connection Problems](#connection-problems)
@@ -121,25 +118,6 @@ fatal: [localhost]: FAILED! => {"changed": false, "failed": true, "msg": "User:
121118

122119
This error indicates you already have Algo deployed to Cloudformation. Need to [delete it](cloud-amazon-ec2.md#cleanup) first, then re-deploy.
123120

124-
### DigitalOcean: error tagging resource
125-
126-
You tried to deploy Algo to DigitalOcean and you received an error like this one:
127-
128-
```
129-
TASK [cloud-digitalocean : Tag the droplet] ************************************
130-
failed: [localhost] (item=staging) => {"failed": true, "item": "staging", "msg": "error tagging resource '73204383': param is missing or the value is empty: resources"}
131-
failed: [localhost] (item=dbserver) => {"failed": true, "item": "dbserver", "msg": "error tagging resource '73204383': param is missing or the value is empty: resources"}
132-
```
133-
134-
The error is caused because Digital Ocean changed its API to treat the tag argument as a string instead of a number.
135-
136-
1. Download [doctl](https://github.com/digitalocean/doctl)
137-
2. Run `doctl auth init`; it will ask you for your token which you can get (or generate) on the API tab at DigitalOcean
138-
3. Once you are authorized on DO, you can run `doctl compute tag list` to see the list of tags
139-
4. Run `doctl compute tag delete environment:algo --force` to delete the environment:algo tag
140-
5. Finally run `doctl compute tag list` to make sure that the tag has been deleted
141-
6. Run algo as directed
142-
143121
### Azure: No such file or directory: '/home/username/.azure/azureProfile.json'
144122

145123
```
@@ -189,24 +167,6 @@ Target: linuxConfiguration.ssh.publicKeys.keyData"}
189167

190168
This is related to [the chmod issue](https://github.com/Microsoft/WSL/issues/81) inside /mnt directory which is NTFS. The fix is to place Algo outside of /mnt directory.
191169

192-
### Docker: Failed to connect to the host via ssh
193-
194-
You tried to deploy Algo from Docker and you received an error like this one:
195-
196-
```
197-
Failed to connect to the host via ssh:
198-
Warning: Permanently added 'xxx.xxx.xxx.xxx' (ECDSA) to the list of known hosts.\r\n
199-
Control socket connect(/root/.ansible/cp/6d9d22e981): Connection refused\r\n
200-
Failed to connect to new control master\r\n
201-
```
202-
203-
You need to add the following to the ansible.cfg in repo root:
204-
205-
```
206-
[ssh_connection]
207-
control_path_dir=/dev/shm/ansible_control_path
208-
```
209-
210170
### Windows: "The parameter is incorrect" error when connecting
211171

212172
When trying to connect to your Algo VPN on Windows 10/11, you may receive an error stating "The parameter is incorrect". This is a common issue that can usually be resolved by resetting your Windows networking stack.
@@ -297,23 +257,6 @@ rm -rf configs/*
297257
```
298258
Then immediately re-run `./algo`.
299259

300-
### Ubuntu Error: "unable to write 'random state'" when generating CA password
301-
302-
When running Algo, you received an error like this:
303-
304-
```
305-
TASK [common : Generate password for the CA key] ***********************************************************************************************************************************************************
306-
fatal: [xxx.xxx.xxx.xxx -> localhost]: FAILED! => {"changed": true, "cmd": "openssl rand -hex 16", "delta": "0:00:00.024776", "end": "2018-11-26 13:13:55.879921", "msg": "non-zero return code", "rc": 1, "start": "2018-11-26 13:13:55.855145", "stderr": "unable to write 'random state'", "stderr_lines": ["unable to write 'random state'"], "stdout": "xxxxxxxxxxxxxxxxxxx", "stdout_lines": ["xxxxxxxxxxxxxxxxxxx"]}
307-
```
308-
309-
This happens when your user does not have ownership of the `$HOME/.rnd` file, which is a seed for randomization. To fix this issue, give your user ownership of the file with this command:
310-
311-
```
312-
sudo chown $USER:$USER $HOME/.rnd
313-
```
314-
315-
Now, run Algo again.
316-
317260
### Old Networking Firewall In Place
318261

319262
You may see the following output when attemptint to run ./algo from your localhost:

0 commit comments

Comments
 (0)