{"id":5006,"date":"2022-08-11T10:59:14","date_gmt":"2022-08-11T15:59:14","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=5006"},"modified":"2022-08-16T09:46:50","modified_gmt":"2022-08-16T14:46:50","slug":"utilizing-the-promote-to-production-plugin","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/utilizing-the-promote-to-production-plugin","title":{"rendered":"Promote to Production"},"content":{"rendered":"\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\"><em>Click <a href=\"https:\/\/www.mrc-productivity.com\/legacy\/utilities\/utilizing-the-promote-to-production-plugin\">here<\/a> to access the legacy version of this documentation.<\/em><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"overview-video\">Overview <\/h2>\n\n\n\n<p>The purpose of this utility is to allow developers the ability to promote their applications to a production environment so applications can be accessed by their users. This utility will allow the developer the ability to access the necessary components directly in the m-Power interface.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"overview-video\">Video<\/h2>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe title=\"Promote to Production\" width=\"643\" height=\"362\" src=\"https:\/\/www.youtube.com\/embed\/qNeKKfTk3SY?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"project-applications\">Project Applications<\/h2>\n\n\n\n<p>A listing of applications and files assigned to the selected project. Click the green \u201cSelect\u201d button to add the app\/file to the Promotion Review.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"900\" height=\"500\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-900x500.png\" alt=\"\" class=\"wp-image-11884\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-900x500.png 900w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-300x167.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-150x83.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-768x426.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-50x28.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-60x33.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41-100x56.png 100w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-41.png 1108w\" sizes=\"(max-width: 900px) 100vw, 900px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">If this is the first time promoting your applications, you may find it beneficial to add all apps from the dictionary to the project. Do this from the \u201cDictionaries\u201d tab -&gt; Find the dictionary in question -&gt; Actions -&gt; Select \u201cAdd all dictionary apps to project\u201d.&nbsp;&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">You may also find it helpful to sort the application list by the Last Action date to see the most recently changed applications to promote.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"view-references\">View References<\/h3>\n\n\n\n<p>Lists all referenced applications to the selected application. For example, if a maintainer uses different Option List Retrievals, smart linked applications, imported apps, or other applications in the workflow &#8212; those applications will need to be promoted to production as well for the maintainer to fully function. This modal will list the referenced applications that need to be promoted as well. Click the &#8220;Select&#8221; button to quickly add these apps to the Promotion Review.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"795\" height=\"376\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-58.png\" alt=\"\" class=\"wp-image-11943\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-58.png 795w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-58-300x142.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-58-150x71.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-58-768x363.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-58-50x24.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-58-60x28.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-58-100x47.png 100w\" sizes=\"(max-width: 795px) 100vw, 795px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">If a referenced application is not showing in the list, you may need to refresh the reference list. Do this by clicking the Menu (three lines) button on the application in question and select \u201cRefresh application references\u201d.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"refresh-application-references\">Refresh Application References<\/h3>\n\n\n\n<p>From the Menu (three lines) button of an application, you may select the \u201cRefresh Application References\u201d option. This will automatically add any applications referenced from the selected app that are not in the current project (i.e. Option List Retrievals, Imports, Smartlinks, Workflow apps, etc). This option will also add any newly reference applications to the &#8220;View References&#8221; list of the selected application.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"other-files\">Other Files<\/h3>\n\n\n\n<p>Here you will see a list of common files that you can manually promote. If you have other common files that need to be promoted, be sure to add them to the list.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"900\" height=\"487\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-900x487.jpg\" alt=\"\" class=\"wp-image-11887\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-900x487.jpg 900w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-300x162.jpg 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-150x81.jpg 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-768x416.jpg 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-50x27.jpg 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-60x32.jpg 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles-100x54.jpg 100w, https:\/\/www.mrc-productivity.com\/docs\/images\/otherfiles.jpg 1301w\" sizes=\"(max-width: 900px) 100vw, 900px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">You may also find it helpful to sort the &#8220;Other Files&#8221; list by the Last Modified date to see the most recently changed files to promote.<\/p>\n\n\n\n<p>When adding dictionary specific files, use &#8216;DD&#8217; as a substitution for the selected Dictionary in the &#8220;Path&#8221; text box.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"594\" height=\"481\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-51.png\" alt=\"\" class=\"wp-image-11895\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-51.png 594w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-51-300x243.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-51-150x121.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-51-50x40.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-51-60x49.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-51-100x81.png 100w\" sizes=\"(max-width: 594px) 100vw, 594px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Please note that any files referenced in this section require a root path of \\mrcjava on the server.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"promotion-review\">Promotion Review<\/h2>\n\n\n\n<p>As soon as an application or file has been selected, it will be added to the Promotion Review screen.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"900\" height=\"454\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-900x454.png\" alt=\"\" class=\"wp-image-11888\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-900x454.png 900w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-300x151.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-150x76.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-768x388.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-50x25.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-60x30.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44-100x50.png 100w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-44.png 1094w\" sizes=\"(max-width: 900px) 100vw, 900px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"review\">Review<\/h3>\n\n\n\n<p>A list of all applications\/files that are currently set to be promoted.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"795\" height=\"538\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-45.png\" alt=\"\" class=\"wp-image-11889\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-45.png 795w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-45-300x203.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-45-150x102.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-45-768x520.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-45-50x34.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-45-60x41.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-45-100x68.png 100w\" sizes=\"(max-width: 795px) 100vw, 795px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"alerts\">Alerts<\/h3>\n\n\n\n<p>Any important suggestions or recommendations will be listed here.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"795\" height=\"536\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-46.png\" alt=\"\" class=\"wp-image-11890\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-46.png 795w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-46-300x202.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-46-150x101.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-46-768x518.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-46-50x34.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-46-60x40.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-46-100x67.png 100w\" sizes=\"(max-width: 795px) 100vw, 795px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"promotions-locations\">Promotions Locations<\/h3>\n\n\n\n<p>Check the box of the location where you would like these files to be promoted.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"796\" height=\"536\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-48.png\" alt=\"\" class=\"wp-image-11892\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-48.png 796w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-48-300x202.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-48-150x101.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-48-768x517.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-48-50x34.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-48-60x40.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-48-100x67.png 100w\" sizes=\"(max-width: 796px) 100vw, 796px\" \/><\/figure>\n\n\n\n<p>If your production instance is on a different server, you can utilize a mapped network drive, if available. If not, you can choose the .zip option. This option will create a zip-file on your development server that you can manually copy and extract on your production environment.&nbsp;&nbsp;<\/p>\n\n\n\n<p>These locations may be edited from the m-Power server in the \/m-power\/mrcwebgui\/WEB-INF\/classes\/promote.properties file.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\"><strong>DO NOT<\/strong> <strong>REMOVE<\/strong> the development location. Although you will likely not promote apps to a development location, this location is required so m-Power will know where the development location is to grab the appropriate files from the server.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"promote-to-production\">Promote to Production<\/h3>\n\n\n\n<p>Clicking the green \u201cPromote to Production\u201d button will copy the selected application files\/other files and promote them to the selected location. After the promotion is completed, remember to restart the production Tomcat service if it was suggested in the Alerts section.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" width=\"796\" height=\"536\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-49.png\" alt=\"\" class=\"wp-image-11893\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-49.png 796w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-49-300x202.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-49-150x101.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-49-768x517.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-49-50x34.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-49-60x40.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-49-100x67.png 100w\" sizes=\"(max-width: 796px) 100vw, 796px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"project-options\">Project Options<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"add-apps-to-project\">Add Apps to Project<\/h3>\n\n\n\n<p>Find applications that need to be promoted to a production environment. Click the green \u201cSelect\u201d button to add one or multiple apps to your project. You may also add applications from other dictionaries to your selected project.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"900\" height=\"458\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-900x458.png\" alt=\"\" class=\"wp-image-11894\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-900x458.png 900w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-300x153.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-150x76.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-768x391.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-50x25.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-60x31.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50-100x51.png 100w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-50.png 1134w\" sizes=\"(max-width: 900px) 100vw, 900px\" \/><\/figure>\n\n\n\n<p>This is a one time selection. Once an application has been added to the project, you will not need to add it again in the future.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"promote-all-project-apps\">Promote All Project Apps<\/h3>\n\n\n\n<p>Add all apps in the current project to the Promotion Review screen.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"select-a-project\">Select a Project<\/h3>\n\n\n\n<p>Use this modal to switch to an existing project or to manage your projects. You may create a new project or delete existing projects here. <\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">The currently selected project cannot be deleted. Select a different project and then delete the desired project.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"create-a-new-project\">Create a New Project<\/h3>\n\n\n\n<p>Create a new project by assigning a name for the project. <\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Upon saving, the project name will automatically convert to uppercase lettering.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"project-notes\">Project Notes<\/h3>\n\n\n\n<p>Add or manage notes for a project. You may assign and  organize them by Category if desired.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" width=\"900\" height=\"485\" src=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-900x485.png\" alt=\"\" class=\"wp-image-11904\" srcset=\"https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-900x485.png 900w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-300x162.png 300w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-150x81.png 150w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-768x414.png 768w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-50x27.png 50w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-60x32.png 60w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56-100x54.png 100w, https:\/\/www.mrc-productivity.com\/docs\/images\/image-56.png 1133w\" sizes=\"(max-width: 900px) 100vw, 900px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"check-all-project-references\">Check All Project References<\/h3>\n\n\n\n<p>This option will comb through all applications in the current project to find any additional apps referenced in those project apps (i.e. Option List Retrievals, Imports, Smartlinks, Workflow apps, etc). Selecting this option will automatically add any found applications referenced to the current project. <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview The purpose of this utility is to allow developers the ability to promote their applications to a production environment so applications can be accessed by their users. This utility will allow the developer the ability to access the necessary components directly in the m-Power interface. Video Project Applications A&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[262],"ht-kb-tag":[],"class_list":["post-5006","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-utilities"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/5006","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=5006"}],"version-history":[{"count":32,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/5006\/revisions"}],"predecessor-version":[{"id":11955,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/5006\/revisions\/11955"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=5006"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=5006"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=5006"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}