Versions Compared

Key

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

...

It is not recommended that customers interact directly with the data in this database.

The GlobalSearch system database, SSMaster, keeps a log of legacy Square 9 users that were migrated into the Identity Manager.  In a table named Migrations a row with the Name value of RolesToS9IM will detail the users and groups that were migrated.  In almost all cases, migrations happen automatically and don't require any user/admin involvement.  If necessary, you can trigger the migration to run again by deleting the row with Name value RolesToS9IM and restarting IIS.  The Square9API on application start will recognize the user migration entry is missing and it will attempt to migrate again.

Installation

Identity Manager will install as part of the GlobalSearch installation.


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.



  • Like all GlobalSearch support applications, the Identity Manager application and supporting files can be found in C:\Program Files\Square 9 Softworks if the default installation path was chosen.
  • 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.