OAuth Token Migration FAQs

Q: How do you find the username and password for MySQL?

A: In your ML 4.x installation, you can find the password for the user mashclient from /etc/mashery-system.conf: 
"client":
{"password":"XXXXXXXXXXXX","user":"mashclient"},

A: Yes. Each time it runs, it will pick all tokens created or updated after the last run of the utility. The utility maintains a journal entry of last-processed tokens.

Q: When do I need to use FILE as an intermediary to migrate tokens between Mashery Local 4.1 and Mashery Local 5.1?

Environments may exist where it is not possible to talk to the MySQL database from the Mashery Local 5.1 Cluster Manager container. Therefore, it is advised to do the migration in 2 steps:
  1. Migrate Mashery Local 4.X MySQL to FILE.
  2. Migrate FILE to Mashery Local 5.1 Cassandra.

Q: How do you migrate tokens with the least downtime?

A: To achieve near-zero downtime:
  1. Run the utility once to migrate all known tokens.
  2. Run the utility again, right before the switching the traffic from Mashery Local 4.x to Mashery Local 5x to migrate tokens generated after the run in Step 1.
  3. Run the utility right after the switch to migrate tokens generated after run in step 2.