Skip to content

Commit 46054e2

Browse files
authored
Merge pull request #206334 from hrshelar/patch-6
Update prepare-network.md with corrected link cardinality
2 parents aa0f018 + 425695a commit 46054e2

File tree

3 files changed

+15
-9
lines changed

3 files changed

+15
-9
lines changed
297 KB
Loading
113 KB
Loading

articles/orbital/prepare-network.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,10 @@ Steps:
2626
> [!NOTE]
2727
> Address range needs to be at least /24 (example 10.0.0.0/23)
2828
29+
Here is an example of a typical VNET setup with a subnet delegated to Azure Orbital Ground Station.
30+
31+
:::image type="content" source="media/azure-ground-station-subnet-example.png" alt-text="Screenshot of subnet configuration with Orbital delegated subnet." lightbox="media/azure-ground-station-subnet-example.png":::
32+
2933
## Setting up the contact profile
3034

3135
Prerequisites:
@@ -45,7 +49,7 @@ Make sure the contact profile properties are set as follows:
4549

4650
The platform pre-reserves IPs in the subnet when the contact is scheduled. These IPs represent the platform side endpoints for each link. IPs will be unique between contacts, and if multiple concurrent contacts are using the same subnet, we guarantee those IPs to be distinct. The service will fail to schedule the contact and an error will be returned if the service runs out of IPs or can't allocate an IP.
4751

48-
When you create a contact, you can find these IPs by viewing the contact properties. Select JSON view in the portal or use the GET contact API call to view the contact properties. The parameters of interest are below:
52+
When you create a contact, you can find these IPs by viewing the contact properties. Select JSON view in the portal or use the GET contact API call to view the contact properties. Make sure to use the current API version of 2022-03-01. The parameters of interest are below:
4953

5054
| Parameter | Usage |
5155
|------------------------------------|----------------------------------------------------------------------------|
@@ -54,8 +58,10 @@ When you create a contact, you can find these IPs by viewing the contact propert
5458

5559
You can use this information to set up network policies or to distinguish between simultaneous contacts to the same endpoint.
5660

61+
:::image type="content" source="media/azure-ground-station-contact-ips-example.png" alt-text="Screenshot of contact object with source and destination IPs." lightbox="media/azure-ground-station-contact-ips-example.png":::
62+
5763
> [!NOTE]
58-
> - The source and destination IPs are always taken from the subnet address range
64+
> - The source and destination IPs are always taken from the subnet address range.
5965
> - Only one destination IP is present. Any link in client mode should connect to this IP and the links are differentiated based on port.
6066
> - Many source IPs can be present. Links in server mode will connect to your specified IP address in the contact profile. The flows will originate from the source IPs present in this field and target the port as per the link details in the contact profile. There is no fixed assignment of link to source IP so please make sure to allow all IPs in any networking setup or firewalls.
6167
@@ -68,25 +74,25 @@ Here's how to set up the link flows based on direction on tcp or udp preference.
6874

6975
| Setting | TCP Client | TCP Server | UDP Client | UDP Server |
7076
|--------------------------------|----------------------------|--------------------------------------|----------------------------|--------------------------------------|
71-
| Contact Profile Link ipAddress | Blank | Routable IP from delegated subnet | Blank | Routable IP from delegated subnet |
72-
| Contact Profile Link port | Unique port in 49152-65535 | Unique port in 49152-65535 | Unique port in 49152-65535 | Unique port in 49152-65535 |
77+
| Contact Profile Link ipAddress | Blank | Routable IP from delegated subnet | Blank | Not applicable |
78+
| Contact Profile Link port | Unique port in 49152-65535 | Unique port in 49152-65535 | Unique port in 49152-65535 | Not applicable |
7379
| **Output** | | | | |
7480
| Contact Object destinationIP | Connect to this IP | Not applicable | Connect to this IP | Not applicable |
75-
| Contact Object sourceIP | Not applicable | Link will come from one of these IPs | Not applicable | Link will come from one of these IPs |
81+
| Contact Object sourceIP | Not applicable | Link will come from one of these IPs | Not applicable | Not applicable |
7682

7783

7884

7985
### Downlink
8086

8187
| Setting | TCP Client | TCP Server | UDP Client | UDP Server |
8288
|--------------------------------|----------------------------|--------------------------------------|----------------------------|--------------------------------------|
83-
| Contact Profile Link ipAddress | Blank | Routable IP from delegated subnet | Blank | Routable IP from delegated subnet |
84-
| Contact Profile Link port | Unique port in 49152-65535 | Unique port in 49152-65535 | Unique port in 49152-65535 | Unique port in 49152-65535 |
89+
| Contact Profile Link ipAddress | Blank | Routable IP from delegated subnet | Not applicable | Routable IP from delegated subnet |
90+
| Contact Profile Link port | Unique port in 49152-65535 | Unique port in 49152-65535 | Not applicable | Unique port in 49152-65535 |
8591
| **Output** | | | | |
86-
| Contact Object destinationIP | Connect to this IP | Not applicable | Connect to this IP | Not applicable |
92+
| Contact Object destinationIP | Connect to this IP | Not applicable | Not applicable | Not applicable |
8793
| Contact Object sourceIP | Not applicable | Link will come from one of these IPs | Not applicable | Link will come from one of these IPs |
8894

8995
## Next steps
9096

9197
- [Register Spacecraft](register-spacecraft.md)
92-
- [Schedule a contact](schedule-contact.md)
98+
- [Schedule a contact](schedule-contact.md)

0 commit comments

Comments
 (0)