Troubleshooting Backup and Restore Failures
In case the back up or restore process fails, check whether all components are running. To do so, use API-Portal Cloud Controller (ACC).
To troubleshoot backup and restore failures
1. Check whether all components are running using ACC.
a. To start ACC under a Windows operating system click Start > All Programs > webMethods API-Portal > Administration > Start webMethods API-Portal Cloud Controller.
To start ACC under a Linux operating system, run the acc.sh file. ACC is available if you have copied and installed the files aris-acc_1.0.0-SNAPSHOT_amd64.deb or aris-cloud-agent-1.0.0-1.x86_64.rpm depending on the Linux operating system.
b. Type help or help <command> to get information about the usage of the commands.
c. Type list to monitor the status of all components (runnables). This example shows ACC of a API-Portal Connect Server installation for a medium number of users.
All Components with their states are listed.
ACC+ arisserver>list
7 installed runnables.
apiportalbundle_m :STARTED com.aris.runnables.apiportal_m
-run-prod-1.0.0-RC17-Trunk-SNAPSHOT)
zoo_m : STARTED (com.aris.runnables.zookeeper-
run-prod-1.0.0-RC17-Trunk-SNAPSHOT)
postgres_m : STARTED (com.aris.runnables.PostgreSQL-
run-prod-1.0.0-RC17-Trunk-windows-SNAPSHOT)
couchdb_m : STARTED (com.aris.runnables.couchdb-
run-prod-1.1.1-RC17-Trunk-windows-SNAPSHOT)
cloudsearch_m : STARTED (com.aris.cip.y-cloudsearch-
run-prod-3.0.0-RC26-Trunk-SNAPSHOT)
elastic_m : STARTED (com.aris.runnables.elasticsearch-
run-prod-1.0.0-RC17-Trunk-SNAPSHOT)
loadbalancer_m : STARTED (com.aris.runnables.httpd.httpd-
run-prod-1.0.0-RC17-Trunk-windows-SNAPSHOT)
ACC+ arisserver>
The status of all components represented by their instance IDs are listed. Possible states are:
UNKNOWNThe component state is not yet known. This state is shown directly after the agent was started.
STOPPED The component is currently not running.
STARTING The component is starting, but this process is not complete yet.
STARTED The component is running.
STOPPING The component is stopping, but this process is not complete yet.
DOWN This component has and crashed. The agent will attempt to automatically restart the component momentarily.
FAILED Component has crashed. The agent has given up trying to restart the component.
2. Perform the following preliminary task in a distributed environment using the ACC REST service
Post a http request to http://loadbalancer_host:loadbalancer_port/acc/rest/nodes/ with payload:
Your system is now ready to start the backup or restore operation.
3. Start the backup or restore operation using a configuration file.
a. Stop the component work_apiportalbundle_m through ACC using the Stop work_apiportalbundle_m command.
b. Edit the file in the path <Installation directory>\API-Portal\server\bin\work\work_apiportalbundle_m\base\webapps\abs\WEB-INF\config\spring\ext\apiportal-servlet.xml.
c. Add the new entry for the distributed ACC server host and port in the bean section.
d. Restart the component work_apiportalbundle_m through ACC using the Start work_apiportalbundle_m command.
Your system is now ready for the backup or restore operation.
