Users tab
The Users tab displays a table of all the registered OpenSpirit users. The list may be sorted by any of the columns by clicking on the header of the column to sort by. The Is Active? column indicates, with a check mark, if the user is currently connected to the OpenSpirit services.
Users are automatically registered with the OpenSpirit framework the first time they run any OpenSpirit enabled application. Automatically registered users will appear with a primary account, name, and description that all match the name of the Windows or Linux account that they were running on when automatically registered. A user's primary account cannot be changed. Users must be deleted and re-registered to change their primary account. The secondary account is optional and can be edited. User names and descriptions may also be edited.
The User Manager's tool bar contains buttons that can be used to create, delete, and disconnect OpenSpirit users.
Adding New Users
The User Manager tool can be used to register new OpenSpirit users rather than waiting for automatic registration to occur. Explicit user registration is most often performed when it is desired to have the user name or description fields contain values other than merely duplicating the primary account name.
New users can be added individually by clicking on the create user icon .
The create user icon will open a dialog that is used to enter the new user's primary account, secondary account, name, and description. The primary account field is the only required field. The name and description will default to the primary account value if left blank. The secondary account is optional and is typically left blank. No validation is performed on the values entered for the primary and secondary accounts, so take care to enter the account names accurately. The primary account cannot match any existing user's primary or secondary account. The secondary account cannot match any existing user's primary or secondary account.
Users can also be added in batch by clicking on the import icon to select a file containing information for many users. The import file should contain a line for each user using a vertical bar character to separate the account fields. The file should be in the form of:
Primary Account | Secondary Account | Name | Description
The import dialog provides an option to overwrite or to skip any users that match an existing primary account.
Deleting Users
The User Manager tool can be used to delete OpenSpirit users. Deleting an OpenSpirit user will remove all information associated with a user from the OpenSpirit repository. This includes the user's sessions, server activation preferences, data source credentials, and private data source configurations. Deleting a user does not remove any Windows or Linux account associated with the user. Only OpenSpirit information is removed.
Users are deleted by selecting one or more rows in the user table and pressing the delete icon . An "are you sure" dialog will be displayed giving you a chance to change your mind and cancel the deletion.
Editing User Information
The user name, description, and secondary account information can be edited by simply clicking in the table cell and typing. Edits to user information are not saved until you click on the save icon in the User Manager tool bar. An edit icon
is displayed in the left most column of each user that has been edited. The edit icons go away when the edits are saved by clicking on the save icon.
The secondary account is used to associate another Windows or Linux account with an OpenSpirit user. It is typically only used when an OpenSpirit user has different account names on Windows and Linux and wishes to run OpenSpirit applications on both accounts. A secondary account is not required to run data connector processes under different accounts. A secondary account is only needed to run applications under two different account names and have them treated as a single OpenSpirit user.
No validation is performed on secondary account information entered using the User Manager tool. Secondary accounts cannot match any other existing primary account or any other existing secondary account.
Disconnecting Users
The User Manager tool can be used to disconnect active users from the OpenSpirit runtime. This feature is provided to enable the OpenSpirit administrator to free resources being held by OpenSpirit users if it is not possible for the user to release the resources themselves.
Users that are running one or more OpenSpirit enabled applications or data connectors will appear with a green check in the IsActive? column of the user table. Select one or more active users and click on the stop sign icon
in the User Manager tool bar to deactivate the selected active users.
Refreshing User List
Click on the refresh icon to refresh the list of users shown in the User Manager tool. Refresh will include any new users that have been registered since the list was last displayed. Refresh can also be used to discard any unsaved edits to user information.