MS-TEAM/steps.md

# IFS Deployment Steps Guide

This guide details the steps for installing a new delivery package in IFS, covering environment setup, database preparation, installation, and final cleanup.

-----

### **I. Preparation and Access**

1.  **Log in to VPN:**
      * Log in to the **IPL - VPN**.
2.  **Log in to Management Server:**
      * Log in to the **Management Server** (e.g., `ifsapp`).
3.  **Check Current Delivery Level:**
      * Check the current delivery level from the application, specifically using the **Delivery Registry**.
4.  **Identify Target Delivery:**
      * The delivery you need to install is the **next available delivery**.
5.  **Download Delivery Package:**
      * **Download the delivery** from the **build place**.
6.  **Copy Delivery Package:**
      * **Copy the delivery package** to the designated **delivery installation directory**.

-----

### **II. Environment Configuration (Kube & Middle-Tier)**

7.  **Source the Environment with Kube Configuration:**
      * Run the following commands to configure `kube`:
        ```bash
        .\main.ps1 -resource 'GETKUBECONFIG'
        copy .\config\kube\config $HOME\.kube\
        ```
8.  **Verify Namespace and Pods:**
      * The correct namespace is **"IPLUPG"**.
      * Get all namespaces:
        ```bash
        kubectl.exe get ns
        ```
      * Verify running Pods in the target namespace:
        ```bash
        kubectl.exe get pods -n IPLUPG
        ```
9.  **Stop the Middle-Tier:**
      * Stop the Middle-Tier. The namespace is **"IPLUPG"**.
      * **Command Example:**
        ```bash
        <path to delivery installation folder>\mtctl.cmd stop -n IPLUPG
        ```

-----

### **III. Database Preparation**

10. **Log in to Oracle Server:**
      * Log in to the **Oracle Linux server** with the username **"oracle"**.
      * Connect to the database:
        ```bash
        sqlplus / as sysdba
        ```
11. **Source the Instance:**
      * Set the Oracle environment ID:
        ```bash
        . oraenv
        # OR
        set oracle_sid=<SID>
        ```
12. **Verify Instance and PDB Status:**
      * Check the status of Pluggable Databases (PDBs):
        ```sql
        show PDB
        ```
13. **Check Archive Log Mode:**
      * Determine if the DB is running in `archive log` or `no archive log` mode:
        ```sql
        archive log list
        ```
14. **Check DB Recovery Destination:**
      * Check the recovery file destination and size parameters:
        ```sql
        show parameter db_recovery_file_dest_size
        show parameter db_recovery_file_dest
        ```
15. **Create Temporary Directory:**
      * Create a directory named **"TEST"** in the `/u02` partition:
        ```bash
        mkdir /u02/TEST
        ```
16. **Configure Recovery Destination (If No Archive Log):**
      * If the database is in `no archive log` mode, configure the destination:
        ```sql
        db_recovery_file_dest_size=100G
        db_recovery_file_dest=/u02/TEST
        ```
17. **Set Database to Archive Log Mode:**
      * **Change DB to Archivelog:**
        ```sql
        shutdown immediate
        startup mount
        alter database archivelog;
        alter database open;
        ```
      * *(The "No Archivelog" commands are provided here for later reference.)*
          * *Change DB to No Archivelog:*
        ```sql
        *shutdown immediate*
        *startup mount*
        *alter database noarchivelog;*
        *alter database open;*
        ```
18. **Verify Instance and PDB Status (Post-change):**
      * Re-verify the status of PDBs:
        ```sql
        show PDB
        ```
19. **Configure Restore Point:**
      * Create a guaranteed restore point before deployment:
        ```sql
        create restore point delivery guarantee flashback database;
        ```
      * *(To drop the restore point later, use:* `drop restore point delivery;`*)*

-----

### **IV. Delivery Installation and Verification**

20. **Run the Delivery Database Part:**
      * Execute the database installer part of the delivery:
        ```bash
        .\installer.cmd --set action=dbinstaller --values <Path>\ifscloud-values.yaml --values <Path>\solutionset.yaml --set dbInstaller.sysPassword=<DBPassword>
        ```
21. **Verify the Logs:**
      * Check for errors and successful completion in the logs located at:
        ```bash
        ifsroot\logs\ifscloudinstaller\
        ```
22. **Run the Delivery Middle-Tier Part:**
      * Execute the middle-tier installer part:
        ```bash
        .\installer.cmd --set action=mtinstaller --values <Path>\ifscloud-values.yaml
        ```
23. **Verify the PODs Status:**
      * Check the status of the pods to ensure the middle-tier has started successfully:
        ```bash
        kubectl.exe get pods -n IPLUPG
        ```
24. **Login and Verify Delivery Level:**
      * **Log in to the application** and verify that the new **delivery level** is correctly displayed.

-----

### **V. Post-Installation Cleanup**

25. **Drop Restore Point (If Successful):**
      * If the delivery is successful, remove the restore point:
        ```sql
        drop restore point delivery;
        ```
26. **Stop Application:**
      * Stop the application (if necessary).
27. **Change Database to No Archivelog:**
      * Revert the database to **No Archivelog** mode:
        ```sql
        shutdown immediate
        startup mount
        alter database noarchivelog;
        alter database open;
        ```
28. **Start Application:**
      * Start the application to bring the system online.