How can I update the credentials for the MATLAB Web App Server service accounts?

I have previously configured my MATLAB Web App Server to run the server and apps services using particular user accounts. Now, I need to update the account credentials (i.e. password) associated with these accounts. How can I do this?

Answer 1

[MathWorks Support Team]

The following steps can be used to change the account used by the MATLAB Web App Server services, or to update the passwords used by these services following a password reset (to change or reset the password for a user account, refer to your OS's documentation). Note that MATLAB Web App Server uses two services, one for the server and one for individual app sessions.

 

On the development version of MATLAB Web App Server

If you are using the development version of Web App Server, you can update the credentials for the MATLAB Web App Server services by unregistering the current services in the Service Registration tab and re-registering with new credentials.

 

On the product version of MATLAB Web App Server

Prerequisites:

• These steps assume that you have already updated the credentials for the accounts used by MATLAB Web App Server. For example, on Windows you can use the netplwiz tool to set a new password for the default server and worker accounts following a password expiry.
• If you are changing the account used by the server or worker services, ensure that the new account has the correct permissions on all folders described in this documentation. You can refer to permissions for the existing accounts for guidance on the correct configuration.

On Windows:

To change the existing MATLAB Web App Server account credentials on Windows:

1. Stop the MATLAB Web App Server.
2. Open the Windows "Services" application.
3. Find the server and apps services as per this documentation.
4. Right-click the service and select Properties.
5. Under "Log On" tab, select "This Account." Update the user credentials  for both services and save your changes.
6. [If changing both user and password]: Delete or rename the USR folder (located in %ProgramData%\MathWorks\webapps\R202Xx\USR). This folder may be hidden by default. 
7. Start the MATLAB Web App Server. 
   1. If the first restart attempt fails, confirm that all services are stopped before running webapps-start again. 

These steps can be used for both the development and the product versions of MATLAB Web App Server.

 

On Linux/macOS:

Note that on Unix systems, you do not need to update the credentials for the services following a password change/reset. The following steps are only necessary when changing the specific account used to run the services (for example, to set the services to run using a domain account instead of a local account).

To change the MATLAB Web App Server accounts on Linux/macOS (product version only):

1. Stop the MATLAB Web App Server.
2. Run ./webapps-config get and copy the output to a text file.
3. Run ./webapps-uninstall to unregister the existing accounts.
4. Run ./webapps-setup to set up the server again, specifying the new accounts you would like to use when prompted.
5. Use ./webapps-config set to set up any additional configurations as per the output from (2). Note that the contents of your previous config folder have been moved to a new folder named config_backup in the same location.
6. Start the MATLAB Web App Server.