Skip to main content

Project environment upgrade

Header

Level: Intermediate

Keywords: upgrade versions, project, local environment

The result: overview of the upgrading process for your project and local environment

This chapter describes all the steps needed for upgrading all software components of your project environment. For how to check your current software components version, see Debugging - Software components versions. The overview of SAMO Platform versions can be found in Lighthouse.

First of all, it is always better to try the upgrade at first on your local environment. Just after you are sure it is OK, apply this upgrade also on your server running project.

Try local environment upgrade​

  1. Update software components versions in localtron file

  2. Change the version of Dynamic-App components in package.json. You will find it directly under the gateway\clients folder (e.g. ...\samo-demo\gateway\clients\demo-dynamic-client.json) or in the environment.properties file in your project Gitlab repository. You can use semantic versioning to ensure automatic update (e.g. for bug fixes). Update the components in Gateway console. See step 8. in the Setting up local environment manual.

  3. In the Release notes, check what has changed in the new version since your previous version and update required parts (LIDS metadata, DB, GTW metadata, Dynamic-App metadata...).

Server environment upgrade​

  1. Commit and push updates in metadata (made based on the Release notes), including the change of required version of Dynamic-App components.

  2. (Only for packaged projects) Release new versions of packages and update package-lock.json. For more info see Using packages in project.

  3. Update the localtron file

  4. Update components versions in the .env file of corresponding environment in your Gitlab project repository.

Local environment upgrade after the server upgrade​

  1. Update your local clone of the project repository. Use Git pull, see: GIT commands.

  2. (Only for packaged projects) Update your local clone of the package repositories. Use Git pull, see: GIT commands.

  3. (Optional - required only in case that some of the packages, which you do not have referenced using pkg project link in your project environment configuration folder (e.g. samo-base), were updated) Reinstall your local project copy. Run pkg project-clear and pkg project-install -nl from your project environment folder.

  4. Run localtron run -u command from your project environment folder.

  5. Update your Dynamic-App components in the Gateway console. See step 8. in the Setting up local environment maual.