{"id":3456,"date":"2024-12-19T22:45:18","date_gmt":"2024-12-19T22:45:18","guid":{"rendered":"https:\/\/www.ssec.wisc.edu\/mcidas\/?page_id=3456"},"modified":"2025-12-30T00:29:56","modified_gmt":"2025-12-30T00:29:56","slug":"install","status":"publish","type":"page","link":"https:\/\/www.ssec.wisc.edu\/mcidas\/software\/xcd\/install\/","title":{"rendered":"McIDAS-XCD Installation Instructions"},"content":{"rendered":"\n\n<p>Note: You <strong>must<\/strong> install <a href=\"..\/..\/x\/download\/\" target=\"_blank\" rel=\"noopener noreferrer\">McIDAS-X 2025.1<\/a> on the workstation <strong>before<\/strong> you install McIDAS-XCD 2025.1. Then continue with the appropriate set of instructions, as described below.<\/p>\n<h3>McIDAS-XCD v. 2025.1<\/h3>\n<p>If you are installing McIDAS-XCD for the first time on the workstation, go to the <em>McIDAS-XCD Administrator\u2019s Guide<\/em>\u2018s <a href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/doc\/xcd_guide\/2025.1\/install-6.html\" target=\"_blank\" rel=\"noopener noreferrer\">Installing McIDAS-XCD 2025.1 for the First Time<\/a> and complete its instructions. Use those instructions rather than those below.<\/p>\n<p><i>&#8211; or &#8211;<\/i><\/p>\n<p>If you are installing McIDAS-XCD Fastrack version 2025.1 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 stop 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 2025.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 2025.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 .\/xcd2025.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>xcd2025.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 .\/xcd2025.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>As user <span class=\"Unix\"><strong> oper<\/strong><\/span>, start a McIDAS-X session and run the command below to remove the .IDT files. The .IDT files are recreated after McIDAS-XCD is restarted (last step below) and at that point will contain the <span class=\"Unix\"><strong>STNDB.CORE<\/strong><\/span> updates.\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH RECREATEIDT.BAT<\/strong><\/span><\/p>\n<\/div>\n<\/li>\n<li>In the McIDAS-X session started as user <span class=\"Unix\"><strong> oper<\/strong><\/span> in step 4 above, run the two commands below. The first command (<strong>BATCH REGROUP.BAT<\/strong>) recreates the <span class=\"Unix\"><strong>GROUPS.DAT<\/strong><\/span> and <span class=\"Unix\"><strong>COUNTRY.DAT<\/strong><\/span> files so they contain the station database changes included in McIDAS-X Fastrack 2025.1. The second command (<strong>BATCH REBILDRAP.BAT<\/strong>) rebuilds the Rapid Access Pointer files so they include the same station database changes and rebuilds the Rapid Access Text files.<br \/>\nNote:  Running the second command erases the previous content of the <strong>*.RAP<\/strong> and <strong>*.RAT<\/strong> files, so they will contain only new data. <em>That means that the user commands MOSRPT, OBSRPT, RAOBRPT, SFCRPT, SYNRPT and TAFRPT will not be able to access any data from prior to McIDAS-XCD being restarted (last step below).<\/em><\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH REGROUP.BAT <\/strong><\/span><br \/>\nType: <span class=\"Unix\"><strong>BATCH REBILDRAP.BAT <\/strong><\/span><\/p>\n<\/li>\n<li>As user <span class=\"Unix\"><strong> mcadde<\/strong><\/span>, start a McIDAS-X session and run the command below to recreate the <span class=\"Unix\"><strong>GROUPS.DAT<\/strong><\/span> and <span class=\"Unix\"><strong>COUNTRY.DAT<\/strong><\/span> files in the <span class=\"Unix\"><strong>mcadde<\/strong><\/span> account so they contain the station database changes included in McIDAS-X Fastrack 2025.1.<\/li>\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH REGROUP.BAT<\/strong><\/span><\/p>\n<\/div>\n<li style=\"padding-bottom: 20px;\">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>In the McIDAS-X session started as user <span class=\"Unix\"><strong>mcadde<\/strong><\/span> in step 6 above, run the command below to remove obsolete and add new RTGRIDS\/* datasets.<\/li>\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type:&nbsp;<span class=\"Unix\"><strong>BATCH UPDATEGRIB2025_1.BAT CONTINUE=YES<\/strong><\/span><\/p>\n<\/div>\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 .\/xcd2025.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<p><i><\/i><\/ol>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/i><\/p>\n<p><i><\/p>\n<div><\/div>\n<div style=\"margin-bottom: 3em;\"><span style=\"display: none;\">.<\/span><\/div>\n<p class=\"Body-Text\">This concludes the McIDAS-XCD Fastrack version 2025.1 installation procedure.<\/p>\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\/2025.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<p><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><i><\/i><\/p>\n\n","protected":false},"excerpt":{"rendered":"<p>Note: You must install McIDAS-X 2025.1 on the workstation before you install McIDAS-XCD 2025.1. Then continue with the appropriate set of instructions, as described below. McIDAS-XCD v. 2025.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 2025.1 for the First Time and complete [&hellip;]<\/p>\n","protected":false},"author":47,"featured_media":0,"parent":171,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-3456","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3456","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=3456"}],"version-history":[{"count":12,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3456\/revisions"}],"predecessor-version":[{"id":3872,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3456\/revisions\/3872"}],"up":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/171"}],"wp:attachment":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/media?parent=3456"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}