Skip to main content

How to install NDMerge

Shows how to install NDMerge.

Installation procedure

  1. Download the complete NDMerge file from the support site below.

    https://www.nextdesign.app/support/auth/downloads/#ndmerge

Attention

After downloading the zip file, remove the security protection as follows and then extract the file.
(1) Right-click the zip file to display [Properties].
(2) Read the [Security] description displayed at the bottom of the [General] tab, check the [Allow] check box on the right, and click the [OK] button.

  1. Unzip and store the file in any location.

  2. Start a command prompt and move to the above storage folder.

  3. Execute the following command.

    ndmerge git-setup install

    • See here for commands.
  4. Follow the steps in "Setting the .gitattributes file" below to set up the file.

    • These steps are set to work with NDMerge when you run a Git merge command.

    To run this program, you need to install .NET Core 3.1.

Confirmation after installation

  • If you execute the setup command of NDMerge, it will be set to gitconfig of the global environment (per OS login user).
    • You can check the set contents by executing the following command.

      ndmerge git-setup list

    • If the item merge.NDMerge.driver is added to the settings, it is set correctly.
    • Execution example
      > ndmerge git-setup list
      exec: git config merge.NDMerge.name
      nd diff merge application
      exec: git config merge.NDMerge.driver
      '[Absolute path for each user environment]/ndmerge.exe' merge -o% A -t% B -b% O -m% A -p% P -l warn
Attention
  • NDMerge will not work if the path set in gitconfig is different from the location of the storage folder.
    If you move the storage folder, execute the setup command again to update the gitconfig settings.

.gitattributes file settings

By setting the .gitattributes file of the Git global environment, NDMerge will be linked when merging the model file of Next Design etc. in Git.

.gitattributes settings

  1. Create and place a .gitattributes file anywhere in your local PC environment.

  2. Execute the following command to set the placed .gitattributes file to the global environment.

    git config --global core.attributesfile [absolute path to .gitattributes file]

  3. Add the following content to the .gitattributes file.

    #NDMerge
    * .nproj merge = NDMerge
    * .nmdl merge = NDMerge
    * .nprof merge = NDMerge
    * .iproj merge = NDMerge
    * .imdl merge = NDMerge
    * .iprof merge = NDMerge

If .gitattributes is already set

  • If you have already created and set the .gitattirbutes file, check it with the following command.

    git config --global core.attributesfile

Update procedure

If you already have NDMerge installed, follow these steps to update to a newer version of NDMerge.

  1. Download the new version of the NDMerge file set from the support site below.

    https://www.nextdesign.app/support/auth/downloads/#ndmerge

Attention

After downloading the zip file, remove the security protection as follows and then extract the file.
(1) Right-click the zip file to display [Properties].
(2) Read the [Security] description displayed at the bottom of the [General] tab, check the [Allow] check box on the right, and click the [OK] button.

  1. Extract the new version of the NDMerge zip file.

  2. Overwrite the files in the installed NDMerge installation folder with the files extracted above.

Confirmation after update

  • To check if the update was successful, go to the NDMerge installation folder at the command prompt and execute the following command.

    ndmerge --version

Uninstall procedure

  1. Start a command prompt and change to the installation folder of NDMerge.
  2. Execute the following command.

    ndmerge git-setup uninstall uninstall

  3. Delete the contents described in the .gitattributes file in .gitattributes setting.
  4. If the settings other than NDMerge are not described in the .gitattributes file, execute the following command.

    git config --global --unset core.attributesfile

  5. Delete all the files in the installation folder.