ODI 12c - SCM

10/6/23, 11:20 AM ODI 12c: SCM
ODI 12.2.1: SCM and Version Control
Before You Begin
Purpose
This tutorial covers using Apache (http://www.apache.org/)™ Subversion (https://subversion.apache.org/)® for ODI (http://www.oracle.com/goto/odi) software
configuration management (SCM (http://en.wikipedia.org/wiki/Software_configuration_management)) and object version control.
(Apache, Apache Subversion, and the Apache feather logo are trademarks of The Apache Software Foundation. Subversion and the Apache Subversion logo are registered trademarks of The
Apache Software Foundation.)
Time to Complete
Approximately 1 hour.
Background
Previous versions of ODI had an internal form of object version control. The internal versions were stored in the ODI Master Repositories. Starting with version 12.2.1,
you can use an external tool for version control such as Subversion. This requires a separate repository. Subversion maintains its repository in the file system. It does
not need a database for it. So Subversion's repository and ODI's repository have no connection. In the ODI repository, you configure Subversion connectivity by
specifying the underlying Subversion repository URL.
Scenario
Subversion has already been installed for another project. ODI has already been installed for another project. This lab connects the two so that a data warehouse
administrator can use Subversion for ODI SCM.
What Do You Need?

Software
Oracle Enterprise Linux (OEL) 6.4 or higher
Oracle Database 12c Release 1 Enterprise Edition (12.1.0.2) - including Oracle Big Data SQL-enabled external tables, Oracle Advanced Analytics, Oracle OLAP,
Oracle Partitioning, Oracle Spatial and Graph, and more
Oracle Data Integrator (ODI) 12.2.1 or higher
Alternatively, the Oracle Data Integrator Getting Started Virtual Machine (http://www.oracle.com/technetwork/middleware/data-integrator/odi-demo-2032565.html)
(the VM) contains all of the above pre-installed.
Hardware
At least 2 GB RAM for each target (database or ODI)
At least 6 GB RAM for the VM (if you are using that)
Prerequisites
Before starting this tutorial, you should:
Have at least 6 GB RAM available if you're using the Oracle Data Integrator Getting Started VM (http://www.oracle.com/technetwork/middleware/data-integrator/odi-
demo-2032565.html)
Have access to or have installed the sample lab artifacts
Have attended ODI 12c training, [D82167GC10 (http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?
page_id=609&p_org_id=1001&lang=US&get_params=dc:D82167GC10,p_preview:N)] Oracle Data Integrator 12c: Integration and Administration, or equivalent
experience.
Typographic Conventions
These are the conventions used throughout this practice to indicate who types what.
Filename or /path/subdirectory/ . Often you can navigate to a destination without having to type it.
Command or value that you type, such as gedit .bashrc . Be mindful of periods at the end of sentences that are not part of the command.
Click this Button such as OK or Next > .
Some variable or <variable> as something you replace. Often prefixed with "my" such as <myName> or <myHost> .
A Menu Item or dialog Field Prompt or Tab name. For example, "click the Designer tab and select Models > New Model".
Generally a red rectangle in the graphics is not part of the original image, but added to draw your attention to an item.
1 Setup / Administration
https://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_12c/odi12c_newfeatures/scm_version.html#overview 1/45
10/6/23, 11:20 AM ODI 12c: SCM
1. Setup / Administration
The SVN repository and its http server should already be installed, configured, started, and available in the VM.
1.1 SVN Setup
1. Open the web browser and go to http://localhost/svn/svnrepository . Enter User Name: odiuser1 and Password: oracle .
Click OK to continue. You should see the following success message with the version displayed.
2. If the URL does not work in the previous step, then run the following commands as root to (re)start the httpd server:
[OS]$ su - root
[OS]# service httpd restart
Stopping httpd: [ OK ]
Starting httpd: [ OK ]
[OS]# exit
[OS]$
Retry the previous step 1 to see if Subversion works now.
3. OPTIONAL: After class, you can find out more about Subversion by clicking the logo: (http://subversion.apache.org).
Subversion is configured and started.
1.2 ODI Subversion Connectivity Setup
Choose a Version Control Application for ODI Studio.
1. If ODI Studio is not started, then start it and Connect to Repository. If you are asked for a wallet password, enter welcome1 .
10/6/23, 11:20 AM ODI 12c: SCM
2. Connect to Login Name: ODI LCM Trunk. (This is the main login for these series of labs.)
Click OK to continue.
3. On the main menu bar, go to Team > Select Versioning Application.
4. Select Subversion and click OK .
In this environment, there is only one choice for a version application. You could use others.
5. Click Disconnect in the Confirmation dialog to disable Legacy Version Control System.
ODI Studio will now use SVN as the team versioning application.
1.3 SVN Connectivity Setup
1. If needed, connect to ODI LCM Trunk again.
2. On the main menu bar, go to Team > Subversion > Edit Connection.
10/6/23, 11:20 AM ODI 12c: SCM
3. In the SVN Connection dialog, set the following options:
Authentication Type: Http Basic Authentication

SVN URL: http://localhost/svn/svnrepository
User: odiuser1
Password: oracle (non-display)
Click OK .
4. Go to Team > Subversion > Configure.
a. Click Create Default Project Structure.
10/6/23, 11:20 AM ODI 12c: SCM
b. Set SVN Project Name: ODI_BETA and add Comments that it is the trunk of the svn project where ODI artifacts are maintained.
Generally speaking, the Comments or Description in SVN is mandatory. Click OK .
c. Set ODI_BETA for the SVN project name, select Trunk. Select VCS Key. Click Enter VCS Key . Enter New VCS Key: oracle123 twice.
Click OK on Enter VCS Key dialog. (VCS stands for "Version Control System.") Click OK on the Configure dialog.
The SVN configuration is done and it can be used for creating ODI artifacts versions. (There is no "Test" button.) You may be prompted to disconnect from the
repository for the changes to take effect. Reconnect to the ODI LCM repository before continuing with the steps in this OBE.
You should now have SVN connectivity set up.
2. Checkin / Checkout ODI artifacts in SVN
During the lifecycle of an ODI object (folder, datastore, package, most any kind of object), you may add, view, save, compare, change, restore, and delete versions of
that object.
2.1 Adding ODI artifacts to SVN
1. On the Designer tab, expand Projects > Demo > Sales Administration Demo > Mappings.
Right-click Load TRG_SALES and select Version > Subversion > Add to VCS.
10/6/23, 11:20 AM ODI 12c: SCM
2. A dialog is opened showing that the parent objects for the mapping are also going to be added to VCS.
Set Comments as something similar to, " This is the initial state. "
Click OK .
3. Click OK on the success Information dialog.
You have added a version of an object to the SVN.
2.2 Adding All Non-Versioned Objects to Subversion
This will be done in two waves: the first wave is adding most of the objects, but we will pretend that the last four objects did not exist yet. The second wave we will
pretend happened some time later after four new objects are created and now need to be versioned.
1. On the main menu bar, go to Team > Subversion > Add Non-versioned Objects.
10/6/23, 11:20 AM ODI 12c: SCM
2. In the Add ODI Objects to Subversion dialog, deselect the last four entries, and set Comments as something similar to,
" I deselected the last four entries. "
Click OK (this may take a while).
3. Click OK on the success Information dialog.
4. Repeat step 2.2.1 again. Only the four objects that were not added earlier appear in the list.
Add some Comments: and click OK to add them to SVN.
10/6/23, 11:20 AM ODI 12c: SCM
Click OK on the success Information dialog.
You have added a version of ALL objects to the SVN.
2.3 Viewing Version History
1. On the Designer tab, expand Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER. Right-click TRG_CUSTOMER and select Version >
Subversion > Version History.
10/6/23, 11:20 AM ODI 12c: SCM
2. Expand Version Search Criteria, and then make sure that Trunk and Date Range are selected as Search Criteria.
Click Apply . The Date Range is assumed to be today.
3. The object versions available in the Subversion repository are listed in the dialog.
Inspect different columns in the table to the version attributes.
Columns are Version, Action, Path, Date, SVN User, ODI User, Comments, and Copy Source. Your values for Version, and of course Date, will be different from what is shown.
4. Select the entry from the list and click Compare ( ) to compare the Subversion version with repository object.
5. A dialog would be shown saying, "No difference found."
Click OK on the Information dialog. Close the Version History tab.
You have viewed version history. In initial (trivial) cases, that may be no history of differences.
10/6/23, 11:20 AM ODI 12c: SCM
2.4 Saving Updates to SVN
1. On the Designer tab, expand Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER > Attributes. Right-click Attributes and add any New
Attribute, for example, Email.
Save the attribute. Close the tab.
2. Right-click TRG_CUSTOMER and select Version > Subversion > Create VCS Version.
3. Add Comments. You do not need to add name/date of change as that is included automatically.
10/6/23, 11:20 AM ODI 12c: SCM
Click OK .
4. An Information dialog is shown notifying the successful operation.
Click OK .
5. View the version history again by right-clicking Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER and select Version > Subversion > Version
History.
6. Make sure that the Trunk checkbox is selected. Click Apply .
Multiple versions of the object are shown in the version history. (Scroll horizontally to see them all, especially the comments.)
Close the Version History tab.
You have saved object changes to SVN.
2.5 Comparing SVN Objects and Comparing Objects
1. Open the Version History Dialog by expanding Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER, right-click TRG_CUSTOMER, and select
Version > Subversion > Version History.
10/6/23, 11:20 AM ODI 12c: SCM
Click Apply .
2. Hold [Ctrl] and select the two version entries.
Click the Compare icon ( ) and select Compare Selected Versions.
3. The Version Compare Results window is opened showing the difference between the two object versions.
10/6/23, 11:20 AM ODI 12c: SCM
Note the attribute you added at the end, in green.
4. Click the Coloring and Filtering icon ( ). Deselect the Unchanged (white) filter for both Object and Field. This would now show only the difference between the two
objects.
You can further narrow the difference if you are interested in only additions or deletions. You can also change the colors used for a given status (for example, if you are red/green colorblind).
Click OK in Display Options.
5. Inspect the differences by expanding the nodes.
10/6/23, 11:20 AM ODI 12c: SCM
Notice the two version numbers selected (in this case 224 and 228, your numbers may be different) are shown at the top of the columns. Close the Version Compare Results tab.
6. Open Version History again (step #1) and select only one entry, the top (earliest) one. Click Compare ( ) to compare the SVN version with the current (latest)
object in the repository.
Your version numbers may vary from what is shown in this example.
7. Click the Coloring and Filtering icon ( ) and uncheck Unchanged (white) checkbox to see only the modified attributes.
Notice the right-hand column at the top used to have a Version number, now it simply says, "Repository Object." Close the Version Compare Results tab.
You have compared versions of objects to each other and compared an object to the current repository object.
2.6 Restoring from Subversion
There are two flavors of restore: Without Merge and With Merge. They are pretty similar right up until the last step.
WITHOUT MERGE:
1. On the Designer tab, expand Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER. Right-click TRG_CUSTOMER and select Version >
Subversion > Restore from VCS.
10/6/23, 11:20 AM ODI 12c: SCM
2. Click Select Version in the Restore Object from Subversion Repository dialog.
This will populate the empty Version box.
3. Select the oldest version from the Version Selection dialog.
Click OK . Note that hovering over a truncated field (such as Date) displays the whole field (in this case, with hh:mm:ss).
4 N th t th V i fi ld i l t d li k OK
10/6/23, 11:20 AM ODI 12c: SCM
4. Now that the Version: field is populated, click OK .
5. The Import Report is shown for successfully importing the object from repository. Open the TRG_CUSTOMER datastore, expand Attributes, and verify that your newly
added column (Email) is not present anymore. (You may have to Refresh ( ) to clear out the column from the Designer > Models tab.)
Close the Import Report.
WITH MERGE:
1. Perform Step #1-2 again and select the newest version this time, which has the newly-added attribute.
10/6/23, 11:20 AM ODI 12c: SCM
Click OK .
2. Select Restore with Merge.
Click OK .
3. The difference in the repository object and Subversion object is shown in the Compare Results tab.
Notice that it is showing the missing attributes in the repository copy of the object which is present in VCS copy.
4. Click Perform Merge ( ) to open the Merge Results window below.
10/6/23, 11:20 AM ODI 12c: SCM
Scroll down (or filter) to see the conflicts marked with a red x on the Attribute icon ( ).
5. In Merge Results, click Edit Repository Object ( ) to open the corresponding datastore. In TRG_CUSTOMER , click Add ( ) and make changes as needed.
Save it. Close all of the Version tabs.
You have done a restore from Subversion both with and without a merge (manual resolution).
2.7 Restoring Deleted Objects
10/6/23, 11:20 AM ODI 12c: SCM
1. On the Designer tab, right-click Models > ODI_Demo and select Version > Subversion > Create VCS Version.
2. Add Comments.
On the Create Version dialog, click OK . On the Information dialog, click OK .
3. Delete Models > ODI_DEMO > Sales Administration > TRG_SALES.
On the Confirmation dialog, click Yes to remove TRG_SALES.
4. Repeat steps 1 and 2 again (Create Version, Add Comments).
10/6/23, 11:20 AM ODI 12c: SCM
Notice TRG_SALES is missing from the Designer Models, and is so noted in the Action as Deleted. Click OK twice.
5. On the main menu bar, go to Team > Subversion > Restore Deleted Object.
6. Select an appropriate date range (defaults to today, which is fine).
Click Apply .
7. Select the TRG_SALES entry to restore and click the Restore object icon ( ).
10/6/23, 11:20 AM ODI 12c: SCM
If the Import Report looks okay and says that TRG_SALES has been imported successfully, Close the report, then Close the Restore Deleted dialog.
8. Click Refresh ( ) and verify that the deleted datastore TRG_SALES has reappeared in the list of Models.
You have restored a deleted object.
You have checked in and checked out ODI objects in SVN.
3. Branch and Label Management
A quick overview of versioning terminology might be helpful:
Tag and label corresponds to same thing. A tag/label is applied a particular version of a set of objects/files so that the same set of objects versions can be retrieved
from SVN system using this tag. For example, Tag T1 is created for file A version 21 and file B version 51. So whenever you retrieve files for Tag T1 you will always
get A v21 and B v51.
A branch is created from a tag so that so that any changes made on the branch are isolated within the branch.
The following diagram illustrates the versions, tags and branch for a file in a trunk and branch:
10/6/23, 11:20 AM ODI 12c: SCM
3.1 Creating Tags
There are three kinds of tags: full, partial, and branch from tags.
1. Create a full tag as follows:
a. On the main menu bar, go to Team > Subversion > Create Full Tag.
b. Set Tag name as Full Label 1.0 and comment.
Click OK . (This may take a while.) Click OK in the success Information dialog.
2. Create a partial tag as follows:
a. On the main menu bar, go to Team > Subversion > Create Partial Tag.
b. Drag and drop Version Control Folder under Projects > Beta and the Version Control folder under Models on the left side of Objects to be Added. It
automatically brings in all the dependent objects.
c. Set Tag name as Partial
Label VCS and comment.
10/6/23, 11:20 AM ODI 12c: SCM
Click OK . Click OK in the success Information dialog.
3. Create a branch from tag as follows:
a. On the main menu bar, go to Team > Subversion > Create Branch from Tag.
b. Set the Branch name as DevBranch and comment, select the Partial Label VCS tag.
Click OK . Click OK in the success Information dialog.
10/6/23, 11:20 AM ODI 12c: SCM
You have created three kinds of tags: full, partial, and branch from.
3.2 Viewing Version Tree
1. On the Designer tab, expand Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER, then right-click TRG_CUSTOMER and and select Version >
Subversion > Version Tree.
The Version Tree editor is opened showing different version, tags, and branches for the object from Subversion.
You have to scroll pretty far horizontally to see everything. Notice the Thumbnail in the top left corner for fast scrolling.
2. Click different versions to view the version attributes. (Your numbers may vary.)
10/6/23, 11:20 AM ODI 12c: SCM
Rectangles are versions, ovals are actions. Yellow oval means Action=Added, White oval means Action=Modified.
3. Select two version nodes and click Compare ( ) to compare the versions.
10/6/23, 11:20 AM ODI 12c: SCM
Close the Version Compare Results tab, leave TAB_TRG_CUSTOMER.xml open.
4. Select a single version node and click Compare ( ) to compare it with Repository Object.
Close the Version Compare Results tab, leave TAB_TRG_CUSTOMER.xml open.
5. Click the Filter ( ) to filter out nodes based on date range.
Click OK .
6. Click Refresh ( ) to refresh and see the full version tree again. Close the TAB_TRG_CUSTOMER.xml tab.
You have explored the version tree.
3.3 Configuring ODI Repository for SVN Branch
10/6/23, 11:20 AM ODI 12c: SCM
1. From the main menu bar, select ODI > Disconnect. Then Connect to Repository, to the blank repository using Studio Login ODI LCM Branch.
The User/Password should be pre-populated. Click OK . (If you are ever prompted for the Wallet password, it is welcome1 .)
2. Select Subversion as the Versioning Application, configure Connection URL/User/Password, and Settings Work/Merge area. This was covered in all of Topic 1.2 and
Topics 1.3.1 through 1.3.3. Studio will remember many of the values as defaults from the previous Repository configuration.
3. Go to Team > Subversion > Configure.
4. Set the following configuration values:
a. Subversion Project Name: ODI_BETA .

b. Select Branch radio button and select the branch DevBranch from drop down.
c. Select VCS Key. Click Enter VCS Key . Enter New VCS Key as oracle123 twice. Click OK .
Note: You can also create a new branch from a tag by clicking New Branch .
Click OK . You are required to Disconnect then reconnect in order for the changes to take effect.
You have configured the SVN repository for a branch.
3.4 Populating Repository from VCS
1. From the main menu bar, go to Team > Subversion > Populate Repository from Branch/Trunk.
10/6/23, 11:20 AM ODI 12c: SCM
This is still using the new repository ODI LCM Branch from the previous topic 3.3.
2. Click Yes on the confirmation dialog.
As it warns you, this could take a while. Close the Import Report if it looks successful.
3. On the Designer tab, click Refresh ( ) and verify that the Sales Administration Demo mappings and models are populated in Studio.
You have populated an empty repository from VCS.
3.5 Performing Branch Merge
1. Still using the new repository login ODI LCM Branch from the previous topic 3.3, make following changes:
a. Duplicate Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER datastore.
10/6/23, 11:20 AM ODI 12c: SCM
Click Yes in the Confirmation dialog.
b. Add a New Attribute to the Models > ODI_DEMO > Sales Administration > TRG_CUSTOMER datastore.
Save and close the datastore.
c. Open Projects > Demo > Sales Administration Demo > Mappings > Load TRG_CUSTOMER and edit the Target Expression SRC_CUSTOMER.CUSTID + 1 to be
SRC_CUSTOMER.CUSTID
+ 2 . (Any trivial change to the mapping is the goal.)
10/6/23, 11:20 AM ODI 12c: SCM
Save and close the mapping.
2. Right-click Designer > Models > ODI_DEMO and select Version > Subversion > Create VCS Version.
Add a Comment.
Click OK twice.
3. Similarly, create a version of Projects > Demo too.
10/6/23, 11:20 AM ODI 12c: SCM
Add a Comment.
Click OK twice.
4. Log out (ODI > Disconnect) and log in (Connect to Repository) with ODI LCM Trunk main Login Name for trunk.
Click OK .
5. On the main menu bar, go to Team > Subversion > Create Full Tag.
Name the full tag Full Label 2.0 . Add Comments.
Click OK . (This may take a while.) Click OK again.
10/6/23, 11:20 AM ODI 12c: SCM
6. On the main menu bar, go to Team > Subversion > Merge.
Select Merge Type: Branch radio button, and select the branch Source: DevBranch from drop down.
The default Merge Name (with date/time suffix) is fine. Click OK . If the Merge Summary looks successful, click Close .
7. Merge is performed and the Merge Summary is shown. Examine the conflicts in the objects that are modified in the branch.
8. Close Merge Summary page and the Merge Results editor is shown with the Merge Objects list. Select Merge Object Filter as Conflict to view only the
conflicted objects.
10/6/23, 11:20 AM ODI 12c: SCM
9. Select the datastore TRG_CUSTOMER and click Fix Merge Conflict ( ) which will open the Merge Conflict Resolution tab with the differences between the two
objects.
10/6/23, 11:20 AM ODI 12c: SCM
10. Inspect the differences and click Edit repository object ( ) which will open the datastore to make changes.
Currently the editor is opened in readonly mode.
11. Notice the red X indicator ( ) next to the datastore in the navigation tree. Open the datastore for editing. Add/modify the datastore based upon the differences:
remove the Gender attribute, then save the datastore.
12. Click on the green check ( ) to mark the object as resolved/fixed.
10/6/23, 11:20 AM ODI 12c: SCM
After you click it, it will go from green to gray.
13. Go back to the Merge Object Selection tab. Notice the Mark Object Merged column. The datastore is marked as resolved.
14. Resolve conflicts in Load TRG_CUSTOMER : Change Target expression for CUST_ID attribute to SRC_CUSTOMER.CUSTID + 2 . Mark them as resolved.
15. Mark all other object as resolved by Selecting All objects ( ) and click Save All ( ).
10/6/23, 11:20 AM ODI 12c: SCM
Close the Merge Results tab.
You have completed a branch merge.
3.6 Viewing Merge Summary
You automatically get to see the Summary report of the last merge you just did, this option shows you merges that may have happened before that.
1. Go to Team > Subversion > Merge Summary.
2. Accept the defaults. (There is currently only one merge to choose from.)
Click OK .
3. Inspect the Merge Summary reports available by changing the Merge Status filters (All, Completed, In Progress) on the previous dialog.
10/6/23, 11:20 AM ODI 12c: SCM
If any objects are In Progress , then the whole merge is In Progress . Click Close .
You have viewed the merge summaries.
You have created tags, viewed version trees, made branches, and merged them.
4. Release Management
You will create, view, apply, and roll back archives and patches.
4.1 Creating Deployment Archives
There are several kinds of Deployment Archives: Full, Selected, and from VCS tags.
1. Create a Full Repository Archive:
a. From the main menu bar, go to Team > Deployment Archives > Create From Repository > Full Repository.
b. Set Deployment Archive Name, Folder Path, and Description.

c. Set Export Key as oracle123 twice.
10/6/23, 11:20 AM ODI 12c: SCM
Click OK on Create dialog. (This takes a long time, approx 5 minutes. Get coffee.) Click OK on Success dialog.
2. Selected Objects from Repository:
a. From the main menu bar, go to Team > Deployment Archives > Create From Repository > Selected Objects.
b. Set Deployment Archive Name, Folder Path, and Description.

c. Set Export Key as oracle123 twice.
d. Drag and drop Project Version Control into the Objects to be added dialog.
10/6/23, 11:20 AM ODI 12c: SCM
Click OK on Create dialog. Click OK on Success dialog.
e. Repeat Step 4.1.2.a. through 4.1.2.c. while selecting only a couple of mappings to create a Patch Deployment Archive. MAKE SURE you select Patch Deployment
Archive (not Initial as the default).
10/6/23, 11:20 AM ODI 12c: SCM
Click OK on Create dialog. Click OK on Success dialog.
f. Check the file structure you created so far.
[OS]$ cd ~/Documents/
[OS]$ ll
total 12208
-rw-r-----. 1 oracle oinstall 5931861 Feb 6 21:44 EXEC_my_full_archive.zip
-rw-r-----. 1 oracle oinstall 530 Feb 6 22:04 EXEC_my_patch_archive.zip
-rw-r-----. 1 oracle oinstall 523 Feb 6 21:33 EXEC_my_selective_archive.zip
-rw-r-----. 1 oracle oinstall 6341439 Feb 6 21:44 my_full_archive.zip
-rw-r-----. 1 oracle oinstall 105352 Feb 6 22:04 my_patch_archive.zip
-rw-r-----. 1 oracle oinstall 105344 Feb 6 21:33 my_selective_archive.zip
[OS]$
You can put them anywhere, this is just an example.
3. From VCS tag:
a. On the main menu bar, go to Team > Deployment Archives > Create from VCS Label.
b. Set Deployment Archive Name, Folder Path, VCS label, and Description.
c. Set export key as oracle123 .
Click OK . Click OK on Success dialog. A Deployment Archive is created with the objects present in the VCS tag/label.
You have created multiple kinds of deployment archives (zip files) and stored them in /Documents .
4.2 Viewing Available Deployment Archives
1. On the main menu bar, go to Team > Deployment Archives > View Details.
2. Set the Folder Path where the Deployment Archives were created.
10/6/23, 11:20 AM ODI 12c: SCM
You cannot type the Folder Path, you must use Browse ( ).
3. View various Initial and Patch deployment archives.
Click Close twice.
You have viewed initial and patch deployment archives (zip files) from /Documents .
4.3 Applying Initial Deployment Archive
1. On the main menu toolbar, do ODI > Disconnect, then Connect to Repository, then switch to Login for ODI LCM Production. (The User/Password should be pre-
populated, but if not, then use SUPERVISOR/welcome1 .)
The production repositories are not supposed to be connected to SVN. SVN configuration is allowed only for development repositories.
2. On the main menu bar, go to Team > Deployment Archives > Initialize Deployment Repository.
10/6/23, 11:20 AM ODI 12c: SCM
If the options are grayed out, then you must not have picked the PRODUCTION repository.
3. Set the path to the folder /home/oracle/Documents (or wherever you put them).
You cannot type the Folder Path, you must use Browse ( ).
4. Select deployment my_selective_archive and click OK .
Q: "Why EXEC_ prefixes?"

A: ODI has two types of work repositories: development and execution. Development repositores can hold all kinds of artifacts that developers create, such as mappings, datastores, packages, and so on. Execution
repositories are strictly for production environments where modifying objects is not allowed. So in an execution repository, only scenarios and loadplans are allowed to reside, which are the executable objects in ODI. So
here EXEC_ archives contain only the executable artifacts and is for the execution repository where design-time objects cannot reside.
5. Enter the Export Key of oracle123 .
10/6/23, 11:20 AM ODI 12c: SCM
The export key is what is used for the import operation... Click OK on Success dialog.
You have deployed a production initial archive.
4.4 Applying Patch Deployment Archive
1. On the main menu bar, go to Team > Deployment Archives > Patch Deployment Repository.
2. Set the Path to the folder /home/oracle/Documents (or wherever you put them), and select my_patch_archive patch deployment.
(See the discussion on step 4.3.4 for the difference between my_patch_archive and EXEC_my_patch_archive .)
Select Create Rollback Deployment Archive, set the Rollback DA Path where rollback deployment archive zip is to be created.
Click OK .
3. Enter the Export Key of oracle123 .
Click OK on Success dialog.
You have deployed a production patch archive.
4.5 Viewing Applied Patches
1 O th i b t T D l t A hi I t
10/6/23, 11:20 AM ODI 12c: SCM
1. On the main menu bar, go to Team > Deployment Archives > Inventory.
2. The list of patch and full Deployment Archives are listed in the tables.
Click Close .
You have viewed the patches and deployment archives that have been applied to the production repository.
4.6 Rollback a Patch
1. On the main menu bar, go to Team > Deployment Archives > Rollback.
2. Set the following parameters:
a. Set Deployment Archive Folder Path: to /home/oracle/Documents (or wherever you put them).
b. Select a rollback Deployment Archive. Click OK .

c. Enter the Export Key of oracle123 .
10/6/23, 11:20 AM ODI 12c: SCM
Click OK .
You have rolled back a patch archive to the previous state.
You have managed the creation, release, rollout, and rollback of deployment archives.
Want to Learn More?
In this Oracle By Example (OBE) tutorial, you learned how to:
Perform the initial setup and administration of Apache Subversion (SVN) and ODI
Check objects in and out of SVN, add, delete, and restore objects
Configure branch and label management
Manage releases of software
Resources
Conceptual or procedural Help topics relevant to the topic of this tutorial:
ODI product home page (http://www.oracle.com/goto/odi)

Documentation on releases 12.2.1 (http://docs.oracle.com/middleware/1221/odi/index.html) and 12.1.3 (http://docs.oracle.com/middleware/1213/odi/index.html)
Training
[D82167GC10 (http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?
page_id=609&p_org_id=1001&lang=US&get_params=dc:D82167GC10,p_preview:N)] Oracle Data Integrator 12c: Integration and Administration. 5 days.
[D87557GC10 (http://education.oracle.com/pls/web_prod-plq-dad/db_pages.getpage?
page_id=609&p_org_id=1001&lang=US&get_params=dc:D87557GC10,p_preview:N)] Oracle Data Integrator 12c: Advanced Integration and Development. 3 days.
ODI A-Team Blogs (http://www.ateam-oracle.com/data-integration/di-odi/)
The Apache (http://www.apache.org/) Software Foundation web site, home of Subversion (https://subversion.apache.org/), among many other projects.
To learn more about ODI, refer to additional OBEs in the Oracle Learning Library (http://www.oracle.com/goto/oll), perhaps starting with this ODI 12c series
(https://apexapps.oracle.com/pls/apex/f?p=44785:24:0::::P24_CONTENT_ID,P24_PREV_PAGE:7952,1).
Credits
As always, a team effort. This is a partial list of the team:
About Oracle (http://www.oracle.com/corporate/index.html) Contact Us (http://www.oracle.com/us/corporate/contact/index.html) Legal Notices (http://www.oracle.com/us/legal/index.html)

Terms of Use (http://www.oracle.com/us/legal/terms/index.html) Your Privacy Rights (http://www.oracle.com/us/legal/privacy/index.html)
Copyright © 2015, Oracle and/or its affiliates. All rights reserved.

ODI 12c - SCM

Uploaded by

Copyright:

Available Formats

ODI 12c - SCM

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ODI 12c - SCM

Uploaded by

Copyright:

Available Formats

10/6/23, 11:20 AM ODI 12c: SCM

ODI 12.2.1: SCM and Version Control

Before You Begin

What Do You Need?

Before starting this tutorial, you should:

Click this Button such as OK or Next > .

1.1 SVN Setup

Retry the previous step 1 to see if Subversion works now.

Subversion is configured and started.

1.2 ODI Subversion Connectivity Setup

Choose a Version Control Application for ODI Studio.

3. On the main menu bar, go to Team > Select Versioning Application.

4. Select Subversion and click OK .

1.3 SVN Connectivity Setup

1. If needed, connect to ODI LCM Trunk again.

3. In the SVN Connection dialog, set the following options:

Authentication Type: Http Basic Authentication

4. Go to Team > Subversion > Configure.

a. Click Create Default Project Structure.

Generally speaking, the Comments or Description in SVN is mandatory. Click OK .

You should now have SVN connectivity set up.

2. Checkin / Checkout ODI artifacts in SVN

2.1 Adding ODI artifacts to SVN

3. Click OK on the success Information dialog.

You have added a version of an object to the SVN.

2.2 Adding All Non-Versioned Objects to Subversion

Click OK (this may take a while).

3. Click OK on the success Information dialog.

Add some Comments: and click OK to add them to SVN.

Click OK on the success Information dialog.

You have added a version of ALL objects to the SVN.

2.3 Viewing Version History

Click Apply . The Date Range is assumed to be today.

Inspect different columns in the table to the version attributes.

5. A dialog would be shown saying, "No difference found."

Click OK on the Information dialog. Close the Version History tab.

2.4 Saving Updates to SVN

Save the attribute. Close the tab.

4. An Information dialog is shown notifying the successful operation.

6. Make sure that the Trunk checkbox is selected. Click Apply .

Close the Version History tab.

You have saved object changes to SVN.

2.5 Comparing SVN Objects and Comparing Objects

2. Hold [Ctrl] and select the two version entries.

Click the Compare icon ( ) and select Compare Selected Versions.

Note the attribute you added at the end, in green.

Click OK in Display Options.

5. Inspect the differences by expanding the nodes.

2.6 Restoring from Subversion

This will populate the empty Version box.

3. Select the oldest version from the Version Selection dialog.

Close the Import Report.

2. Select Restore with Merge.

4. Click Perform Merge ( ) to open the Merge Results window below.

Save it. Close all of the Version tabs.

2.7 Restoring Deleted Objects

On the Create Version dialog, click OK . On the Information dialog, click OK .

3. Delete Models > ODI_DEMO > Sales Administration > TRG_SALES.

On the Confirmation dialog, click Yes to remove TRG_SALES.