Installing SchemaAgent Server

www.altova.com Print this Topic Previous Page Up One Level Next page

Home >  SchemaAgent Server >

Installing SchemaAgent Server

The SchemaAgent Server installation package can be downloaded free of charge from the SchemaAgent download page.

 

 

To install SchemaAgent Server:

1.Double-click the SchemaAgent Server installer file.
2.Follow the on-screen instructions. During installation, a dialog box prompts you to choose whether SchemaAgent Server should be installed as a standalone server, or a service. Each of these options is described below.
3.If necessary, start the server (see Starting SchemaAgent Server).

 

Installing SchemaAgent Server as standalone server

When installed as a standalone server, SchemaAgent Server can be started from the Start | All Programs menu or from a desktop shortcut. The application opens in a GUI, and, when started, an application icon ic_sa-server appears in the system tray. SchemaAgent Server can be configured (that is, have search paths defined for it) directly in the GUI. This installation is well suited for installation on a local machine.

app_standalone-gui

 

Installing SchemaAgent Server as a service

When installed as a service, SchemaAgent Server is available as a service in Control Panel | Administrative Tools | Services, and can be managed in the same way as other Windows services. The advantage is that it can be configured to start automatically when the system starts (this option is also available on the installation wizard). Installing SchemaAgent Server as a service is suitable when it must act as a network server for multiple clients.

 

Note that, in this scenario, SchemaAgent Server does not have a GUI and cannot be started from the Start | All Programs menu or from a desktop shortcut. Also, no system tray icon is available. In order to configure SchemaAgent Server (that is, define search paths), you must first install SchemaAgent Server as a standalone server, configure it, and then change the installation method from the command line (see instructions below).

 

Changing the installation method using the command line

If you want to change the installation method of SchemaAgent Server after you have installed the program, you can do so by calling SchemaAgentServer.exe using the command line. Otherwise, you would have to uninstall SchemaAgent Server and reinstall it choosing a different installation method.

 

The commands listed below are available when calling SchemaAgentServer.exe from the command line. The executable always returns a return code when run in command-line mode. If an error is encountered using the install and remove parameters, then the returned error code is identical to the code supplied by the operating system.

 

No command line parameters

Start as GUI application.

/install or -install

Install as a (non-interactive) service and (creates an entry in the SCM Database*).

/install:interactive or

-install:interactive

Install as an interactive service (creates an entry in the SCM Database*).

 

Note: This option is deprecated in Windows Vista and Windows 2008 Server (and later), because support for interactive services has been removed on these operating systems for security reasons. If you attempt to run SchemaAgent Server as an interactive service on these operating systems, a system error occurs (and logged in the Windows Event Viewer): "The SchemaAgent Server Service service is marked as an interactive service. However, the system is configured to not allow interactive services. This service may not function properly". For further details, see https://technet.microsoft.com/en-us/library/cc756339(v=ws.10).aspx.

/remove or -remove

Uninstalls the service (deletes entry from the SCM-Database*).

/quiet or -quiet

Suppresses message boxes that appear when an error

occurs using the Install or Remove commands.

 

*  The Service Control Manager (SCM) maintains a database of installed services and driver services, and provides a unified and secure means of controlling them. The database includes information on how each service or driver service should be started. It also enables system administrators to customize security requirements for each service and thereby control access to the service. (Source: MSDN Library)

 

 

To change the installation method from "standalone" to "service":

1.Ensure that SchemaAgent Server is not running. To exit a running SchemaAgent Server server, right-click the Altova SchemaAgent Server ic_sa-server application icon in the system tray and select Shutdown from the context menu.
2.Open a Command Prompt window (as administrator), and change the current directory to the installation folder of SchemaAgent Server (C:\Program Files\Altova\SchemaAgentServer2019 by default).
3.At the command prompt, enter SchemaAgentServer.exe /install to install SchemaAgent Server as a service.
4.Start SchemaAgent Server as a service (see Starting SchemaAgent Server).

 

 

To change the installation method from "service" to "standalone":

1.Ensure that SchemaAgent Server is not running. To exit a running SchemaAgent Server service, open Control Panel | Administrative Tools | Services, right-click the SchemaAgent Server Service and choose Stop from the context menu.
2.Open a Command Prompt window (as administrator), and change the current directory to the installation folder of SchemaAgent Server (C:\Program Files\Altova\SchemaAgentServer2019 by default).
3.At the command prompt, enter SchemaAgentServer.exe /remove to uninstall the existing SchemaAgent Server service.
4.At the command prompt, enter SchemaAgentServer.exe to start the standalone installation.

© 2019 Altova GmbH