Installation on macOS

www.altova.com Expand/Collapse All Print this Topic Previous Page Up One Level Next page

Home >  Setting Up RaptorXML > Setup on macOS >

Installation on macOS

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

 

Click to expand/collapseSystem requirements
hmtoggle_arrow0macOS

macOS 10.12 or newer

 

Click to expand/collapse FlowForce Server integration

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

 

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

 

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

 

 

Click to expand/collapseNote about root user

You must have administrator (root) privileges to be able to install RaptorXML+XBRL 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+XBRL Server, stop the service with the following command:

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

 

To check whether the service has been stopped, open the Activity Monitor in Finder and make sure that RaptorXML+XBRL Server is not in the list.In the Applications folder in Finder, right-click the RaptorXML+XBRL 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/RaptorXMLXBRLServer2019/

 

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+XBRL Server.

 

 

Click to expand/collapseDownload the disk image file

Download the disk image (.dmg) file from the Altova website (http://www.altova.com/download.html).

 

 

Click to expand/collapseInstall RaptorXML+XBRL Server

Click to open the downloaded disk image (.dmg). This causes the RaptorXML+XBRL 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+XBRL Server package will be installed in the folder:

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

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

 

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

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

 

 

Click to expand/collapseAltova LicenseServer

In order for any Altova Server product—including RaptorXML+XBRL 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 (http://www.altova.com/download.html).

 

The LicenseServer package will be installed in the folder:

/usr/local/Altova/LicenseServer

 

For information about how to register RaptorXML+XBRL 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+XBRL Server version, or with a later version of LicenseServer.
The LicenseServer version that is appropriate for a particular version of RaptorXML+XBRL Server is displayed during the installation of RaptorXML+XBRL Server. You can install this version of LicenseServer along with RaptorXML+XBRL 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+XBRL Server.
If you install a new version of RaptorXML+XBRL 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.1

 

 

 


© 2019 Altova GmbH