Hi, 

I try to find how I can move my configured TECHMOBILE APP between environments.

Probably there is a guide somewhere but i cannot find it. 

Hi Patrik,

In my opinion there are two areas that need to be mentioned when we are talking about custom changes in Maximo Mobile and how to migrate them between environments.

1. Where to keep custom changes:
   According to the best practices all the files that were customized, for example, app.xml and AppCustomizations.js should be stored in file repository (for example git/svn). There are lots of advantage using file repository, for example, will secure you not to lose changes during dev work, when you select by mistake re-download option in MAF.
2. How to move custom changes between environments:
   Using the MAF you can connect to any environments, then copy the files from your file repository to the src folder (please review how folder structure looks in your computer that is used as volumes for docker container, you will see that for each users and environments MAF is creating separate folders structures.) and then you can publish the app using MAF. You could also a little bit automatise this process by creating tool that will take care of copy the files from your repository to the correct src folders.
   Another way is to create separate docker containers for each environments (but still copy the files form file repository to src folder) especially that there is one docker container parameter that should be set to 1 when you publish application for PROD. I thinking about GRAPHITE_RELEASE parameter.
   Information from IBM document: "You can use the GRAPHITE_RELEASE parameter to reduce the size of the application package that you publish back to the Maximo® Manage server."

To keep it really simple.

1) Copy the all the changed files (like app.xml) into Notepad++ or some editor.

2) Stop and Start Docker (just to make sure that there is no "old stuff" running)

3) Log in on the next environment with your credentials (we use API keys).

4) Open the TechMobile app. 

5) Paste all the files from Notepad into Docker (like app.xml)

6) Press Publish...

The discussions around source control and all that are critical, especially if you promote things at different times. For example, if you have feature A only in DEV but want to promote feature B from DEV to PROD, you need to go through the traditional source control process and merge in the appropriate things. If you have different versions of Maximo Mobile, then you need to build the appropriate version of the app. 

However, if you're trying to do a full promotion of the application changes from say your QA environment to your production environment, there is another option. Inside your local workspace, in the folder structure like: USER-ENVIRONMENT\APPNAME\build\app\build is going to be a zip after you build the application. For example, my custom app is named SCOINSPECTION and inside that folder I'll see a zip like SCOINSPECTION__ver-8.11.0.0.zip. That zip is the generated zip that gets uploaded to Maximo. You could also fetch this zip from Maximo if you weren't the one to build it.

Then you can make a POST request in a tool like Postman. 
Method: POST
URL: /maximo/api/os/OSLCMAFAPPDATA?appid=SCOINSPECTION&action=wsmethod:uploadFile&version=8.11.0.0

The body would be set to binary and you'd select the zip from earlier.

That will upload the exact copy of your QA application to PROD. There is nothing in this zip that is environment specific (out of the box at least) so you can safely promote it without making any changes to it. 

You would still follow the normal processes for cloning in each environment to ensure that the security templates, applications, menu entries, etc. are created. 

Hi @Steven Shull

Thanks, interesting information about zip file and REST call.