Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
* adding content

* adding content

Signed-off-by: therayy <raafat@ibm.com>

* changing not icon

* fixing icons 

Signed-off-by: Ray Abaid Raafat@ibm.com

* adding in Infrastructure details
  • Loading branch information
therayy authored Mar 7, 2022
1 parent 1845f3e commit 5d38276
Showing 1 changed file with 70 additions and 21 deletions.
91 changes: 70 additions & 21 deletions doc/sfg-recipe.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,23 @@
# Deploy Sterling File Gateway

# Deploy [Sterling Secure File Gateway](https://www.ibm.com/supply-chain/collaboration?utm_content=SRCWW&p1=Search&p4=43700068006590527&p5=p&gclid=CjwKCAiAjoeRBhAJEiwAYY3nDKkx-iT7gk0IHoCYzWN97TVVeQu_mOixEk4no6pi3I_MxnSH8GwSrhoCo8EQAvD_BwE&gclsrc=aw.ds)

### Infrastructure - Kustomization.yaml
1. Edit the Infrastructure layer `${GITOPS_PROFILE}/1-infra/kustomization.yaml`, un-comment the following lines, commit and push the changes and synchronize the `infra` Application in the ArgoCD console.
```yaml
- argocd/consolenotification.yaml
- argocd/namespace-db2.yaml
- argocd/namespace-mq.yaml
- argocd/namespace-tools.yaml
- argocd/namespace-sealed-secrets.yaml
- argocd/serviceaccounts-db2.yaml
- argocd/serviceaccounts-mq.yaml
- argocd/serviceaccounts-tools.yaml
```
1. Edit the Infrastructure layer `${GITOPS_PROFILE}/1-infra/kustomization.yaml`, un-comment the following lines, commit and push the changes and synchronize the `infra` Application in the ArgoCD console.

```bash
cd multi-tenancy-gitops/0-bootstrap/single-cluster/1-infra
```

```yaml
- argocd/consolenotification.yaml
- argocd/namespace-db2.yaml
- argocd/namespace-mq.yaml
- argocd/namespace-tools.yaml
- argocd/namespace-sealed-secrets.yaml
- argocd/serviceaccounts-db2.yaml
- argocd/serviceaccounts-mq.yaml
- argocd/serviceaccounts-tools.yaml
```
### Services - Kustomization.yaml
1. This recipe is currently set to use the `ibmc-file-gold` storageclass provided by IBM Cloud by default.
@@ -21,49 +27,92 @@
```
1. Generate Sealed Secrets resources required by Sterling File Gateway.

1. From a terminal window, go to the `multi-tenancy-gitops-services/instances/ibm-sfg-b2bi-setup` directory.
```
cd multi-tenancy-gitops-services/instances/ibm-sfg-b2bi-setup
```
1. From a terminal window and clone the `multi-tenancy-gitops-services` repository using your Git Organization.

```bash
git clone git@github.com:${GIT_ORG}/multi-tenancy-gitops-services.git
1. Generate a Sealed Secret for the DB2 credentials.
```
```bash
B2B_DB_SECRET=db2inst1 ./b2b-db-secret-secret.sh
```
1. Generate a Sealed Secret for the MQ credentials, keystore and truststore password.
```
```bash
JMS_PASSWORD=password JMS_KEYSTORE_PASSWORD=password JMS_TRUSTSTORE_PASSWORD=password ./b2b-jms-secret.sh
```
1. Generate a Sealed Secret for the B2B System Passphrase.
```
```bash
B2B_SYSTEM_PASSPHRASE_SECRET=password ./b2b-system-passphrase-secret.sh
```

1. Generate Persistent Volume Yamls required by Sterling File Gateway:
```
```bash
./ibm-b2bi-documents-pv.sh
./ibm-b2bi-logs-pv.sh
./ibm-b2bi-resources-pv.sh
./sterlingtoolkit-pv.sh
```

> 💡 **NOTE**
> Push the changes & sync ArgoCD this will


1. Edit the Services layer `${GITOPS_PROFILE}/2-services/kustomization.yaml` by uncommenting the following lines to install the pre-requisites for Sterling File Gateway, **commit** and **push** the changes and synchronize the `services` Application in the ArgoCD console.
```yaml
- argocd/instances/ibm-db2.yaml
- argocd/instances/ibm-mq.yaml
- argocd/instances/ibm-sfg-b2bi-setup.yaml
```

> 💡 **NOTE**
> Push the changes & sync ArgoCD this will

1. Generate Helm Chart values.yaml for the Sterling Secure File Gateway Helm Chart:

```bash
cd multi-tenancy-gitops-services/instances/ibm-sfg-b2bi
./ibm-sfg-b2bi-overrides-values.sh
```

1. Edit the Services layer `${GITOPS_PROFILE}/2-services/kustomization.yaml` by uncommenting the following line to install Secure File Gateway, commit and push the changes and synchronize the `services` Application in the ArgoCD console:

1. Generate Helm Chart values.yaml for the Sterling File Gateway Helm Chart:
```
cd multi-tenancy-gitops-services/instances/ibm-sfg-b2bi
./ibm-sfg-b2bi-overrides-values.sh
```
1. Edit the Services layer `${GITOPS_PROFILE}/2-services/kustomization.yaml` by uncommenting the following line to install Sterling File Gateway, **commit** and **push** the changes and synchronize the `services` Application in the ArgoCD console:

```yaml
- argocd/instances/ibm-sfg-b2bi.yaml
```

> 💡 **NOTE**
> Push the changes & sync ArgoCD this will take around 1.5 hr.
---
> **⚠️** Warning:
> If you decided to scale the pods or upgrade the verison you should do the following steps:
- Step 1:
```bash
cd multi-tenancy-gitops-services/instances/ibm-sfg-b2bi
```
- Step 2:
- Inside `values.yaml`, find & set
- ```bash
datasetup:
enable: false
dbCreateSchema: false
```
> This is to avoid going through the job again

___

### Validation

1. Retrieve the Sterling File Gateway console URL.

```bash
oc get route -n tools ibm-sfg-b2bi-sfg-asi-internal-route-filegateway -o template --template='https://{{.spec.host}}'
```
2. Log in with the default credentials: `fg_sysadmin / password`.

2. Log in with the default credentials: username:`fg_sysadmin` password: `password`

0 comments on commit 5d38276

Please sign in to comment.