From 8cefb1d2e53923ca5e8464241bd3b28057d6ade5 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 20 Jan 2025 16:20:07 +0100 Subject: [PATCH 1/9] feat(ins): add troubleshooting --- .../troubleshooting/fix-common-issues.mdx | 273 ++++++++++++++++++ menu/navigation.json | 5 +- 2 files changed, 277 insertions(+), 1 deletion(-) create mode 100644 compute/instances/troubleshooting/fix-common-issues.mdx diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx new file mode 100644 index 0000000000..48dce1ecb2 --- /dev/null +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -0,0 +1,273 @@ +--- +meta: + title: Fix common issues with Scaleway Instances + description: This page helps you fix common issues you may experience when using Scaleway Instances +content: + h1: Fix common issues with Scaleway Instances + paragraph: This page helps you fix common issues you may experience when using Scaleway Instances +tags: instances troubleshooting common issues +dates: + validation: 2025-01-20 + posted: 2025-01-20 +categories: + - compute +--- + +This page list the most common issues you may encounter with your Scaleway Instance and provides useful tips how to troubleshoot them. + +## I experience HTTP errors on Instances + +### Symptoms +- You receive `4xx` or `5xx` errors when trying to reach your Instance via HTTP. +- The website or service running on your Instance is slow or unavailable. +- You cannot perform basic HTTP operations like `GET` or `POST` on your Instance endpoint. + +### Possible causes +- Incorrect firewall rules: The Instance or Security Groups might be blocking HTTP/HTTPS ports (`80`, `443`). +- Configuration errors in the web server: Nginx, Apache, or another web server might be misconfigured. +- Application-level errors: Your application code may be crashing or returning incorrect responses. +- DNS misconfiguration: The domain’s DNS settings might be pointing to the wrong IP or not updated. + +### Troubleshooting tips +- Check security group and firewall rules: + - In the [Scaleway console](https://console.scaleway.com/instance/security-groups), confirm that ports 80 (HTTP) and 443 (HTTPS) are allowed inbound for the security group used by your Instance. + - If you manage your own firewall (e.g., iptables, ufw), verify that HTTP and HTTPS traffic is permitted. +- Verify the web server configuration: + - SSH into your Instance and inspect your web server’s config (for example `/etc/nginx/nginx.conf` or `/etc/apache2/apache2.conf`). + - Look for syntax errors or missing directives (e.g., missing `server_name`). + - Restart the web server to apply changes (`sudo systemctl restart nginx` or `sudo systemctl restart apache2`). +- Check application logs: + - Check logs in `/var/log/` or wherever your application outputs logs to identify potential errors. + - Look for stack traces or misconfiguration messages. +- Validate DNS records: + - Use `dig ` or `nslookup ` to confirm the IP address matches your Instance’s public IP. + - If necessary, update the DNS records and wait for propagation. + +### Additional resources +- [Scaleway Documentation: How to use security groups](/compute/instances/how-to/use-security-groups/) +- [Nginx Official Documentation](https://nginx.org/en/docs/) +- [Apache HTTP Server Documentation](https://httpd.apache.org/docs/) + +## I am unable to connect to my Instance + +### Symptoms +- Your SSH or RDP connection is timing out. +- You see “Connection refused” or “Host unreachable” errors in your terminal. +- Ping (ICMP) requests are dropped. + +### Possible causes +- Security Group settings: SSH (port `22`) or RDP (port `3389`) might not be open. +- Incorrect IP address: You might be connecting to the wrong public IP. +- User-side firewall or network: Your local network may block outbound SSH or RDP connections. +- Instance not running: The Instance may be shut down or stuck in an error state. + +### Troubleshooting tips +- Check your Instance status: + - In the [Scaleway console](https://console.scaleway.com/instance/servers), confirm the Instance is in a running state. + - Restart the Instance if it’s not responding. +- Verify the Instance's public IP address: + - Confirm that the IP in the Scaleway console matches the IP you are using for the connection. +- Review security groups and local firewalls + - Make sure the default Security Group allows SSH or RDP inbound traffic. + - Check your local firewall to ensure outbound SSH (port `22`) or RDP (port `3389`) is allowed. +- Use the Scaleway console to connect to your Instance + - Try using Scaleway’s web-based terminal in the console to rule out local network issues. + +### Additional resources +- [Scaleway Documentation: How to connect to your Instance](/compute/instances/how-to/connect-to-instance/) +- [Scaleway Documentation: Troubleshooting SSH connection issues to Instances](/compute/instances/troubleshooting/cant-connect-ssh/) + + +## I cannot connect to my Instance using an SSH key + +### Symptoms +- You see an "Invalid SSH key” or “Permission denied (publickey)” error. +- SSH prompts you for a password instead of accepting your key. +- The connection works with a password but not with the SSH key. + +### Possible causes +- Incorrect permissions on the SSH key: The key file might have unsafe permissions or ownership. +- Wrong username: Using `root` versus a custom user. +- Misconfiguration of the SSH daemon: `sshd_config` might disallow key-based authentication. +- Key not installed: The public key might not have been successfully added to the Instance. + +### Troubleshooting tips +- Check file permissions locally: + - On your local machine, ensure the private key file has restrictive permissions: + ```bash + chmod 600 ~/.ssh/id_rsa + ``` + - Verify that the user and group ownership are correct. +- Verify the correct username + - By default, Scaleway Instances use the `root` user. Check if you have created a new user with sudo privileges and if so, use that username. +- Inspect the Instance’s SSH configuration + - If you can connect via another method or console, check `/etc/ssh/sshd_config` for lines such as `PasswordAuthentication`, `PubkeyAuthentication`, and `PermitRootLogin`. + - Make sure `PubkeyAuthentication yes` is set. +- Re-add your SSH Key in the Scaleway console + - Go to the [SSH keys](https://console.scaleway.com/project/ssh-keys) tab in the **Project** section of theScaleway console, remove the old SSH key, then add your new, correct public key. + - Restart your Instance to re-upload the list of allowed SSH keys. + +### Additional resources +- [Scaleway Docs: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) +- [OpenSSH Documentation](https://www.openssh.com/manual.html) + +## My Instance is locked + +### Symptoms +- Attempts to modify or delete the Instance fail with a “Instance is protected” error. +- You see a message in the Scaleway console that the Instance is protected or locked. + +### Possible causes +- Security measure: The Instance might be locked due to non-payment or administrative hold. +- User-applied lock: You (or another administrator) enabled resource locking to prevent accidental deletion. +- Ongoing operation: A pending snapshot or backup can temporarily lock the Instance. + +### Troubleshooting tips +- Check billing and support tickets: + - Ensure your Scaleway account is in good standing with no overdue invoices. + - If there is a lock from Scaleway support, resolve any open tickets or compliance issues. +- Disable the Protected Instance feature: + - In the Scaleway console, go to your Instance settings and turn off the lock if you set it manually. +- Wait for ongoing maintenance operations to complete: + - If an action is running on your Instance, you must wait until it finishes before you can modify the Instance. + +### Additional resources +- [Scaleway Billing FAQ](/faq/billing/) +- [Scaleway Documentation: How to use the Protected Instance feature](/compute/instances/how-to/use-protected-instance/) + +## How can I open port 25 for my Instances? + +### Symptoms +- Your application cannot send emails (SMTP) from the Instance. +- Port 25 connections are blocked or refused. + +### Possible causes +- Default SMTP restriction: Access to port 25 is restricted by default to prevent spam. +- Security Group settings: The inbound/outbound rules might block port 25. +- Missing or incorrect mail server configuration: Postfix, Exim, or another MTA might be misconfigured. + +### Troubleshooting tips +- Configure your security group: + - In the Scaleway console, ensure outbound connections on port 25 are allowed. +- Set up proper SPF/DKIM/DMARC: + - To avoid being flagged as spam, configure DNS records for email authentication. +- Use "Authenticated SMTP" (Port 587 or 465): + - If port 25 is restricted, consider using a mail relay or an authenticated SMTP service on port 587 or 465. + +### Additional resources +- [Scaleway Documentation: How to send emails from your Instance](/compute/instances/how-to/send-emails-from-your-instance/) +- [Scaleway Tutorial: Setting up a secure mail server on Ubuntu 22.04 LTS (Jammy Jellyfish)](/tutorials/setup-postfix-ubuntu-bionic/) +- [Scaleway general terms of service](https://www-uploads.scaleway.com/General_Terms_of_Services_v17072024_45d4879c08.pdf) +- [Postfix Documentation](http://www.postfix.org/documentation.html) +- [SPF/DKIM/DMARC Basics](https://dmarc.org/overview/) + +## Routed IP errors + +### Symptoms +- Your Instance does not respond when using a routed IP. +- Packets might be dropped or misrouted. +- Services are not accessible via the secondary IP. + +### Possible causes +- Incorrect network configuration: The routed IP might not be properly configured on your Instance. +- No static routes set: A missing route or gateway could cause traffic to fail. +- Security Groups or firewall blocking: The traffic from or to the routed IP might be filtered. + +### Troubleshooting tips +- Verify the IP configuration in the Scaleway console: + - Confirm that the routed IP is associated with the correct Instance. +- Update your network configuration files: + - On your Instance, add the secondary IP to the appropriate network interface (e.g., `eth0:0` or via netplan). + - Make sure the netmask and gateway are set according to the instructions. +- Check your routing table: + - Use `ip route` or `route -n` to confirm the route for the additional IP is properly set. +- Test connectivity: + - Ping the secondary IP from an external source. If it fails, look at local logs (`dmesg` or `/var/log/syslog`) for network errors. +- Adjust your security group: + - Ensure inbound and outbound traffic is allowed for both IP addresses. + +### Additional resources +- [Scaleway Documentation: How to use flexible IP addresses with Instances](/compute/instances/how-to/use-flexips/) +- [Scaleway Troubleshooting: Fix unreachable Ubuntu Focal Instance when it has two public IP adresses](/compute/instances/troubleshooting/fix-unreachable-focal-with-two-public-ips/) +- [Scaleway Troubleshooting: Fix lost IPv6 connectivity on old Debian Buster images when migrating to routed IP](/compute/instances/troubleshooting/fix-lost-ip-connectivity-on-debian-buster/) +- [Scaleway Troubleshooting: Fix unreachable IPv6 RHEL-based Instances after transitioning to routed IP](/compute/instances/troubleshooting/fix-unreachable-ipv6-rhel-based-instance/) +- [Netplan documenation](https://netplan.readthedocs.io/en/stable/) + +## Disk space errors with Instances + +### Symptoms +- “No space left on device” errors when installing packages or writing files. +- The system becomes unresponsive, or services crash due to insufficient disk space. +- You cannot create or expand files on the Instance. + +### Possible causes +- Full root partition: Logs or application data have consumed all available disk space. +- Improper partition setup: Your primary partition might be too small. +- Uncleaned temporary files: `/tmp`, `/var/tmp`, or application cache directories might be full. + +### Troubleshooting tips +- Check your disk usage: + - Use `df -h` to check available space on all mounted volumes. + - Use `du -sh /var/log/*` or other directories to find large files. +- Clean up unnecessary files: + - Remove old logs from `/var/log/` or archived backups you no longer need. + - Clear temporary files in `/tmp` or application cache directories. +- Resize or add a volume: + - If you consistently run out of space, consider resizing your volume or attaching an additional volume via the Scaleway console. +- Implement log rotation: + - Configure `logrotate` or other log management solutions to prevent logs from filling the disk. + +### Additional resources +- [Scaleway Documentation: How to attach a Block Storage volume to an Instance](/storage/block/how-to/attach-a-volume/) +- [Scaleway Documentation: How to increase the size of your Block Storage volumes](/storage/block/how-to/increase-block-volume/) +- [Linux Log Rotation Guide](https://linux.die.net/man/8/logrotate) + +## Packet loss issues with Instances + +### Symptoms +- High latency or intermittent connectivity to your Instance. +- Pings show dropped packets. +- Applications that rely on constant connectivity (VoIP, real-time apps) experience disruptions. + +### Possible causes +- Network congestion: On either the Instance side or your local network. +- Incorrect MTU settings: The maximum transmission unit might cause fragmentation issues. +- Firewall or rate limits: Overly strict firewall rules can drop packets. +- Hardware or routing issues: Upstream or local network hardware problems. + +### Troubleshooting tips +- Run basic network diagnostics: + - Use `ping` and `traceroute` from both your local machine and another external server. + - Check if packet loss is local or global. +- Check the Instance's load: + - High CPU or network usage on your Instance can cause dropped packets. Monitor system resources with `top` or `htop`. +- Optimize the MTU + - Try lowering the MTU (Maximum transmission unit) to 1400 or 1450 and see if packet loss improves, especially in VPN or container setups. +- Adjust firewall/security groups: + - Confirm that your firewall isn not inadvertently dropping packets or rate-limiting ICMP. + +### Additional resources +- [Scaleway Documentation: How to use security groups](/compute/instances/how-to/use-security-groups/) +- [Scaleway Documentation: Preventing outgoing DDoS](/compute/instances/reference-content/preventing-outgoing-ddos/) +- [Scaleway Tutorial: Configuring Firewalls for Instances](/tutorials/installation-uncomplicated-firewall/) + +## I cannot delete my Instance + +### Symptoms +- Attempts to delete the Instance fail with a “Instance is protected” error. +- You see a message in the Scaleway console that the Instance is protected or locked. + +### Possible causes +- User-applied lock: You (or another administrator) enabled resource locking to prevent accidental deletion. + +### Troubleshooting tips +- Disable the Protected Instance feature: + - In the Scaleway console, go to your Instance settings and turn off the lock if you set it manually. + +### Additional resources +- [Scaleway Documentation: How to use the Protected Instance feature](/compute/instances/how-to/use-protected-instance/) + +## Next steps + +- Always consult the official [Scaleway Instances Documentation](https://www.scaleway.com/en/docs/compute/instances/) for detailed, up-to-date information to troubleshoot your Instance. +- If you are still experiencing issues after following these tips, open a [support ticket](https://console.scaleway.com/support) in your Scaleway console, providing detailed descriptions of your issue, logs, screenshots, or error messages. This will help the support team diagnose and resolve your issue more quickly. \ No newline at end of file diff --git a/menu/navigation.json b/menu/navigation.json index 6fc4b72960..24258d2234 100644 --- a/menu/navigation.json +++ b/menu/navigation.json @@ -1521,6 +1521,10 @@ }, { "items": [ + { + "label": "Fix common issues with Instances", + "slug": "fix-common-issues" + }, { "label": "Troubleshooting SSH connection issues", "slug": "cant-connect-ssh" @@ -2961,7 +2965,6 @@ "slug": "getting-most-private-networks" }, { - "label": "VPC use case 1: basic infrastructure", "slug": "use-case-basic" }, From 079f80e9db2af050a011344241e35f41ae1a02b7 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 20 Jan 2025 16:22:18 +0100 Subject: [PATCH 2/9] feat(ins): troubleshooting --- .../instances/troubleshooting/fix-common-issues.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index 48dce1ecb2..4fa75476e8 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -67,10 +67,10 @@ This page list the most common issues you may encounter with your Scaleway Insta - Restart the Instance if it’s not responding. - Verify the Instance's public IP address: - Confirm that the IP in the Scaleway console matches the IP you are using for the connection. -- Review security groups and local firewalls +- Review security groups and local firewalls: - Make sure the default Security Group allows SSH or RDP inbound traffic. - Check your local firewall to ensure outbound SSH (port `22`) or RDP (port `3389`) is allowed. -- Use the Scaleway console to connect to your Instance +- Use the Scaleway console to connect to your Instance: - Try using Scaleway’s web-based terminal in the console to rule out local network issues. ### Additional resources @@ -98,12 +98,12 @@ This page list the most common issues you may encounter with your Scaleway Insta chmod 600 ~/.ssh/id_rsa ``` - Verify that the user and group ownership are correct. -- Verify the correct username +- Verify the correct username: - By default, Scaleway Instances use the `root` user. Check if you have created a new user with sudo privileges and if so, use that username. -- Inspect the Instance’s SSH configuration +- Inspect the Instance’s SSH configuration: - If you can connect via another method or console, check `/etc/ssh/sshd_config` for lines such as `PasswordAuthentication`, `PubkeyAuthentication`, and `PermitRootLogin`. - Make sure `PubkeyAuthentication yes` is set. -- Re-add your SSH Key in the Scaleway console +- Re-add your SSH Key in the Scaleway console: - Go to the [SSH keys](https://console.scaleway.com/project/ssh-keys) tab in the **Project** section of theScaleway console, remove the old SSH key, then add your new, correct public key. - Restart your Instance to re-upload the list of allowed SSH keys. From fee6c99a8cba85fe8fd140b167b324065ee1d2dc Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 20 Jan 2025 16:35:15 +0100 Subject: [PATCH 3/9] feat(ins): add more troubleshooting --- .../troubleshooting/fix-common-issues.mdx | 26 ++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index 4fa75476e8..ab46f36950 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -108,9 +108,33 @@ This page list the most common issues you may encounter with your Scaleway Insta - Restart your Instance to re-upload the list of allowed SSH keys. ### Additional resources -- [Scaleway Docs: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) +- [Scaleway Documentation: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) - [OpenSSH Documentation](https://www.openssh.com/manual.html) +## 5. How Can I recover access to my Instance? + +### Symptoms +- You are unable to connect to your Instance via SSH. +- Your SSH key is missing, or you cannot locate the corresponding private key. + +### Possible causes +- The private SSH key associated with the Instance was lost or deleted. +- The Instance’s SSH configuration or authorized keys file was altered, removing your access. + +### Troubleshooting tips + +- Check for another SSH key: + - Verify if another SSH key pair is associated with your [Scaleway account](https://console.scaleway.com/project/ssh-keys). + - Login using the alternative SSH key + +- Use the Scaleway console to add a new SSH key + - Upload another SSH key in the [SSH key section](https://console.scaleway.com/project/ssh-keys) of your Instance's Scaleway project. + - Reboot the Instance from the console to re-upload the new key to the Instance. + +### Additional resources +- [Scaleway Documentation: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) +- [Scaleway Documenation: How to power off your Instance](/compute/instances/how-to/power-off-instance/) + ## My Instance is locked ### Symptoms From 65715847cd9dcd0ef1f945ea91ac06c77a7ef2ad Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 20 Jan 2025 16:38:28 +0100 Subject: [PATCH 4/9] feat(ins): fix typo --- compute/instances/troubleshooting/fix-common-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index ab46f36950..8414323f1d 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -127,7 +127,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Verify if another SSH key pair is associated with your [Scaleway account](https://console.scaleway.com/project/ssh-keys). - Login using the alternative SSH key -- Use the Scaleway console to add a new SSH key +- Use the Scaleway console to add a new SSH key: - Upload another SSH key in the [SSH key section](https://console.scaleway.com/project/ssh-keys) of your Instance's Scaleway project. - Reboot the Instance from the console to re-upload the new key to the Instance. From 8cb9f5b19d03f24400043ed60d36abe82d88c000 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 20 Jan 2025 21:30:13 +0100 Subject: [PATCH 5/9] fix(ins): fix typo --- compute/instances/troubleshooting/fix-common-issues.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index 8414323f1d..c6d3a4dd77 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -111,7 +111,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - [Scaleway Documentation: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) - [OpenSSH Documentation](https://www.openssh.com/manual.html) -## 5. How Can I recover access to my Instance? +## How Can I recover access to my Instance? ### Symptoms - You are unable to connect to your Instance via SSH. @@ -122,7 +122,6 @@ This page list the most common issues you may encounter with your Scaleway Insta - The Instance’s SSH configuration or authorized keys file was altered, removing your access. ### Troubleshooting tips - - Check for another SSH key: - Verify if another SSH key pair is associated with your [Scaleway account](https://console.scaleway.com/project/ssh-keys). - Login using the alternative SSH key From f2678424bd8d60fdd00ab88812e0245f8318c32b Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Tue, 21 Jan 2025 09:28:20 +0100 Subject: [PATCH 6/9] fix(ins): fix typo --- .../instances/troubleshooting/fix-common-issues.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index c6d3a4dd77..c93f09bd05 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -23,7 +23,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - You cannot perform basic HTTP operations like `GET` or `POST` on your Instance endpoint. ### Possible causes -- Incorrect firewall rules: The Instance or Security Groups might be blocking HTTP/HTTPS ports (`80`, `443`). +- Incorrect firewall rules: The Instance or security groups might be blocking HTTP/HTTPS ports (`80`, `443`). - Configuration errors in the web server: Nginx, Apache, or another web server might be misconfigured. - Application-level errors: Your application code may be crashing or returning incorrect responses. - DNS misconfiguration: The domain’s DNS settings might be pointing to the wrong IP or not updated. @@ -56,7 +56,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Ping (ICMP) requests are dropped. ### Possible causes -- Security Group settings: SSH (port `22`) or RDP (port `3389`) might not be open. +- security groups settings: SSH (port `22`) or RDP (port `3389`) might not be open. - Incorrect IP address: You might be connecting to the wrong public IP. - User-side firewall or network: Your local network may block outbound SSH or RDP connections. - Instance not running: The Instance may be shut down or stuck in an error state. @@ -68,7 +68,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Verify the Instance's public IP address: - Confirm that the IP in the Scaleway console matches the IP you are using for the connection. - Review security groups and local firewalls: - - Make sure the default Security Group allows SSH or RDP inbound traffic. + - Make sure the default security groups allows SSH or RDP inbound traffic. - Check your local firewall to ensure outbound SSH (port `22`) or RDP (port `3389`) is allowed. - Use the Scaleway console to connect to your Instance: - Try using Scaleway’s web-based terminal in the console to rule out local network issues. @@ -166,7 +166,7 @@ This page list the most common issues you may encounter with your Scaleway Insta ### Possible causes - Default SMTP restriction: Access to port 25 is restricted by default to prevent spam. -- Security Group settings: The inbound/outbound rules might block port 25. +- security groups settings: The inbound/outbound rules might block port 25. - Missing or incorrect mail server configuration: Postfix, Exim, or another MTA might be misconfigured. ### Troubleshooting tips @@ -194,7 +194,7 @@ This page list the most common issues you may encounter with your Scaleway Insta ### Possible causes - Incorrect network configuration: The routed IP might not be properly configured on your Instance. - No static routes set: A missing route or gateway could cause traffic to fail. -- Security Groups or firewall blocking: The traffic from or to the routed IP might be filtered. +- security groups or firewall blocking: The traffic from or to the routed IP might be filtered. ### Troubleshooting tips - Verify the IP configuration in the Scaleway console: From 99590a6fd86722a111b77122dddcaf8e8411e1a1 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 3 Feb 2025 11:14:52 +0100 Subject: [PATCH 7/9] Apply suggestions from code review Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> Co-authored-by: ldecarvalho-doc <82805470+ldecarvalho-doc@users.noreply.github.com> --- .../troubleshooting/fix-common-issues.mdx | 70 +++++++++---------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index c93f09bd05..3b704e7d31 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -13,7 +13,7 @@ categories: - compute --- -This page list the most common issues you may encounter with your Scaleway Instance and provides useful tips how to troubleshoot them. +This page lists the most common issues you may encounter with your Scaleway Instance and provides useful tips for troubleshooting them. ## I experience HTTP errors on Instances @@ -28,7 +28,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Application-level errors: Your application code may be crashing or returning incorrect responses. - DNS misconfiguration: The domain’s DNS settings might be pointing to the wrong IP or not updated. -### Troubleshooting tips +### Solution - Check security group and firewall rules: - In the [Scaleway console](https://console.scaleway.com/instance/security-groups), confirm that ports 80 (HTTP) and 443 (HTTPS) are allowed inbound for the security group used by your Instance. - If you manage your own firewall (e.g., iptables, ufw), verify that HTTP and HTTPS traffic is permitted. @@ -44,7 +44,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - If necessary, update the DNS records and wait for propagation. ### Additional resources -- [Scaleway Documentation: How to use security groups](/compute/instances/how-to/use-security-groups/) +- [Scaleway Documentation: How to use security groups](/instances/how-to/use-security-groups/) - [Nginx Official Documentation](https://nginx.org/en/docs/) - [Apache HTTP Server Documentation](https://httpd.apache.org/docs/) @@ -56,26 +56,26 @@ This page list the most common issues you may encounter with your Scaleway Insta - Ping (ICMP) requests are dropped. ### Possible causes -- security groups settings: SSH (port `22`) or RDP (port `3389`) might not be open. +- Security group settings: SSH (port `22`) or RDP (port `3389`) might not be open. - Incorrect IP address: You might be connecting to the wrong public IP. - User-side firewall or network: Your local network may block outbound SSH or RDP connections. - Instance not running: The Instance may be shut down or stuck in an error state. -### Troubleshooting tips +### Solution - Check your Instance status: - In the [Scaleway console](https://console.scaleway.com/instance/servers), confirm the Instance is in a running state. - Restart the Instance if it’s not responding. - Verify the Instance's public IP address: - Confirm that the IP in the Scaleway console matches the IP you are using for the connection. - Review security groups and local firewalls: - - Make sure the default security groups allows SSH or RDP inbound traffic. + - Make sure the default security groups allow SSH or RDP inbound traffic. - Check your local firewall to ensure outbound SSH (port `22`) or RDP (port `3389`) is allowed. - Use the Scaleway console to connect to your Instance: - Try using Scaleway’s web-based terminal in the console to rule out local network issues. ### Additional resources -- [Scaleway Documentation: How to connect to your Instance](/compute/instances/how-to/connect-to-instance/) -- [Scaleway Documentation: Troubleshooting SSH connection issues to Instances](/compute/instances/troubleshooting/cant-connect-ssh/) +- [Scaleway Documentation: How to connect to your Instance](/instances/how-to/connect-to-instance/) +- [Scaleway Documentation: Troubleshooting SSH connection issues to Instances](/instances/troubleshooting/cant-connect-ssh/) ## I cannot connect to my Instance using an SSH key @@ -91,7 +91,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Misconfiguration of the SSH daemon: `sshd_config` might disallow key-based authentication. - Key not installed: The public key might not have been successfully added to the Instance. -### Troubleshooting tips +### Solution - Check file permissions locally: - On your local machine, ensure the private key file has restrictive permissions: ```bash @@ -108,7 +108,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Restart your Instance to re-upload the list of allowed SSH keys. ### Additional resources -- [Scaleway Documentation: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) +- [Scaleway Documentation: How to generate an SSH key pair](/organizations-and-projects/how-to/create-ssh-key/) - [OpenSSH Documentation](https://www.openssh.com/manual.html) ## How Can I recover access to my Instance? @@ -121,7 +121,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - The private SSH key associated with the Instance was lost or deleted. - The Instance’s SSH configuration or authorized keys file was altered, removing your access. -### Troubleshooting tips +### Solution - Check for another SSH key: - Verify if another SSH key pair is associated with your [Scaleway account](https://console.scaleway.com/project/ssh-keys). - Login using the alternative SSH key @@ -131,13 +131,13 @@ This page list the most common issues you may encounter with your Scaleway Insta - Reboot the Instance from the console to re-upload the new key to the Instance. ### Additional resources -- [Scaleway Documentation: How to generate an SSH key pair](/identity-and-access-management/organizations-and-projects/how-to/create-ssh-key/) -- [Scaleway Documenation: How to power off your Instance](/compute/instances/how-to/power-off-instance/) +- [Scaleway Documentation: How to generate an SSH key pair](/organizations-and-projects/how-to/create-ssh-key/) +- [Scaleway Documentation: How to power off your Instance](/instances/how-to/power-off-instance/) ## My Instance is locked ### Symptoms -- Attempts to modify or delete the Instance fail with a “Instance is protected” error. +- Attempts to modify or delete the Instance fail with an “Instance is protected” error. - You see a message in the Scaleway console that the Instance is protected or locked. ### Possible causes @@ -145,7 +145,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - User-applied lock: You (or another administrator) enabled resource locking to prevent accidental deletion. - Ongoing operation: A pending snapshot or backup can temporarily lock the Instance. -### Troubleshooting tips +### Solution - Check billing and support tickets: - Ensure your Scaleway account is in good standing with no overdue invoices. - If there is a lock from Scaleway support, resolve any open tickets or compliance issues. @@ -156,7 +156,7 @@ This page list the most common issues you may encounter with your Scaleway Insta ### Additional resources - [Scaleway Billing FAQ](/faq/billing/) -- [Scaleway Documentation: How to use the Protected Instance feature](/compute/instances/how-to/use-protected-instance/) +- [Scaleway Documentation: How to use the Protected Instance feature](/instances/how-to/use-protected-instance/) ## How can I open port 25 for my Instances? @@ -166,10 +166,10 @@ This page list the most common issues you may encounter with your Scaleway Insta ### Possible causes - Default SMTP restriction: Access to port 25 is restricted by default to prevent spam. -- security groups settings: The inbound/outbound rules might block port 25. +- Security group settings: The inbound/outbound rules might block port 25. - Missing or incorrect mail server configuration: Postfix, Exim, or another MTA might be misconfigured. -### Troubleshooting tips +### Solution - Configure your security group: - In the Scaleway console, ensure outbound connections on port 25 are allowed. - Set up proper SPF/DKIM/DMARC: @@ -178,7 +178,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - If port 25 is restricted, consider using a mail relay or an authenticated SMTP service on port 587 or 465. ### Additional resources -- [Scaleway Documentation: How to send emails from your Instance](/compute/instances/how-to/send-emails-from-your-instance/) +- [Scaleway Documentation: How to send emails from your Instance](/instances/how-to/send-emails-from-your-instance/) - [Scaleway Tutorial: Setting up a secure mail server on Ubuntu 22.04 LTS (Jammy Jellyfish)](/tutorials/setup-postfix-ubuntu-bionic/) - [Scaleway general terms of service](https://www-uploads.scaleway.com/General_Terms_of_Services_v17072024_45d4879c08.pdf) - [Postfix Documentation](http://www.postfix.org/documentation.html) @@ -196,7 +196,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - No static routes set: A missing route or gateway could cause traffic to fail. - security groups or firewall blocking: The traffic from or to the routed IP might be filtered. -### Troubleshooting tips +### Solution - Verify the IP configuration in the Scaleway console: - Confirm that the routed IP is associated with the correct Instance. - Update your network configuration files: @@ -210,10 +210,10 @@ This page list the most common issues you may encounter with your Scaleway Insta - Ensure inbound and outbound traffic is allowed for both IP addresses. ### Additional resources -- [Scaleway Documentation: How to use flexible IP addresses with Instances](/compute/instances/how-to/use-flexips/) -- [Scaleway Troubleshooting: Fix unreachable Ubuntu Focal Instance when it has two public IP adresses](/compute/instances/troubleshooting/fix-unreachable-focal-with-two-public-ips/) -- [Scaleway Troubleshooting: Fix lost IPv6 connectivity on old Debian Buster images when migrating to routed IP](/compute/instances/troubleshooting/fix-lost-ip-connectivity-on-debian-buster/) -- [Scaleway Troubleshooting: Fix unreachable IPv6 RHEL-based Instances after transitioning to routed IP](/compute/instances/troubleshooting/fix-unreachable-ipv6-rhel-based-instance/) +- [Scaleway Documentation: How to use flexible IP addresses with Instances](/instances/how-to/use-flexips/) +- [Scaleway Troubleshooting: Fix unreachable Ubuntu Focal Instance when it has two public IP addresses](/instances/troubleshooting/fix-unreachable-focal-with-two-public-ips/) +- [Scaleway Troubleshooting: Fix lost IPv6 connectivity on old Debian Buster images when migrating to routed IP](/instances/troubleshooting/fix-lost-ip-connectivity-on-debian-buster/) +- [Scaleway Troubleshooting: Fix unreachable IPv6 RHEL-based Instances after transitioning to routed IP](/instances/troubleshooting/fix-unreachable-ipv6-rhel-based-instance/) - [Netplan documenation](https://netplan.readthedocs.io/en/stable/) ## Disk space errors with Instances @@ -228,7 +228,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Improper partition setup: Your primary partition might be too small. - Uncleaned temporary files: `/tmp`, `/var/tmp`, or application cache directories might be full. -### Troubleshooting tips +### Solution - Check your disk usage: - Use `df -h` to check available space on all mounted volumes. - Use `du -sh /var/log/*` or other directories to find large files. @@ -241,8 +241,8 @@ This page list the most common issues you may encounter with your Scaleway Insta - Configure `logrotate` or other log management solutions to prevent logs from filling the disk. ### Additional resources -- [Scaleway Documentation: How to attach a Block Storage volume to an Instance](/storage/block/how-to/attach-a-volume/) -- [Scaleway Documentation: How to increase the size of your Block Storage volumes](/storage/block/how-to/increase-block-volume/) +- [Scaleway Documentation: How to attach a Block Storage volume to an Instance](/block-storage/how-to/attach-a-volume/) +- [Scaleway Documentation: How to increase the size of your Block Storage volumes](/block-storage/how-to/increase-block-volume/) - [Linux Log Rotation Guide](https://linux.die.net/man/8/logrotate) ## Packet loss issues with Instances @@ -258,7 +258,7 @@ This page list the most common issues you may encounter with your Scaleway Insta - Firewall or rate limits: Overly strict firewall rules can drop packets. - Hardware or routing issues: Upstream or local network hardware problems. -### Troubleshooting tips +### Solution - Run basic network diagnostics: - Use `ping` and `traceroute` from both your local machine and another external server. - Check if packet loss is local or global. @@ -267,30 +267,30 @@ This page list the most common issues you may encounter with your Scaleway Insta - Optimize the MTU - Try lowering the MTU (Maximum transmission unit) to 1400 or 1450 and see if packet loss improves, especially in VPN or container setups. - Adjust firewall/security groups: - - Confirm that your firewall isn not inadvertently dropping packets or rate-limiting ICMP. + - Confirm that your firewall is not inadvertently dropping packets or rate-limiting ICMP. ### Additional resources -- [Scaleway Documentation: How to use security groups](/compute/instances/how-to/use-security-groups/) -- [Scaleway Documentation: Preventing outgoing DDoS](/compute/instances/reference-content/preventing-outgoing-ddos/) +- [Scaleway Documentation: How to use security groups](/instances/how-to/use-security-groups/) +- [Scaleway Documentation: Preventing outgoing DDoS](/instances/reference-content/preventing-outgoing-ddos/) - [Scaleway Tutorial: Configuring Firewalls for Instances](/tutorials/installation-uncomplicated-firewall/) ## I cannot delete my Instance ### Symptoms -- Attempts to delete the Instance fail with a “Instance is protected” error. +- Attempts to delete the Instance fail with an “Instance is protected” error. - You see a message in the Scaleway console that the Instance is protected or locked. ### Possible causes - User-applied lock: You (or another administrator) enabled resource locking to prevent accidental deletion. -### Troubleshooting tips +### Solution - Disable the Protected Instance feature: - In the Scaleway console, go to your Instance settings and turn off the lock if you set it manually. ### Additional resources -- [Scaleway Documentation: How to use the Protected Instance feature](/compute/instances/how-to/use-protected-instance/) +- [Scaleway Documentation: How to use the Protected Instance feature](/instances/how-to/use-protected-instance/) ## Next steps -- Always consult the official [Scaleway Instances Documentation](https://www.scaleway.com/en/docs/compute/instances/) for detailed, up-to-date information to troubleshoot your Instance. +- Always consult the official [Scaleway Instances Documentation](https://www.scaleway.com/en/docs/instances/) for detailed, up-to-date information to troubleshoot your Instance. - If you are still experiencing issues after following these tips, open a [support ticket](https://console.scaleway.com/support) in your Scaleway console, providing detailed descriptions of your issue, logs, screenshots, or error messages. This will help the support team diagnose and resolve your issue more quickly. \ No newline at end of file From 104d93c59babf18e81fc734faab97d2b27e353b1 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 3 Feb 2025 16:36:36 +0100 Subject: [PATCH 8/9] Apply suggestions from code review Co-authored-by: Jessica <113192637+jcirinosclwy@users.noreply.github.com> --- compute/instances/troubleshooting/fix-common-issues.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index 3b704e7d31..69d9672b0e 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -48,7 +48,7 @@ This page lists the most common issues you may encounter with your Scaleway Inst - [Nginx Official Documentation](https://nginx.org/en/docs/) - [Apache HTTP Server Documentation](https://httpd.apache.org/docs/) -## I am unable to connect to my Instance +## I can't connect to my Instance ### Symptoms - Your SSH or RDP connection is timing out. @@ -78,7 +78,7 @@ This page lists the most common issues you may encounter with your Scaleway Inst - [Scaleway Documentation: Troubleshooting SSH connection issues to Instances](/instances/troubleshooting/cant-connect-ssh/) -## I cannot connect to my Instance using an SSH key +## I can't connect to my Instance using an SSH key ### Symptoms - You see an "Invalid SSH key” or “Permission denied (publickey)” error. @@ -111,7 +111,7 @@ This page lists the most common issues you may encounter with your Scaleway Inst - [Scaleway Documentation: How to generate an SSH key pair](/organizations-and-projects/how-to/create-ssh-key/) - [OpenSSH Documentation](https://www.openssh.com/manual.html) -## How Can I recover access to my Instance? +## I can't access my Instance ### Symptoms - You are unable to connect to your Instance via SSH. @@ -274,7 +274,7 @@ This page lists the most common issues you may encounter with your Scaleway Inst - [Scaleway Documentation: Preventing outgoing DDoS](/instances/reference-content/preventing-outgoing-ddos/) - [Scaleway Tutorial: Configuring Firewalls for Instances](/tutorials/installation-uncomplicated-firewall/) -## I cannot delete my Instance +## I can't delete my Instance ### Symptoms - Attempts to delete the Instance fail with an “Instance is protected” error. From 7bcb3dceae844f7104ba951b9ccdf466d1b32869 Mon Sep 17 00:00:00 2001 From: Benedikt Rollik Date: Mon, 3 Feb 2025 16:41:27 +0100 Subject: [PATCH 9/9] Update compute/instances/troubleshooting/fix-common-issues.mdx --- compute/instances/troubleshooting/fix-common-issues.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/compute/instances/troubleshooting/fix-common-issues.mdx b/compute/instances/troubleshooting/fix-common-issues.mdx index 69d9672b0e..7aba663e03 100644 --- a/compute/instances/troubleshooting/fix-common-issues.mdx +++ b/compute/instances/troubleshooting/fix-common-issues.mdx @@ -292,5 +292,5 @@ This page lists the most common issues you may encounter with your Scaleway Inst ## Next steps -- Always consult the official [Scaleway Instances Documentation](https://www.scaleway.com/en/docs/instances/) for detailed, up-to-date information to troubleshoot your Instance. +- Always consult the official [Scaleway Instances Documentation](/instances/) for detailed, up-to-date information to troubleshoot your Instance. - If you are still experiencing issues after following these tips, open a [support ticket](https://console.scaleway.com/support) in your Scaleway console, providing detailed descriptions of your issue, logs, screenshots, or error messages. This will help the support team diagnose and resolve your issue more quickly. \ No newline at end of file