diff --git a/.github/workflows/README-from-matlab-docker.md b/.github/workflows/README-from-matlab-docker.md index e4306fd..3521124 100644 --- a/.github/workflows/README-from-matlab-docker.md +++ b/.github/workflows/README-from-matlab-docker.md @@ -24,6 +24,6 @@ This workflow consists of the following steps: --- -Copyright (c) 2023 The MathWorks, Inc. All rights reserved. +Copyright 2023 The MathWorks, Inc. All rights reserved. --- diff --git a/.github/workflows/README-matlab-installer.md b/.github/workflows/README-matlab-installer.md index c49fde0..c87a512 100644 --- a/.github/workflows/README-matlab-installer.md +++ b/.github/workflows/README-matlab-installer.md @@ -25,6 +25,6 @@ This workflow consists of the following steps: --- -Copyright (c) 2023 The MathWorks, Inc. All rights reserved. +Copyright 2023 The MathWorks, Inc. All rights reserved. --- diff --git a/.github/workflows/build-test-publish.yml b/.github/workflows/build-test-publish.yml index 9815195..dc55bdd 100644 --- a/.github/workflows/build-test-publish.yml +++ b/.github/workflows/build-test-publish.yml @@ -26,7 +26,7 @@ jobs: strategy: fail-fast: false matrix: - matlab-release: [r2023a, r2022b, r2022a, r2021b, r2021a, r2020b] + matlab-release: [r2023b, r2023a, r2022b, r2022a, r2021b, r2021a, r2020b] steps: - name: Checkout repo diff --git a/.github/workflows/from-matlab-docker-build-test.yml b/.github/workflows/from-matlab-docker-build-test.yml index de1c35c..e47a0bb 100644 --- a/.github/workflows/from-matlab-docker-build-test.yml +++ b/.github/workflows/from-matlab-docker-build-test.yml @@ -27,7 +27,7 @@ jobs: strategy: fail-fast: false matrix: - matlab-release: [r2023a, r2022b, r2022a] + matlab-release: [r2023b, r2023a, r2022b, r2022a] steps: - name: Checkout repo diff --git a/Dockerfile b/Dockerfile index 10cfc25..0e57dc1 100644 --- a/Dockerfile +++ b/Dockerfile @@ -4,15 +4,15 @@ # install, and the location at which to install MATLAB. # Here is an example docker build command with the optional build arguments. -# docker build --build-arg MATLAB_RELEASE=r2023a +# docker build --build-arg MATLAB_RELEASE=r2023b # --build-arg MATLAB_PRODUCT_LIST="MATLAB Deep_Learning_Toolbox Symbolic_Math_Toolbox" -# --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab/R2023a" +# --build-arg MATLAB_INSTALL_LOCATION="/opt/matlab/R2023b" # --build-arg LICENSE_SERVER=12345@hostname.com # -t my_matlab_image_name . # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument. # Use lowercase to specify the release, for example: ARG MATLAB_RELEASE=r2021b -ARG MATLAB_RELEASE=r2023a +ARG MATLAB_RELEASE=r2023b # Specify the list of products to install into MATLAB. ARG MATLAB_PRODUCT_LIST="MATLAB" diff --git a/LICENSE.md b/LICENSE.md index 9b684ab..72dedbc 100644 --- a/LICENSE.md +++ b/LICENSE.md @@ -4,7 +4,7 @@ The files in this GitHub repository refer to commercial software products and se The following license terms apply only to the files in this GitHub repository, including files in this folder and its subfolders, and do not apply to MathWorks Programs. References to “software” and “code” in the following license terms refer to the files in this GitHub repository. -Copyright (c) 2020, The MathWorks, Inc. +Copyright 2020, The MathWorks, Inc. All rights reserved. diff --git a/MPM.md b/MPM.md index 94a08c2..e734038 100644 --- a/MPM.md +++ b/MPM.md @@ -34,24 +34,24 @@ For the MATLAB Dependencies, refer to `base-dependencies.txt` files in the [MATL ### Install MATLAB, Simulink, and Additional Products -To install MATLAB R2023a, Simulink, and Signal Processing Toolbox to the default folder, navigate to the folder containing the `mpm` binary file and run the following command. +To install MATLAB R2023b, Simulink, and Signal Processing Toolbox to the default folder, navigate to the folder containing the `mpm` binary file and run the following command. - ./mpm install --release=R2023a --products MATLAB Simulink Signal_Processing_Toolbox + ./mpm install --release=R2023b --products MATLAB Simulink Signal_Processing_Toolbox You can install further products later. For example, add Robotics System Toolbox to the MATLAB installation. - ./mpm install --release=R2023a --products Robotics_System_Toolbox + ./mpm install --release=R2023b --products Robotics_System_Toolbox ### Install MATLAB and Specify Installation Options -Install MATLAB R2023a, specifying these installation options: +Install MATLAB R2023b, specifying these installation options: - Set the installation destination folder to `/home/username/matlab`. - Install Parallel Computing Toolbox without the GPU libraries. ``` -./mpm install --release=R2023a --destination=/home/username/matlab --products MATLAB Parallel_Computing_Toolbox --no-gpu +./mpm install --release=R2023b --destination=/home/username/matlab --products MATLAB Parallel_Computing_Toolbox --no-gpu ``` Download a documentation ISO from [Install Documentation on Offline Machines](https://www.mathworks.com/help/install/ug/install-documentation-on-offline-machines.html) and mount the ISO. Install the documentation and examples, specifying the MATLAB installation folder and the path to the mounted ISO. @@ -67,7 +67,7 @@ Download a documentation ISO from [Install Documentation on Offline Machines](ht ## Installation Options | Option | Description | Example | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ | -| `--release` | Software version to install. This option supports releases and updates. To install the latest version of a release, specify the release version (for example, `R2022b`). To install a specific update release, specify the release version with an update number suffix (for example, `R2022bU4`). To a version without updates, specify the release version with an update 0 or general release suffix (for example, `R2022bU0` or `R2022bGR`). | `R2023a`, `R2022bU2`, `R2022GR` | +| `--release` | Software version to install. This option supports releases and updates. To install the latest version of a release, specify the release version (for example, `R2023b`). To install a specific update release, specify the release version with an update number suffix (for example, `R2023bU4`). To a version without updates, specify the release version with an update 0 or general release suffix (for example, `R2023bU0` or `R2023bGR`). | `R2023b`, `R2023bU2`, `R2023bGR` | | `--products` | List of products to install, specified as product names separated by spaces. MATLAB Package Manager can install most MathWorks products. For the full list of correctly formatted product names, download the [MathWorks Product Installer](https://www.mathworks.com/help/install/ug/install-noninteractively-silent-installation.html) and refer to the `installer_input.txt` file included in it. Alternatively, see [Products and Services](https://www.mathworks.com/products.html) for product names in the current MATLAB release and replace spaces in names with underscores. For more information on which products MATLAB Package manager can not install, see [Limitations](#limitations). | `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer` | | `--destination` | Full path to the desired installation folder. Defaults to `/usr/share/matlab` if unset. | `/path/to/destination` | | `--source` | Full path to downloaded product files (optional). MATLAB Package Manager downloads the product files if unset. | `/path/to/source` | diff --git a/README.md b/README.md index 30fe249..0136787 100644 --- a/README.md +++ b/README.md @@ -27,14 +27,14 @@ cd matlab-dockerfile Build container with a name and tag of your choice. ```bash -docker build -t matlab:r2023a . +docker build -t matlab:r2023b . ``` Run the container. Test the container by running an example MATLAB command such as ver. ```bash -docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2023a -batch ver +docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2023b -batch ver ``` -The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/Dockerfile) defaults to building a container for MATLAB R2023a. +The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/Dockerfile) defaults to building a container for MATLAB R2023b. The example command `ver` displays the version number of MATLAB and other installed products. For more information, see [ver](https://www.mathworks.com/help/matlab/ref/ver.html). For more information on running the container, see the section on [Running the Container](#run-the-container). @@ -57,9 +57,9 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma | Argument Name | Default value | Description | |---|---|---| -| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2023a | The MATLAB release you want to install, in lower-case. For example: `r2019b`| +| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2023b | The MATLAB release you want to install, in lower-case. For example: `r2019b`| | [MATLAB_PRODUCT_LIST](#build-an-image-with-a-specific-set-of-products) | MATLAB | Products to install as a space-separated list. For more information, see [MPM.md](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/main/MPM.md). For example: `MATLAB Simulink Deep_Learning_Toolbox Fixed-Point_Designer`| -| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/r2023a | The path to install MATLAB. | +| [MATLAB_INSTALL_LOCATION](#build-an-image-with-matlab-installed-to-a-specific-location) | /opt/matlab/r2023b | The path to install MATLAB. | | [LICENSE_SERVER](#build-an-image-with-license-server-information) | *unset* | The port and hostname of the machine that is running the Network License Manager, using the `port@hostname` syntax. For example: `27000@MyServerName` | Use these arguments with the the `docker build` command to customize your image. @@ -74,13 +74,13 @@ docker build --build-arg MATLAB_RELEASE=r2019b -t matlab:r2019b . #### Build an Image with a specific set of products For example, to build an image with MATLAB and Simulink, use this command. ```bash -docker build --build-arg MATLAB_PRODUCT_LIST='MATLAB Simulink' -t matlab:r2023a . +docker build --build-arg MATLAB_PRODUCT_LIST='MATLAB Simulink' -t matlab:r2023b . ``` #### Build an Image with MATLAB installed to a specific location For example, to build an image with MATLAB installed at /opt/matlab, use this command. ```bash -docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t matlab:r2023a . +docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t matlab:r2023b . ``` #### Build an Image with License Server Information @@ -88,10 +88,10 @@ docker build --build-arg MATLAB_INSTALL_LOCATION='/opt/matlab' -t matlab:r2023a Including the license server information with the `docker build` command means you do not have to pass it when running the container. ```bash # Build container with the License Server. -docker build --build-arg LICENSE_SERVER=27000@MyServerName -t matlab:r2023a . +docker build --build-arg LICENSE_SERVER=27000@MyServerName -t matlab:r2023b . # Run the container, without needing to pass license information. -docker run --init --rm matlab:r2023a -batch ver +docker run --init --rm matlab:r2023b -batch ver ``` ## Use the Network License Manager @@ -124,7 +124,7 @@ With the `docker build` command, either: ```bash # Example - docker build -t matlab:r2023a --build-arg LICENSE_SERVER=27000@MyServerName . + docker build -t matlab:r2023b --build-arg LICENSE_SERVER=27000@MyServerName . ``` - Use the `network.lic` file: 1. Place the `network.lic` file in the same folder as the Dockerfile. @@ -133,13 +133,13 @@ With the `docker build` command, either: ```bash # Example - docker build -t matlab:r2023a . + docker build -t matlab:r2023b . ``` With the `docker run` command, use the `MLM_LICENSE_FILE` environment variable. For example: ```bash -docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2023a -batch ver +docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2023b -batch ver ``` ## Run the Container @@ -147,7 +147,7 @@ If you did not provide the license server information when building the image, t ```bash # Start MATLAB, print version information, and exit: -docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2023a -batch ver +docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab:r2023b -batch ver ``` You can run the container **without** specifying `MLM_LICENSE_FILE` if you provided the license server information when building the image, as shown in the examples below. @@ -155,19 +155,19 @@ You can run the container **without** specifying `MLM_LICENSE_FILE` if you provi ### Run MATLAB in an Interactive Command Prompt To start the container and run MATLAB in an interactive command prompt, execute: ```bash -docker run --init -it --rm matlab:r2023a +docker run --init -it --rm matlab:r2023b ``` ### Run MATLAB in Batch Mode To start the container, run a MATLAB command, and then exit, execute: ```bash # Container runs the command RAND in MATLAB and exits. -docker run --init --rm matlab:r2023a -batch rand +docker run --init --rm matlab:r2023b -batch rand ``` ### Run MATLAB with Startup Options To override the default behavior of the container and run MATLAB with any set of arguments, such as `-logfile`, execute: ```bash -docker run --init -it --rm matlab:r2023a -logfile "logfilename.log" +docker run --init -it --rm matlab:r2023b -logfile "logfilename.log" ``` To learn more, see the documentation: [Commonly Used Startup Options](https://www.mathworks.com/help/matlab/matlab_env/commonly-used-startup-options.html). @@ -191,7 +191,7 @@ For some workflows and toolboxes, you must specify dependencies. You must do thi * Use the MATLAB Engine API for C and Fortran. * Use the Polyspace 32-bit tcc compiler. - The [matlab-deps repository](https://github.com/mathworks-ref-arch/container-images/tree/main/matlab-deps) repository lists Dockerfiles for various releases and platforms. [Click here to view the Dockerfile for R2023a](https://github.com/mathworks-ref-arch/container-images/blob/main/matlab-deps/r2023a/ubuntu20.04/Dockerfile). + The [matlab-deps repository](https://github.com/mathworks-ref-arch/container-images/tree/main/matlab-deps) repository lists Dockerfiles for various releases and platforms. [Click here to view the Dockerfile for R2023b](https://github.com/mathworks-ref-arch/container-images/blob/main/matlab-deps/r2023b/ubuntu22.04/Dockerfile). These Dockerfiles contain commented lines with the libraries that support these additional capabilities. Copy and uncomment these lines into your Dockerfile. @@ -208,6 +208,6 @@ We encourage you to try this repository with your environment and provide feedba ---- -Copyright (c) 2021-2023 The MathWorks, Inc. All rights reserved. +Copyright 2021-2023 The MathWorks, Inc. All rights reserved. ---- diff --git a/alternates/building-on-matlab-docker-image/Dockerfile b/alternates/building-on-matlab-docker-image/Dockerfile index a9e8aa6..06ac2bd 100755 --- a/alternates/building-on-matlab-docker-image/Dockerfile +++ b/alternates/building-on-matlab-docker-image/Dockerfile @@ -2,7 +2,7 @@ # To specify which MATLAB release to install in the container, edit the value of the MATLAB_RELEASE argument. # Use lower case to specify the release, for example: ARG MATLAB_RELEASE=r2021b -ARG MATLAB_RELEASE=r2023a +ARG MATLAB_RELEASE=r2023b # Specify the extra toolboxes to install into the image. ARG ADDITIONAL_PRODUCTS="Symbolic_Math_Toolbox Statistics_and_Machine_Learning_Toolbox" diff --git a/alternates/building-on-matlab-docker-image/README.md b/alternates/building-on-matlab-docker-image/README.md index 8edd4ff..f188d62 100644 --- a/alternates/building-on-matlab-docker-image/README.md +++ b/alternates/building-on-matlab-docker-image/README.md @@ -25,17 +25,17 @@ cd matlab-dockerfile/alternates/building-on-matlab-docker-image ### Quick start Build a container with a name and tag. ```bash -docker build -t matlab_with_toolboxes:r2023a . +docker build -t matlab_with_toolboxes:r2023b . ``` You can then run the container with the "batch" option. Test the container by running an example MATLAB command such as `ver` to display the installed toolboxes. ```bash -docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab_with_toolboxes:r2023a -batch ver +docker run --init --rm -e MLM_LICENSE_FILE=27000@MyServerName matlab_with_toolboxes:r2023b -batch ver ``` You can also run the container with the "browser" option to access MATLAB in a browser. ```bash -docker run --init --rm -it -p 8888:8888 matlab_with_toolboxes:r2023a -browser +docker run --init --rm -it -p 8888:8888 matlab_with_toolboxes:r2023b -browser ``` For more information, see [Run the Container](#run-the-container). @@ -50,7 +50,7 @@ The `ADDITIONAL_PRODUCTS` argument must be a space separated list surrounded by By default, `ADDITIONAL_PRODUCTS` includes two example toolboxes, which you can replace. For example, to build an image containing MATLAB and the Deep Learning Toolbox: ```bash -docker build --build-arg ADDITIONAL_PRODUCTS="Deep_Learning_Toolbox" -t matlab_with_toolboxes:r2023a . +docker build --build-arg ADDITIONAL_PRODUCTS="Deep_Learning_Toolbox" -t matlab_with_toolboxes:r2023b . ``` For a successful build, include at least one product. @@ -64,7 +64,7 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma | Argument Name | Default value | Effect | |---|---|---| -| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2023a | The MATLAB release to install. Must be lower-case, for example: `r2020b`.| +| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | r2023b | The MATLAB release to install. Must be lower-case, for example: `r2020b`.| | [ADDITIONAL_PRODUCTS](#customize-products-to-install-using-matlab-package-manager-mpm) | "Symbolic_Math_Toolbox Statistics_and_Machine_Learning_Toolbox" | A space separated list of toolboxes to install. | | [LICENSE_SERVER](#build-an-image-with-license-server-information) | *unset* | The port and hostname of a machine that is running a Network License Manager, using the `port@hostname` syntax. For example: `27000@MyServerName`. To use this build argument, the corresponding lines must be uncommented in the Dockerfile. | @@ -87,12 +87,12 @@ server or browser mode will not start successfully. Build container with the License Server. ```bash -docker build -t matlab_with_toolboxes:r2023a --build-arg LICENSE_SERVER=27000@MyServerName . +docker build -t matlab_with_toolboxes:r2023b --build-arg LICENSE_SERVER=27000@MyServerName . ``` Run the container, without needing to pass license information. ```bash -docker run --init matlab_with_toolboxes:r2023a -batch ver +docker run --init matlab_with_toolboxes:r2023b -batch ver ``` ## Run the Container The Docker container you build using this Dockerfile inherits run options from its base image. @@ -117,6 +117,6 @@ We encourage you to try this repository with your environment and provide feedba ---- -Copyright (c) 2023 The MathWorks, Inc. All rights reserved. +Copyright 2023 The MathWorks, Inc. All rights reserved. ---- diff --git a/alternates/matlab-installer/Dockerfile b/alternates/matlab-installer/Dockerfile index fc30457..77ee819 100644 --- a/alternates/matlab-installer/Dockerfile +++ b/alternates/matlab-installer/Dockerfile @@ -2,7 +2,7 @@ # To specify which MATLAB release you wish to install in the container, edit the value of the MATLAB_RELEASE argument. # Use lower case to specify the release. -ARG MATLAB_RELEASE=r2023a +ARG MATLAB_RELEASE=r2023b FROM ubuntu as versioner diff --git a/alternates/matlab-installer/README.md b/alternates/matlab-installer/README.md index bea2412..bd7da1b 100644 --- a/alternates/matlab-installer/README.md +++ b/alternates/matlab-installer/README.md @@ -74,7 +74,7 @@ The [Dockerfile](https://github.com/mathworks-ref-arch/matlab-dockerfile/blob/ma | Argument Name | Default value | Effect | | ------------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | latest | The MATLAB release you want to install. Must be lower-case, for example: `r2023a`. | +| [MATLAB_RELEASE](#build-an-image-for-a-different-release-of-matlab) | latest | The MATLAB release you want to install. Must be lower-case, for example: `r2023b`. | | [LICENSE_SERVER](#build-an-image-with-license-server-information) | _unset_ | The port and hostname of the machine running the Network License Manager, using the `port@hostname` syntax. For example: `27000@MyServerName` | Use these arguments with the `docker build` command to customize your image. Run a command from the `alternates/matlab-installer` of the cloned repository of the form: @@ -160,6 +160,6 @@ We encourage you to try this Dockerfile with your environment and provide feedba --- -Copyright (c) 2023 The MathWorks, Inc. All rights reserved. +Copyright 2023 The MathWorks, Inc. All rights reserved. ---