@@ -0,0 +1,89 @@
1++++
2+title = "Software Distribution FAQ"
3+template = "doc.html"
4+weight = 9
5++++
6+
7+This document concerns the September 2021 release of the software distribution OTA, codenamed "Grid." It is current as of 2021-09-29 at 7:45 AM PST.
8+
9+## Changes
10+
11+**How do I know the OTA succeeded?`**
12+
13+Run `+trouble`.
14+You should see entries for five desks: `%bitcoin`, `%base`, `%landscape`, `%webterm`, and `%garden`.
15+
16+**How do I get back to Landscape to see my DMs?**
17+
18+What was formerly called "Landscape" is now the Groups app. You can access DMs and groups via the "Groups" tile.
19+
20+**Where did my app tiles in Landscape go?**
21+
22+For apps ported to software distribution, tiles will be shown in the home screen.
23+
24+If you're already running non-Tlon apps, those apps will stop running, but the state will be preserved.
25+
26+If the developer provides a version of the app over software distribution and you install it, the new app will migrate the old state.
27+
28+**What's the base hash?**
29+
30+After this OTA there is a base hash _per app desk_:
31+
32+However, this may differ from ship to ship for now, so instead check the %cz hash.
33+The table lists the suffixes (last 5 characters) of the %cz hashes.
34+
35+| Software | Desk | %cz Hash |
36+| ------------ | ---------- | --------- |
37+| Arvo/OS | %base | `288fd` |
38+| Home Screen | %garden | `7ai82` |
39+| Groups | %landscape | `eoafs` |
40+| BTC Wallet | %bitcoin | `8kkfo` |
41+| Web Terminal | %webterm | `b2pme` |
42+
43+Run `+trouble` to see these hashes.
44+
45+**How do I see the base hashes for my ship?**
46+
47+The `+trouble` generator is now an alias for `+vats`.
48+Running either one will show the base hashes for every installed app desk.
49+
50+Clicking the settings icon on the top left of the home screen provides an 'About' choice.
51+Selecting this will bring up an app info widget for the system app, which will show the base hash of the `%garden` desk.
52+
53+Selecting the menu icon in the top right of an application tile provides an 'App Info' choice.
54+Selecting this will bring up an app info widget for the selected application, which will show its desk name and the base hash of its desk.
55+
56+Groups (formerly Landscape) will no longer show a base hash within the app.
57+
58+## Troubleshooting
59+
60+**The OTA is taking a long time.**
61+
62+This is expected and unfortunately unavoidable.
63+Your ship will be unresponsive for several minutes, possibly up to half an hour.
64+This is normal.
65+
66+Technical note: this is because OTAs are run as a single Arvo event which must compile the OTA and run migrations.
67+
68+**I saw crashes and stack traces during the OTA.**
69+
70+Some stack traces are expected. The `%goad` and `%publish` apps will not be present in the OTA,
71+and Clay will complain about not being able to build them. You will also see some Clay `read-at-aeon-fail` errors.
72+
73+**I haven't gotten the OTA yet and I can't post in some groups or DM some people.**
74+
75+This OTA includes breaking changes to `%graph-store` which stores and shares messages, notebooks, and collections.
76+Ships with the OTA will not be able to communicate over graph store with ships without the OTA.
77+
78+**I have gotten the OTA and I can't post in some groups or DM some people.**
79+
80+See above. Once your peers receive the OTA, you will be able to communicate again.
81+
82+**Can I still `|hi` between pre and post OTA ships?**
83+
84+`|hi` will continue to work between pre and post OTA ships.
85+
86+**Can I still use `|ota` to select my OTA provider?**
87+
88+`|ota` will continue to work on ships without the OTA, even if their OTA provider is running the OTA.
89+After the OTA, the `|ota` command is removed and is replaced by the `|install` command.