API bootstrap - RapturePlatform/Rapture GitHub Wiki
Bootstrap API
The Bootstrap API is used to setup an initial Rapture environment and to migrate existing bootstrap repositories to a new repository format.
setEmphemeralRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.setEmphemeralRepo(config);
retVal = baseAPI.doBootstrap_SetEmphemeralRepo(config);
Entitlement: /admin/bootstrap
The ephemeral repository is used to store information that does not need to survive a restart of Rapture. It normally holds information such as sessions, and its config is usually based around a shared non-versioned memory model
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| config | String |
Return value
| Type | Description |
|---|---|
| void |
setConfigRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.setConfigRepo(config);
retVal = baseAPI.doBootstrap_SetConfigRepo(config);
Entitlement: /admin/bootstrap
The config repository is used to store general config information about entities in Rapture. These entities include users, types, indices, queues and the like.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| config | String |
Return value
| Type | Description |
|---|---|
| void |
setSettingsRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.setSettingsRepo(config);
retVal = baseAPI.doBootstrap_SetSettingsRepo(config);
Entitlement: /void/bootstrap
The settings repository is used to store general low level settings in Rapture.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| config | String |
Return value
| Type | Description |
|---|---|
| void |
migrateConfigRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.migrateConfigRepo(newConfig);
retVal = baseAPI.doBootstrap_MigrateConfigRepo(newConfig);
Entitlement: /admin/bootstrap
This method is used to migrate the top level Config repository to a new config. This task takes place in the background, and once completed the config repository is switched to the new config. Any changes to config up to this point may be lost.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| newConfig | String |
Return value
| Type | Description |
|---|---|
| void |
migrateEphemeralRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.migrateEphemeralRepo(newConfig);
retVal = baseAPI.doBootstrap_MigrateEphemeralRepo(newConfig);
Entitlement: /admin/bootstrap
This method is used to migrate the top level Ephemeral repository to a new config. This task takes place in the background, and once completed the config repository is switched to the new config. Any changes to config up to this point may be lost.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| newConfig | String |
Return value
| Type | Description |
|---|---|
| void |
migrateSettingsRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.migrateSettingsRepo(newConfig);
retVal = baseAPI.doBootstrap_MigrateSettingsRepo(newConfig);
Entitlement: /admin/bootstrap
This method is used to migrate the top level Settings repository to a new config. This task takes place in the background, and once completed the config repository is switched to the new config. Any changes to config up to this point may be lost.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| newConfig | String |
Return value
| Type | Description |
|---|---|
| void |
getConfigRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
String retVal = bootstrapApi.getConfigRepo();
retVal = baseAPI.doBootstrap_GetConfigRepo();
Entitlement: /admin/main
Retrieve the current settings of the config repository.
Function Parameters
This function takes no parameters.
Return value
| Type | Description |
|---|---|
| String |
getSettingsRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
String retVal = bootstrapApi.getSettingsRepo();
retVal = baseAPI.doBootstrap_GetSettingsRepo();
Entitlement: /admin/main
Retrieve the current settings of the settings repository.
Function Parameters
This function takes no parameters.
Return value
| Type | Description |
|---|---|
| String |
getEphemeralRepo
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
String retVal = bootstrapApi.getEphemeralRepo();
retVal = baseAPI.doBootstrap_GetEphemeralRepo();
Entitlement: /admin/main
Retrieve the current settings of the ephemeral repository.
Function Parameters
This function takes no parameters.
Return value
| Type | Description |
|---|---|
| String |
restartBootstrap
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.restartBootstrap();
retVal = baseAPI.doBootstrap_RestartBootstrap();
Entitlement: /admin/bootstrap
After changing the definition of any bootstrap repository, Rapture will need to be restarted. This method will restart Rapture.
Function Parameters
This function takes no parameters.
Return value
| Type | Description |
|---|---|
| void |
addScriptClass
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
void retVal = bootstrapApi.addScriptClass(keyword, className);
retVal = baseAPI.doBootstrap_AddScriptClass(keyword, className);
Entitlement: /admin/bootstrap
All scripts that are run by Rapture are passed a set of helper instances that can be used by the script. The helpers are locked to the entitlement context of the calling user. This method sets the name of such a class in this context. It is primarily an internal function, defined during startup, as the class provided must be accessible by the main Rapture application.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| keyword | String | |
| className | String |
Return value
| Type | Description |
|---|---|
| void |
getScriptClasses
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
Map<String,String> retVal = bootstrapApi.getScriptClasses();
retVal = baseAPI.doBootstrap_GetScriptClasses();
Entitlement: /admin/bootstrap
This method retrieves previous defined script classes for this system
Function Parameters
This function takes no parameters.
Return value
| Type | Description |
|---|---|
| Map<String,String> |
deleteScriptClass
HttpBootstrapApi bootstrapApi = new HttpBootstrapApi(loginApi);
boolean retVal = bootstrapApi.deleteScriptClass(keyword);
retVal = baseAPI.doBootstrap_DeleteScriptClass(keyword);
Entitlement: /admin/bootstrap
This method removes a previously defined script class.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| keyword | String |
Return value
| Type | Description |
|---|---|
| boolean |