{"id":2391,"date":"2021-12-27T23:03:51","date_gmt":"2021-12-27T23:03:51","guid":{"rendered":"https:\/\/www.ssec.wisc.edu\/mcidas\/?page_id=2391"},"modified":"2025-01-30T19:49:59","modified_gmt":"2025-01-30T19:49:59","slug":"install","status":"publish","type":"page","link":"https:\/\/www.ssec.wisc.edu\/mcidas\/archive\/2020-1\/xcd\/install\/","title":{"rendered":"McIDAS-XCD Installation Instructions v. 2020.1"},"content":{"rendered":"\n<p>Note: You <strong>must<\/strong> install <a href=\"..\/..\/x\/download\/\" target=\"_blank\" rel=\"noopener noreferrer\">McIDAS-X 2020.1<\/a> on the workstation <strong>before<\/strong> you install McIDAS-XCD 2020.1. Then continue with the appropriate set of instructions, as described below.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">McIDAS-XCD v. 2020.1<\/h3>\n\n\n\n<p>If you are installing McIDAS-XCD for the first time on the workstation, go to the <em>McIDAS-XCD Administrator&#8217;s Guide<\/em>&#8216;s <a href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/doc\/xcd_guide\/2020.1\/install-6.html\" target=\"_blank\" rel=\"noopener noreferrer\">Installing McIDAS-XCD 2020.1 for the First Time<\/a> and complete its instructions. (Use those instructions rather than those below.)<\/p>\n\n\n\n<p>If you are installing McIDAS-XCD Fastrack version 2020.1 on a workstation that already has a previous version of McIDAS-XCD installed, complete the steps below.<\/p>\n\n\n\n<ol><li>As <span class=\"Unix\"><strong>root<\/strong><\/span>, disable the writing of binary log files associated with the database so that it is not enabled when MySQL\/MariaDB is upgraded on your McIDAS-XCD system. This is needed because MySQL\/MariaDB 8.0 and later enable binary logging by default, which fills large amounts of disk (possibly an entire file system) due to it logging millions of <em>INSERT into file_list<\/em> entries per day. \n<div> <div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong><strong>\/home\/oper\/mcidas\/bin\/gribadmin disablelog<\/strong><\/strong><\/span><\/p> <\/div> \n<p class=\"Numbers-Text\">When the command is finished, you should see a message like that below.<\/p> \n<div style=\"padding-left: 90px; padding-bottom: 0px;\"> \n<table border=\"1\"> <tbody> <tr> <td style=\"padding: 5px;\" colspan=\"1\" rowspan=\"1\" valign=\"top\"> <pre class=\"Screen\">\/etc\/my.cnf.d\/disable-log-bin.cnf successfully written!<\/pre> <\/td> <\/tr> <\/tbody> <\/table> <\/div> \n<\/div>\n<p class=\"Numbers-Text\">Once its successful completion is verified, exit from <strong>root<\/strong>.<\/p><\/li>\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> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>xcdadmin stop<\/strong><\/span>\n<br>Type: <span class=\"Unix\"><strong>ldmadmin stop<\/strong><\/span><\/p> <\/div> <\/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 2020.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 2020.1. You must use the same compilers and optional flag settings for both the McIDAS-X and McIDAS-XCD builds. \n<div> <div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>sh .\/xcd2020.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> <\/div><\/div>\n<ul>\n<li><div><div>The <span class=\"Type-Press\"><strong>-noopt<\/strong><\/span> flag is used to build McIDAS-XCD with no optimization. If you don&#8217;t 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><\/div><\/li>\n<li><div><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. \n<p class=\"Numbers-Text\">When the script <span class=\"Unix\"><strong>xcd2020.1.sh<\/strong><\/span> is finished, you will see the message below.<\/p> <div style=\"padding-left: 90px; padding-bottom: 15px;\"> <table border=\"1\"> <tbody> <tr> <td style=\"padding: 5px;\" colspan=\"1\" rowspan=\"1\" valign=\"top\"> <pre class=\"Screen\">McIDAS-XCD binaries built correctly<\/pre> <\/td> <\/tr> <\/tbody> <\/table> <\/div> <\/div> <\/div><\/li><\/ul><\/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> <div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>sh .\/xcd2020.1.sh cutover<\/strong><\/span><\/p> <\/div> \n<p class=\"Numbers-Text\">When the script is finished, you will see the message below.<\/p> <div style=\"padding-left: 90px; padding-bottom: 15px;\"> <table border=\"1\"> <tbody> <tr> <td style=\"padding: 5px;\" colspan=\"1\" rowspan=\"1\" valign=\"top\"> <pre class=\"Screen\">McIDAS-XCD package cutover is now complete<\/pre> <\/td> <\/tr> <\/tbody> <\/table> <\/div> <\/div><\/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> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH RECREATEIDT.BAT<\/strong><\/span><\/p> <\/div><\/li>\n<li>In the McIDAS-X session started as user <span class=\"Unix\"><strong> oper<\/strong><\/span> in step 5 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 2020.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. Note that 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> \n<div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH REGROUP.BAT <\/strong><\/span><br>Type: <span class=\"Unix\"><strong>BATCH REBILDRAP.BAT <\/strong><\/span><\/p> \n<p class=\"Numbers-Text\" style=\"margin-bottom: 0px;\">Note: This McIDAS-XCD 2020.1 release includes software changes that allow you to specify a value of up to 20 for the maximum number of Metar obs per station per hour that are stored in the SAOMETAR.RAT file (which users access with the SFCRPT command). The maximum value was previously 6 but now is 20. The prior default setting of 6 is maintained in the REBILDRAP.BAT file that you run in this step.<\/p> \n<p>If you would like to set a different value for your McIDAS-XCD system, edit the REBILDRAP.BAT file prior to running the BATCH commands above and change the &#8220;<strong>6<\/strong>&#8221; in its <strong>BILDTEXT INIT SAOMETAR.RAP SAOMETAR.RAT 12500 6 C4  36 1  80 SAOMETAR X 144 <\/strong>entry to the value you would like for your system (up to 20). If you want to do it at a later time, you will need to stop McIDAS-XCD, run the command in a McIDAS-X session as user <strong>oper<\/strong>, then restart McIDAS-XCD. <\/p> <\/div><\/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 2020.1. <div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH REGROUP.BAT<\/strong><\/span><\/p> <\/div><\/li>\n<li>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.<br><br> <\/li>\n<li>In the McIDAS-X session started as user <span class=\"Unix\"><strong>mcadde<\/strong><\/span> in step 7 above, run the command below to remove obsolete and add new RTGRIDS\/* datasets. \n<div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type:&nbsp;<span class=\"Unix\"><strong>BATCH UPDATEGRIB2020_1.BAT CONTINUE=YES<\/strong><\/span><\/p> <\/div><\/li>\n<li>In the McIDAS-X session started as user <span class=\"Unix\"><strong>mcadde<\/strong><\/span> in step 7 above, run the command below to update the TDWR\/* and RADAR\/TDWR-* datasets so they contain the data currently available over the NOAAPORT NEXRAD feed. \n<div> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>BATCH UPDATETDWR2020_1.BAT CONTINUE=YES<\/strong><\/span><\/p> <\/div> <\/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> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"> <strong>sh .\/xcd2020.1.sh install addeservers<\/strong><\/span><\/p> <\/div><\/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> <p class=\"Numbers-Command\" style=\"padding-left: 90px;\">Type: <span class=\"Unix\"><strong>ldmadmin start<\/strong><\/span><br>Type: <span class=\"Unix\"><strong>xcdadmin start<\/strong><\/span><\/p> <\/div> <\/li><\/ol>\n\n\n\n<div>\n<\/div>\n\n\n\n<div style=\"margin-bottom:3em;\"><span style=\"display:none;\">.<\/span><\/div>\n\n\n\n<p class=\"Body-Text\">This concludes the McIDAS-XCD Fastrack version 2020.1 installation procedure.<\/p>\n\n\n\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 rel=\"noreferrer noopener\" href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/doc\/xcd_guide\/2020.1\/install-7.html\" target=\"_blank\">Configuring McIDAS-XCD<\/a> in the <em>McIDAS-XCD Administrator\u2019s Guide<\/em> for all configuration options. Also note that a new optional data monitor was added in version 2020.1: the <a href=\"https:\/\/www.ssec.wisc.edu\/mcidas\/doc\/xcd_guide\/2020.1\/install-11.html\">DMCOND data monitor for GRIB2 files from the LDM CONDUIT feed<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Note: You must install McIDAS-X 2020.1 on the workstation before you install McIDAS-XCD 2020.1. Then continue with the appropriate set of instructions, as described below. McIDAS-XCD v. 2020.1 If you are installing McIDAS-XCD for the first time on the workstation, go to the McIDAS-XCD Administrator&#8217;s Guide&#8216;s Installing McIDAS-XCD 2020.1 for the First Time and complete [&hellip;]<\/p>\n","protected":false},"author":47,"featured_media":0,"parent":3611,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"class_list":["post-2391","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/2391","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=2391"}],"version-history":[{"count":2,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/2391\/revisions"}],"predecessor-version":[{"id":3643,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/2391\/revisions\/3643"}],"up":[{"embeddable":true,"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/pages\/3611"}],"wp:attachment":[{"href":"https:\/\/www.ssec.wisc.edu\/mcidas\/wp-json\/wp\/v2\/media?parent=2391"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}