Installing on Windows Server Core
Windows Server Core is a minimal Windows installation that does not use a number of GUI features. You can install RaptorXML+XBRL Server on a Windows Server Core machine as follows:
1.Download the RaptorXML+XBRL Server installer executable from the Altova website. This file is named RaptorXMLXBRLServer<version>.exe. Make sure to choose the executable matching your server platform (32-bit or 64-bit).
2.On a standard Windows machine (not the Windows Server Core machine), run the command RaptorXMLXBRLServer<version>.exe /u. This unpacks the .msi file to the same folder as the installer executable.
3.Copy the unpacked .msi file to the Windows Server Core machine.
4.If you are updating an earlier version of RaptorXML+XBRL Server, shut down RaptorXML+XBRL Server before carrying out the next step.
5.Use the .msi file for the installation by running the command msiexec /i RaptorXMLXBRLServer.msi. This starts the installation on Windows Server Core.
| Note: | When upgrading to a major version, you can retain your RaptorXML+XBRL Server settings by using the properties listed in the subsections of this section: (i) Webserver Properties, (ii) SSL-Webserver Properties, and (iii) Service Properties. |
Important: Keep the MSI file!Note the following points:
•Keep the extracted .msi file in a safe place. You will need it later to uninstall, repair, or modify your installation. •If you want to rename the MSI file, do this before you install RaptorXML+XBRL Server. •The MSI filename is stored in the registry. You can update its name there if the filename has changed.
|
Register RaptorXML+XBRL Server with LiceseServer
If you are installing RaptorXML+XBRL Server for the first time or are upgrading to a major version, you will need to register RaptorXML+XBRL Server with an Altova LicenseServer on your network. If you are upgrading to a non-major version of RaptorXML+XBRL Server, then the previous LicenseServer registration will be known to the installation and there is no need to register RaptorXML+XBRL Server with LicenseServer. However, if you want to change the LicenseServer that is used by RaptorXML+XBRL Server at any time, then you will need to register RaptorXML+XBRL Server with the new LicenseServer.
To register RaptorXML+XBRL Server with an Altova LicenseServer during installation, run the installation command with the REGISTER_WITH-LICENSE_SERVER property, as listed below, providing the name or address of the LicenseServer machine as the value of the property, for example:
msiexec /i RaptorXMLXBRLServer.msi REGISTER_WITH_LICENSE_SERVER="localhost"
To register RaptorXML+XBRL Server with an Altova LicenseServer after installation, run the following command:
msiexec /r RaptorXMLXBRLServer.msi REGISTER_WITH_LICENSE_SERVER="<MyLS-IPAddress>"
Useful commands
Given below are a set of commands that are useful in the installation context.
To test the return value of the installation, run a script similar to that below. The return code will be in the %errorlevel% environment variable. A return code of 0 indicates success.
start /wait msiexec /i RaptorXMLXBRLServer.msi /q
echo %errorlevel%
For a silent installation with a return code and a log of the installation process:
start /wait msiexec /i RaptorXMLXBRLServer.msi /q /L*v! <pathToInstallLogFile>
To modify the installation:
msiexec /m RaptorXMLXBRLServer.msi
To repair the installation:
msiexec /r RaptorXMLXBRLServer.msi
To uninstall RaptorXML+XBRL Server:
msiexec /x RaptorXMLXBRLServer.msi
To uninstall RaptorXML+XBRL Server silently and report the detailed outcome in a log file:
start /wait msiexec /x RaptorXMLXBRLServer.msi /q /L*v! <pathToUninstallLogFile>
To install RaptorXML+XBRL Server using another langauge (available language codes are: German=de; Spanish=es; French=fr):
msiexec /i RaptorXMLXBRLServer.msi INSTALLER_LANGUAGE=<languageCode>
| Note: | On Windows Server Core, the charts functionality of RaptorXML+XBRL Server will not be available. |
| Note: | To install taxonomies, use the Taxonomy Package Manager via the command line. See the RaptorXML+XBRL Server manual for information about how to do this. |