Genero Archive deployment in depth

If your are working from a remote server, use the Genero Archive deployment service to manage your Genero applications.

The deployment Web service is accessible on the GAS at a base URL of /ws/r/services/DeploymentService. See Table 1 for descriptions of the actions you can perform and to view some examples of use.

Table 1. Actions available for the Genero Archive deployment service
Action Description HTTP request details
deploy Deploys a Genero Archive (gar) file on the Genero Application Server by calling:

gasadmin gar --deploy-archive

Returns the command result in XML format.

 HTTP PUT request of following form:
URL: /ws/r/services/DeploymentService/deploy?archive=name
Note: archive=name is mandatory to identify the archive on the GAS.

To send the archive to the Genero Application Server, you could use curl with a PUT instruction:

curl -X PUT -T test.gar 
http://app_server:port/connector
/ws/r/services/DeploymentService/
deploy?archive=name
where:
  • app_server is the server name or IP address.
  • port is the port where the application server or Web server is listening.
  • connector is the Genero Application Server connector (/gas, for example).
enable Enables all applications and services of a given archive by calling:

gasadmin gar --enable-archive

Returns the command result in XML format.

 HTTP GET request of following form:

URL: /ws/r/services/DeploymentService/enable?archive=name
disable Disables all applications and services of given archive by calling:

gasadmin gar -–disable-archive

Returns the command result in XML format.

 HTTP GET request of following form:

URL: /ws/r/services/DeploymentService/disable?archive=name
undeploy Undeploys a genero archive on the Genero Application Server by calling:

gasadmin gar –-undeploy-archive

 HTTP GET request of following form:

URL: /ws/r/services/DeploymentService/undeploy?archive=name
list Returns a list and status of all archives available on the Genero Application Server by calling:

gasadmin gar --list-archive

Returns the command result in XML format.

 HTTP GET request of following form:

URL: /ws/r/services/DeploymentService/list
cleanup The cleanup operation is not available with the REST service, as it requires user interaction to its prompts. To perform a cleanup operation, you must use gasadmin on the application server, performed by the command:

gasadmin gar --clean-archives

 N/A