{"id":1554,"date":"2019-04-22T19:07:27","date_gmt":"2019-04-22T19:07:27","guid":{"rendered":"https:\/\/www.ssec.wisc.edu\/aeri\/?page_id=1554"},"modified":"2019-05-16T21:48:15","modified_gmt":"2019-05-16T21:48:15","slug":"maerisst-for-docker-installation-procedure","status":"publish","type":"page","link":"https:\/\/www.ssec.wisc.edu\/aeri\/kb\/software\/maerisst-for-docker-installation-procedure\/","title":{"rendered":"MAERISST Installation on a Windows 10 Pro Computer"},"content":{"rendered":"

Overview<\/h2>\n

This procedure describes the steps for a new installation of MAERISST<\/em> on a computer with the Windows 10 Pro<\/em> operating system, from the files provided on the USB drive.\u00a0 It also includes instructions for functional testing, running a test dataset, and description of the input and output data files.<\/p>\n

<\/h3>\n

 <\/p>\n

Installation Procedure<\/h2>\n
    \n
  1. \n
      \n
    1. Ensure that the operating system is Windows 10 Pro<\/em>. Docker<\/em> functionality for MAERISST<\/em> will not work on Windows 10 Home<\/em>.<\/li>\n
    2. Create a user called AERI<\/em> with administrator privileges. Log in and perform all subsequent steps from the AERI<\/em> account.<\/li>\n
    3. Confirm that virtualization is enabled on the computer. This can be determined from the Task Manager<\/em> > Performance<\/em> tab.\n
        \n
      • Type “Task Manager<\/em>” where it says “Type here to search<\/em>” in the lower left then click to launch.<\/li>\n<\/ul>\n

        \"\"
        \nIf virtualization is not enabled, then this can be enabled in the BIOS.<\/p>\n

          \n
        • Enabling virtualization in BIOS if disabled on a Lenovo T530\n
            \n
          1. Restart computer<\/li>\n
          2. Press enter to stop normal boot at black ThinkPad splash screen<\/li>\n
          3. Press F1 within 5 seconds to get to BIOS setup utility<\/li>\n
          4. Select Security menu<\/li>\n
          5. Select Virtualization<\/li>\n
          6. Enable both Intel (R) Virtualization Technology and Intel (R) VT-d Feature<\/li>\n
          7. Press F10 to save then choose yes<\/li>\n<\/ol>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n
              \n
            1. Install Docker for Windows<\/em>\n
                \n
              • Copy the file Docker for Windows Installer.exe<\/tt> from the USB drive to the computer<\/li>\n
              • Run the file and follow the prompts to guide through the installation. Accept all the default configurations options. Select OK<\/em> if prompted to enable Hyper-V and Containers features<\/em>.<\/li>\n
              • Restart the computer.\u00a0 By default, Docker<\/em> will be configured to auto-run on startup.\u00a0 Docker<\/em> may take a few minutes to start up.<\/li>\n
              • There is no need for a Docker ID \/ password.<\/li>\n
              • Docker<\/em> settings can be accessed by right-clicking on the Docker<\/em> icon in the taskbar.<\/li>\n
              • Share the drive where the M-AERI data for MAERISST<\/em> is located (C Drive for provided test data):\u00a0 Docker<\/em> > Settings<\/em> > Shared Drives<\/em> tab > Select C<\/em> Drive.<\/li>\n<\/ul>\n

                Alternatively Docker<\/em> can be downloaded from the Docker Store at https:\/\/store.docker.com\/editions\/community\/docker-ce-desktop-windows<\/tt>. Download Docker Community Edition (CE) for Windows<\/em>.
                \n\"\"<\/p>\n

                \"\"<\/li>\n<\/ol>\n

                  \n
                1. Copy the folder docker<\/tt> from the USB drive to C:\\Users\\AERI\\<\/tt>. This folder contains the files needed for MAERISST<\/em> to run.<\/li>\n
                2. Ensure that the file C:\\Users\\AERI\\docker\\maerisst_docker.tar<\/tt> exists. This is the Docker<\/em> image of MAERISST<\/em>.<\/li>\n
                3. Load the Docker<\/em> image of MAERISST<\/em>. Open Command Prompt<\/em>. Type\n

                  cd c:\\Users\\AERI\\docker
                  \ndocker load -i maerisst_docker.tar<\/p>\n<\/li>\n<\/ol>\n

                  MAERISST<\/em> is now installed and ready to run.<\/p>\n

                  Note: the first time mounting a directory, Docker for Windows<\/em> may need to be granted permission to access drive C:\\<\/tt>.\"\"<\/p>\n

                  <\/h3>\n

                   <\/p>\n

                  <\/h3>\n

                   <\/p>\n

                  MAERISST Functional Test<\/h2>\n

                  Test data from a M-AERI have been included inside the Docker<\/em> image to confirm operation.\u00a0 To test the operation of MAERISST<\/em>, open Command Prompt<\/em>. Type<\/p>\n

                  docker run \u2011\u2011rm -it maerisst bash<\/p>\n

                  Note: there are two dashes before rm, not one.<\/em><\/p>\n

                  This starts the MAERISST<\/em> Docker<\/em> container, and returns a prompt such as bash-4.2#<\/tt><\/p>\n

                  For the test case provided, AE960318<\/tt>, at the Docker<\/em> prompt (bash-4.2#<\/tt>), type<\/p>\n

                  cd \/root\/test_data\/
                  \nmaerisst.exe
                  \n960318
                  \n1<\/p>\n

                  This will run MAERISST<\/em> on the test dataset inside the Docker<\/em> container and write output files asciiout.mlt<\/tt>,\u00a0 TSKINDMP.ASC<\/tt>,\u00a0 maerisst.log<\/tt>.<\/p>\n

                  To verify that matching output is generated, while still in the container, type<\/p>\n

                  cd \/root\/test_data\/
                  \ndiff asciiout.mlt test_output\/asciiout.mlt<\/p>\n

                  If the output is identical, diff<\/tt> should return an empty set.<\/p>\n

                  Note:\u00a0 numerical precision differences between computers may result in different computed output on different computers.\u00a0 In that case, inspect and compare the output files manually.<\/em><\/p>\n

                  To close the Docker<\/em> container, type<\/p>\n

                  exit<\/p>\n

                  <\/h3>\n

                   <\/p>\n

                  Running MAERISST on User Data<\/h2>\n

                  To run MAERISST<\/em> on user data for a given day, YYMMDD<\/tt>, the M-AERI data as well as the configuration files must be copied into the Docker<\/em> container using a mounted drive.<\/p>\n

                    \n
                  1. Set up the input M-AERI data and configuration files on the computer.\u00a0 For the test data provided, copy the folder AE960318<\/tt> from the USB drive to C:\\ftp\\<\/tt>. This folder contains test data and configuration files needed to run MAERISST<\/em>.<\/li>\n
                  2. Start a Docker<\/em> container mounting the M-AERI data directory.\u00a0 Open Command Prompt<\/em> and type\n

                    docker run \u2011\u2011rm -it -v c:\\ftp:\/ftp maerisst bash<\/p>\n

                    Note: there are two dashes before rm, not one.<\/em><\/li>\n

                  3. Copy the input data into the Docker<\/em> container.\u00a0 Note: MAERISST<\/em> will not run on data outside the Docker<\/em> container.\u00a0 Type\n

                    cp -r \/ftp\/AE960318 \/root\/data\/.<\/p>\n<\/li>\n

                  4. Run MAERISST<\/em>.\u00a0 Type\n

                    cd \/root\/data\/AE960318
                    \nmaerisst.exe
                    \n960318
                    \n1<\/p>\n<\/li>\n

                  5. Copy the output data out of the Docker<\/em> container.\u00a0 Note:\u00a0 new files created inside the Docker<\/em> container will be discarded once it is closed.\u00a0 Type\n

                    cp asciiout.mlt \/ftp\/AE960318\/.
                    \ncp TSKINDMP.ASC \/ftp\/AE960318\/.
                    \ncp maerisst.log \/ftp\/AE960318\/.<\/p>\n

                    This will copy the output data into c:\\ftp\\AE960318<\/tt> on the computer.<\/li>\n

                  6. To close the Docker<\/em> container, type\n

                    exit<\/p>\n<\/li>\n<\/ol>\n

                    <\/h3>\n

                     <\/p>\n

                    Input data<\/h2>\n

                    The following input files need to be in each c:\\ftp\\AEYYMMDD directory in order to run MAERISST<\/em> per the instructions above. They need to be configured for the given M-AERI input data.\u00a0 The test data in AE960318<\/tt> are provided as a template.<\/p>\n

                      \n
                    • .RNC<\/tt> files from the M-AERI for the given day (e.g. 960318C1.RNC<\/tt>, 960318C2.RNC<\/tt>)<\/li>\n
                    • .SUM<\/tt> file from the M-AERI for the given day (e.g. 960318.SUM<\/tt>)<\/li>\n
                    • mirror.beg<\/tt> file used to collect M-AERI data, found in the c:\\config directory on the M-AERI data acquisition computer.<\/li>\n
                    • MAERISST.VIP<\/tt> specifies file locations for input, output, etc.\u00a0 These must be specified for each given day.<\/li>\n
                    • MAERISST.SIP<\/tt> specifies scene mirror position IDs, and other parameters.\u00a0 These must be specified based on the given mirror.beg<\/tt> file.\n
                        \n
                      • SceneMirPosIDzenithSky<\/tt>: zenith position in mirror.beg (e.g. S<\/tt>)<\/li>\n
                      • SceneMirPosID1*TempCalc<\/tt>: 55 degrees from nadir position in mirror.beg (e.g. V<\/tt>)<\/li>\n
                      • SceneMirPosID2*TempCalc<\/tt>: 55 degress from zenith position in mirror.beg (e.g. W<\/tt>)<\/li>\n<\/ul>\n<\/li>\n
                      • coeffs<\/tt> directory<\/li>\n<\/ul>\n

                         <\/p>\n

                        Output data<\/h2>\n

                        Three output files are generated<\/p>\n

                          \n
                        • asciiout.mlt<\/tt>, ASCII datafile containing sea surface skin temperature calculations, uncertainties, and other output data.\u00a0 The data are described in the file header.<\/li>\n
                        • TSKINDMP.ASC<\/tt>, parameter file<\/li>\n
                        • maerisst.log<\/tt>, processing log file<\/li>\n<\/ul>\n

                          For the test case provided, output can be verified against test output found in \/root\/test_data\/test_output<\/tt> inside the Docker<\/em> container, or test_output<\/tt> on the USB drive.<\/p>\n

                          <\/h3>\n

                           <\/p>\n

                          Reference<\/h2>\n

                          The theory behind the retrieval is described in:
                          \nSmith, W. L., and Coauthors, 1996: Observations of the infrared radiative properties of the ocean – implications for the measurement of sea surface temperature via satellite remote sensing. Bull. Amer. Meteor. Soc.<\/em>, 77<\/strong>, 41-51.<\/p>\n","protected":false},"excerpt":{"rendered":"

                          Overview This procedure describes the steps for a new installation of MAERISST on a computer with the Windows 10 Pro operating system, from the files provided on the USB drive.\u00a0 It also includes instructions for functional testing, running a test dataset, and description of the input and output data files.   Installation Procedure Ensure that […]<\/p>\n","protected":false},"author":13,"featured_media":0,"parent":603,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-1554","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/pages\/1554","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/comments?post=1554"}],"version-history":[{"count":87,"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/pages\/1554\/revisions"}],"predecessor-version":[{"id":1649,"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/pages\/1554\/revisions\/1649"}],"up":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/pages\/603"}],"wp:attachment":[{"href":"https:\/\/www.ssec.wisc.edu\/aeri\/wp-json\/wp\/v2\/media?parent=1554"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}