{"id":13937,"date":"2020-04-19T22:30:36","date_gmt":"2020-04-19T20:30:36","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/"},"modified":"2020-04-19T22:30:36","modified_gmt":"2020-04-19T20:30:36","slug":"documentum-xplore-installer-refuses-to-start-because-of-multiple-launches","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/","title":{"rendered":"Documentum &#8211; xPlore installer refuses to start because of &#8216;Multiple launches&#8217;"},"content":{"rendered":"<p>While working with xPlore, you might have faced before a message saying that an xPlore installer refused to start because it is not allowed to run multiple instances at the same time. This could have happened while running any installer: binaries, patches, dsearch, aso&#8230; However, when checking the processes, there is only one running and that&#8217;s the one you just started.<\/p>\n<p>&nbsp;<\/p>\n<p>That&#8217;s actually a very old and very persistent issue since it&#8217;s there at least since xPlore 1.2 and it&#8217;s still the same for the latest version. It is already documented in the OpenText <a href=\"https:\/\/knowledge.opentext.com\/knowledge\/cs.dll\/kcs\/kbarticle\/view\/KB7867004\" target=\"_blank\" rel=\"noopener noreferrer\">KB7867004<\/a>. In the KB, only xPlore 1.2 to 1.4 are mentioned and only for a xPlore patch installation. The truth is that it&#8217;s still true even for the most recent 16.x version and it&#8217;s not limited to patches, you might have that for all installers as I mentioned before, because they are all built using the same soft. I wanted to talk about this issue in this blog because it&#8217;s probably something that might happen more and more with the DevOps approach. With ordinary Virtual Machines, you might face this once but then it&#8217;s fixed, you won&#8217;t see it again. In the DevOps world, if it&#8217;s not done properly, it&#8217;s something that might repeat a few times until it&#8217;s really fixed at the root of the issue.<\/p>\n<p>&nbsp;<\/p>\n<p>So what&#8217;s this issue? As mentioned, it actually comes from the installer itself. You probably know that OpenText inherited from Dell and EMC before that of the &#8220;InstallAnywhere&#8221; installers. The issue here usually comes when there are wrong permissions on the home folder. The InstallAnywhere creates hidden files\/folders under the home folder (<em>E.g.:<\/em> ~\/.com.zerog.registry.xml) for the installation which register all components present. In case it&#8217;s not possible to create that, the installer fails to start with the message I mentioned above. This is something that you might be facing while using containers because of several things. Here are some potential examples:<\/p>\n<ul>\n<li>the home folder of your installation owner (xplore or whatever the name) was left with root permissions<\/li>\n<li>xPlore binaries were installed properly in an image but then at the runtime, it wasn&#8217;t mounted properly (if it&#8217;s a volume)<\/li>\n<li>something changed the permissions<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p>To replicate the issue quickly, you can just start the Dsearch installer for example. Here I&#8217;m using a silent properties file because there is no GUI:<\/p>\n<pre class=\"brush: bash; gutter: true; first-line: 1; highlight: [1,6,8,11,14]\">[xplore@ds-0 ~]$ $XPLORE_HOME\/setup\/dsearch\/dsearchConfig.bin LAX_VM \"$JAVA_HOME\/bin\/java\" -f $XPLORE_HOME\/setup\/FT_Dsearch.properties\nPreparing to install\nExtracting the installation resources from the installer archive...\nConfiguring the installer for this system's environment...\n\nLaunching installer...\n\nMultiple launches of this installer is not allowed. It will now quit.\n[xplore@ds-0 ~]$\n[xplore@ds-0 ~]$ ls -ld $HOME\ndrwx------ 1 root root 4096 Mar 21 15:29 \/home\/xplore\n[xplore@ds-0 ~]$\n[xplore@ds-0 ~]$ ls -l $HOME\nls: cannot open directory \/home\/xplore\/: Permission denied\n[xplore@ds-0 ~]$<\/pre>\n<p>&nbsp;<\/p>\n<p>If you have the above behavior, then you just need to correct the permissions on the home folder. If this is inside a container (docker or other) or inside a Kubernetes pod for example, then you will need to find where exactly the issue is coming from and fix it there but for that I cannot help you because it depends on the infrastructure you put together. To validate the solution quickly:<\/p>\n<pre class=\"brush: bash; gutter: true; first-line: 1; highlight: [5,10,13,14,15]\">[root@ds-0 \/]# chown -R xplore:xplore \/home\/xplore\n[root@ds-0 \/]#\n[root@ds-0 \/]# su - xplore\n[xplore@ds-0 ~]$\n[xplore@ds-0 ~]$ $XPLORE_HOME\/setup\/dsearch\/dsearchConfig.bin LAX_VM \"$JAVA_HOME\/bin\/java\" -f $XPLORE_HOME\/setup\/FT_Dsearch.properties\nPreparing to install\nExtracting the installation resources from the installer archive...\nConfiguring the installer for this system's environment...\n\nLaunching installer...\n\n[xplore@ds-0 ~]$\n[xplore@ds-0 ~]$ grep \".version\" $XPLORE_HOME\/installinfo\/instances\/dsearch\/PrimaryDsearch.properties\ness.version=16.4.0000\nappserver.version=9.0.1\n[xplore@ds-0 ~]$<\/pre>\n<p>&nbsp;<\/p>\n<p>The error message could be clearer, mentioning that there is a permission issue with the home folder but at least, it&#8217;s not failing silently. I guess that&#8217;s at least a good point.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>While working with xPlore, you might have faced before a message saying that an xPlore installer refused to start because it is not allowed to run multiple instances at the same time. This could have happened while running any installer: binaries, patches, dsearch, aso&#8230; However, when checking the processes, there is only one running and [&hellip;]<\/p>\n","protected":false},"author":20,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[197,525],"tags":[962,1903,1621,129,1904,474],"type_dbi":[],"class_list":["post-13937","post","type-post","status-publish","format-standard","hentry","category-application-integration-middleware","category-enterprise-content-management","tag-1-5","tag-1-6","tag-16-4","tag-documentum","tag-installanywhere","tag-xplore"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.2 (Yoast SEO v27.2) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Documentum - xPlore installer refuses to start because of &#039;Multiple launches&#039; - dbi Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Documentum - xPlore installer refuses to start because of &#039;Multiple launches&#039;\" \/>\n<meta property=\"og:description\" content=\"While working with xPlore, you might have faced before a message saying that an xPlore installer refused to start because it is not allowed to run multiple instances at the same time. This could have happened while running any installer: binaries, patches, dsearch, aso&#8230; However, when checking the processes, there is only one running and [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\" \/>\n<meta property=\"og:site_name\" content=\"dbi Blog\" \/>\n<meta property=\"article:published_time\" content=\"2020-04-19T20:30:36+00:00\" \/>\n<meta name=\"author\" content=\"Morgan Patou\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@MorganPatou\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Morgan Patou\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\"},\"author\":{\"name\":\"Morgan Patou\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/c4d05b25843a9bc2ab20415dae6bd2d8\"},\"headline\":\"Documentum &#8211; xPlore installer refuses to start because of &#8216;Multiple launches&#8217;\",\"datePublished\":\"2020-04-19T20:30:36+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\"},\"wordCount\":532,\"commentCount\":0,\"keywords\":[\"1.5\",\"1.6\",\"16.4\",\"Documentum\",\"InstallAnywhere\",\"xPlore\"],\"articleSection\":[\"Application integration &amp; Middleware\",\"Enterprise content management\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\",\"name\":\"Documentum - xPlore installer refuses to start because of 'Multiple launches' - dbi Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\"},\"datePublished\":\"2020-04-19T20:30:36+00:00\",\"author\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/c4d05b25843a9bc2ab20415dae6bd2d8\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\/\/www.dbi-services.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentum &#8211; xPlore installer refuses to start because of &#8216;Multiple launches&#8217;\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/\",\"name\":\"dbi Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/c4d05b25843a9bc2ab20415dae6bd2d8\",\"name\":\"Morgan Patou\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/5d7f5bec8b597db68a09107a6f5309e3870d6296ef94fb10ead4b09454ca67e5?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/5d7f5bec8b597db68a09107a6f5309e3870d6296ef94fb10ead4b09454ca67e5?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/5d7f5bec8b597db68a09107a6f5309e3870d6296ef94fb10ead4b09454ca67e5?s=96&d=mm&r=g\",\"caption\":\"Morgan Patou\"},\"description\":\"Morgan Patou has over 12 years of experience in Enterprise Content Management (ECM) systems, with a strong focus in recent years on platforms such as Alfresco, Documentum, and M-Files. He specializes in the architecture, setup, customization, and maintenance of ECM infrastructures in complex &amp; critical environments. Morgan is well-versed in both engineering and operations aspects, including high availability design, system integration, and lifecycle management. He also has a solid foundation in open-source and proprietary technologies - ranging from Apache, OpenLDAP or Kerberos to enterprise-grade systems like WebLogic. Morgan Patou holds an Engineering Degree in Computer Science from ENSISA (\u00c9cole Nationale Sup\u00e9rieure d'Ing\u00e9nieurs Sud Alsace) in Mulhouse, France. He is Alfresco Content Services Certified Administrator (ACSCA), Alfresco Content Services Certified Engineer (ACSCE) as well as OpenText Documentum Certified Administrator. His industry experience spans the Public Sector, IT Services, Financial Services\/Banking, and the Pharmaceutical industry.\",\"sameAs\":[\"https:\/\/blog.dbi-services.com\/author\/morgan-patou\/\",\"https:\/\/x.com\/MorganPatou\"],\"url\":\"https:\/\/www.dbi-services.com\/blog\/author\/morgan-patou\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Documentum - xPlore installer refuses to start because of 'Multiple launches' - dbi Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/","og_locale":"en_US","og_type":"article","og_title":"Documentum - xPlore installer refuses to start because of 'Multiple launches'","og_description":"While working with xPlore, you might have faced before a message saying that an xPlore installer refused to start because it is not allowed to run multiple instances at the same time. This could have happened while running any installer: binaries, patches, dsearch, aso&#8230; However, when checking the processes, there is only one running and [&hellip;]","og_url":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/","og_site_name":"dbi Blog","article_published_time":"2020-04-19T20:30:36+00:00","author":"Morgan Patou","twitter_card":"summary_large_image","twitter_creator":"@MorganPatou","twitter_misc":{"Written by":"Morgan Patou","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#article","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/"},"author":{"name":"Morgan Patou","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/c4d05b25843a9bc2ab20415dae6bd2d8"},"headline":"Documentum &#8211; xPlore installer refuses to start because of &#8216;Multiple launches&#8217;","datePublished":"2020-04-19T20:30:36+00:00","mainEntityOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/"},"wordCount":532,"commentCount":0,"keywords":["1.5","1.6","16.4","Documentum","InstallAnywhere","xPlore"],"articleSection":["Application integration &amp; Middleware","Enterprise content management"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/","url":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/","name":"Documentum - xPlore installer refuses to start because of 'Multiple launches' - dbi Blog","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/#website"},"datePublished":"2020-04-19T20:30:36+00:00","author":{"@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/c4d05b25843a9bc2ab20415dae6bd2d8"},"breadcrumb":{"@id":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.dbi-services.com\/blog\/documentum-xplore-installer-refuses-to-start-because-of-multiple-launches\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.dbi-services.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Documentum &#8211; xPlore installer refuses to start because of &#8216;Multiple launches&#8217;"}]},{"@type":"WebSite","@id":"https:\/\/www.dbi-services.com\/blog\/#website","url":"https:\/\/www.dbi-services.com\/blog\/","name":"dbi Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/c4d05b25843a9bc2ab20415dae6bd2d8","name":"Morgan Patou","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/5d7f5bec8b597db68a09107a6f5309e3870d6296ef94fb10ead4b09454ca67e5?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/5d7f5bec8b597db68a09107a6f5309e3870d6296ef94fb10ead4b09454ca67e5?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/5d7f5bec8b597db68a09107a6f5309e3870d6296ef94fb10ead4b09454ca67e5?s=96&d=mm&r=g","caption":"Morgan Patou"},"description":"Morgan Patou has over 12 years of experience in Enterprise Content Management (ECM) systems, with a strong focus in recent years on platforms such as Alfresco, Documentum, and M-Files. He specializes in the architecture, setup, customization, and maintenance of ECM infrastructures in complex &amp; critical environments. Morgan is well-versed in both engineering and operations aspects, including high availability design, system integration, and lifecycle management. He also has a solid foundation in open-source and proprietary technologies - ranging from Apache, OpenLDAP or Kerberos to enterprise-grade systems like WebLogic. Morgan Patou holds an Engineering Degree in Computer Science from ENSISA (\u00c9cole Nationale Sup\u00e9rieure d'Ing\u00e9nieurs Sud Alsace) in Mulhouse, France. He is Alfresco Content Services Certified Administrator (ACSCA), Alfresco Content Services Certified Engineer (ACSCE) as well as OpenText Documentum Certified Administrator. His industry experience spans the Public Sector, IT Services, Financial Services\/Banking, and the Pharmaceutical industry.","sameAs":["https:\/\/blog.dbi-services.com\/author\/morgan-patou\/","https:\/\/x.com\/MorganPatou"],"url":"https:\/\/www.dbi-services.com\/blog\/author\/morgan-patou\/"}]}},"_links":{"self":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/13937","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/comments?post=13937"}],"version-history":[{"count":0,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/13937\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media?parent=13937"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/categories?post=13937"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/tags?post=13937"},{"taxonomy":"type","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/type_dbi?post=13937"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}