{"id":3833,"date":"2025-12-29T22:35:11","date_gmt":"2025-12-29T22:35:11","guid":{"rendered":"https:\/\/www.ssec.wisc.edu\/mcidas\/?page_id=3833"},"modified":"2025-12-29T22:36:04","modified_gmt":"2025-12-29T22:36:04","slug":"install","status":"publish","type":"page","link":"https:\/\/www.ssec.wisc.edu\/mcidas\/archive\/2024-1\/xcd\/install\/","title":{"rendered":"McIDAS-XCD Installation Instructions v. 2024.1"},"content":{"rendered":"<p>Note: You <strong>must<\/strong> install <a href=\"..\/..\/x\/download\/\" target=\"_blank\" rel=\"noopener noreferrer\">McIDAS-X 2024.1<\/a> on the workstation <strong>before<\/strong> you install McIDAS-XCD 2024.1. Then continue with the appropriate set of instructions, as described below.<\/p>\n<h3>McIDAS-XCD v. 2024.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\/2024.1\/install-6.html\" target=\"_blank\" rel=\"noopener noreferrer\">Installing McIDAS-XCD 2024.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 2024.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 2024.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 2024.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 .\/xcd2024.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>xcd2024.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 .\/xcd2024.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;\">Confirm that the RAOB alias contains the UQ WMO header.\u00a0 In a McIDAS-X session as user <span class=\"Unix\"><strong class=\"\">oper <\/strong><span class=\"\">on the -XCD machine<\/span><\/span>, run the command below to list the the WMO headers, indices and aliases for the NTXT circuit.\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>WMORTE LIST NTXT<\/strong><\/span><\/p>\n<p>Find the line in the list for the alias RAOB.\u00a0 If the RAOB line looks like the following and contains UQ, but not UX, skip to <nobr>Step 6<\/nobr>. Otherwise, proceed to Step 5.<\/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\"><b>RAOB\u00a0\u00a0\u00a0\u00a0 UJ\u00a0\u00a0\u00a0\u00a0 UJ UE UF UK UL UM UP US UG UQ<\/b><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/li>\n<li style=\"padding: 5px;\">If the command in Step 4 returns a line with the UX header or does not have the UQ header listed, run the commands below to remove the UX header and to define the UQ header.\u00a0 In the McIDAS-X session as user <b>oper<\/b> on the -XCD machine, run the following commands.\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>WMORTE DEL WMO INDEX=UJ HEADER=UX CIRCUIT=NTXT<\/strong><\/span><\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>WMORTE ADD WMO INDEX=UJ HEADER=UQ CIRCUIT=NTXT<\/strong><\/span><\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>WMORTE LIST NTXT<\/strong><\/span><\/p>\n<p>Once again, find the line in the list for the alias RAOB.\u00a0 If the RAOB line looks like the following and contains UQ, but not UX, then the IDXALIAS.DAT file has been successfully updated.<\/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\"><b>RAOB\u00a0\u00a0\u00a0\u00a0 UJ\u00a0\u00a0\u00a0\u00a0 UJ UE UF UK UL UM UP US UG UQ<\/b><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\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 .\/xcd2024.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<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 2024.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\/2024.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 2024.1 on the workstation before you install McIDAS-XCD 2024.1. Then continue with the appropriate set of instructions, as described below. McIDAS-XCD v. 2024.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 2024.1 for the First Time and complete [&hellip;]<\/p>\n","protected":false},"author":47,"featured_media":0,"parent":3827,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-3833","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3833","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=3833"}],"version-history":[{"count":1,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3833\/revisions"}],"predecessor-version":[{"id":3834,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3833\/revisions\/3834"}],"up":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3827"}],"wp:attachment":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/media?parent=3833"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}