{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Locate upgrade scripts folder in distribution zip file. For example, ","type":"text"},{"text":"/database/oracle/upgrade, /database/postgres/upgrade.","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" This folder(s) includes a number of folders containing ","type":"text"},{"text":"migration.sql","type":"text","marks":[{"type":"strong"}]},{"text":", which upgrade the FlexDeploy schemas.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Checks prior to running Migration SQLs","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As part of FlexDeploy 5.4 upgrade, missing UK constraint was added for REL_METADATA_VALUE table. Please check that there are no duplicate rows by running following SQL prior to upgrade. If you find duplicates then contact us via support portal.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"sql"},"content":[{"text":"SELECT * FROM (SELECT REL_DEFINITION_ID, PIPELINE_METADATA_ID, COUNT(1) NUMROWS\nFROM FD.REL_METADATA_VALUE\nGROUP BY REL_DEFINITION_ID, PIPELINE_METADATA_ID)\nWHERE NUMROWS>1;","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are upgrading from version prior to FlexDeploy 5.2, run following SQL prior to running upgrade scripts and make sure no rows are returned. If there are any row returned, it is possible that migration may not work correctly, in which case contact us via support portal.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"sql"},"content":[{"text":"SELECT\n kd.property_key_name, k.*\nFROM\n fd.property_key k,\n fd.property_key_definition kd,\n fd.property_value pv\nWHERE\n k.property_definition_id = kd.property_definition_id\n AND pv.sequence_number = 0\n AND k.property_key_id = pv.property_key_id\n AND kd.is_encrypted = 'Y'\n AND k.is_encrypted = 'N'\n AND pv.property_value not in ('', '');","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FlexDeploy 5.1 migration includes updates to Unique Constraint for FF.DB_PROPERTIES_DATA. If you are upgrading from version prior to 5.1, then run following SQL before running upgrade scripts. If you have duplicates then it needs to be fixed up prior to starting migration. If there are duplicates, work with Flexagon support team to resolve prior to migration.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"sql"},"content":[{"text":"SELECT * FROM (SELECT DB_PROPERTIES_ID, SEQUENCE_NUMBER, COUNT(1) NUMROWS\nFROM FF.DB_PROPERTIES_DATA \nGROUP BY DB_PROPERTIES_ID, SEQUENCE_NUMBER) \nWHERE NUMROWS>1;","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Running Migration SQL(s)","type":"text"}]},{"type":"paragraph","content":[{"text":"You will need to execute one or more SQL script(s) from the version of FlexDeploy you currently have, up to the latest version. And they must be executed in that order.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":669,"id":"640a4845-c978-4c26-8b34-ce8e6c7406b8","collection":"contentId-10340185352","type":"file","height":671}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"There is not an upgrade script for every version. For instance there is no upgrade script for upgrading FlexDeploy 5.6.0.6 to FlexDeploy 5.7.0.0. Simply skip to the next one needed, or stop if there aren't anymore.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"See some examples below to help you understand database upgrade process.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Upgrading 5.6.0.0 to 6.0.0.0","type":"text"}]},{"type":"codeBlock","attrs":{"language":"sql"},"content":[{"text":"v5.6.0.0-to-v5.6.0.2/migration.sql\nv5.6.0.2-to-v5.6.0.5/migration.sql\nv5.6.0.5-to-v5.6.0.6/migration.sql\nv5.7.0.0-to-v5.7.0.1/migration.sql\nv5.7.0.1-to-v5.7.0.2/migration.sql\nv5.7.0.2-to-v6.0.0.0/migration.sql","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Executing migration files","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have decided which migration scripts to execute, you need to run them against your database using database specific tools in proper sequence.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Oracle","type":"text"}]},{"type":"paragraph","content":[{"text":"These scripts should be executed as ","type":"text"},{"text":"system, sys, or another user which has privileges to create objects in other schemas, performs grants, etc","type":"text","marks":[{"type":"strong"}]},{"text":". You can load and execute these scripts using other tools such as Toad or SQL Developer. Instructions below are for using the ","type":"text"},{"text":"sqlplus","type":"text","marks":[{"type":"strong"}]},{"text":" client.","type":"text"}]},{"type":"paragraph","content":[{"text":"Oracle SQL*Plus is part of the Oracle Client, and may be executed on any host which has it installed. If the Oracle Client is not installed on the same host as where you are installing FlexDeploy, you can copy the scripts to another host which has it installed.","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure to spool output to a file, so it can be analyzed later if necessary.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To launch sqlplus:","type":"text"}]},{"type":"codeBlock","content":[{"text":"export ORACLE_HOME=\nexport ORACLE_SID=\nspool migration5.2.0.out #(change for each script execution so logs are preserved)\n$ORACLE_HOME/bin/sqlplus #(login as sys or system when prompted)\nSQL> <>","type":"text"}]},{"type":"paragraph","content":[{"text":"If running on another host other than the database server, you must update your tnsnames file and and launch sqlplus as follows:","type":"text"}]},{"type":"codeBlock","content":[{"text":"export ORACLE_HOME=\nexport ORACLE_SID=\nspool migration5.2.0.out #(change for each script execution so logs are preserved)\n$ORACLE_HOME/bin/sqlplus system@\nSQL> <>","type":"text"}]},{"type":"paragraph","content":[{"text":"For example,","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":52.0},"content":[{"type":"media","attrs":{"width":900,"id":"f2448c1f-2a41-448f-b302-23b4d9e88749","collection":"contentId-10340185352","type":"file","height":313}}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"PostgreSQL","type":"text"}]},{"type":"paragraph","content":[{"text":"These scripts should be executed as ","type":"text"},{"text":"postgres or another super user which has privileges to create objects in other schemas, performs grants, etc","type":"text","marks":[{"type":"strong"}]},{"text":". Change the bold text as needed in your environment.","type":"text"}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"Linux","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run FlexDeploy migration scripts. Type the password when asked. ","type":"text"},{"text":"PostgresDDL.txt ","type":"text","marks":[{"type":"strong"}]},{"text":"records the output of the script so that you can refer back to it later.","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd \\database\\postgres\\upgrade\\vx.y.0.z-v.a.b.0.c\n/path/to/psql -U postgres -h hostname -p 5432 -d flexdeploy -a -b -e -f migration.sql > PostgresDDL.txt","type":"text"}]},{"type":"heading","attrs":{"level":6},"content":[{"text":"Windows","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run FlexDeploy scripts. Type the password when asked. ","type":"text"},{"text":"PostgresDDL.txt","type":"text","marks":[{"type":"strong"}]},{"text":" records the output of the script so that you can refer back to it later. ","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"cd /database/postgres/upgrade/vx.y.0.z-v.a.b.0.c\nC:\\path\\to\\psql -U postgres -h hostname -p 5432 -d flexdeploy -a -b -e -f migration.sql > PostgresDDL.txt","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported