Relativity Server Deployment and Setup
From RemObjects Wiki
This is a HowTo topic
about Data Abstract for .NET
Feel free to add your notes to this topic below.
Contents |
Requirements
Relativity requires
- .NET Framework 3.5SP1 or above on Windows platforms
- Mono framework 2.6 or above on Linux and Mac OS X platforms
Deployment
Relativity server can be installed via xcopy installation. This means that you can just copy the Relativity folder to the destination host and, if needed, install it as service (see below).
List of files needed by the Relativity server:
- Relativity.exe
- RemObjects.Relativity.Engine.dll
- RemObjects.Relativity.UI.dll
- RemObjects.InternetPack.dll
- RemObjects.SDK.dll
- RemObjects.SDK.Server.dll
- RemObjects.SDK.ZeroConf.dl
- RemObjects.SDK.ZLib.dll
- RemObjects.DataAbstract.dll
- RemObjects.DataAbstract.Server.dll
- RemObjects.DataAbstract.Scripting.dll
- RemObjects.Script.dll
- DataAbstract.daConfig
You will also need to deploy any third-party database drivers your server will use. In addition to the drivers included in the .NET framework (such as Microsoft SQL Server and Oracle), the Relativity folder contains support dlls for the Firebird, PostgreSQL and SQLite.NET drivers, out of the box.
To install the Relativity Server Admin, you need to deploy the following files to the destination host:
- RelativityAdminTool.exe
- RemObjects.InternetPack.dll
- RemObjects.SDK.dll
- RemObjects.SDK.ZeroConf.dll
- RemObjects.SDK.ZLib.dll
All files can be found in the ...\RemObjects Software\Data Abstract (Common)\Bin\Relativity folder of your Data Abstract installation on Windows.
Note: The 'Open in Schema Modeler' feature of the Relativity Server Admin requires a valid Data Abstract for .NET or Data Abstract for Delphi installation and license on the machine running the Admin.
Running as Service on Windows
To run Relativity as a Windows Service, simply install it by issuing "Relativity.exe /i" or "Relativity.exe --install" from the command line (Administrator privileges are needed). Once that is done, you can start and stop Relativity like any other Windows Service, using the Services Management Console, or via the "net start/net stop" command line tool.
Note: With UAC enabled you will need RUN AS administrator on the CMD prompt. Also note that if you want a dependency on SQL Server, you will need to install the service manually with
sc create Relativity binpath= "C:\Program Files (x86)\RemObjects Software\Relativity Server\Bin\Relativity" depend=MSSQLSERVER
(substitute MSSQLSERVER with your instance name)
When running as a Windows Service, Relativity will not display a GUI. You can, however, verify whether it is running by visiting the server info page at http://localhost:7099 with a web browser (see below).
Running as Unix Daemon on Linux and Mac OS X
Relativity can also be started as Unix daemon using Mono on Linux and Mac OS X. It uses the standard .NET/Mono Service infrastructure, and can be launched using the "mono-service2 Relativity.exe" command (either manually in Terminal or via SSH or as part of startup system scripts or launchd).
Running as Application on Mac OS X
As of the Spring 2010 release, the Data Abstract for Xcode installer includes a pre-packaged Relativity.app application bundle that allows you to run Relativity as a regular Mac application, integrated with the Mac desktop. After launching Relativity.app, the application will manifest itself as an icon in the Mac menu bar, providing a UI to control the service. Mono 2.6 or later is required for running Relativity.app.
Server Information Page
Each Relativity instance serves a very simple http page that provides short information about the server instance. For default Relativity settings, this page is available at http://localhost:7099.
Product: RemObjects Data Abstract
Available Editions: Data Abstract for .NET, Xcode, Delphi, Java and JavaScript
