Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info
titleRDS Servers

Windows Installer packages have known limitations in environments where RDS is enabled on the server.  Server's configured for RDS need to be put into install mode, or the IM installation will hang.  Refer to the documentation on common installation issues here.  This behavior is a problem with Windows Installer chaining, and can also be bypassed by telling the installer to skip the chained installation.  Run the GlobalSearch installer with a 'no chaining' option, setup.exe /v"DO_NOT_CHAIN=TRUE".  Identity Manager is a required service for proper GlobalSearch operations.  If the identity manager install is skipped or bypassed, it will need to be installed separately.

...

Note: Uninstalling GlobalSearch from an environment will not uninstall Identity Manager.  The service will be listed in the Server Add/Remove Programs list as a separate application (with the name Square 9 Identity Manager) that would need to be uninstalled separately.

User Accounts

The Identity Manager should be set to run as Local System.  While the application runs in the context of Local System, any internal actions like accessing the database are performed in the context of the Square 9 Admin Authenticated user.  This user, traditionally SSAdministrator, has cached credentials on the server that are leveraged by Square 9 applications for performing these types of actions.  Use the Square 9 Service Console to view the currently configured user.

At startup, Identity Manager will leverage its configuration files to provision the Square9.IdentityManager database.  

  • When upgrading from previous versions, the Identity Manager will automatically migrate existing Square 9 users.  what if this doesn't happen?  Migrations table in SSMaster will detail user accounts that were migrated in the process.  Look specifically for a row with a Name value of RolesToS9IM.
  • How can someone log in if the database doesn't exist?IM needs to be manually uninstalled if you are trying to uninstall all Square 9 applications from an environment.
  • Server's configured for RDS need to be put into install mode, or the IM installation will hang.  Refer to the documentation on common installation issues here.  This behavior is a problem with Windows Installer chaining, and can also be bypassed by telling the installer to skip the chained installation.  Run the GlobalSearch installer with a 'no chaining' option, setup.exe /v"DO_NOT_CHAIN=TRUE", and manually trigger the Identity manager install.  Identity Manager is a required service for proper GlobalSearch operations.  If the identity manager install is skipped or bypassed, it will need to be installed separately.  https://bugzilla.square-9.com/show_bug.cgi?id=11545
  • Database context is admin auth.
  • S9API is what runs any user migration, delete roles to S9IM and it will kick it.