Altova SchemaAgent 2025

Installing SchemaAgent Server

Home Prev Top Next

The SchemaAgent Server installation package can be downloaded free of charge from the SchemaAgent download page (https://www.altova.com/schemaagent/download).

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 as a standard Windows application, from the Start sa_ic_winstart menu. When the server is started, an application icon sa_ic_server appears in the system tray. In this approach, the application has a graphical user interface from where you can configure the search paths and other settings. This kind of installation is well suited if you need to access the graphical user interface frequently (for example, in order to change the search paths).

sa_server_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 graphical user interface and cannot be started from the Start sa_ic_winstart 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 type

If you want to change the installation model (from standalone to service, or vice versa) 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 standalone application.

/install or -install

Install as a service.

/remove or -remove

Uninstalls the service.

/quiet or -quiet

Suppresses message boxes that appear when an error

occurs using the Install or Remove commands.

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

1.Ensure that SchemaAgent Server is not running. To exit a running SchemaAgent Server, right-click the Altova SchemaAgent Server sa_ic_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\SchemaAgentServer2025 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 type 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\SchemaAgentServer2025 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.

© 2018-2024 Altova GmbH