commit c1b0d0b7c8d37d7bd5c335a819b66d1c342f6dd5 Author: OB Date: Thu Oct 2 13:25:12 2025 +0530 init diff --git a/steps.md b/steps.md new file mode 100644 index 0000000..ccdd880 --- /dev/null +++ b/steps.md @@ -0,0 +1,168 @@ +# 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 + \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= + ``` +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 \ifscloud-values.yaml --values \solutionset.yaml --set dbInstaller.sysPassword= + ``` +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 \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.