Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add-libragob-update-service-sequance #389

Merged
merged 5 commits into from
Feb 4, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .github/actions/spelling/expect.txt
Original file line number Diff line number Diff line change
@@ -1,17 +1,21 @@
ACNF
ACRD
agw
AJRA
atl
atlassian
atlassiannonprod
atlasssian
Bance
ccbcdc
cdef
Chirag
CVP
Dac
Datlassian
deevanapalli
devrot
dfd
dpdb
dsl
EDB
Expand All @@ -28,6 +32,9 @@ jfrt
jira
journalctl
kalyan
libragob
libragobrestore
mdnrg
mdv
MDVADMVPNHA
MDVDMZJUMPL
Expand All @@ -49,10 +56,13 @@ ruxit
SBZ
statefulset
STE
themisgatewayapi
thw
toset
totp
TTLs
utilisation
Virtualbox
virtualwan
VNETs
wsdl
2 changes: 1 addition & 1 deletion .github/workflows/build.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ jobs:
name: Check spelling
steps:
- name: Spell-Check
uses: check-spelling/[email protected].22
uses: check-spelling/[email protected].24
with:
checkout: true
extra_dictionaries:
Expand Down
2 changes: 1 addition & 1 deletion source/Services/apim-migration.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Upgrading Azure API Management platform version
last_reviewed_on: 2024-05-28
review_in: 12 months
weight: 160
weight: 150
---

# <%= current_page.data.title %>
Expand Down
2 changes: 1 addition & 1 deletion source/Services/atlassian.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Atlassian Apps - Jira, Confluence, Crowd and GlusterFS
last_reviewed_on: 2025-01-17
review_in: 12 months
weight: 159
weight: 15
---

# <%= current_page.data.title %>
Expand Down
2 changes: 1 addition & 1 deletion source/Services/docmosis.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Updating Docmosis Variables
last_reviewed_on: 2024-01-26
review_in: 12 months
weight: 150
weight: 195
---

# <%= current_page.data.title %>
Expand Down
Binary file added source/Services/images/Libragob-down.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 15 additions & 11 deletions source/Services/index.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -20,22 +20,33 @@ This space is for any guides relating to services that we deploy and share respo

[Data Boarding](databoarding.html)

## Mailrelay Guides
## Docmosis Guides

[Mailrelay](mailrelay.html)
[Updating Docmosis Variables](docmosis.html)

## Globalscape Guides

[Globalscape](globalscape.html)

## Docmosis Guides
## LibraGoB
[LibraGoB](libragob.html)

[Updating Docmosis Variables](docmosis.html)
## Mailrelay Guides

[Mailrelay](mailrelay.html)

## Other Docmosis Docs

