GIP working directory

The Genero Identity Provider (GIP) working directory is the directory where GIP data such as endpoints to GIP services and GIP databases are stored.

The GIP working directory is created during GIP installation, when the StarterApp creates the idp.xml endpoints file and initializes the databases. By default, the directory is $(home)/.genero-sso, where $(home) resolves to the home directory of the user who installed the GIP.

Setting the location

You can change the location of the GIP working directory by setting the res.path.idp and/or res.path.idp.home resources in the GAS configuration file. 
<RESOURCE Id="res.path.idp" Source="INTERNAL">$(res.path.home)</RESOURCE>
<RESOURCE Id="res.path.idp.home" Source="INTERNAL">$(res.path.idp)/.genero-sso</RESOURCE>
Use res.path.idp.home to override or rename the directory (instead of .genero-sso). For servers with multiple GAS versions, point res.path.idp to the parent directory (for example, a directory containing .genero-sso-401 and .genero-sso-501) and set res.path.idp.home to each version’s subdirectory.
Warning:

If the GIP is started behind an Apache or IIS server, the user's home directory is not set. In a production environment (behind Apache, nginx, or IIS), we recommend you set res.path.idp (or res.path.idp.home to change the folder path/name) to a directory that is accessible when the GAS (and therefore the fglrun command) is started from the web server.

Contents

The GIP working directory stores the GIP database files, the idp.xml endpoints file, and application configuration files for GIP applications such as the Console App and Deployment App. The services subdirectory ($(home)/.genero-sso/services) contains the following GIP service configuration files:

  • GeneroProfileService.xcf
  • GeneroRegistrationService.xcf
  • GeneroDeploymentService.xcf
  • GeneroSharedFileService.xcf

Files shared between registered users via the SharedFile App are stored in the $(home)/.genero-sso/.shared subdirectory. For details, go to Share files using the SharedFile App.

Usage notes

Do not modify files in the GIP working directory; it is for internal use only. The exception is setting MAX_AVAILABLE to 1 in the GIP service configuration files when testing, to limit license consumption. For details of GIP license requirements, go to Install and configure for SSO.

Warning:

Installing more than one GIP instance on the same machine is typically not needed and not recommended. However, if you do use multiple GIP instances, you must configure a separate GIP working directory for each one by setting res.path.idp (or res.path.idp.home to change the folder path/name) in the GAS configuration file (as.xcf).

Tip:

To reinstall the GIP, delete the GIP working directory completely and rerun the StarterApp. For details, go to Configure the primary Genero Identity Provider.