Skip to content

Commit 17b838b

Browse files
authored
Merge pull request #3354 from reubenmiller/docs-add-tenant-manager-note
docs: add c8y tenant manager note to getting started guide
2 parents ce649ba + cd20a3e commit 17b838b

File tree

2 files changed

+6
-4
lines changed

2 files changed

+6
-4
lines changed

docs/src/start/connect-c8y.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -190,7 +190,7 @@ sudo tedge cert upload c8y --user "$C8Y_USER"
190190

191191
Below shows some common errors that can be experienced when trying to upload the device certificate.
192192

193-
#### InvalidCertificate(NotValidForName)
193+
#### InvalidCertificate(NotValidForName) {#common-errors-invalid-certificate}
194194

195195
If you receive the following error, then you are most likely using the [custom domain feature](https://cumulocity.com/docs/enterprise-tenant/customization/#domain-name), and should see the [custom domain instructions](#custom-domain) to configure the correct HTTP and MQTT endpoints.
196196

@@ -202,7 +202,7 @@ Caused by:
202202
Connection check failed
203203
```
204204
205-
#### 401 - Unauthorized
205+
#### 401 - Unauthorized {#common-errors-401}
206206
207207
The 401 (Unauthorized) error means either the user and/or password is invalid for the configured Cumulocity url that was set in the `tedge config set c8y.url <url>` command.
208208
@@ -214,7 +214,7 @@ Check the following items to help you diagnose the root cause of the problem:
214214
* Check that you are not using a SSO user. SSO users are not permitted to use the REST API calls which the `tedge cert upload c8y` command is using. Please create a new Cumulocity user via the [Administration Page](https://cumulocity.com/docs/standard-tenant/managing-users/#to-add-a-user)
215215
216216
217-
#### 403 - Forbidden
217+
#### 403 - Forbidden {#common-errors-403}
218218
219219
The 403 (Forbidden) error means that your user/password is correct however you do not have sufficient permissions to add the %%te%%'s device certificate to the Cumulocity's [Trusted certificates](https://cumulocity.com/docs/device-integration/device-certificates/).
220220
@@ -227,7 +227,7 @@ Alternatively, you can explicitly add one of the following permissions to your C
227227
If you are still having trouble, please check out the official [Cumulocity documentation](https://cumulocity.com/docs/device-integration/device-certificates/#upload-your-ca-certificate).
228228
229229
230-
#### Address is unreachable
230+
#### Address is unreachable {#common-errors-unreachable}
231231
232232
If you are unable to reach Cumulocity, then it is likely that your device's network is not properly configured. This could be for many different reasons, however the following checks might help you spot where the mistake is:
233233

docs/src/start/getting-started.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,8 @@ sudo tedge cert create --device-id "$DEVICE_ID"
146146

147147
The device id is a unique identifier e.g. the MAC address that identifies the physical device.
148148

149+
Before you can upload the device's certificate to Cumulocity, your Cumulocity user must have the **Tenant Manager** Global Role assigned to it. For details on how to do this, see the [docs](connect-c8y.md#common-errors-403).
150+
149151
The certificate is uploaded to the Cumulocity Tenant via:
150152

151153
<UserContext>

0 commit comments

Comments
 (0)