{"id":3217,"date":"2024-01-10T05:31:58","date_gmt":"2024-01-10T05:31:58","guid":{"rendered":"https:\/\/www.ssec.wisc.edu\/mcidas\/?page_id=3217"},"modified":"2025-01-30T19:49:06","modified_gmt":"2025-01-30T19:49:06","slug":"install","status":"publish","type":"page","link":"https:\/\/www.ssec.wisc.edu\/mcidas\/archive\/2022-1\/xcd\/install\/","title":{"rendered":"McIDAS-XCD Installation Instructions v. 2022.1"},"content":{"rendered":"\n\n<p>Note: You <strong>must<\/strong> install <a href=\"..\/..\/x\/download\/\" target=\"_blank\" rel=\"noopener noreferrer\">McIDAS-X 2022.1<\/a> on the workstation <strong>before<\/strong> you install McIDAS-XCD 2022.1. Then continue with the appropriate set of instructions, as described below.<\/p>\n<h3>McIDAS-XCD v. 2022.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\/2022.1\/install-6.html\" target=\"_blank\" rel=\"noopener noreferrer\">Installing McIDAS-XCD 2022.1 for the First Time<\/a> and complete its instructions. (Use those instructions rather than those below.)<\/p>\n<p><i>-or<\/i><\/p>\n<p>If you are installing McIDAS-XCD Fastrack version 2022.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 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 2022.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 2022.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 .\/xcd2022.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>xcd2022.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 .\/xcd2022.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 2022.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 2022.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 UPDATEGRIB2022_1.BAT CONTINUE=YES<\/strong><\/span><\/p>\n<\/div>\n<li>If you completed the <a href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/archive\/2021-1\/xcd-nexrad\/\">McIDAS-XCD NEXRAD Addendum<\/a> dated 19 May 2022, <b>skip to step 10<\/b>.\n<div>\n<p>If you <b>did not<\/b> complete the <b>McIDAS-XCD NEXRAD Addendum<\/b>, the McIDAS-X 2022.1 installation and the commands below will complete that process.<\/p>\n<\/div>\n<div>\n<p class=\"Numbers-Command\" style=\"padding-left: 45px;\">In the McIDAS-X session started as user <b>mcadde<\/b> in step 6 above, run the commands below to create McIDAS strings named WSRDATA and TDWRDATA that contain the fully expanded paths to the directories that will store the WSR-88D and TDWR data, respectively. These are the same directories that are specified for the values of WSRFILE= and TDWRFILE= in the \/home\/oper\/mcidas\/data\/NEXRID.CFG file.<\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <b>TE WSRDATA \u201c<i>\/wsr_data_directory_path<\/i><\/b><\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <b>TE TDWRDATA \u201c<i>\/tdwr_data_directory_path<\/i><\/b><\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">(Example: <b>TE WSRDATA \u201c\/home\/oper\/xcd_data\/wsr<\/b>)<\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">(Example: <b>TE TDWRDATA \u201c\/home\/oper\/xcd_data\/tdwr<\/b>)<\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">\n<\/div>\n<\/li>\n<p class=\"Numbers-Command\" style=\"padding-left: 45px;\">In the McIDAS-X session started as user <b>mcadde<\/b> in step 6 above, run the command below to create the updated real-time RADAR, TDWR, and WSR ADDE datasets listed in the tables below. Running this batch file will overwrite any locally-created datasets with names matching those in the batch file.<\/p>\n<p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <b>BATCH UPDATERADAR2022_1.BAT CONT=YES<\/b><\/p>\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 .\/xcd2022.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 2022.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\/2022.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 2022.1 on the workstation before you install McIDAS-XCD 2022.1. Then continue with the appropriate set of instructions, as described below. McIDAS-XCD v. 2022.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 2022.1 for the First Time and complete [&hellip;]<\/p>\n","protected":false},"author":95,"featured_media":0,"parent":3600,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-3217","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3217","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\/95"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/comments?post=3217"}],"version-history":[{"count":14,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3217\/revisions"}],"predecessor-version":[{"id":3641,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3217\/revisions\/3641"}],"up":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3600"}],"wp:attachment":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/media?parent=3217"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}