Configure GIP for DB Sync

The GIP system must define the DB Sync administration user and configuration apps to be started from a web browser.

Important:

If you are using the HTTPS protocol in the URLs to access the GAS and IDP services (https://host:port/...) , make sure that the specified host corresponds to the Common Name (CN) used in the certificate.

Important:

GIP requires to have write permissions on the $FGLDIR\web_utilities\services\openid-connect directory. Otherwise, the error "Invalid configuration parameters" will display, when starting a server app from your browser.

Tip:

In the context of GAS upgrade, you want to skip steps 1 and 2, as long as the GIP configuration files and databases (.genero-sso) are kept. However, step 3 is mandatory to re-deploy the DB Sync system apps in the new GAS version.

To set up the GIP system for DB Sync, follow these steps:

Initialize the GIP system:
Open the demos.html starter page in a browser:
```
http[s]://host:port/demos.html
```
For example:
```
http://toro:6394/demos.html
```
Start the GIP Starter app, and enter the parameters to initialize the GIP system.

For more details about GIP setup, go to the Single Sign-On User Guide.
Create DB Sync configuration apps settings in GIP:

Important:
This command needs to be executed on the server where the GIP is located, with FGL, GAS and DB Sync environment set.

In a command line terminal, set the FGL env and the GAS env.

Go to the FGLGWS installation directory and run the envcomp script (envcomp.bat on Windows)
Use the dbsync_tool setup-gip command, by specifying the DB Sync administrator name and password:
```
dbsync_tool setup-gip dbsync_admin password
```
Deploy the DB Sync configuration apps in GIP:

To deploy the configuration apps, use the dbsync_tool deploy-dbsync command, by specifying the DB Sync administrator name/password and the URLs to the GAS and GIP services.

For example:
```
dbsync_tool deploy-dbsync dbsync_admin password http://toro:6394 http://luna:6394
```
The third and fourth arguments define respectively the URL to the location of the GAS serving DB Sync apps and GIP-Base-URL idenfities the location of the GIP service.
If the GIP service and GAS service are listening on the same host/port, you can omit the last parameter:
```
dbsync_tool deploy-dbsync dbsync_admin password http://toro:6394
```

If the DB Sync package has been already deployed on the GAS and you want re-deploy it, you have to run the following commands:

gasadmin gar --disable-archive dbsync
gasadmin gar --undeploy-archive dbsync