Here we state the basic steps to migrate to Oasis V2 in your product and how to test it locally.

1. Update base libraries

npm i @oasis/system@^1.0.1 @oasis/security@^2.0.9 @oasis/masiv-navigators@^2.0.19

⚠️ If your product uses file preview, you must use file preview ≥ 1.2.35

It’s not necessary to update Aqua or Language library.

2. Configure libraries

• Configure Security V2 following the guide: ‣ o Oasis Security V2 - Update the render function
• Masiv Navigators and other libraries don’t need extra configuration.

3. Run your product locally

❗Remove this code when deploying to production

This step will help you run your product locally by automatically logging in to Oasis. Please remove this code when deploying to production or whenever you don’t want to authenticate automatically.

// main.js
...

// Add the login credentials
// of the environment you're pointing to
const login = {
  user: 'username',
  pass: 'password',
};

// Add localConfig attribute and pass the login credentials
// **Remove the localConfig property when deploying to production**
Vue.use(OasisSecurity, { store, initialize: true, localConfig: login });

ℹ️ HINT Once you run your product locally in the browser and it does the login successfully, you can remove the localConfig property from the main.js since the session cookies have been created

Migrated products