{"id":3902,"date":"2014-07-05T01:56:13","date_gmt":"2014-07-05T01:56:13","guid":{"rendered":"http:\/\/www.jitendrazaa.com\/blog\/?p=3902"},"modified":"2014-11-03T01:19:22","modified_gmt":"2014-11-03T01:19:22","slug":"automated-daily-backup-using-ant-migration-tool-and-git","status":"publish","type":"post","link":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/automated-daily-backup-using-ant-migration-tool-and-git\/","title":{"rendered":"Automated Daily Backup of Salesforce Using ANT Migration Tool and GIT"},"content":{"rendered":"

In few\u00a0previous articles, I have talked about how to use “ANT Migration tool in Salesforce<\/a>” and “How to Use EGit plugin in Eclipse to work with Git<\/a>“. So to make this article short, I assume that you are already familiar with ANT Migration tool provided by Salesforce and Git.<\/p>\n

During project development life cycle it is very essential to backup your code and Configurations daily. However sometimes developers forgot to commit changes in Git, may be \u00a0because of workload. It may create an issue if someone wants to check back history of code for\u00a0that duration, there will be no use of having code repository in place if it cant help us to get out of problem.<\/p>\n

In this article, I will move one step further and explain how to setup automated script which will run on your System startup and commit\u00a0backup of your Salesforce organization into local Git repository without any manual interference.<\/p>\n

\"Salesforce<\/a>
Salesforce Automated Script for Data Backup Using CommandLine<\/figcaption><\/figure>\n

<\/p>\n

Step1 :<\/strong> Get your Salesforce project into Eclipse, If possible select every Metadata components. This step will give us “package.xml<\/span>” file.<\/p>\n

Step 2 :<\/strong> Set up your EGit in Eclipse, It is explained here in very detail<\/a>. This step will generate “.git” folder in your system which will have all information about your local and remote repository.<\/p>\n

Step 3 :<\/strong> Create “build.properties<\/span>” file, may be one folder above your Source code folder.<\/p>\n

\r\n# build.properties\r\n# Specify the login credentials for the desired Salesforce organization\r\nsf.username = YOUR_SFDC_USERNAME\r\nsf.password = YOUR_SFDC_PASSWORD+SECURITYTOKEN\r\n# Use 'https:\/\/login.salesforce.com' for production or developer edition (the default if not specified).\r\n# Use 'https:\/\/test.salesforce.com for sandbox.\r\nsf.serverurl = https:\/\/test.salesforce.com\r\n\r\n#Below String is used as a comment while pushing Backup into Git\r\ngt.commitMessage = Daily Data Backup using Automated ANT Script\r\n\r\n#Directory where Git Configuration is created by Egit. "..\/ denotes one folder above current folder"\r\ngt.Directory = ..\/git\/Shivasoft-sandbox\r\n<\/pre>\n
You can read in detail about ANT configurations here<\/a>.<\/p>\n
Step 4 :<\/strong> ANT Does not have any command for Git. So we have to write macro for ANT which will execute Git executable file from your operating System.<\/p>\n
\r\n\t<macrodef name="git">\r\n\t\t<attribute name="command" \/>\r\n\t\t<attribute name="dir" default="${gt.Directory}" \/>\r\n\t\t<element name="args" optional="true" \/>\r\n\t\t<sequential>\r\n\t\t\t<echo message="git @{command}" \/>\r\n\t\t\t<exec executable="git" dir="@{dir}">\r\n\t\t\t\t<arg value="@{command}" \/>\r\n\t\t\t\t<args\/>\r\n\t\t\t<\/exec>\r\n\t\t<\/sequential>\r\n\t<\/macrodef>\r\n<\/pre>\n
We will add above code snippet in “build.xml<\/span>” file of ANT Migration tool. Complete “build.xml<\/span>” file will look like :<\/p>\n
\r\n<project name="Shivasoft Sandbox" default="deployCode" basedir="." xmlns:sf="antlib:com.salesforce">\r\n    <property file="build.properties"\/>\r\n    <property environment="env"\/>\r\n\r\n\t<target name="SFDCFetch">\r\n\t  <!-- Retrieve the contents into another directory -->\r\n\t  <sf:retrieve username="${sf.username}"\r\n\t\t\t\t   password="${sf.password}"\r\n\t\t\t\t   serverurl="${sf.serverurl}"\r\n\t\t\t\t   retrieveTarget="RELATIVE PATH OF SRC FOLDER WHICH IS FETCHED BY ECLIPSE"\r\n\t\t\t\t   unpackaged="RELATIVE PATH OF PACKAGE.XML FILE" \/>\r\n\t<\/target>\r\n\r\n\t<macrodef name="git">\r\n\t\t<attribute name="command" \/>\r\n\t\t<attribute name="dir" default="${gt.Directory}" \/>\r\n\t\t<element name="args" optional="true" \/>\r\n\t\t<sequential>\r\n\t\t\t<echo message="git @{command}" \/>\r\n\t\t\t<exec executable="git" dir="@{dir}">\r\n\t\t\t\t<arg value="@{command}" \/>\r\n\t\t\t\t<args\/>\r\n\t\t\t<\/exec>\r\n\t\t<\/sequential>\r\n\t<\/macrodef>\r\n\r\n\t<target name="GitOperations" description="Commits all changes to version git" depends="SFDCFetch">\r\n\r\n\t\t<echo message="Commiting all changes with message ${gt.commitMessage}" \/> \r\n\r\n\t\t<git command="add">\r\n\t\t\t<args>\r\n\t\t\t\t<arg value="." \/>\r\n\t\t\t<\/args>\r\n\t\t<\/git>\r\n\r\n\t\t<git command="commit">\r\n\t\t\t<args>\r\n\t\t\t\t<arg value="-am ${gt.commitMessage}" \/>\r\n\t\t\t<\/args>\r\n\t\t<\/git>\r\n\t<\/target>\r\n<\/project>\r\n<\/pre>\n
As per above file, target “GitOperations” depends on “SFDCFetch”. So first metadata information will be fetched into folder specified in attribute “retrieveTarget” of tag “sf:retrieve”. After that target “GitOperation” will be executed.
\nAs shown in above file, “GitOperations” uses “git” macro defined which eventually invokes Git executable file and passes required argument.<\/p>\n
To run above file, we simple have to use command “ant GitOperations”.
\nHowever, If we want to run above files automatically, we need to create “Command\/Batch” file in Windows or “Shell” file in linux.<\/p>\n
Step 5 :<\/strong> Create Command file in Windowst by name “Script.cmd”. This file needs to save in same folder where “build.properties” and “build.xml” exists.<\/p>\n
\r\n@echo OFF\r\necho Data Backup for Shivasoft Sandbox\r\nant GitOperations\r\npause\r\n<\/pre>\n
\"Salesforce<\/a>
Salesforce Automated Script for Data Backup<\/figcaption><\/figure>\n
Step 6 :<\/strong> Add Shortcut of above command file into Windows startup folder. And at this step we achieved our target. Whenever you will start you System, this executable file will execute.
\nI hope you believe on Energy saving and shutdown your system everyday before leaving office \ud83d\ude42 . However if you doesn’t\u00a0shutdown or Log-Off your system, You may need to check for “Scheduling Task<\/a>” to run above command file once in 24 hours.<\/p>\n
Note :<\/strong> We have committed Data into Local Git repository only. Whenever you open Eclipse, you can use “Push to Remote” option in EGit. I tried to push automatically in remote repository however I run into issue where my Push Command in ANT hanged, I tried a lot but no luck. If anyone of you get lucky, please let me know.<\/p>\n
Update <\/strong>(2-Nov-2014):<\/span><\/em>
\nIf you want to save log of Git operations daily, then we can pipe output of all operations to text file.
\nAssume, Command for “ant git operation” is saved in some batch file named “AntCommand.cmd”.<\/p>\n
\r\n@echo OFF\r\necho Data Backup in Progress, Please wait\r\nAntCommand.cmd > logs\/"%date%".log 2>&1\r\necho Backup Complete\r\n"logs\/"%date%".log"\r\n<\/pre>\n
sample content of “AntCommand.cmd”<\/p>\n
\r\n@echo OFF\r\necho Data Backup for all sandboxes\r\nant GitOperations\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
In few\u00a0previous articles, I have talked about how to use “ANT Migration tool in Salesforce” and “How to Use EGit plugin in Eclipse to work with Git“. So to make this article short, I assume that you are already familiar with ANT Migration tool provided by Salesforce and Git. During project development life cycle it […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"advanced_seo_description":"","jetpack_seo_html_title":"","jetpack_seo_noindex":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"jz_research_post":"","_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[23,9],"tags":[261,262,86,88,108,331],"class_list":["post-3902","post","type-post","status-publish","format-standard","hentry","category-configuration","category-salesforce","tag-ant","tag-ant-migration-tool","tag-eclipse","tag-egit","tag-git","tag-salesforce"],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack-related-posts":[{"id":5478,"url":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/delete-components-using-ant-migration-tool-video\/","url_meta":{"origin":3902,"position":0},"title":"Delete Components using Ant Migration tool – Video","author":"Jitendra","date":"April 27, 2016","format":false,"excerpt":"This video tutorial shows that how we can delete components like Apex class, trigger from Salesforce using ANT migration tool.","rel":"","context":"In "Salesforce"","block_context":{"text":"Salesforce","link":"https:\/\/www.jitendrazaa.com\/blog\/category\/salesforce\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/img.youtube.com\/vi\/3kMGy6OeJAc\/0.jpg?resize=350%2C200","width":350,"height":200},"classes":[]},{"id":4276,"url":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/continuous-integration-in-salesforce-using-jenkins-and-git-video-tutorial\/","url_meta":{"origin":3902,"position":1},"title":"Continuous integration in Salesforce Using Jenkins and Git | Video Tutorial","author":"Jitendra","date":"March 23, 2015","format":false,"excerpt":"As your Salesforce Organization undergoes heavy customization and frequent builds, moving changes from one Sandbox to other sandboxes starts taking longer time and effort. Also, in normal Salesforce project, there are chances that you will have minimum three sandboxes likely Developer Sandbox, QA Sandbox and UAT Sandbox. After some time\u2026","rel":"","context":"In "Salesforce"","block_context":{"text":"Salesforce","link":"https:\/\/www.jitendrazaa.com\/blog\/category\/salesforce\/"},"img":{"alt_text":"Salesforce - Jenkins Git Polling Log","src":"https:\/\/i0.wp.com\/www.jitendrazaa.com\/blog\/wp-content\/uploads\/2015\/03\/Salesforce-Jenkins-Git-Polling-Log.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/www.jitendrazaa.com\/blog\/wp-content\/uploads\/2015\/03\/Salesforce-Jenkins-Git-Polling-Log.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/www.jitendrazaa.com\/blog\/wp-content\/uploads\/2015\/03\/Salesforce-Jenkins-Git-Polling-Log.png?resize=525%2C300&ssl=1 1.5x, https:\/\/i0.wp.com\/www.jitendrazaa.com\/blog\/wp-content\/uploads\/2015\/03\/Salesforce-Jenkins-Git-Polling-Log.png?resize=700%2C400&ssl=1 2x"},"classes":[]},{"id":3086,"url":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/salesforce-git-eclipse-egit-better-and-distributed-source-control\/","url_meta":{"origin":3902,"position":2},"title":"Salesforce + Git + Eclipse + EGIT = Better and Distributed Source Control","author":"Jitendra","date":"September 16, 2012","format":false,"excerpt":"During my J2EE and .Net days, I was much dependent on the subversion repository. I had never thought my code without SVN. When I moved to Salesforce few years back, the first thing I missed is code repository to have better source code control. As svn creates either \".svn\"\u009d or\u2026","rel":"","context":"In "Salesforce"","block_context":{"text":"Salesforce","link":"https:\/\/www.jitendrazaa.com\/blog\/category\/salesforce\/"},"img":{"alt_text":"Architecture of GIT","src":"https:\/\/i0.wp.com\/jitendrazaa.com\/blog\/wp-content\/uploads\/2012\/09\/Architecture-of-GIT.png?resize=350%2C200&ssl=1","width":350,"height":200},"classes":[]},{"id":3115,"url":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/authenticate-git-using-ssh-protocol-with-eclipse-and-egit-salesforce\/","url_meta":{"origin":3902,"position":3},"title":"Authenticate Git using SSH protocol with Eclipse and Egit – Salesforce","author":"Jitendra","date":"September 25, 2012","format":false,"excerpt":"In Previous article, i have explained step by step approach to configure Git for Salesforce using Eclipse and Egit plugin. However, i have explained the \"https\" method to connect Git directly. There are several repositories which does not support the \"https\" protocol and prefer \"SSH\" (Secure Shell) protocol. So, in\u2026","rel":"","context":"In "Salesforce"","block_context":{"text":"Salesforce","link":"https:\/\/www.jitendrazaa.com\/blog\/category\/salesforce\/"},"img":{"alt_text":"Configure Push for SSH Authentication in Git","src":"https:\/\/i0.wp.com\/jitendrazaa.com\/blog\/wp-content\/uploads\/2012\/09\/Generate-SSH-RSA-Key-using-Eclipse.png?resize=350%2C200&ssl=1","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/jitendrazaa.com\/blog\/wp-content\/uploads\/2012\/09\/Generate-SSH-RSA-Key-using-Eclipse.png?resize=350%2C200&ssl=1 1x, https:\/\/i0.wp.com\/jitendrazaa.com\/blog\/wp-content\/uploads\/2012\/09\/Generate-SSH-RSA-Key-using-Eclipse.png?resize=525%2C300&ssl=1 1.5x"},"classes":[]},{"id":3448,"url":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/using-git-with-force-com-ide-video-tutorial\/","url_meta":{"origin":3902,"position":4},"title":"Using GIT with Force.com IDE – Video Tutorial","author":"Jitendra","date":"September 23, 2013","format":false,"excerpt":"In this article, we discussed how to use GIT with Eclipse. I have created Video Tutorial for same which includes How to Upgrade Eclipse from Helios to Indigo Install EGIT Plugin Introduction to Bit Bucket","rel":"","context":"In "Force.com"","block_context":{"text":"Force.com","link":"https:\/\/www.jitendrazaa.com\/blog\/category\/salesforce\/force-com\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":3937,"url":"https:\/\/www.jitendrazaa.com\/blog\/salesforce\/heroku\/create-node-js-application-using-eclipse-and-deploy-to-heroku-video-tutorial\/","url_meta":{"origin":3902,"position":5},"title":"Create Node.js Application using Eclipse and deploy to Heroku – Video Tutorial","author":"Jitendra","date":"July 27, 2014","format":false,"excerpt":"In Below video, I have explained how to create basic Node.js application in Eclipse with help of Egit and Heroku plugin and deploy to Heroku. Please read below two articles, to get familiar of Plugins and how to setup : Salesforce + Git + Eclipse + EGIT = Better and\u2026","rel":"","context":"In "Heroku"","block_context":{"text":"Heroku","link":"https:\/\/www.jitendrazaa.com\/blog\/category\/salesforce\/heroku\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]}],"jetpack_likes_enabled":true,"_links":{"self":[{"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/posts\/3902","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/comments?post=3902"}],"version-history":[{"count":7,"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/posts\/3902\/revisions"}],"predecessor-version":[{"id":4036,"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/posts\/3902\/revisions\/4036"}],"wp:attachment":[{"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/media?parent=3902"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/categories?post=3902"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.jitendrazaa.com\/blog\/wp-json\/wp\/v2\/tags?post=3902"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}