API Connect

API Connect

Join this online group to communicate across IBM product users and experts by sharing advice and best practices with peers and staying up to date regarding product enhancements.

 View Only
  • 1.  AMU Tool for Migration APICv5 to APICv10.

    Posted Thu November 03, 2022 03:51 PM

    Hello team how are you,

    I am coming to you for support, as I want to understand how to use IBM's AMU tool for migrations from APICv5 to APICv10. In my case I have an APICv10 environment over Openshift on IBM Cloud (ROKs), which works quite well, & i want to test how to use this tool.

    I understand that to run it it is required to have a backup of an APICv5 & I have obtained a: v5extract.e2e.121420.tar.gz to test a migration, but I don't know how to start.

    If you could share a step by step on how to do this exercise and understand it in passing, it would be excellent.

    Thanks friends.

    CESAR GUERRA



    ------------------------------
    Cesar Ricardo Guerra Arnaiz
    ------------------------------


  • 2.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Thu November 03, 2022 04:48 PM

    Hello Cesar, 

    I escalated your question to our team and they have sent the following instructions from the knowledge center: Migrating a Version 5 deployment - you will be able to find the instructions you need to make the migration, just change it to the specific version that you are migrating to. 

    Please let me know if you have any other questions and we will be happy to help!



    ------------------------------
    Gabriel Marte Blanco
    Austin TX
    ------------------------------



  • 3.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Thu November 03, 2022 05:58 PM
      |   view attached

    Hello, thank you very much for answering,

    In my case these are the steps I have done:

    1_ I have the apic-migrate-utility downloaded locally and installed.

    2_ I understand a test Backup called: apic6-2019-01-08.tar.gz

    3_ I have these URLs that I have taken from my Cloud Manager of my APIC working in ROKs.

    * https://ins-apic-0-1be6f0a5-portal-director-cp4i.cluster-test-banco-popula-ccc03eca20d26e6ac64511f874a64b9b-0000.us-south.containers.appdomain.cloud


    * https://ins-apic-0-1be6f0a5-portal-web-cp4i.cluster-test-banco-popula-ccc03eca20d26e6ac64511f874a64b9b-0000.us-south.containers.appdomain.cloud

    4_ I have performed the Extract locally from the APICv5 DB like this:

    $ cd C:\AMU
    $ apicm archive:unpack apic6-2019-01-08.tar.gz --accept-license --saveErrorLog=ErrorLog-unpack.log --saveInfoLog=InfoLog-unpack.log

    5_ Then, I validate that the directories of the extracted APIC Components are generated (starting with the Provider Organization).

    6_ Finally, I am wanting to Remotely Upload ROKs from the Consuming Organization and its content:

    $ apicm archive:push https://ins-apic-0-1be6f0a5-portal-director-cp4i.cluster-test-banco-popula-ccc03eca20d26e6ac64511f874a64b9b-0000.us-south.containers.appdomain.cloud C:\AMU\cloud\provider-orgs\chandrikas-org --saveErrorLog=ErrorLog-push-admin-org.log --saveInfoLog=InfoLog-push-admin-org.log --apigw-only 

    But I haven't been able to, I don't know if between each of the steps I've done I have to do additional steps (I think so), but I would like you to help me with it.

    Thanks.

    CESAR GUERRA



    ------------------------------
    Cesar Ricardo Guerra Arnaiz
    ------------------------------

    Attachment(s)

    gz
    apic6-2019-01-08.tar.gz   3.12 MB 1 version


  • 4.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Thu November 03, 2022 08:42 PM

    Complementing the above according to this graph, these 3 steps are the ones that I would not have done & that I do not know what to do.

    Apparently I went from UNPACK to PUSH straight away.

    Due to this, I ask for your support to complete my missing steps that I do not understand how to do.

    Thanks.




    ------------------------------
    Cesar Ricardo Guerra Arnaiz
    ------------------------------



  • 5.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Mon November 07, 2022 08:33 AM

    Some idea about this ?, 

    Thanks.



    ------------------------------
    Cesar Ricardo Guerra Arnaiz
    ------------------------------



  • 6.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Mon November 07, 2022 02:15 PM
    Hi,
    everything is explained in the KC (previously you had the runbook).

    Version Migration - IBM Documentation - Includes the detailed procedures, best practices and commands to complete your migration. This includes all the detailed command explanations & troubleshooting advice previously found in the separate runbook.  Now all doc is in one location.

    what is not clear?

    cheers,
    Jeroen

    ------------------------------
    jeroen willems
    ------------------------------



  • 7.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Tue November 08, 2022 05:11 PM

    Hi Cesar,

    The unpack will create a cloud folder with v5 artifacts.  If you push at this point, you would need to push to a v5 compatible gateway in v10.  If you wish to use the v10 API Gateway, then you will need to run the archive:port-to-apigw step.  This will create *-apigw artifacts which will be used in the push if you indicate to only use apigw artifacts.  What in the instructions isn't clear?

    Regards,
    Steve Linn



    ------------------------------
    Steve Linn
    Senior Consulting I/T Specialist
    IBM
    ------------------------------



  • 8.  RE: AMU Tool for Migration APICv5 to APICv10.

    Posted Thu November 03, 2022 09:31 PM
    Edited by manoj dusa Thu November 03, 2022 09:46 PM

    Original Message:
    Sent: Thu November 03, 2022 03:51 PM
    From: Cesar Ricardo Guerra Arnaiz
    Subject: AMU Tool for Migration APICv5 to APICv10.

    Hello team how are you,

    I am coming to you for support, as I want to understand how to use IBM's AMU tool for migrations from APICv5 to APICv10. In my case I have an APICv10 environment over Openshift on IBM Cloud (ROKs), which works quite well, & i want to test how to use this tool.

    I understand that to run it it is required to have a backup of an APICv5 & I have obtained a: v5extract.e2e.121420.tar.gz to test a migration, but I don't know how to start.

    If you could share a step by step on how to do this exercise and understand it in passing, it would be excellent.

    Thanks friends.

    CESAR GUERRA



    ------------------------------
    Cesar Ricardo Guerra Arnaiz
    ------------------------------