{"id":3444,"date":"2024-12-19T22:27:00","date_gmt":"2024-12-19T22:27:00","guid":{"rendered":"https:\/\/www.ssec.wisc.edu\/mcidas\/?page_id=3444"},"modified":"2025-01-30T19:48:26","modified_gmt":"2025-01-30T19:48:26","slug":"install","status":"publish","type":"page","link":"https:\/\/www.ssec.wisc.edu\/mcidas\/archive\/2023-1\/xcd\/install\/","title":{"rendered":"McIDAS-XCD Installation Instructions v. 2023.1"},"content":{"rendered":"<p>Note: You <strong>must<\/strong> install <a href=\"..\/..\/x\/download\/\" target=\"_blank\" rel=\"noopener noreferrer\">McIDAS-X 2023.1<\/a> on the workstation <strong>before<\/strong> you install McIDAS-XCD 2023.1. Then continue with the appropriate set of instructions, as described below.<\/p>\n<h3>McIDAS-XCD v. 2023.1<\/h3>\n<p><strong>If you are installing McIDAS-XCD for the first time on the workstation<\/strong>, go to the <em>McIDAS-XCD Administrator\u2019s Guide<\/em>\u2018s <a href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/doc\/xcd_guide\/2023.1\/install-6.html\" target=\"_blank\" rel=\"noopener noreferrer\">Installing McIDAS-XCD 2023.1 for the First Time<\/a> and complete its instructions. (Use those instructions rather than those below.)<\/p>\n<div  style=\"padding-left: 15px;\"><i>&#8211; or &#8211;<\/i><\/div>\n<p><strong>If you are upgrading to McIDAS-XCD Fastrack version 2023.1 <\/strong> on a workstation that already has a previous version of McIDAS-XCD installed, complete the steps below.<\/p>\n<ol>\n<li>At a Unix prompt as user <strong>oper<\/strong>, stop McIDAS-XCD and then LDM by running the commands below in order.\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>xcdadmin stop<\/strong><\/span><br \/>\nType: <span class=\"Unix\"><strong>ldmadmin stop<\/strong><\/span><\/p>\n<\/div>\n<\/li>\n<li>As user <span class=\"Unix\"><strong>oper<\/strong><\/span>, run the script below from the <span class=\"firstnum\"><span class=\"Unix\"><strong>~oper\/mcidas<\/strong><\/span><\/span> directory to build and install McIDAS-XCD 2023.1 using the same settings for optional flags <span class=\"Unix\"><strong>-noopt<\/strong><\/span> and <span class=\"Unix\"><strong>-mysql<\/strong><\/span> as were used to build McIDAS-X 2023.1. You must use the same compilers and optional flag settings for both the McIDAS-X and McIDAS-XCD builds.\n<div>\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>sh .\/xcd2023.1.sh <\/strong> <\/span><em>flags <\/em><span class=\"Unix\"> <strong>build<\/strong><\/span><\/p>\n<p class=\"Numbers-Text\">where <span class=\"Type-Press\"><em>flags<\/em><\/span> is zero, one or both of the two optional flags described below.<\/p>\n<\/div>\n<\/div>\n<ul>\n<li>\n<div>\n<div>The <span class=\"Type-Press\"><strong>-noopt<\/strong><\/span> flag is used to build McIDAS-XCD with no optimization. If you don\u2019t specify this <span class=\"Type-Press\"><strong>-noopt<\/strong><\/span> flag, McIDAS-XCD is built using the default optimization: -O1 for builds with gcc\/gfortran.<\/div>\n<\/div>\n<\/li>\n<li>\n<div>\n<div>The <span class=\"Type-Press\"><strong>-mysql<\/strong><\/span> flag is used to build McIDAS-XCD using the MySQL\/MariaDB database libraries. Use this flag if this workstation will be serving real-time GRIB files from the NOAAPORT data stream and you have installed and want to use a MySQL\/MariaDB database to make the GRIB data access faster for your McIDAS-X clients\/users. If the database is in a non-standard install location, specify the flag as <span class=\"Type-Press\"><strong>-mysql=<em>directory<\/em><\/strong><\/span>, where <span class=\"Type-Press\"><strong><em>directory<\/em><\/strong><\/span> is the root MySQL\/MariaDB install directory. Remember, the <span class=\"Type-Press\"><strong>-mysql<\/strong><\/span> flag must be specified when building both McIDAS-X and McIDAS-XCD.<\/p>\n<p class=\"Numbers-Text\">When the script <span class=\"Unix\"><strong>xcd2023.1.sh<\/strong><\/span> is finished, you will see the message below.<\/p>\n<div style=\"padding-left: 90px; padding-bottom: 15px;\">\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px;\" colspan=\"1\" rowspan=\"1\" valign=\"top\">\n<pre class=\"Screen\">McIDAS-XCD binaries built correctly<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<\/div>\n<\/li>\n<\/ul>\n<\/li>\n<li>As user <span class=\"Unix\"><strong>oper<\/strong><\/span>, run the script below from the <span class=\"firstnum\"><span class=\"Unix\"><strong>~oper\/mcidas<\/strong><\/span><\/span> directory to install the new executable code and a subset of the replaceable McIDAS-XCD data files for your workstation.\n<div>\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>sh .\/xcd2023.1.sh cutover<\/strong><\/span><\/p>\n<\/div>\n<p class=\"Numbers-Text\">When the script is finished, you will see the message below.<\/p>\n<div style=\"padding-left: 90px; padding-bottom: 15px;\">\n<table border=\"1\">\n<tbody>\n<tr>\n<td style=\"padding: 5px;\" colspan=\"1\" rowspan=\"1\" valign=\"top\">\n<pre class=\"Screen\">McIDAS-XCD package cutover is now complete<\/pre>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n<\/li>\n<li  style=\"padding: 5px;\">As user <span class=\"Unix\"><strong>mcadde<\/strong><\/span>, make a backup copy of your <strong>RESOLV.SRV<\/strong> file (e.g., <strong>cp RESOLV.SRV RESOLV.SRV.BAK<\/strong>) in preparation for adding the restructured RTGRIDS\/* datasets below.<\/li>\n<li style=\"padding: 5px;\">In the McIDAS-X session started as user <span class=\"Unix\"><strong>mcadde<\/strong><\/span> in step 4 above, run the command below to remove obsolete and add new RTGRIDS\/* datasets.\n<ol>\n<li style=\"list-style-type: none;\"><\/li>\n<\/ol>\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type:\u00a0<span class=\"Unix\"><strong>BATCH UPDATEGRIB2023_1.BAT CONTINUE=YES<\/strong><\/span><\/p>\n<\/div>\n<\/li>\n<li>As user <span class=\"Unix\"><strong> mcidas<\/strong><\/span>, run the script below from the <span class=\"firstnum\"><span class=\"Unix\"><strong>~oper\/mcidas<\/strong><\/span><\/span> directory to install the new ADDE server executable code in the <span class=\"Unix\"><strong>mcidas<\/strong><\/span> account.\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"> <strong>sh .\/xcd2023.1.sh install addeservers<\/strong><\/span><\/p>\n<\/div>\n<\/li>\n<li>Restart LDM and then McIDAS-XCD by running the commands below in order at a Unix prompt as user <strong>oper<\/strong>.\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>ldmadmin start<\/strong><\/span><br \/>\nType: <span class=\"Unix\"><strong>xcdadmin start<\/strong><\/span><\/p>\n<\/div>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<ol>\n<li style=\"list-style-type: none;\"><\/li>\n<\/ol>\n<ol>\n<li style=\"list-style-type: none;\"><\/li>\n<\/ol>\n<div><\/div>\n<div style=\"margin-bottom: 3em;\"><span style=\"display: none;\">.<\/span>This concludes the McIDAS-XCD Fastrack version 2023.1 installation procedure.<\/div>\n<p class=\"Body-Text\">Depending on your site\u2019s configuration and needs, additional actions may be required now or at a later time. Go to <a href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/doc\/xcd_guide\/2023.1\/install-7.html\" target=\"_blank\" rel=\"noreferrer noopener\">Configuring McIDAS-XCD<\/a> in the <em>McIDAS-XCD Administrator\u2019s Guide<\/em> for all configuration options.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Note: You must install McIDAS-X 2023.1 on the workstation before you install McIDAS-XCD 2023.1. Then continue with the appropriate set of instructions, as described below. McIDAS-XCD v. 2023.1 If you are installing McIDAS-XCD for the first time on the workstation, go to the McIDAS-XCD Administrator\u2019s Guide\u2018s Installing McIDAS-XCD 2023.1 for the First Time and complete [&hellip;]<\/p>\n","protected":false},"author":47,"featured_media":0,"parent":3557,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-3444","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3444","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/users\/47"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/comments?post=3444"}],"version-history":[{"count":6,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3444\/revisions"}],"predecessor-version":[{"id":3640,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3444\/revisions\/3640"}],"up":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3557"}],"wp:attachment":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/media?parent=3444"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}