{"id":56565,"date":"2023-02-03T12:05:01","date_gmt":"2023-02-03T06:35:01","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=56565"},"modified":"2024-06-10T15:39:32","modified_gmt":"2024-06-10T10:09:32","slug":"step-by-step-tutorial-on-setting-up-aem-repo-tool-for-syncing-aem-with-intellij-on-windows","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/step-by-step-tutorial-on-setting-up-aem-repo-tool-for-syncing-aem-with-intellij-on-windows\/","title":{"rendered":"Step by Step Tutorial on Setting up AEM Repo tool for Syncing AEM with IntelliJ on Windows"},"content":{"rendered":"

When working with AEM, we often have to make changes to our jcr content while developing components and to get those changes up to the AEM server, we have to deploy code again and again. These multiple deployments can slow down our development cycle and eat up developers\u2019 time. So to tackle this problem, we can use the \u201cAEM Repo tool\u201d.<\/span><\/p>\n

AEM repo tool is a simple solution to transfer jcr content from our local file system to the AEM server without deploying the whole code. This tool simplifies the transfer of files for the developers and makes the development cycle faster and more efficient. It can be integrated with IntelliJ or Eclipse.<\/span><\/p>\n

Setting up the Repo tool on other OS is relatively straightforward, but for Windows, it can get a little tricky. So today, we will see step by step setup of the AEM repo tool on windows and will integrate it with IntelliJ.<\/span><\/p>\n

Prerequisite<\/b><\/p>\n

Install Cygwin for windows from the following link:<\/span> https:\/\/www.cygwin.com\/install.html<\/span><\/a><\/p>\n

    \n
  1. Run the setup-x86_64.exe file downloaded from the above link and click \u201cNext\u201d to continue.<\/span><\/span>\"\"<\/li>\n
  2. A prompt to select the download source should appear. Here select \u201cInstall from Internet\u201d and click \u201cNext\u201d to proceed.<\/span><\/span>\"\"\n

     <\/li>\n

  3. Now it will ask to select the root installation directory and whether it should be installed for \u201cAll User\u201d or \u201cJust You.\u201d Unless changing to the root directory is unnecessary, keep settings as default and click on \u201cNext\u201d to continue.\"\"<\/li>\n
  4. To download the package files, the setup will ask you to specify a \u201cLocal Package Directory,\u201d which by default points to system\u2019s \u201cDownload\u201d folder. In case you want to specify another location, specify its path here and click \u201cNext\u201d to proceed with the setup.\"\"<\/li>\n
  5. In this step, the setup will ask to choose the internet connection. You can either select \u201cUse System Proxy Settings\u201d or \u201cDirect connection\u201d to proceed ( in my case, I’ve used \u201cDirect connection\u201d ). Click \u201cNext\u201d to proceed.\"\"<\/li>\n
  6. In this step, the setup will ask you to choose a download site. You should ideally choose a site based on which domain is closest to your geographical location, as there are multiple top-level domains listed, such as .com, .au, .nz, .ca, etc.\u2026.. In my case in India, I chose \u201chttps:\/\/cygwin.mirror.constant.com<\/a>\u201d. If you are confused about which one to select, you can click on anyone in the list and click \u201cNext\u201d to continue.\"\"<\/li>\n
  7. Cygwin provides a lot of UNIX\/Linux-based utilities that run on Windows. Not all packages get installed by default. Only a minimal set of important packages gets installed. In this step, you can customize the Cygwin setup by selecting\/un-selecting different categories of packages. Now for our AEM Repo tool to work properly on windows, we need the following mandatory packages to be installed : zip, unzip, curl, rsync.Note: Make sure you install zip, unzip, curl, rsync packages with the cygwin installation. <\/b>After selecting all the required packages, click on \u201cNext\u201d to continue.\n

    \"\"<\/p>\n

    \"\"<\/p>\n

    \"\"<\/p>\n

    \"\"<\/li>\n

  8. Now verify all the packages that you have selected and click on \u201cNext\u201d to continue.\"\"<\/li>\n
  9. Now the download will start for the selected packages, and the installation will be finished. Click on \u201cFinish\u201d to complete the Cygwin installation with the required packages.<\/span><\/span>\"\"\n

    \"\"<\/p>\n

     <\/li>\n<\/ol>\n

    Downloading and installing Repo tool<\/b><\/p>\n

    Create a folder called adoberepo under the c:\\cloudmanager.<\/span> Download the repo tool from here <\/span>https:\/\/github.com\/Adobe-Marketing-Cloud\/tools\/releases\/tag\/repo-1.4<\/span><\/a> and install it <\/span>by copying the repo file and placing it under the c:\\cloudmanger\\adoberepo folder.<\/span><\/p>\n

    We can download the \u201cSource Code (zip)\u201d from the above link. Extract the zip and copy the \u201crepo\u201d file to the above folder.<\/span><\/p>\n

    \"\"<\/p>\n

    \"\"<\/p>\n

    Configuring the Repo tool in IntelliJ<\/b><\/p>\n

      \n
    1. Launch IntelliJ<\/span><\/li>\n
    2. Hit the Ctrl+Alt+S keys to launch the settings window.<\/span><\/li>\n
    3. Select Tools->External Tools, click the + sign and enter the following as shown in the screenshot.<\/span><\/li>\n
    4. Make sure you create a group called repo by typing in \u201crepo\u201d in the Group drop down field (when creating the first command) and all the commands that you create belong to the <\/span>repo<\/b> group ( after creating group in the first command, select \u201crepo\u201d from dropdown for all other commands )<\/span><\/span>.\"\"<\/li>\n<\/ol>\n

      Creating commands :\u00a0<\/b><\/p>\n