Altova DiffDog Server 2018 · (C) 2018 Altova GmbH Altova DiffDog Server 2018 Note: To change the...

(C) 2018 Altova GmbH

Altova DiffDog Server2018

Note:

To change the product logo for your ow n print manual or

PDF, click "Tools > Manual Designer" and modify the print

manual template.

Title page 1Use this page to introduce the product

by

This is "Title Page 1" - you may use this page to introduceyour product, show title, author, copyright, company logos,etc.

This page intentionally starts on an odd page, so that it is onthe right half of an open book from the readers point of view.This is the reason why the previous page was blank (theprevious page is the back side of the cover)

All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, ormechanical, including photocopying, recording, taping, or information storage and retrieval systems - without thewritten permission of the publisher.

Products that are referred to in this document may be either trademarks and/or registered trademarks of therespective owners. The publisher and the author make no claim to these trademarks.

While every precaution has been taken in the preparation of this document, the publisher and the author assume noresponsibility for errors or omissions, or for damages resulting from the use of information contained in thisdocument or from the use of programs and source code that may accompany it. In no event shall the publisher andthe author be liable for any loss of profit or any other commercial damage caused or alleged to have been causeddirectly or indirectly by this document.

Printed: May 2018 in (whereever you are located)

Altova DiffDog Server 2018


PublisherSpecial thanks to:

