Skip to content

Commit 505ad04

Browse files
authored
Restructure networking section (#375)
* restructure networking section * remove f5 admin portal references as its palo * folder restructure * Remove list and keep to generic slack channel * add bash references * replace images to correct * fix links * fix links --------- Co-authored-by: Thomas Thornton <>
1 parent 9859000 commit 505ad04

20 files changed

+320
-257
lines changed

source/monitoring/dynatrace-private-locations.html.md.erb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ Here is an [example pr](https://github.com/hmcts/azure-private-dns/pull/800).
5454

5555
If the DNS is resolving but you're getting a timeout error when running an on-demand execution, the issue could be firewall related.
5656

57-
Connect to the appropriate [Palo Alto](../network/connecting-palos.html) and check the Palo Alto [monitor](../network/palos-troubleshooting.html).
57+
Connect to the appropriate [Palo Alto](../network/palo-alto/connecting-palos.html) and check the Palo Alto [monitor](../network/palo-alto/palos-troubleshooting.html).
5858

5959
If the traffic is showing as denied, then you will need to ensure the traffic is allowed by ensuring the two networks are in the correct zone and there is a rule to allow the traffic.
6060

source/network/F5-GeoIP.html.md.erb

Lines changed: 0 additions & 65 deletions
This file was deleted.

source/network/accounts.html.md.erb

Lines changed: 0 additions & 35 deletions
This file was deleted.
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,38 @@
11
---
2-
title: MyCloudGateway - Operations Guide
3-
weight: 100
2+
title: Operations Guide
3+
weight: 10
44
last_reviewed_on: 2024-05-16
55
review_in: 6 months
66
---
77
# <%= current_page.data.title %>
88

9-
The My Cloud Gateway service provides wide area networking between MoJ office, data centres and public cloud providers.
9+
Cloud Gateway service provides wide area networking between MoJ office, data centres and public cloud providers.
1010

1111
## Portal
12-
Once you have a login and have registered your mobile phone, connect to the portal via https://my.cloudgateway.co.uk/login and enter the OTP code you have just been sent.
12+
Once you have a login and have registered your mobile phone, connect to the portal via [https://my.cloudgateway.co.uk/login](https://my.cloudgateway.co.uk/login) and enter the OTP code you have just been sent.
1313

1414

1515
## Firewall Rules
16-
https://my.cloudgateway.co.uk/protect
17-
1816
Select the Protect tab to see the existing firewall rule. New rules and modifications are managed via service requests.
1917

18+
[https://my.cloudgateway.co.uk/protect](https://my.cloudgateway.co.uk/protect)
19+
2020
## Routing
2121
My Cloud Gateway manage all routes, any routes created in Azure Virtual WAN, will have to be imported by My Cloud Gateway, via a service request.
2222

2323
## NAT
2424
Network address transition is used to minimise IP routing complexity from Azure. VIP address on MyCloudGateway enable Azure to reach MoJ offices, without knowing the full routing table.
2525

2626
## Monitoring
27-
https://my.cloudgateway.co.uk/inspect/traffic-logs
28-
2927
The Inspect tab can be used to gain access to the live traffic logs. Important to use filters, such as source or destination IP, as the logs are very busy.
3028
Export logs to CSV, is more reliable than the live logs feature. Plus the file can be emailed to 3rd parties, enabling team work, on problem solving.
3129

30+
[https://my.cloudgateway.co.uk/inspect/traffic-logs](https://my.cloudgateway.co.uk/inspect/traffic-logs)
3231

3332
## Service Requests
34-
https://my.cloudgateway.co.uk/support/service-requests
35-
3633
When something has stopped working, an incident needs to be logged. To add or modify My Cloud Gateway, log a service request.
3734

38-
Service requests are chargable, so consider creating a single large request, if you need multiple tasks completing.
35+
Service requests are chargable, so consider creating a single large request, if you need multiple tasks completing.
36+
37+
[https://my.cloudgateway.co.uk/support/service-requests](https://my.cloudgateway.co.uk/support/service-requests)
38+
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: CloudGateway
3+
last_reviewed_on: 2024-01-26
4+
review_in: 12 months
5+
weight: 70
6+
---
7+
8+
### Admin / Access
9+
- [Admin Portal](https://my.cloudgateway.co.uk/login)
10+
11+
### Guides
12+
- [Information](https://my.cloudgateway.co.uk/)
13+
- [Using MyCloudGateway](MyCloudGateway_ops.html)

source/network/connecting-palos.html.md.erb

Lines changed: 0 additions & 80 deletions
This file was deleted.
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Update GeoIP
3+
last_reviewed_on: 2024-12-12
4+
review_in: 6 months
5+
weight: 10
6+
---
7+
8+
# <%= current_page.data.title %>
9+
10+
## IP Geolocation Database
11+
12+
Used to control access to the VPN based on the physical location of the user connection. The database is updated monthly and doesn't interrupt service.
13+
14+
[F5 GeoIP Guide](https://my.f5.com/manage/s/article/K11176)
15+
16+
## Prerequisites
17+
18+
1. SSH access to the F5 device, via bash. (Beware the Azure NSG rules)
19+
2. Access to [my.f5.com](https://my.f5.com) and "HM Courts & Tribunals Service" account to download the latest GeoIP database.
20+
3. SFTP client to upload the database to the F5 device.
21+
22+
23+
## Instructions
24+
These steps can be performed during working hours as they do not interrupt service.
25+
26+
### Pre-Update
27+
1. Confirm your F5 VPN is not active before proceeding
28+
2. Log into the F5 Web Admin portal using a web browser and note the current version BIG-IP
29+
3. Confirm your admin user account has access to the F5 device via SSH and if any IP access restrictions are in place
30+
4. Log into the [MyF5](https://my.f5.com) portal and download the latest GeoIP database
31+
- Goto Resources > Downloads
32+
- Set `GROUP` as `BIG-IP`
33+
- Set Product Line and Product Version as per your F5 device
34+
- Set `GEOLOCATIONUPDATES_Edge`
35+
- Download the latest GeoIP database zip file and md5 file
36+
37+
### Update GeoIP database
38+
The following steps are to be in the `*shared*` directory, which is different from the `*/usr/share*` directory, which contains the default GeoIP database files.
39+
40+
1. Use a SFTP client to upload the GeoIP database zip file to the F5 device
41+
2. Place the GeoIP database zip and md5 files in the */shared/tmp* directory
42+
43+
- Connect to the F5 device via SSH and run the following commands:
44+
45+
```bash
46+
mkdir /shared/GeoIP_backup
47+
48+
cp -R /GeoIP/* /GeoIP_backup/
49+
50+
cd /shared/tmp
51+
52+
md5sum -c <ip-geolocationfile>.zip.md5
53+
54+
unzip <ip-geolocationfile>.zip
55+
56+
```
57+
58+
59+
- This step will overwrite the update GeoIP database files, repeat for each rpm file in the zip archive
60+
61+
```bash
62+
geoip_update_data -f </path/to/rpm>
63+
64+
geoip_lookup -f <path/to/db/files> <IP address>
65+
```
66+
67+
- Remove the now redundant zip, rpm and md5 files from temp directory
68+
69+
```bash
70+
rm -i </path/to/file>
71+
72+
```

source/network/F5AdminPortal.html.md.erb renamed to source/network/f5/F5AdminPortal.html.md.erb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Palo Alto Admin Portal
2+
title: Admin Portal
33
last_reviewed_on: 2024-09-20
44
review_in: 6 months
55
weight: 10

0 commit comments

Comments
 (0)