{"id":13062,"date":"2023-07-24T12:30:46","date_gmt":"2023-07-24T17:30:46","guid":{"rendered":"https:\/\/www.mrc-productivity.com\/docs\/?post_type=ht_kb&#038;p=13062"},"modified":"2023-07-24T14:25:27","modified_gmt":"2023-07-24T19:25:27","slug":"promoting-message-tasks-to-production","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/promoting-message-tasks-to-production","title":{"rendered":"Promoting Message Tasks to Production"},"content":{"rendered":"\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\"><a href=\"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/messaging-and-scheduled-tasks#message-types\">Go back to the full Messaging and Scheduled Tasks documentation<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p>To promote Task Groups to production, you will need to move all the applications involved. This includes: the target application, the Distribution List Retrieval (if used), and the maintainer application (if used). These applications will be promoted in the regular way via the Promote to Production utility. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Messaging Files<\/h2>\n\n\n\n<p>You also need to promote specific messaging files in addition to the application files. These are the files, and their corresponding locations:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>mrc_distribution_jobs_mrcdb_XXXX.txt&nbsp;&nbsp; &nbsp; &nbsp;&#8230;\\m-power\\mrcjava\\job_streams<\/li>\n\n\n\n<li>mrc_distributions.txt&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8230;\\m-power\\mrcjava\\WEB-INF\\classes\\DICTIONARY<\/li>\n\n\n\n<li>message-queue.properties&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &#8230;\\m-power\\mrcjava\\job_streams<\/li>\n\n\n\n<li>messaging.properties&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#8230;\\m-power\\mrcjava\\job_streams<\/li>\n<\/ul>\n\n\n\n<p>These files are described in further detail, as well as when they should be promoted. <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The <strong>mrc_distribution_jobs_mrcdb_XXXX.txt<\/strong> file stores all of your defined schedules for any Task Groups (Admin -&gt; Messaging Scheduled Tasks -&gt; Scheduled Tasks). Anytime a task group&#8217;s execution schedule is modified, added, or delete, this file must be re-promoted. Note that the database connection will be referenced in the filename on the server. For example, if your m-Power is connecting to an AS400 database, the default file name would be as follows: <code>mrc_distribution_jobs_mrcdb_as400_remote1<\/code>.<\/li>\n\n\n\n<li>The <strong>message-queue.properties<\/strong> file stores all the queue directory paths set in the Output Folder list (Admin -&gt; Messaging Scheduled Tasks -&gt; Output Folders). Anytime an output location is modified, added, or delete, this file must be re-promoted.  <\/li>\n\n\n\n<li>The <strong>mrc_distributions.txt<\/strong> file stores all of the tasks and task groups <strong>per data dictionary<\/strong> (Admin -&gt; Messaging Scheduled Tasks -&gt; Tasks &amp; Task Groups).  Anytime a Task Group or individual Tasks within a group are modified, added, or deleted, this file must be re-promoted.  <\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">The above three files will need to be promoted every time a new message task has been created or modified if wanting to use them in a production environment.<\/p>\n\n\n\n<p>The <strong>messaging.properties<\/strong> file is the configuration file and is located in \\m-power\\mrcjava\\job_streams. This file needs to be promoted only once, unless the configuration properties of the email server changes, then it will need to be promoted again. After the messaging.properties file is promoted, the mpower_server field will need to be modified to point to the correct port for the production instance. After this is done, Tomcat will need to be restarted.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/www.mrc-productivity.com\/techblog\/images\/MessagingProperties.jpg\"><img decoding=\"async\" src=\"https:\/\/www.mrc-productivity.com\/techblog\/images\/MessagingProperties.jpg\" alt=\"MessagingProperties\" class=\"wp-image-9091\"\/><\/a><\/figure>\n\n\n\n<h2 class=\"wp-block-heading titlebold anchor\" id=\"scheduleDev\">Stopping Scheduled Tasks from Running in Development<\/h2>\n\n\n\n<p>After promoting your messaging files to production, your tasks will immediately run in both production and development.&nbsp;Should you wish to stop the task from running in development, you can do so by returning to the Task &amp; Message Configuration page and disabling the scheduler like so:<\/p>\n\n\n\n<p>enable_scheduler=false<\/p>\n\n\n\n<p>Tomcat will need to be restarted for this to take effect. With this done, you will no longer be able to run a scheduled task through development.&nbsp; However, you will be able to create and set the scheduled task, so that once promoted, it runs as scheduled.&nbsp; Additionally, you can still test the task in development with the green test task arrow button.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-danger\">If you accidentally promote the messaging.properties file to production again, scheduled tasks will no longer run in production because of the disabled scheduler. Simply edit the file in production again to have your scheduled tasks run.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview To promote Task Groups to production, you will need to move all the applications involved. This includes: the target application, the Distribution List Retrieval (if used), and the maintainer application (if used). These applications will be promoted in the regular way via the Promote to Production utility. Messaging Files&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[304],"ht-kb-tag":[298],"class_list":["post-13062","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-messaging","ht_kb_tag-messaging"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/13062","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=13062"}],"version-history":[{"count":3,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/13062\/revisions"}],"predecessor-version":[{"id":13109,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/13062\/revisions\/13109"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=13062"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=13062"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=13062"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}