All the people who contributed to this document, to mum and dadand grandpa, to my sisters and brothers and mothers in law, to oursecretary Kathrin, to the graphic artist who created this great productlogo on the cover page (sorry, don't remember your name at themoment but you did a great work), to the pizza service down thestreet (your daily Capricciosas saved our lives), to the copy shopwhere this document will be duplicated, and and and...

Last not least, we want to thank EC Software who wrote this greathelp tool called HELP & MANUAL which printed this document.

Managing Editor

Technical Editors

Cover Designer

...enter name...

...enter name...

...enter name...

...enter name...

...enter name...

Production

...enter name...

Team Coordinator

...enter name...

5Contents

5


Table of Contents

Foreword 7

Part I Altova DiffDog Server 2018 8

................................................................................................................................... 91

Part II 12

................................................................................................................................... 121 Linux

.......................................................................................................................................................... 12DiffDog Server

.......................................................................................................................................................... 13

.......................................................................................................................................................... 13DiffDog Server

................................................................................................................................... 142 OS X / macOS

.......................................................................................................................................................... 14DiffDog Server

.......................................................................................................................................................... 15DiffDog Server

................................................................................................................................... 153 Windows

.......................................................................................................................................................... 15DiffDog Server

.......................................................................................................................................................... 17Windows

Part III 19

................................................................................................................................... 191

................................................................................................................................... 202

................................................................................................................................... 223

................................................................................................................................... 284 (Linux)

................................................................................................................................... 295 (OS X / macOS)

................................................................................................................................... 296 (Windows)

Part IV DiffDog Server Command Line 30

................................................................................................................................... 311 assignlicense (Windows only)

................................................................................................................................... 322 createconfig

................................................................................................................................... 333 debug

................................................................................................................................... 344 exportresourcestrings

................................................................................................................................... 365 help

................................................................................................................................... 376 install

................................................................................................................................... 387 licenseserver

................................................................................................................................... 398 setdeflang

................................................................................................................................... 409 start

................................................................................................................................... 4110 uninstall

................................................................................................................................... 4211 verifylicense (Windows only)

Part V DiffDog 44

................................................................................................................................... 441 diff

Altova DiffDog Server 2018 6


................................................................................................................................... 542 import

................................................................................................................................... 553 showcfg

Index 57

Foreword

This is just another title pageplaced between table of contents

and topics

7Foreword




1 Altova DiffDog Server 2018

DiffDog Server Windows Linux Mac OS X XML (ZIP ) URL

DiffDog Server : DiffDog Server DiffDog Server : DiffDog Server DiffDog Server DiffDog DiffDog Server : DiffDog Linux Mac OS X Windows DiffDog Server URL : URL http://www.example.org/page1.html http://www.example.org/page2.html URL http://www.example.org/page1.html C:\page2.html 3 : 2 ( ) 3 XML: : XML : DiffDog : (.filedif .dirdif ) DiffDog (https://www.altova.com/ja/diffdog) DiffDog Windows DiffDog XML

( HTTP)

Windows Windows 7 SP1 Windows8 Windows 10

Windows Server Windows Server 2008 R2SP1

https://www.altova.com/ja/diffdog




Linux CentOS 6 RedHat 6 Debian 7 Ubuntu 12.04

(Mac) OS X, macOS OS X10.10 10.11 macOS 10.12

Windows DiffDog Server 32 64

: 2018 05 28

1.1

DiffDog Server

Windows C:\Program Files\Altova\DiffDogServer2018\

Linux /opt/Altova/DiffDogServer2018/

OS X / macOS /usr/local/Altova/DiffDogServer2018/

2 :

1. bin DiffDog Server DiffDog Server

2. DiffDog cmdlclient ( ) diff diff : URL

DiffDog DiffDogCmdlClient

DiffDog Server :

Windows "C:\Program Files\Altova\DiffDogServer2018\bin\DiffDogServer" --version

Linux /opt/Altova/DiffDogServer2018/bin/diffdogserver --version

OS X / macOS /usr/local/Altova/DiffDogServer2018/bin/diffdogserver --version

2 diff ( ) DiffDogCmdlClient :

Windows DiffDogCmdlClient.exe diff file1.txt file2.txt

Linux diffdogcmdlclient diff file1.txt file2.txt



OS X / macOS ./diffdogcmdlclient diff file1.txt file2.txt

"C:\Program Files\Altova\DiffDogServer2018\cmdlclient\DiffDogCmdlClient.exe" difffile1.txt file2.txt

( Windows ):

DiffDogCmdlClient.exe diff file1.txt file2.txt

:

file1.txt file2.txt ( ) DiffDog Server DiffDog

:

( ) PATH cd Linux Linux OS X /macOS ./

DiffDog DiffDog Server HTTP DiffDog Server diff DiffDog Server ( Windows Linux ) : .

diff :

XML ( XML ) XML XML ( )



XML

: diff



2

2.1 Linux

2.1.1 DiffDog Server

Linux

CentOS 6 RedHat 6 Debian 7 Ubuntu 12.04

Linux yum ( apt-get )

CentOS, RedHat Debian Ubuntu

LicenseServer krb5-libs libgssapi-krb5-2 libgssapi-krb5-2

sudo DiffDog Server

DiffDog Server 1. https://www.altova.com/download#server

2. :

cd /home/User/Downloads

3. DiffDog Server

[Debian, Ubuntu] sudo dpkg --install diffdogserver-2018-debian.deb[CentOS, RedHat] sudo rpm -ivh diffdogserver-2018-1.x86_64.rpm

:

4. DiffDog Server

[CentOS 6]: sudo initctl start diffdogserver [CentOS 7]: sudo systemctl start diffdogserver

https://www.altova.com/download#server

13


[Debian 7]: sudo /etc/init.d/diffdogserver start [Debian 8]: sudo systemctl start diffdogserver[RedHat 6]: sudo initctl start diffdogserver[RedHat 7]: sudo systemctl start diffdogserver[Ubuntu 14]: sudo initctl start diffdogserver[Ubuntu 15]: sudo systemctl start diffdogserver

DiffDog Server 1. Altova LicenseServer

(https://www.altova.com/ja/licenseserver) 2. DiffDog Server Altova LicenseServer

LicenseServer 127.0.0.1 :

sudo diffdogserver licenseserver 127.0.0.1

: CentOS OS X "./"

3. LicenseServer DiffDog Server

Altova LicenseServer (https://www.altova.com/ja/documentation).

2.1.2

Altova :

:

[Debian, Ubuntu] dpkg --list | grep server[CentOS, RedHat] rpm -qa | grep server


DiffDog Server : :

[Debian, Ubuntu] sudo dpkg --remove diffdogserver[CentOS, RedHat] sudo rpm -e diffdogserver

:

[Debian, Ubuntu] sudo dpkg --remove licenseserver[CentOS, RedHat] sudo rpm -e licenseserver

https://www.altova.com/ja/licenseserver

https://www.altova.com/ja/documentation




2.2 OS X / macOS


(Mac) OS X macOS

OS X 10.10

( )

DiffDog Server 1. Altova Web ( http://www.altova.com/ja/download.html )

(.dmg)

2. (.pkg) FlowForce Server /usr/local/Altova/FlowForceServer2018/

3. Altova License Server (.pkg)

4. DiffDog Server

sudo launchctl load /Library/LaunchDaemons/com.altova.DiffDogServer.plist


(https://www.altova.com/ja/licenseserver) 2. DiffDog Server Altova LicenseServer

LicenseServer 127.0.0.1 :

sudo diffdogserver licenseserver 127.0.0.1

3. LicenseServer LicenseServer DiffDog Server


http://www.altova.com/ja/download.html




15



DiffDog Server :

1. DiffDog Server

sudo launchctl unload /Library/LaunchDaemons/com.altova.DiffDogServer.plist

( )

2. DiffDog Server DiffDog Server ( )

3. DiffDog Server :

sudo rm -rf /usr/local/Altova/DiffDogServer2018/

: /var/Altova/DiffDogServer2018

2.3 Windows


Windows 7 SP1 Windows 8 Windows 10 Windows Server 2008 R2 SP1

DiffDog Server 1. Altova (https://www.altova.com/ja/download)

2.

3. :

a. Altova LicenseServer Altova LicenseServer

b. Altova LicenseServer AltovaLicenseServer AltovaLicenseServer Altova LicenseServer DiffDog Server

https://www.altova.com/ja/download



c. Altova LicenseServer LicenseServer

d. Altova LicenseServer :i. Altova LicenseServer

ii. DiffDog Server Altova LicenseServer

4. 5. HTTP DiffDog Server

:

6. DiffDog Server Windows : Windows

7.

Altova ServiceController ( )


(https://www.altova.com/ja/licenseserver)


17


2. DiffDog Server Altova LicenseServer LicenseServer 127.0.0.1 :

DiffDogServer.exe licenseserver 127.0.0.1

3. LicenseServer LicenseServer DiffDog Server


2.3.2 Windows

Windows DiffDog Server :

DiffDog Server Windows : DiffDog Server Windows : Local System Local Service Network Service DiffDog Server Windows Services

Windows Services





Windows Services Windows Services Services.msc

19


3

DiffDog Server .ini :

Linux /var/opt/Altova/DiffDogServer

Mac /var/Altova/DiffDogServer

Windows 7 8 10 C:\ProgramData\Altova\DiffDogServer

:

DiffDog Server DiffDog Server .ini

:

DiffDog Server

DiffDog Server :

(Linux) (OS X / macOS) (Windows)

3.1

DiffDog Server DiffDog :

1. DiffDog Server ( : Windows Linux macOS )

2. DiffDog Server HTTP DiffDog Server HTTP DiffDogServer http.socket-host 0.0.0.0

Windows \ \Windows



3. DiffDog Server 4. cmdlclient

.ini 1 DiffDog Server cmdlclient DiffDog Server

:

a) Altova (https://www.altova.com/ja/download) cmdlclient b) cmdlclient

5. DiffDog Server HTTP 192.0.2.0 29800 DiffDog Server server.host server.port

DiffDog Server path\to\my\file1.txt path\to\my\file2.txt diff

diffdogcmdlclient diff --client-left=path\to\client\file.txt --server-right=path\to\server\file.txt --mode=text

DiffDog DiffDogServer DiffDog Server HTTP

3.2

DiffDog Server server_config.ini :

Linux /var/opt/Altova/DiffDogServer

Mac /var/Altova/DiffDogServer

Windows 7 8 10 C:\ProgramData\Altova\DiffDogServer

DiffDog createconfig

https://www.altova.com/ja/download

21


[DiffDogServer]

http.access-file= C:\ProgramData\Altova\DiffDogServer2018\Log\access.loghttp.enable=Truehttp.environment= productionhttp.error-file= C:\ProgramData\Altova\DiffDogServer2018\Log\error.loghttp.log-screen= Truehttp.socket-host=0.0.0.0http.socket-port=29800language= enserver.unrestricted-filesystem-access= Trueserver.log-file= C:\ProgramData\Altova\DiffDogServer2018\Log\server.logserver.output-root-dir= C:\ProgramData\Altova\DiffDogServer2018\output\

server_config.ini

http.access-file HTTP

http.enable DiffDog Server HTTP :

True

False

:

http.environment ( ) :

production

development

http.error-file HTTP

http.log-screen debug DiffDog Server true

http.socket-host HTTP DiffDog Server (HTTP

) localhost

IP 1



DiffDog Server 0.0.0.0 127.0.0.1

http.socket-port DiffDog Server HTTP

language :en de es fr ja( ).

server.log-file

server.output-root-dir

server.unrestricted-filesystem-access

True ( ) ( ) True DiffDog Server HTTP False

False ( : .output-root-dir )

3.3

DiffDog DiffDog Server :

DiffDog DiffDog Server server.address server.port DiffDogServer ( ) ( ) XML XML XML

cmdlclient client_config.ini.sample client_config.ini.sample .sample

23


--c --c DiffDog

showcfg

[general]

language ( ) en de es fr ja ( ).

server.address DiffDog Server HTTP

server.port DiffDog Server HTTP

zip-as-dir diff --zip-as-dir

whitespace-mode diff --whitespace-mode

[file-types]--mode ( XML) diff ( --mode=auto) XML

text

xml XML

binary



[xml]

ignore-namespace diff --xml-ignore-namespace

ignore-prefixes diff --xml-ignore-prefixes

resolve-entities diff --xml-resolve-entities

ignore-text diff --xml-ignore-text

ignore-case-in-names

diff --xml-ignore-case-in-names

ignore-case-in-text

diff --xml-ignore-case-in-text

ignore-markup-attributes

diff --xml-ignore-markup-attributes

ignore-markup-cdata

diff --xml-ignore-markup-cdata

ignore-markup-comments

diff --xml-ignore-markup-comments

ignore-markup-processing-instructions

diff --xml-ignore-markup-processing-instructions

ignore-markup-doctype-decls

diff --xml-ignore-markup-doctype

ignore-markup-xml-decls

diff --xml-ignore-markup-xml

order-by-elements

diff --xml-order-by-elements

order-by- diff --xml-order-by-attributes

25


attributes

order-by-text diff --xml-order-by-text

order-by-list diff --xml-order-by-attribute-list [xml.orderby<name-of-my-list>] ( )

[xml.orderby:<identifier>] XML XML XML : --xml-order-by-attribute-list [xml.orderby:list1] [xml.orderby:list2]

attributes XML :

attributes = myattribute

XML :

attributes = attr1, attr2, attr3

[xml.filter:<identifier>] [xml.filter:filter1] [xml.filter:filter2]

ignore-elements XML

ignore-attributes

XML

ignore-both XML

--xml-filter



[text]

ignore-case diff --ignore-case

ignore-blank-lines

diff --ignore-blank-lines

[dir]

ignore-case diff --dir-ignore-case

compare-file-content

diff --dir-compare-contents

compare-sizes diff --dir-compare-sizes

compare-modification-times

diff --dir-compare-mod-times

ignore-modtime-interval

diff --dir-compare-mod-times-ignore-seconds

[dir.filter:<identifier>] --directory-filter

[dir.filter:filter1] [dir.filter:filter2] 1 :

ignore-files ( )

27


ignore-dirs ( )

include-dirs

include-files

include-archive-files

Windows true false

include_hidden_dirs Windows true false

include_hidden_files

Windows true false

include-readonly-files

Windows true false

include_system_dirs

Windows true false

include_system_files

Windows true false

( ) :

xml : *.biz *.cml *.dcd *.dtd *.ent *.fo *.math *.mml *.mtx *.rdf *.smil *.svg *.tld *.tsd *.vml *.vxml *.wml *.wsdl *.xbrl *.xdr *.xhtml *.xml *.xsd

*.xsl *.xslt

Windows

text : *.asp *.c *.cc *.cpp *.cs *.css *.cxx *.h *.hpp *.htm *.html *.java *.jsp *.rc *.tlh

*.tli *.txt.

Windows

nobinary : a.out *.a *.avi *.bmp *.chm *.com *.dll *.doc *.docm *.docx *.dot *.dotm *.dotx *.exe *.gif *.gz



*.hlp *.ico *.ilk *.jar *.jpeg *.jpg *.lib *.mdb *.mid *.mp2 *.mp3 *.mp4 *.mpeg *.msi *.o *.obj *.ogg *.pdb *.pdf *.png *.pps *.ppt *.pptx *.rar *.snd *.so *.tar *.tif *.tiff *.tlb *.ttf *.wav *.wma *.wmf *.wmv *.xls *.xlsx *.zip

cvs : .#* .cvsignore .cvsrc .cvswrappers .cvspass .rhosts. CVS

Windows

svn .svn

Windows

git .git .gitignore

Windows

3.4 (Linux)

:

[CentOS 6]: sudo initctl start diffdogserver [CentOS 7]: sudo systemctl start diffdogserver[Debian 7]: sudo /etc/init.d/diffdogserver start [Debian 8]: sudo systemctl start diffdogserver[RedHat 6]: sudo initctl start diffdogserver[RedHat 7]: sudo systemctl start diffdogserver[Ubuntu 14]: sudo initctl start diffdogserver[Ubuntu 15]: sudo systemctl start diffdogserver

:

[CentOS 6]: sudo initctl stop diffdogserver[CentOS 7]: sudo systemctl stop diffdogserver[Debian 7]: sudo /etc/init.d/diffdogserver stop [Debian 8]: sudo systemctl stop diffdogserver[RedHat 6]: sudo initctl stop diffdogserver[RedHat 7]: sudo systemctl stop diffdogserver[Ubuntu 14]: sudo initctl stop diffdogserver[Ubuntu 15]: sudo systemctl stop diffdogserver

29


3.5 (OS X / macOS)

:

sudo launchctl load /Library/LaunchDaemons/com.altova.DiffDogServer.plist

:

sudo launchctl unload /Library/LaunchDaemons/com.altova.DiffDogServer.plist

3.6 (Windows)

DiffDog Server Windows

:

( ) Altova DiffDog Server >

:

( ) Altova DiffDog Server >

Microsoft Management Console DiffDog Server ( > > )



4 DiffDog Server Command Line

This section:

Default location of DiffDog Server executable Usage and list of CLI commands

Default location of DiffDog Server executableGiven below are the default locations of the DiffDog Server executable:

Windows <ProgramFilesFolder>\Altova\DiffDogServer2018\bin\DiffDogServer.exe

Linux /opt/Altova/DiffDogServer2018/bin/diffdogserver

Mac /usr/local/Altova/DiffDogServer2018/bin/diffdogserver

Usage and list of CLI commandsGeneral command line syntax for DiffDogServer is:

Windows DiffDogServer --h | --help | --version | <command> [options] [arguments]

Linux diffdogserver --h | --help | --version | <command> [options] [arguments]

Mac diffdogserver --h | --help | --version | <command> [options] [arguments]

Windows DiffDogServer

Unix (Linux Mac) diffdogserver

* (diffdogserver) (Windows Linux Mac) (DiffDogServer) Windows Mac * Linux Mac Windows

where

--h | --help Displays the help text.

--version Displays the version of DiffDog Server.

Valid CLI commands are listed below and are explained in the sub-sections of this section.

DiffDog Server Command Line 31


assignlicense Upload a license to LicenseServer and assign it to DiffDogServer on this machine.

createconfig Resets the server configuration file to default settings.

debug Starts DiffDog Server for debugging (not as a service).

exportresourcestrings Exports all application resource strings to an XML file.

help Displays help for a specific command.For example: help run

install Installs DiffDog Server as a service.

licenseserver Register DiffDog Server with LicenseServer on the localnetwork.

setdeflang | sdl Sets the default language.

start Starts DiffDog Server as a service.

uninstall Uninstalls DiffDog Server as a service.

verifylicense Check if the current DiffDog Server is licensed; optionally,check if a given license key is assigned.

4.1 assignlicense (Windows only)

This section:

Command syntax Command description Examples Command options

Command syntax

Windows DiffDogServer assignlicense [options] FILE

Note: This command is supported only on Windows systems. It is not supported on Linux or Macsystems.

Command descriptionOn execution, the assignlicense command uploads the license file specified by the FILE argument to

the registered LicenseServer, and assigns the license to DiffDog Server on this machine. The FILE

argument takes the filepath of the license file.

The --test-only option allows you to upload to LicenseServer and validate the license, without



assigning the license to DiffDog Server. For details about licensing, see the LicenseServerdocumentation.

ExamplesExamples of the assignlicense command:

diffdogserver assignlicense C:\DiffDog Server12345.altova_licenses

diffdogserver assignlicense --test-only=true C:\DiffDog Server12345.altova_licenses

The first command above uploads the specified license to LicenseServer and assigns it to DiffDog Server.The second command uploads the specified license to LicenseServer and validates it, without assigningit to DiffDog Server.




Command optionsOptions are listed in their short forms (in the first column) and long forms (second column), together withtheir descriptions (third column). On the command line, one or two dashes can be used for both shortand long forms.

--t --test-only Values are true|false. If true, then the license file is onlyuploaded to LicenseServer and validated. It is not assigned toDiffDog Server. Form: --test-only=true|false. Set to true if theoption is specified without a value.

4.2 createconfig

This command creates a server configuration file with default settings for all options. Note that runningthis command will not overwrite any existing configuration file. If you need to do that, delete the existingconfiguration file and then run this command.

For more information about the configuration file, see Server Configuration File Reference.

Syntax

Windows DiffDogServer createconfig [options]



Linux diffdogserver createconfig [options]

Mac diffdogserver createconfig [options]

Options

Option Description

--lang Sets the value of the language parameter in theconfiguration file. Valid languages are en, es, de, fr, ja.

ExamplesTo create a default configuration file and set the command line interface language to German, use:

DiffDogServer createconfig --lang=de

4.3 debug

This section:

Command syntax Command description Examples

Command syntax

Windows DiffDogServer debug

Linux diffdogserver debug

Mac diffdogserver debug

Command descriptionThe debug command starts DiffDog Server for debugging—not as a service. To stop DiffDog Server in this

mode, press Ctrl+C. The command takes no options.

ExamplesExamples of the debug command:

diffdogserver debug






4.4 exportresourcestrings

This section:

Command syntax Arguments Command description Examples Creating localized versions of DiffDog Server

Command syntax

Windows DiffDogServer exportresourcestrings LanguageCode XMLOutputFile

Linux diffdogserver exportresourcestrings LanguageCode XMLOutputFile

Mac diffdogserver exportresourcestrings LanguageCode XMLOutputFile

ArgumentsThe exportresourcestrings command takes the following arguments:

LanguageCode Specifies the language of resource strings in the exported XML file.Supported languages are: en, de, es, fr, ja

XMLOutputFile Specifies the location and name of the exported XML file.

Command descriptionThe exportresourcestrings command outputs an XML file containing the resource strings of the

DiffDog Server application. It takes two arguments: (i) the language of the resource strings in the outputXML file, and (ii) the path and name of the output XML file. Allowed export languages (with their languagecodes in parentheses) are: English (en), German, (de), Spanish (es), French (fr), and Japanese (ja).



ExamplesAn example of the exportresourcestrings command:

diffdogserver exportresourcestrings de c:\Strings.xml

This command creates a file called Strings.xml at c:\ that contains all the resource strings of theDiffDog Server application in German.




Creating localized versions of DiffDog ServerYou can create a localized version of DiffDog Server for any language of your choice. Five localizedversions (English, German, Spanish, French, and Japanese) are already available in the C:\ProgramFiles (x86)\Altova\DiffDogServer2018\bin folder, and therefore do not need to be created.

Create a localized version as follows:

1. Generate an XML file containing the resource strings by using the exportresourcestringscommand (see command syntax above). The resource strings in this XML file will be one of thefive supported languages: English (en), German (de), Spanish (es), French (fr), or Japanese(ja), according to the LanguageCode argument used with the command.

2. Translate the resource strings from one of the four supported languages into the target language.The resource strings are the contents of the <string> elements in the XML file. Do not translatevariables in curly brackets, such as {option} or {product}.

3. Contact Altova Support to generate a localized DiffDog Server DLL file from your translated XMLfile.

4. After you receive your localized DLL file from Altova Support, save the DLL in the C:\ProgramFiles (x86)\Altova\<%APPFOLDER\bin folder. Your DLL file will have a name of the formDiffDogServer2018_lc.dll. The _lc part of the name contains the language code. Forexample, in DiffDogServer2018_de.dll, the de part is the language code for German(Deutsch).

5. Run the setdeflang command to set your localized DLL file as the DiffDog Server application touse. For the argument of the setdeflang command, use the language code that is part of theDLL name.

Note: Altova DiffDog Server is delivered with support for five languages: English, German, Spanish,French, and Japanese. So you do not need to create a localized version of these languages. Toset any of these languages as the default language, use DiffDog Server's setdeflang command.

http://www.altova.com/support

http://www.altova.com/support



4.5 help

This section:

Command syntax Command description Examples The --help option

Command syntax

Windows DiffDogServer help Command

Linux diffdogserver help Command

Mac diffdogserver help Command

Command descriptionThe help command takes a single argument (Command): the name of the command for which help is

required. It displays the correct syntax of the command and other information relevant to the correctexecution of the command.

ExamplesAn example of the help command:

diffdogserver help exportresourcestrings

The command above contains one argument: the command exportresourcestrings, for which help isrequired. When the example command above is executed, information about the exportresourcestrings command will be displayed in the terminal.






The --help option

Help information about a command is also available by using the --help option with the command forwhich help information is required. For example, using the --help option with theexportresourcestrings command, as follows:

diffdogserver exportresourcestrings --help

achieves the same result as does using the help command with an argument ofexportresourcestrings:

diffdogserver help exportresourcestrings

In both cases, help information about the exportresourcestrings command is displayed.

4.6 install

This section:


Command syntax

Windows DiffDogServer install

Linux diffdogserver install

Mac diffdogserver install

Command descriptionThe install command installs DiffDog Server as a service on the server machine. The command takesno options.

Note that installing DiffDog Server as a service, does not automatically start the service. To start theservice, use the start command. To uninstall DiffDog Server as a service, use the uninstallcommand.

ExamplesExamples of the install command:



diffdogserver install




4.7 licenseserver

This section:


Command syntax

Windows DiffDogServer licenseserver [options] Server-Or-IP-Address

Linux diffdogserver licenseserver [options] Server-Or-IP-Address

Mac diffdogserver licenseserver [options] Server-Or-IP-Address

Command descriptionOn execution, the licenseserver command registers DiffDog Server with the LicenseServer specified bythe Server-Or-IP-Address argument. Server-Or-IP-Address identifies the machine on the network on

which Altova LicenseServer is installed and running. It can be the machine's name or its IP address.

For the licenseserver command to be executed successfully, the two servers must be connected onthe network and LicenseServer must be running. You must have administrator privileges to be able toregister DiffDog Server with LicenseServer.

Once DiffDog Server has been successfully registered with LicenseServer, you will receive a message tothis effect. The message will also display the URL of the LicenseServer. You can now go toLicenseServer to assign DiffDog Server a license. For details, see the LicenseServer documentation.

ExamplesExamples of the licenseserver command:



diffdogserver licenseserver DOC.altova.com

diffdogserver licenseserver localhost

diffdogserver licenseserver 127.0.0.1

The commands above specify, respectively, the machine named DOC.altova.com, and the user'smachine (localhost and 127.0.0.1) as the machine running Altova LicenseServer. In each case, thecommand registers DiffDog Server with the LicenseServer on the machine specified.





--j --json Prints the result of the registration attempt as a machine-parsable JSONobject. Form: --json=true|false

4.8 setdeflang

This section:

Command syntax Command description Examples Supported languages

Command syntax

Windows DiffDogServer setdeflang | sdl LangaugeCode

Linux diffdogserver setdeflang | sdl LangaugeCode

Mac diffdogserver setdeflang | sdl LangaugeCode



Command descriptionThe setdeflang command (short form is sdl) sets the default language of DiffDog Server. It takes a

mandatory LanguageCode argument.

ExamplesAn example of the setdeflang command:

diffdogserver setdeflang DE

The command above sets the default language for messages to German.




Supported languagesThe table below lists the languages currently supported together with their language codes.

EN English

DE German

ES Spanish

FR French

JA Japanese

4.9 start

This section:




Command syntax

Windows DiffDogServer start

Linux diffdogserver start

Mac diffdogserver start

Command descriptionThe start command starts DiffDog Server as a service on the server machine. The command takes nooptions.

Note that, if DiffDog Server is not installed as a service, you can install it with the install command. Touninstall DiffDog Server as a service, use the uninstall command.

ExamplesExamples of the start command:

diffdogserver start




4.10 uninstall

This section:


Command syntax

Windows DiffDogServer uninstall

Linux diffdogserver uninstall



Mac diffdogserver uninstall

Command descriptionThe uninstall command uninstalls DiffDog Server as a service on the server machine. The commandtakes no options.

To re-install DiffDog Server as a service, use the install command.

ExamplesExamples of the uninstall command:

diffdogserver uninstall




4.11 verifylicense (Windows only)

This section:


Command syntax

Windows DiffDogServer verifylicense [options]

Note: This command is supported only on Windows systems. It is not supported on Linux or Macsystems.



Command descriptionChecks whether the current product is licensed. Additionally, the --license-key option enables you tocheck whether a specific license key is already assigned to the product. For details about licensing, seethe LicenseServer documentation.

ExamplesExamples of the verifylicense command:

diffdogserver verifylicense diffdogserver verifylicense --license-key=ABCDEFG-HIJKLMN-OPQRSTU-VWXYZ12-3456789

The commands above check, respectively, whether the product has been licensed, and whether theproduct has been licensed with the license key given as the value of the --license-key option.





--l --license-key Checks whether the submitted license key has already beenassigned to the product. Form: --license-key=VALUE



5 DiffDog

DiffDog

diffimportshowcfg

:

DiffDogCmdlClient <command> --help

Linux Linux OS X / macOS ./

5.1 diff

diff 2 URL ( http://server/file.txt URL C:\file.txt )

compare compare diff

( ) URL 3 DiffDog DiffDog Server ( )

DiffDogCmdlClient diff [options] [path path [path]]


pathpath http://server/segment URL

diff 2 --client-left --client-right --server-left --server-right DiffDog DiffDog Server 2

DiffDog 45


--client-left --client-right --server-left --server-right 2 (3 3 )

URL ( URL )

diff

:

( )

--c, --config : .

--c DiffDog

--cl, --client-left ( ).

--cm, --client-middle 3 ( )

--cr, --client-right ( )

--dc, --dir-compare-contents ( ) false ( ) true



--df, --directory-filter [dir.filter] [dir.filter:svn] :

--directory-filter=svn

Windows DiffDog DiffDog Server DiffDog ( ) SVN :

--directory-filter="No SVN directories"

DiffDog :

1. DiffDog 2.

DiffDog DiffDog (https://www.altova.com/ja/documentation)

--di, --dir-compare-mod-times-ignore-seconds (+/-) 0

--dic, --dir-ignore-case true ( ) SomeDir somedir somefile.txt SomeFile.txt

false

--ds, --dir-compare-sizes true false

--dt, --dir-compare-mod-times true false

--ib, --ignore-blank-lines true false false


DiffDog 47


--ic, --ignore-case :

true ( A a )

false ( ) ( A a )

--m, --mode :

auto ( ) XML XML : .

binary

text

xml XML

--o, --output-file --om

--om, --output-mode ( XML) :

auto ( )

text

: XML --output-mode=text XML --output-mode text --output-file

xml XML

--port DiffDog Server DiffDog Server 29800



--q, --quiet :

true

false ( )

--s, --server-output-file --om

--server DiffDog Server DiffDog Server localhost

--sl, --server-left ( )

--sm, --server-middle (3 )

--sr, --server-right ( )

--ws, --whitespace-mode XML 1 : :

normalize A B A B XML

strip A B A B XML

--xf, --xml-filter XML XML XML

DiffDog 49


[xml.filter] XML [xml.filter:ignore-abc-elems] :

--xml-filter=ignore-abc-elems

Windows DiffDog DiffDog Server DiffDog XML DiffDog XML :

1. 2. XML

3. /

DiffDog XML DiffDog (https://www.altova.com/ja/documentation)

--xicin, --xml-ignore-case-in-names XML true XML XML :

<book ID="1"/> <book id="1"/>

ID --xml-

ignore-case-in-names=true false

--xicit, --xml-ignore-case-in-text XML true XML :

<book hardcover="yes">

<genre>fiction</genre>

</book>

<book hardcover="Yes">

<genre>Fiction</genre>

</book>

hardcover genre 2 --xml-ignore-case-in-

text=true false

--xima, --xml-ignore-markup-attributes XML :





true XML

false ( ) XML

--ximc, --xml-ignore-markup-comments XML :

true XML

false ( ) XML

--ximcd, --xml-ignore-markup-cdata XML :

true XML (CDATA)

false ( ) XML CDATA

--ximd, --xml-ignore-markup-doctype XML :

true XML DOCTYPE

false ( ) XML DOCTYPE

--ximpi, --xml-ignore-markup-processing-instructions XML :

true Ignore XML

false ( ) Take XML

--ximx, --xml-ignore-markup-xml XML :

true XML

false ( ) XML

--xins, --xml-ignore-namespace XML true XML false

--xip, --xml-ignore-prefixes XML true XML false

DiffDog 51


--xit, --xml-ignore-text XML true XML 2 XML false

--xoba, --xml-order-by-attributes XML XML true 2 XML :

<book author="Franz Kafka" title="The

Metamorphosis"/>

<book title="The Metamorphosis"

author="Franz Kafka"/>

--xml-order-by-attributes true false

--xobe, --xml-order-by-elements XML XML true 2 XML :

<book>

<author>Franz Kafka</author>

<title>The Metamorphosis</title>

</book>

<book>

<title>The Metamorphosis</title>

<author>Franz Kafka</author>

</book>

--xml-order-by-elements true false

--xobl, --xml-order-by-attribute-list XML [xml.orderby:<name_of_your_list>]

2 XML :

<data>

<phone type="work" ext="111"/>



</data>

<data>




</data>

ext phone



:

;; an example attributes list

[xml.orderby:mylist]

attributes = ext

--xml-order-by-attribute-list=mylist diff ext --xml-order-by-attribute-list

--xml-order-by-attributes=true

: --xml-order-by-attribute-list --xml-order-by-elements=true

Windows DiffDog DiffDog Server DiffDog DiffDog :

1. 2. XML 3.

4.

DiffDog DiffDog (https://www.altova.com/ja/documentation)

--xobt, --xml-order-by-text XML true :

<data>

<phone type="mobile">111</phone>


</data>

<data>



</data>

--xml-order-by-text true false

: --xml-order-by-text --xml-order-by-elements=true

--xre, --xml-resolve-entities XML true


DiffDog 53


false

--zd, --zip-as-dir ZIP true ZIP false

XML --output-mode --output-file

: ( --mode=binary ) DiffDog Server %ERRORLEVEL%

0

1

2

Windows 2 PDF %ERRORLEVEL%

DiffDogCmdlClient diff "C:\book1.pdf" "C:\book2.pdf" --m=binaryECHO %ERRORLEVEL%

diff 2 ( 2 ) diff :

DiffDogCmdlClient diff file1.txt file2.txt --mode=text

3 3 :

DiffDogCmdlClient diff file1.xml file2.xml file3.xml --mode=xml

: --mode binary xml 2



text 2 3 XML xml

DiffDog 2 XML ( ):

DiffDogCmdlClient diff --client-left=file1.xml --client-right=file2.xml

DiffDog Server 2

DiffDogCmdlClient diff --client-left=file1.txt --server-right=file2.txt

: Windows Linux Windows- --client-left Linux- --server-right

3 3 ( --client-middle --server-middle) file2.csv (file1.csv file3.csv)

DiffDogCmdlClient diff --client-left=file1.csv --server-middle=file2.csv --client-right=file3.csv

5.2 import

*.dirdif ( ) *.filedif ( ) import Altova DiffDog (https://www.altova.com/ja/diffdog)

load import load

(XML ) DiffDog

DiffDogCmdlClient import comparison-file1 [comparison-file2 [comparison-fileN]]



DiffDog 55


comparison-file.dirdif .filedif

--quiet, --q :

true

false ( )

: C:\DiffDog\Comparison1.filedif, :

DiffDogCmdlClient import C:\DiffDog\Comparison1.filedif

: Comparison1.filedif Comparison2.dirdif (C:\DiffDog ) :

DiffDogCmdlClient import C:\DiffDog\Comparison1.filedif C:\DiffDog\Comparison2.dirdif

5.3 showcfg

showcfg DiffDog :

- Registry - (Windows ) Windows DiffDog DiffDog XML : --directory-filter --xml-filter order by DiffDog : --xml-order-by-attribute-list -



DiffDogCmdlClient showcfg [options] [all]


all

showcfg

--c, --config :

Index 57


Index- C -Command line usage 30

Commands

exportresourcestrings 34

help 36

licenseserver 38

setdeflang 39

- D -DiffDog Server

9

8

8

- E -exportresourcestrings command 34

- H -help command 36

- L -licenseserver command 38

Linux DiffDog Server 28

DiffDog Server 13

DiffDog Server 12

13

Localization 34, 39

- M -macOS

DiffDog Server 29

DiffDog Server 15

DiffDog Server 14

- O -OS X

DiffDog Server 29

DiffDog Server 15

DiffDog Server 14

- S -setdeflang command 39

- W -Windows

DiffDog Server 29

DiffDog Server 15

DiffDog Server 17

- Z -

Windows 17

54

54

44

22

20

44

Endnotes 2... (after index)



Back Cover

Altova DiffDog Server 2018 · (C) 2018 Altova GmbH Altova DiffDog Server 2018 Note: To change the...

Documents

Transcript of Altova DiffDog Server 2018 · (C) 2018 Altova GmbH Altova DiffDog Server 2018 Note: To change the...