When a user is established to the user registry used for the CMC, APIM, or Dev Portal Site, you cannot remove. Therefore, you will have to completely destroy and re-build. Until the RFE: Changing the user registry or owner is put into place, the way to change an established user registry will be to clean out the config (for cmc/apim) or create a new catalog (for dev portal site).
Please vote for this RFE: https://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe&CR_ID=94672
A “system clean apiconfig” means you will lose all your configured topology, organizations, Products, and API configurations from the management server.
Therefore, you must ensure the following before executing the command:
- 1. backup all your Products and APIs (this document will go over how to do that)
- 2. ensure a backup of the management server is made just in case you need to revert back for any reason
- 3. ensure that the portal server sites are all backed up
- 4. must have the networking details (IP, netmask, gateway, etc) of the previous management server because this will be re-configured
- 5. ensure your have a screen shot of the members and organizations the cmc currently contains
- 6. ensure that all the certificates you have set up in the TLS profile is available because they will have to be recreated
NOTICE: If you already have LDAP set as the user registry, and only need to update parameters in the user registry, this may be done with the exception that the Prefix and Suffix may not be changed; the other LDAP parameters may be changed.
Backup Products and APIs (WebUI)
Note: If you have a few Products and APIs, using the WebUI method is fine, but the APIC Toolkit can pull all your Products and APIs in bulk.
Please see the next section for the APIC Toolkit method to pull the Products and APIs in bulk.
- If you have your management servers in HA, ensure you take the exports from the primary server. To find out which is the primary server, log into the mgmt server and issue the ha list command.
- If you have multiple provider organizations, ensure you create a folder on your local system to store these backups so you know which Products and APIs below to which provider organization.
1. Log into your APIM environment (https://<APIC_Mgmt_Svr_URL>/apim).
2. Navigate to the Product you would like to export.
3. Click on the upper right vertical ellipsis icon and select Download:
2. Issue apic drafts:clone -s <your_APIC_URL> -o <your_Provider_Organization_Name_NOT_the_Display_Name> to download all the Products and APIs in the selected provider organization. NOTICE: You may get a false error message noting that you do not have permission if you enter in the organization name incorrectly, ensure that you have not input the display name.
Note: -s is for server, -o is for organization