Skip to content

Commit

Permalink
Merge pull request #2467 from nmelehan/rc-v0.11
Browse files Browse the repository at this point in the history
[Release Candidate] v0.11
  • Loading branch information
rsyracuse committed Apr 29, 2019
2 parents 045477c + 68f5ba3 commit 0bc8a21
Show file tree
Hide file tree
Showing 35 changed files with 383 additions and 119 deletions.
4 changes: 2 additions & 2 deletions docs/getting-started/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: 'This guide will help you set up your first Linode.'
og_description: "Learn how to create an account, boot your first Linode, and connect via SSH with our Getting Started guide."
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
aliases: ['getting-started-new-manager/']
modified: 2019-03-05
modified: 2019-03-08
modified_by:
name: Linode
published: 2018-11-05
Expand Down Expand Up @@ -43,7 +43,7 @@ If you haven't already signed up for a Linode account, start here.

## Create a Linode

![Create a Linode by selecting the image, the region, the plan, and creating a label and a password.](create-a-linode.gif)
![Create a Linode by selecting the image, the region, the plan, and creating a label and a password.](getting-started.gif)

1. Log in to the [Cloud Manager](https://cloud.linode.com) with the username and password you created when signing up.

Expand Down
77 changes: 53 additions & 24 deletions docs/networking/an-overview-of-ipv6-on-linode/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,11 @@ author:
name: Linode
email: docs@linode.com
description: 'This guide is a brief overview of IPv6 resources and support afforded by and available with Linode.'
og_description: "This guide is a brief overview of IPv6 support on Linode, including how to find your Linode's IPv6 address, how to request additional addresses, and information about address pools and forwarding."
og_description: "This guide is a brief overview of IPv6 support on Linode, including how to find your Linode's IPv6 address, how to request additional addresses, and information about address ranges and forwarding."
keywords: ["ipv6 networking", "IP configuration"]
aliases: ['networking/native-ipv6-networking/','networking/how-to-enable-native-ipv6-on-linux/']
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
modified: 2019-01-02
modified: 2019-03-12
modified_by:
name: Linode
published: 2011-05-03
Expand All @@ -21,56 +21,85 @@ external_resources:

## Default IPv6 Configuration

All Linodes are created with one IPv6 address, which is acquired by Stateless Address Autoconfiguration (SLAAC). IPv6 is fully enabled on all of Linode's supported operating systems and uses hardware-based addressing.
All Linodes are created with one IPv6 address, which is acquired by [*Stateless Address Autoconfiguration*](https://en.wikipedia.org/wiki/IPv6#Stateless_address_autoconfiguration_(SLAAC)) (SLAAC). IPv6 is fully enabled on all of Linode's supported operating systems and uses hardware-based addressing.

Linode does not offer private IPv6 address allocations. Our IPv6 accounting was designed so that local IPv6 traffic does not count against your transfer quota, so you can use your default IPv6 address as if it were a private IP address.
Linode does not offer private IPv6 address allocations. Our IPv6 accounting was designed so that local IPv6 traffic does not count against your [network transfer quota](/docs/platform/billing-and-support/network-transfer-quota/), so you can use your default IPv6 address as if it were a private IP address.

{{< note >}}
In order for your Linode to receive its SLAAC address, it must respond to IPv6's ping protocol.

Please be sure to allow ICMPv6 in your [firewall](/docs/security/securing-your-server#configure-a-firewall), for example in `iptables`:
Please be sure to allow ICMPv6 in your [firewall](/docs/security/securing-your-server#configure-a-firewall). For example, in `iptables`, you can issue the following commands:

`-A INPUT -p icmpv6 -j ACCEPT`
ip6tables -A INPUT -p icmpv6 -j ACCEPT
ip6tables -A FORWARD -p icmpv6 -j ACCEPT
{{< /note >}}

## How to Find Your IPv6 Address

To find your Linode's IPv6 address, see the [Remote Access](/docs/networking/remote-access) tab of your Linode's dashboard or use the `ip` tool:
You can find your Linode's IPv6 address using the Linode Cloud Manager or the `ip` tool with the Linux Terminal.
### Linode Cloud Manager

root@localhost:~# ip -6 address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 state UNKNOWN qlen 1
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 state UP qlen 1000
inet6 2600:3c02::f03c:91ff:fe24:3a2f/64 scope global mngtmpaddr dynamic
valid_lft 2591998sec preferred_lft 604798sec
inet6 fe80::f03c:91ff:fe24:3a2f/64 scope link
valid_lft forever preferred_lft forever
1. Log in to your [Linode Cloud Manager](https://cloud.linode.com/) account and select the Linodes link in the sidebar to view a list of all your Linodes.

- Line 3 shows the IPv6 loopback interface. This is used for IPv6 traffic within the system, similar to the 127.0.0.0/8 IPv4 address block.
1. On the Linodes page, under the *IP Addresses* column, you can quickly view each Linode's IP addresses.

- Line 6 is the Linode's public IP address. You can see it's in a /64 pool.
![List of Linodes to view your IPv6 address.](ip-address-quick-view.png)

- Line 8 is the link-local IPv6 address. An IPv6 link-local address is a unicast address that is automatically configured on any interface.
1. To see a more detailed view, select the Linode whose IPv6 address you would like to find and click on its **Networking** tab.

1. Under the *IPv6* section, you can view the Linode's SLAAC and Link Local IPv6 addresses.

![A Linode Networking Tab detail view.](ip-address-detail-view.png)

### Linux Terminal

1. Using your terminal, SSH into the Linode whose IPv6 address you would like to find.

ssh user@192.0.2.0

1. Use the `ip` tool to find your Linode's IPv6 address:

root@localhost:~# ip -6 address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 state UNKNOWN qlen 1
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 state UP qlen 1000
inet6 2600:3c02::f03c:91ff:fe24:3a2f/64 scope global mngtmpaddr dynamic
valid_lft 2591998sec preferred_lft 604798sec
inet6 fe80::f03c:91ff:fe24:3a2f/64 scope link
valid_lft forever preferred_lft forever

- Line 3 shows the IPv6 loopback interface, `::1/128`. This is used for IPv6 traffic within the system, similar to the `127.0.0.0/8` IPv4 address block.

- Line 6 is the Linode's public IP address, `600:3c02::f03c:91ff:fe24:3a2f/64`. You can see it's in a `/64` range.

- Line 8 is the link-local IPv6 address, `fe80::f03c:91ff:fe24:3a2f/64`. An IPv6 link-local address is a unicast address that is automatically configured on any interface.

If your Linode does not have the correct IPv6 address or any IPv6 address at all, you should verify that you have router advertisements enabled and IPv6 privacy extensions disabled. Your Linode will need to accept router advertisements for SLAAC to function. These settings are properly configured by default in our supported distributions.


## Additional IPv6 Addresses

You can request additional IPv6 addresses at any time by opening a [support ticket](/docs/platform/support). While default IPv6 addresses are configured automatically, you will need to statically configure each IPv6 address in the pool you request. See our [static IP guide](/docs/networking/linux-static-ip-configuration) for instructions on how to do this.
You can request additional IPv6 addresses at any time by opening a [support ticket](/docs/platform/billing-and-support/support/#contacting-linode-support). While default IPv6 addresses are configured automatically, you will need to statically configure each IPv6 address in the range you request. See our [static IP guide](/docs/networking/linux-static-ip-configuration) for instructions on how to do this.


## IPv6 Pools
## IPv6 Ranges and Pools

IPv6 addresses are allocated in *pools*. The IPv6 pool sizes Linode provides and their respective quantity of IPv6 addresses are below.
{{< note >}}
The IPv6 `/116` pool is not available in the Toronto data center.
{{</ note >}}

You will see where the pool is routed under *Public IP Pools* on the Linode Manager's Remote Access tab.
IPv6 addresses are allocated in *ranges* and *pools*. The IPv6 range and pool sizes Linode provides and their respective quantity of IPv6 addresses are listed below.

| Pool | Number of addresses |
<!--You will see where the range is routed under *Public IP Pools* on the Linode Manager's Remote Access tab.-->

| **Range** | **Number of addresses** |
|:------:|:-----------------------------:|
| /56 | 4,722,366,482,869,645,213,696 |
| /64 | 18,446,744,073,709,551,616 |

| **Pool** | **Number of addresses** |
|:------:|:-----------------------------:|
| /116 | 4,096 |


Expand Down
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 4 additions & 2 deletions docs/platform/api/using-the-linode-cli/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: The Linode CLI provides a simplified interface to the Linode API. T
og_description: The Linode CLI provides a simplified interface to the Linode API. This guide shows how to install the CLI and describes how to perform basic tasks from the command line.
keywords: ["linode api", "linode cli", "python cli"]
license: '[CC BY-ND 4.0](https://creativecommons.org/licenses/by-nd/4.0)'
modified: 2018-06-29
modified: 2019-03-05
modified_by:
name: Linode
published: 2018-06-29
Expand All @@ -30,7 +30,7 @@ The easiest way to install the CLI is through [Pip](https://pypi.org/project/pip

pip install linode-cli --upgrade

1. You need a Personal Access Token to use the CLI. Use the [beta Linode Manager](https://cloud.linode.com/profile/tokens) to obtain a token.
1. You need a Personal Access Token to use the CLI. Use the [Linode Cloud Manager](https://cloud.linode.com/profile/tokens) to obtain a token.

1. The first time you run any command, you will be prompted with the CLI's configuration script. Paste your access token (which will then be used by default for all requests made through the CLI) at the prompt. You will be prompted to choose defaults for Linodes created through the CLI (region, type, and image). These are optional, and can be overridden for individual commands. Update these defaults at any time by running `linode-cli configure`:

Expand Down Expand Up @@ -115,6 +115,7 @@ ap-south sg
eu-central de
ap-northeast jp
ap-northeast-1a jp
ca-east ca
{{< /highlight >}}

linode-cli regions list --text --delimiter ";"
Expand All @@ -130,6 +131,7 @@ ap-south;sg
eu-central;de
ap-northeast;jp
ap-northeast-1a;jp
ca-east;ca
{{< /highlight >}}

## Examples
Expand Down

0 comments on commit 0bc8a21

Please sign in to comment.