Installation on macOS Expand/Collapse All Print this Topic Previous Page Up One Level Next page

Home >  Setting Up RaptorXML > Setup on macOS >

Installation on macOS

RaptorXML Server is available for installation on macOS systems. Its installation and setup procedure is described below.


Click to expand/collapseSystem requirements

macOS 10.12 or newer


Click to expand/collapse FlowForce Server integration

If you install RaptorXML Server together with FlowForce Server, it is recommended that you install FlowForce Server first. If you install RaptorXML Server before FlowForce Server, then, after having installed both RaptorXML Server and FlowForce Server, run the following command:


cp /usr/local/Altova/RaptorXMLServer2019/etc/*.tool /usr/local/Altova/FlowForceServer2019/tools


This command copies the .tool file from /etc directory of RaptorXML Server to the FlowForce Server /tools directory. The .tool file is required by FlowForce Server; it contains the path to the RaptorXML Server executable. You do not need to run this command if you install FlowForce Server before installing RaptorXML Server.



Click to expand/collapseNote about root user

You must have administrator (root) privileges to be able to install RaptorXML Server. Installation must be done, therefore, as the root user. If you are logged in as root, you can leave out the sudo keyword from the commands listed below.



Click to expand/collapseUninstall old versions of Altova server products

Before uninstalling RaptorXML Server, stop the service with the following command:

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


To check whether the service has been stopped, open the Activity Monitor in Finder and make sure that RaptorXML Server is not in the list.In the Applications folder in Finder, right-click the RaptorXML Server icon and select Move to Trash. The application will be moved to Trash. You will, however, still need to remove the application from the usr folder. Do this with the command:

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


If you need to uninstall an old version of Altova LicenseServer, you must first stop it running as a service. Do this with the following command:

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


To check whether the service has been stopped, open the Activity Monitor in Finder and make sure that LicenseServer is not in the list. Then proceed to uninstall in the same way as described above for RaptorXML Server.



Click to expand/collapseDownload the disk image file

Download the disk image (.dmg) file from the Altova website (



Click to expand/collapseInstall RaptorXML Server

Click to open the downloaded disk image (.dmg). This causes the RaptorXML Server installer to appear as a new virtual drive on your computer. On the new virtual drive, double-click the installer package (.pkg). Go through the successive steps of the installer wizard. These are self-explanatory and include one step in which you have to agree to the license agreement before being able to proceed. To eject the drive after installation, right-click it and select Eject.


The RaptorXML Server package will be installed in the folder:

/usr/local/Altova/RaptorXMLServer2019 (application binaries)

/var/Altova/RaptorXMLServer (data files: database and logs)


RaptorXML Server server daemon starts automatically after installation and a re-boot of the machine.  You can start RaptorXML Server as a daemon with the following command:

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



Click to expand/collapseAltova LicenseServer

In order for any Altova Server product—including RaptorXML Server—to run, that server product must be licensed via an Altova LicenseServer on your network.


The Altova LicenseServer installation package is available on the virtual drive you have mounted in the previous step. To install Altova LicenseServer, double-click the installer package included on the virtual drive and follow the on-screen instructions. You will need to accept the license agreement for installation to proceed.


Altova LicenseServer can also be downloaded and installed separately from the Altova website (


The LicenseServer package will be installed in the folder:



For information about how to register RaptorXML Server with Altova LicenseServer and license it, see the section, Licensing on macOS.



Click to expand/collapseLicenseServer versions
Altova server products must be licensed either with the version of LicenseServer that is appropriate to the installed RaptorXML Server version, or with a later version of LicenseServer.
The LicenseServer version that is appropriate for a particular version of RaptorXML Server is displayed during the installation of RaptorXML Server. You can install this version of LicenseServer along with RaptorXML Server, or you can install LicenseServer separately.
Before installing a newer version of LicenseServer, any older one must be de-installed. The LicenseServer installer will do this automatically if it detects an older version.
LicenseServer versions are backwards compatible. They will work with older versions of RaptorXML Server.
If you install a new version of RaptorXML Server and if your installed LicenseServer version is older than the appropriate LicenseServer, install the latest version available on the Altova website.
At the time of LicenseServer de-installation, all registration and licensing information held in the older version of LicenseServer will be saved to a database on your server machine. This data will be imported automatically into the newer version when the newer version is installed.
The version number of the currently installed LicenseServer is given at the bottom of the LicenseServer configuration page (all tabs).


Current version: 3.2




© 2019 Altova GmbH