Complete the API-Portal Upgrade
1. Make sure the old API-Portal is shut down.
2. If you installed API-Portal 9.9 in a clustered, high-availability setup, make sure all nodes are running and accessible to the Zookeeper ensemble. Then register all the nodes with the parent node by invoking the REST service shown below. The default for the load balancer port is 18003.
Parameter | Value |
End point | http://load_balancer_host:load_balancer_port/acc/rest/nodes/ |
Method type | POST |
Content type | application/json |
Payload | {"nodename": "host_name", "hostname": "host_name", "port": "cloud_agent_port", "username": "Cloud", "password": "g3h31m“} |
3. Start the API-Portal 9.9 Cloud Controller.
4. Run this command:
acc> startall
5. Restore the old master tenant into API-Portal 9.9 from the backup file you created earlier.
9.7 upgrade: Run these commands:
acc> set acc config backup.restore.tenant.app.types = UMC
acc> restore tenant master from full_path_to_backup_file
username=your_user_name password=your_password
9.8 upgrade: Run these commands:
acc> set acc config backup.restore.tenant.app.types=ECP,ADS,UMC
acc> restore tenant master from full_path_to_backup_file
username=your_user_name password=your_password
6. Earlier in this guide, you generated a list of tenants in the old API-Portal. For each old tenant on the list except the default tenant and the master tenant, create a corresponding tenant in API-Portal 9.9 by running this command:
cmd> cd 9.9_Software_AG_directory\API_Portal\server\bin\work\
work_apiportalbundle_m\tools\bin
cmd> y-tenantmgmt.bat -s http://load_balancer_host:load_balancer_port
-t tenant_name createTenant -u your_user_name -p your_password
7. In the User Management Component at http://host:port/umc, import the license for each tenant you created.
8. In the API-Portal 9.9 Cloud Controller, run these commands:
acc> stop apiportalbundle_m
acc> start apiportalbundle_m
9. For each new tenant you created, restore the data for the corresponding old tenant into API-Portal 9.9 from the backup file you created earlier by running the commands below. Each file has the file extension .acb.
Important: | Inform API-Portal users that they cannot work on the tenants during the restoration process. |
Important: | If the new tenant contains any data, the data will be replaced by the data you restore from the old tenant. |
acc> set acc config backup.restore.tenant.app.types = UMC, ABS, ADS, ECP
acc> restore tenant tenant_name from full_path_to_backup_file
username=your_user_name password=your_password
10. Run these commands:
acc> stop apiportalbundle_m
acc> start apiportalbundle_m
11. If you created a customized view of your old API-Portal, you backed up the view. For instructions on restoring the customized view from the backup, see the backup and restore section in the webMethods API-Portal Customization Guide.
