Migrate data in ColdFusion API Manager

Migrate data in ColdFusion API Manager

After you install API Manager, stop Redis, and follow the steps below:

  1. Copy the file <apim_root>/database/datastore/dump.rdb from the old API Manager installation to the new one.

    If you have made any changes to the datastore, confirm the location of dump.rdb by running the command below:

    CONFIG GET dir

    The name of the .rdb file is in the following entry in the Redis config at <apim_root>/database/datastore/redis.conf.properties.

    dbfilename dump.rdb

  2. Ensure that the name of the cluster in the new API Manager installation has the same name as the old installation.

    In the Analytics server, in the config file at <apim_root>/database/analytics/config/elasticsearch.yml, set the property below:

    cluster.name: groot-elasticsearch

    In the API Manager installation, this value should be set to match the value in the older API Manager installation. The setting is located in the config file at <apim_root>/conf/default_conf.xml, as shown below:

    <elastic>

                    <clusterName>groot-elasticsearch</clusterName>

    </elastic>

    Also, make sure that the cluster names in the two config files are the same.

  3. API Manager uses a seed for encryption purposes (like API keys, client credentials, and so on). This seed is stored in <apim_root>/lib/seed.properties.

    Copy the seed from old the API Manager installation to the new one.

  4. If you are using using the SAML feature for authentication in your APIM installation, copy the SAML service provider keystore file (<apim_root>/conf/samlspcerts.jks) from the old API Manager instance to new one.

    Add the following SAML config detail in the security section of the apim config file at <apim_root>/conf/config.xml.

    <security>
                   <seed ref="${sys:apim.home}/conf/seed.properties"/>
    <keystore>
    <path>C:\work\depot\ColdFusion\groot\main\conf\samlspcerts9098711651914958960.jks</path>
    <type>JKS</type>
        <password>password</password>
        <samlspalias>ampserviceprovider</samlspalias>
        <samlspkeypassword>samlspkeypassword</samlspkeypassword>
    </keystore>
    </security>
    
  5. API Manager, by default, uses AOF logging.

    Set it to no by modifying the following setting in <apim_root>/database/datastore/redis.conf.properties file:

    appendonly no

    This force loads the data from the .rdb file on startup. Once the data is loaded into the memory, ensure that you change it back to yes in the config file.

    You can set it at runtime as well, using redis-cli with the following command:

    CONFIG SET appendonly yes

Get help faster and easier

New user?