Configuring a Satellite Installation

Configuring a satellite is much simpler than configuring a master. The only information needed to configure a satellite is the host and port of the master that it is to be associated with. The OpenSpirit master's administrator password is also needed to configure a Linux satellite if the Install Config Manager is not being run from the OpenSpirit administrator account.

Click the create satellite button to configure a new satellite. This opens a window that prompts for the host name and port number of the OpenSpirit master that the satellite is to be associated with.

Master Host and Port

The master's shared service must be running when configuring a satellite. Enter the host name and port of the master and press the Ok button. Ask your OpenSpirit administrator if you do not know the host name or port to enter.

A green check mark appears next to the Shared Services Host and Port settings if a connection was made to the master. A red stop sign appears if a connection could not be made to the master. Make sure that the host and port settings were entered correctly and the master services are running. Click the edit button to reopen the host and port entry window to correct the values if the stop sign is displayed.

Windows Satellite Registration

A Use satellite for server activation option is available when configuring a Windows satellite.

Selecting this option makes the host computer that you are running the Install Config tool on available for selection in the User Setup Wizard's host selection lists. This enables the host to be used to run Windows data connector processes from OpenSpirit applications that are running on other Windows or Linux hosts. This option is intended to be used to register a Windows server class machine with OpenSpirit making it available for users to run Windows data servers rather than running them on the user's desktop machine. The host must be running an SSH daemon. Consult with your IT department about configuring the host to run OpenSSH or some other SSH daemon. The Use satellite for server activation option does not appear when configuring Linux satellites because it is assumed that all Linux satellites are intended to be used to run remote Linux data server processes.

Description

The description setting is optional and is only enabled on Windows if the Use satellite for server activation option is selected. The description provides a way to document the purpose for a satellite configuration. It can contain any text.

Satellite Config Directory

The directory that the configuration's config.properties file written to. This should be an empty directory before creating the satellite configuration. This setting is for informational purposes only when configuring a satellite on Windows. The default configuration directory must be used on Windows. Select an empty directory when configuring on Linux. The directory must be readable by the users that running applications or data connectors from the satellite.

Tip: The default directory on Linux is a subdirectory named config in the top-level folder of the OpenSpirit software installation that the Install Config Manager is being run from.
Using the default directory eliminates the need to have an OSP_CONFIG environment variable set before running the OpenSpirit Desktop on Linux. The environment variable must be set if a different name or location is used.

Save Configuration

Click the save button to create the satellite or save changes to an existing satellite. The bottom portion of the satellite configuration form is filled in with information about its associated master when the satellite configuration has been saved.