1. ® IBM Software Group © 2006 IBM Corporation Rational Asset Manager v7.2 Using Scripting Tutorial for using command line and scripting using Ant Tasks Carlos Ferreira Product Manager

2. IBM Software Group | Rational software 2 Agenda  Setup  Demo Downloading and Asset  Demo Publishing and Asset  Demo Relating assets to previously published assets

3. IBM Software Group | Rational software 3 Setup Ant  Download Ant 1.7.1 or later - http://ant.apache.org/bindownload.cgihttp://ant.apache.org/bindownload.cgi  Unzip files in C:\ant\  Install Ant – Directions found here http://ant.apache.org/manual/index.html http://ant.apache.org/manual/index.html  Set environment variables  ANT_HOME=C:\ant\apache-ant-1.7.1  JAVA_HOME=c:\jdk-1.5.0.05 or where ever you have Java with tools.jar  PATH=C:\ant\apache-ant-1.7.1\bin append to you existing path  Download Contributor files  http://sourceforge.net/projects/ant-contrib/files/ant-contrib/ant-contrib-0.6/ant-contrib-0.6- bin.zip/download http://sourceforge.net/projects/ant-contrib/files/ant-contrib/ant-contrib-0.6/ant-contrib-0.6- bin.zip/download  Unzip files and copy the ant-contrib-0.6.jar into the C:\ant\apache-ant-1.7.1\lib

4. IBM Software Group | Rational software 4 Setup RAM scripting client jars  Go RAM Web Client, Help, Extensions  http:// : /ram/ramclient.zip replace hostname and port http://ibmdev.com:9080/ram/ramclient.zip  Download ramclient.zip, unzip it to a folder, like C:\ramclient  Add unzipped folder on the ANT library path when you execute one of the ANT scripts.  ANT_HOME=C:\ant\apache-ant-1.7.1;C:\ramclient

5. IBM Software Group | Rational software 5 Agenda  Setup  Demo Downloading and Asset  Demo Publishing and Asset  Demo Relating assets for published assets

6. IBM Software Group | Rational software 6 Modify Download script to download and asset  Copy the file c:\ramclient\ramDownloadAsset.xml  Add the properties in black replacing the values with your own for the asset to download  Save the file Directory to download asset to RAM WebService URL from Extensions page RAM asset unique id from Asset page RAM asset version from Asset page

7. IBM Software Group | Rational software 7 Run download script  C:\ramclient>ant -v -lib C:\ramclient -file ramDownloadAsset-2.xml  Other options below  ant -v -lib -file ramDownloadAsset.xml -Dlib.dir= -Dram.url= -Dram.user.id= -Dram.user.passwd= - Dram.asset.quid= -Dram.asset.version= -Dbuild.id= Verbose Ant command RAM scripts to download

8. IBM Software Group | Rational software 8 Ant Script Help  Under Reference  Rational Asset Manager Custom ANT Library  Under Extending  BuildForge

9. IBM Software Group | Rational software 9 Agenda  Setup  Demo Downloading and Asset  Demo Publishing and Asset  Demo Relating assets for published assets

10. IBM Software Group | Rational software 10 Modify Publish script to publish an asset  Copy the file c:\ramclient\ramPublishAsset.xml  Add the properties in red box below replacing the values with your own for the asset to download  Save the file Build metadata about asset RAM WebService URL from Extensions page RAM asset unique name RAM asset version RAM asset unique ID and version this asset is related to as part of a release

11. IBM Software Group | Rational software 11 Run publish script  C:\ramclient>ant -v -lib C:\ramclient -file ramPublishAsset-2.xml Verbose Ant command RAM scripts to publish

12. IBM Software Group | Rational software 12 Agenda  Setup  Demo Downloading and Asset  Demo Publishing and Asset  Demo Relating assets for published assets

13. IBM Software Group | Rational software 13 Modify RelateArtifacts-Link script to download and asset  Copy the file c:\ramclient\ramDownloadArtifactLinks.xml  Add the properties in black replacing the values with your own for the asset to download  Save the file. RAM WebService URL from Extensions page Eclipse workspace where rambuildercontrol.xml files are

14. IBM Software Group | Rational software 14 Run publish script again this time with relate  Modify the publish script to also include all the related files that were dependencies in the project specified in the rambuildercontrol.xml in the.settings folder of the workspace  This will generate a relationship file in the ram.download.result.file location  Add properties:  C:\ramclient>ant -v -lib C:\ramclient -file ramPublishAsset-2.xml Verbose Ant command RAM scripts to publish