Contains unsupported experimental feature flags for future development.

Author: Prabhakar Kumar

gui/src/components/App/index.js

@@ -1,4 +1,4 @@
-// Copyright 2020-2022 The MathWorks, Inc.
+// Copyright 2020-2023 The MathWorks, Inc.
 
 import React, { useState, useCallback, useEffect, useMemo } from 'react';
 import { useSelector, useDispatch } from 'react-redux';
@@ -14,20 +14,22 @@ import Information from '../Information';
 import Help from '../Help';
 import Error from '../Error';
 import {
-  selectOverlayVisible,
-  selectFetchStatusPeriod,
-  selectHasFetchedServerStatus,
-  selectLicensingProvided,
-  selectMatlabUp,
-  selectError,
-  selectLoadUrl,
-  selectIsConnectionError,
-  selectHasFetchedEnvConfig,
-  selectAuthEnabled,
-  selectIsAuthenticated,
-  selectLicensingMhlmHasEntitlements,
-  selectIsEntitled,
-  selectLicensingInfo,
+    selectOverlayVisible,
+    selectFetchStatusPeriod,
+    selectHasFetchedServerStatus,
+    selectLicensingProvided,
+    selectMatlabUp,
+    selectError,
+    selectLoadUrl,
+    selectIsConnectionError,
+    selectHasFetchedEnvConfig,
+    selectAuthEnabled,
+    selectIsAuthenticated,
+    selectLicensingMhlmHasEntitlements,
+    selectIsEntitled,
+    selectLicensingInfo,
+    selectUseMOS,
+    selectUseMRE,
 } from "../../selectors";
 
 import {
@@ -56,17 +58,34 @@ function App() {
     const isAuthenticated = useSelector(selectIsAuthenticated)
     const authEnabled = useSelector(selectAuthEnabled);
     const licensingInfo = useSelector(selectLicensingInfo);
+    const useMOS = useSelector(selectUseMOS);
+    const useMRE = useSelector(selectUseMRE);
 
     const baseUrl = useMemo(() => {
-        const url = document.URL        
+        const url = document.URL
         return url.split(window.location.origin)[1].split('index.html')[0]
     }, [])
-    
-    const parseQueryParams = (url)  => {
+
+    const parseQueryParams = (url) => {
         const queryParams = new URLSearchParams(url.search);
         return queryParams;
     }
 
+    const fullyQualifiedUrl = useMemo(() => {
+        // Returns the Fully Qualified URL used to load the page.
+        const url = document.URL
+        let baseUrlStr = url.split('/index.html')[0]
+        return baseUrlStr;
+    }, [])
+
+    const htmlToRenderMATLAB = () => {
+        let theHtmlToRenderMATLAB = useMOS ? "index-matlabonlineserver.html" : 'index-jsd-cr.html'
+        if (useMRE) {
+            theHtmlToRenderMATLAB += `?mre=${fullyQualifiedUrl}`
+        }
+        return theHtmlToRenderMATLAB
+    }
+
     const toggleOverlayVisible = useCallback(
         () => dispatch(setOverlayVisibility(!overlayVisible)),
         [overlayVisible, dispatch]
@@ -137,42 +156,42 @@ function App() {
     // Periodic fetch server status
     useInterval(() => {
         dispatch(fetchServerStatus());
-    },  fetchStatusPeriod);
+    }, fetchStatusPeriod);
 
     // Load URL
-    useEffect(() => {      
+    useEffect(() => {
         if (loadUrl !== null) {
             window.location.href = loadUrl;
         }
     }, [loadUrl]);
 
     useEffect(() => {
         const queryParams = parseQueryParams(window.location);
-        const token = queryParams.get("mwi_auth_token");      
+        const token = queryParams.get("mwi_auth_token");
 
-        if(token){
-            dispatch(updateAuthStatus(token));              
+        if (token) {
+            dispatch(updateAuthStatus(token));
         }
-        window.history.replaceState(null, '', `${baseUrl}index.html`); 
+        window.history.replaceState(null, '', `${baseUrl}index.html`);
     }, [dispatch, baseUrl]);
-    
+
     // Display one of:
     // * Confirmation
     // * Help
     // * Error
     // * License gatherer
     // * License selector
     // * Status Information
-    let overlayContent;   
+    let overlayContent;
 
     if (dialog) {
         // TODO Inline confirmation component build
         overlayContent = dialog;
-    }    
+    }
     // Give precedence to token auth over licensing info ie. once after token auth is done, show licensing if not provided.
-    else if((!licensingProvided) && hasFetchedServerStatus && (!authEnabled || isAuthenticated)) {    
+    else if ((!licensingProvided) && hasFetchedServerStatus && (!authEnabled || isAuthenticated)) {
         overlayContent = <LicensingGatherer role="licensing" aria-describedby="license-window" />;
-    } 
+    }
     // Show license selector if the user has entitlements and is not currently entitled
     else if (hasEntitlements && !isEntitled) {
         overlayContent = <EntitlementSelector options={licensingInfo.entitlements} />;
@@ -192,19 +211,23 @@ function App() {
         </Overlay>
     ) : null;
 
+
     // FIXME Until https://github.com/http-party/node-http-proxy/issues/1342
     // is addressed, use a direct URL in development mode. Once that is
     // fixed, the request will be served by the fake MATLAB Embedded Connector
     // process in development mode
+
+    // MW Internal Comment: See g2992889 for a discussion on why a FQDN is required in the MRE parameter.
+    // MW Internal Comment: Using websocket on breaks some UI components : `./index-matlabonlineserver.html?websocket=on&mre=${fullyQualifiedUrl}`;
     const matlabUrl = process.env.NODE_ENV === 'development'
         ? 'http://localhost:31515/index-jsd-cr.html'
-        : './index-jsd-cr.html';
+        : `./${htmlToRenderMATLAB()}`;
 
     let matlabJsd = null;
-    if(matlabUp){
-        matlabJsd = (!authEnabled || isAuthenticated) 
-        ? ( <MatlabJsd url={matlabUrl} /> ) 
-        : <img style={{objectFit: 'fill'}}src={blurredBackground} alt='Blurred MATLAB environment'/> 
+    if (matlabUp) {
+        matlabJsd = (!authEnabled || isAuthenticated)
+            ? (<MatlabJsd url={matlabUrl} />)
+            : <img style={{ objectFit: 'fill' }} src={blurredBackground} alt='Blurred MATLAB environment' />
     }
 
     const overlayTrigger = overlayVisible ? null : <OverlayTrigger />;

gui/src/reducers/index.js

@@ -35,6 +35,26 @@ export function authEnabled(state = false, action) {
     }
 }
 
+// Stores information on whether to use MOS HTML while rendering MATLAB.
+export function useMOS(state = false, action) {
+    switch (action.type) {
+        case RECEIVE_ENV_CONFIG:
+            return action.config.useMOS;
+        default:
+            return state;
+    }
+}
+
+// Stores information on whether to provide MRE parameter to HTML while rendering MATLAB.
+export function useMRE(state = false, action) {
+    switch (action.type) {
+        case RECEIVE_ENV_CONFIG:
+            return action.config.useMRE;
+        default:
+            return state;
+    }
+}
+
 // Stores status of token authentication.
 export function authStatus(state = false, action) {
     switch (action.type) {
@@ -251,7 +271,7 @@ export function envConfig(state = null, action) {
         case RECEIVE_ENV_CONFIG:
             // Token authentication info is also sent as a response to /get_env_config endpoint.
             // As its already stored in 'authStatus', 'authEnabled' and 'authToken', ignoring it in envConfig.
-            const { authStatus, authEnabled, ...envConfig } = action.config
+            const { authStatus, authEnabled, useMOS, useMRE, ...envConfig } = action.config
             return envConfig
         default:
             return state;
@@ -284,4 +304,6 @@ export default combineReducers({
     error,
     envConfig,
     authInfo,
+    useMOS,
+    useMRE,
 });

gui/src/selectors/index.js

@@ -15,6 +15,8 @@ export const selectError = state => state.error;
 export const selectAuthEnabled = state => state.authInfo.authEnabled;
 export const selectAuthToken = state => state.authInfo.authToken;
 export const selectIsAuthenticated = state => state.authInfo.authStatus === true;
+export const selectUseMOS = state => state.useMOS === true;
+export const selectUseMRE = state => state.useMRE === true;
 
 export const selectTriggerPosition = createSelector(
     state => state.triggerPosition,

matlab_proxy/app.py

@@ -152,6 +152,9 @@ async def get_env_config(req):
     config = state.settings["env_config"]
     config["authEnabled"] = state.settings["mwi_is_token_auth_enabled"]
 
+    config["useMOS"] = mwi_env.Experimental.should_use_mos_html()
+    config["useMRE"] = mwi_env.Experimental.should_use_mre_html()
+
     # In a previously authenticated session, if the url is accessed without the token(using session cookie), send the token as well.
     config["authStatus"] = True if await token_auth.authenticate_request(req) else False
     return web.json_response(config)

matlab_proxy/app_state.py

@@ -679,6 +679,18 @@ async def __setup_env_for_matlab(self) -> dict:
         # The mwi_logs_dir is where MATLAB will write any subsequent logs
         matlab_env["MATLAB_LOG_DIR"] = str(self.mwi_logs_dir)
 
+        # Set MW_CONNECTOR_CONTEXT_ROOT for MPA
+        if mwi_env.Experimental.is_mpa_enabled():
+            matlab_env["MW_CONNECTOR_CONTEXT_ROOT"] = self.settings.get("base_url", "/")
+            logger.info(
+                f"MW_CONNECTOR_CONTEXT_ROOT is set to: {matlab_env['MW_CONNECTOR_CONTEXT_ROOT']}"
+            )
+
+        # Setup Simulink Online which requires a pre-warm stage
+        if mwi_env.Experimental.is_simulink_enabled():
+            logger.info("Enabling usage of Simulink Online...")
+            matlab_env["PREWARM_SIMULINK"] = "true"
+
         # Env setup related to logging
         # Very verbose logging in debug mode
         if logger.isEnabledFor(logging.getLevelName("DEBUG")):

matlab_proxy/settings.py

@@ -369,6 +369,14 @@ def get_matlab_settings():
             f"Set {mwi_env.get_env_name_custom_matlab_root()} to a valid MATLAB root path"
         )
 
+    mpa_flags = (
+        mwi_env.Experimental.get_mpa_flags()
+        if mwi_env.Experimental.is_mpa_enabled()
+        else ""
+    )
+    profile_matlab_startup = (
+        "-timing" if mwi_env.Experimental.is_matlab_startup_profiling_enabled() else ""
+    )
     return {
         "matlab_path": matlab_root_path,
         "matlab_version": matlab_version,
@@ -377,7 +385,10 @@ def get_matlab_settings():
             "-nosplash",
             *flag_to_hide_desktop,
             "-softwareopengl",
+            # " v=mvm ",
             *matlab_lic_mode,
+            *mpa_flags,
+            profile_matlab_startup,
             "-r",
             f"try; run('{matlab_startup_file}'); catch ME; disp(ME.message); end;",
         ],