[Docmosis](https://tools.hmcts.net/confluence/display/RD/Docmosis+Service+Operations+Guide+2.0)

## Palo Alto XSIAM XDR Agent Installation for Crime

[XDR Agent installation](xdr-agent-crime.html)

## Palo Alto XSIAM XDR Agent Installation for HMCTS

[XDR Agent installation](xdr-agent-hmcts.html)

## Power Platform

[Power Platform](powerplatformgateway.html)
Expand All @@ -44,10 +55,3 @@ This space is for any guides relating to services that we deploy and share respo

[Upgrading Azure API Management Migration](apim-migration.html)

## Palo Alto XSIAM XDR Agent Installation for HMCTS

[XDR Agent installation](xdr-agent-hmcts.html)

## Palo Alto XSIAM XDR Agent Installation for Crime

[XDR Agent installation](xdr-agent-crime.html)
81 changes: 81 additions & 0 deletions source/Services/libragob.html.md.erb
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
---
title: LibraGoB
last_reviewed_on: 2025-01-28
review_in: 6 months
weight: 130
---

# <%= current_page.data.title %>

## Introduction
Libra Green on Black (GoB) or Libra-GoB is the legacy system used in magistrates court for compliance and enforcement.
It is passed details of financial impositions from the court, and then 'manages' the collection of those fines - takings payments, setting terms and sending bailiffs etc.

The application itself runs in containers hosted by Azure Kubernetes, SDS clusters, in the MET namespace. With CGI creating the images, which are manually pushed by them, to the HMCTS container repository.

Known as MET within the sds-flux-config apps folder

## Repositories
* Frontend
[sds-flux-config / MET](https://github.com/hmcts/sds-flux-config/tree/master/apps/met)

* Backend
[Libragob-Shared-Infrastructure](https://github.com/hmcts/libragob-shared-infrastructure)



### Pipelines
GitHub Actions apply HELM CHART changes to the MET containers in the TEST environments, when a GitHub Pull Request in sds-flux-config is created. When these PRs are approved, the PROD environment receives the new helm charts.


Libragob-Shared-Infrastructure uses SDS Jenkins and the HMCTS / libragob-shared-infrastructure pipeline to manage infrastructure
[Jenkins Pipeline](https://sds-build.hmcts.net/blue/organizations/jenkins/HMCTS%2Flibragob-shared-infrastructure)


# MET Containers

The [themis-fe.yaml](https://github.com/hmcts/sds-flux-config/blob/master/apps/met/themis-fe/themis-fe.yaml) file describes the MET application and is combined with either prod.yaml or test.yaml to create the specific environments containers.

The environment variables within the files are the responsibility of CGI and they toggle "TEMP_VAR" to either 0 or 1, to restart the containers in environments.

Log output from the application can be viewed by either watching the live logs via K9s or kubectl logs

### Example log file
```
kubectl logs -n namespace container > any_name.txt

kubectl logs -n met met-themis-fe-nodejs-X > any_name.txt
```

By saving the logs to a text file, you can use an editor to search the log for key events

Starting

* Starting DacSbApplication v1.0.0 using Java 17-ea on met-themis-fe-nodejs-X
* Starting ThemisGatewaySbApplication v1.0.0 using Java 17-ea on met-themis-fe-nodejs-X
* Starting service [Tomcat]
* Starting Servlet engine: [Apache Tomcat/9.0.70]


Exception
* Caused by: java.sql.SQLException: Cannot create JDBC driver of class 'org.postgresql.Driver' for connect URL 'jdbc:postgresql://libragobrestore-'


## MET Testing
If the MET containers are operational and you are connected via thw F5 VPN tunnel, these URLs will respond with a page of XML
"This XML file does not appear to have any style information associated with it. The document tree is shown below."

* PROD - [https://cloudgobgateway.platform.hmcts.net/services/themisgatewayapi?wsdl](https://cloudgobgateway.platform.hmcts.net/services/themisgatewayapi?wsdl)
* TEST - [https://cloudgobgateway.test.platform.hmcts.net/services/themisgatewayapi?wsdl](https://cloudgobgateway.test.platform.hmcts.net/services/themisgatewayapi?wsdl)

The URL resolves to an application gateway (aks00-(env$)-agw) which has the health probe "gob-gateway" to test the response from /services/themisgatewayapi?wsdl for a HTTP response status code match between 200-399. The probe connects a 2nd gateway and ultimately the MET containers.
Any problems with the back end network, containers or themis-fe-nodejs application and the 502 Bad Gateway error will be returned.

### Example Of Failed Application
<img src=images/Libragob-down.png width="800">


## Key Vault Secrets
Important configuration details are held within each environments key vault. Problems with database connection strings, user names or passwords, maybe reported in the log files. As shown in the example above. However, it is possible the container will become stuck in a reboot loop, when the readiness or liveness tests fail.

In January 2025, a wrong value for dac-datasource-username was provided but was not reported in the log file as an issue. It was only by testing the individual secrets called by the apps/met/themis-fe/test.yaml file, that the problem was discovered.
2 changes: 1 addition & 1 deletion source/Services/mailrelay.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Mailrelay Essentials
last_reviewed_on: 2024-01-26
review_in: 12 months
weight: 50
weight: 140
---

# <%= current_page.data.title %>
Expand Down
2 changes: 1 addition & 1 deletion source/Services/powerplatformgateway.html.md.erb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
title: Power Platform Gateways
last_reviewed_on: 2024-05-28
review_in: 6 months
weight: 158
weight: 145
---

# <%= current_page.data.title %>
Expand Down
Loading