You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/install-guides/atp.md
+16-54Lines changed: 16 additions & 54 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -169,85 +169,47 @@ When the installation finishes, select **Close** to exit the installer.
169
169
170
170
## How do I prepare my target for ATP connections?
171
171
172
-
Before connecting to an Arm Linux target, set up SSH key-based authentication and configure passwordless sudo access. The setup differs depending on whether your target is a cloud instance or an on-premise server.
172
+
Before connecting to an Arm Linux target, ensure SSH key-based authentication is configured and that passwordless sudo access is enabled. If you already manage your target system via SSH, you likely have most of this setup complete.
173
173
174
-
### Working with cloud instances
174
+
### Check your existing SSH key
175
175
176
-
If your target is a cloud instance (for example: AWS EC2 Graviton, GCP Axion, Azure Cobalt), you likely created it with an existing SSH key pair. You need to generate a separate ATP key for the tool to use.
177
-
178
-
First, ensure you can connect to your cloud instance using the existing key. For example, if your cloud provider key is stored at `~/cloud-keys/my-instance.pem`:
After this, you can use `~/.ssh/atp_key` as the private key when configuring ATP's target connection.
205
-
206
-
### Working with on-premise targets
207
-
208
-
If your target is an on-premise Arm Linux server, check if you already have an SSH key pair on your local machine:
176
+
Verify that you can connect to your target using SSH:
209
177
210
178
```bash
211
-
ls -l ~/.ssh/id*
179
+
ssh user@target_host
212
180
```
213
181
214
-
If a key pair exists, you see files like `id_ed25519` and `id_ed25519.pub`. The `.pub` file is your public key.
215
-
216
-
If no keys exist, generate a new key pair:
182
+
If the connection works, you have SSH key authentication configured. Now check if your existing key has a passphrase. Try to display the public key:
217
183
218
184
```bash
219
-
ssh-keygen
185
+
ssh-keygen -y -f ~/.ssh/id_ed25519
220
186
```
221
187
222
-
Press **Enter** to accept the default location. When prompted for a passphrase, press **Enter** to skip (ATP doesn't support SSH keys with a passphrase).
188
+
If you're prompted for a passphrase, your key is protected with one. ATP doesn't support SSH keys with passphrases, so you need to create a separate key without a passphrase for ATP.
223
189
224
-
Copy your public key to the target system:
190
+
### Create a passphrase-free key for ATP (if needed)
225
191
226
-
```bash
227
-
ssh-copy-id user@target_host
228
-
```
229
-
230
-
By default, `ssh-copy-id` uses your default public key. If you have multiple keys and want to specify which one to copy, use the `-i` option:
192
+
If your existing SSH key has a passphrase, generate a new key specifically for ATP:
Press **Enter**when prompted for a passphrase to leave it empty.
237
199
238
-
If you see a message that "All keys were skipped because they already exist on the remote system," but you still need to add or update the key, use the `-f` option to force the installation:
200
+
Copy the new public key to your target. If your existing SSH key is at a non-default location (for example, `~/cloud-keys/my-instance.pem`), specify it when copying:
0 commit comments