{"id":24463,"date":"2024-02-15T14:53:34","date_gmt":"2024-02-15T22:53:34","guid":{"rendered":"https:\/\/docs.extraview.com\/v25\/book\/running-integration-daemon-6\/"},"modified":"2025-04-23T09:46:01","modified_gmt":"2025-04-23T16:46:01","slug":"running-integration-daemon-6","status":"publish","type":"page","link":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/","title":{"rendered":"Running the Integration Daemon"},"content":{"rendered":"<h3>Summary of Steps to Start Integration Daemon<\/h3>\n<p>The following steps are documented for both Microsoft Windows and Linux operating system installations. On Windows, the servers are normally started as Windows Services, although they can be started from the command-line for troubleshooting purposes. On Linux and other operating systems the servers are started on the command-line and run as background processes.<\/p>\n<ul>\n<li>Start the ExtraView server<\/li>\n<li>Start the Perforce server<\/li>\n<li>Start the Integration Daemon<\/li>\n<\/ul>\n<h3>Start ExtraView Server<\/h3>\n<p>Start the application server that deploys the ExtraView application. Once the application server is started, connect to the ExtraView application with a web browser or other client from the machine where the integration daemon is installed in order to ensure connectivity from the integration daemon to the ExtraView application.<\/p>\n<h3>Start Perforce Server<\/h3>\n<p>Start Perforce according to its product documentation. For example, on Windows start the Perforce Service to start Perforce. Once the Perforce server is started, connect to the Perforce server with the p4 client from the machine where the integration daemon is installed in order to ensure connectivity from the integration daemon to the Perforce server.<\/p>\n<h3>Start Integration Daemon<\/h3>\n<p>On Microsoft Windows, if the integration daemon was installed as a Windows Service, then simply start the service named ExtraViewIntegrationDaemon. To start the integration daemon on the command-line, you must first open a Command Prompt window and change the current directory to the installation directory, INTEGRATION_HOME:<\/p>\n<pre>cd INTEGRATION_HOME\n<\/pre>\n<p>Next, execute the <span class=\"fixedWidthFont\">start_daemon.bat<\/span> script. The following lines are written to the Command Prompt window as the integration daemon starts:<\/p>\n<pre><code>C:\\ExtraView\\integrationdaemon&gt;start_daemon.bat\nPerforce Integration Daemon Started\n Setting event log:C:\\ExtraView\\integrationdaemon\\logs\nAttempting to Open Log File: C:\\ExtraView\\integrationdaemon\\logs\\error.log\nLog is:C:\\ExtraView\\integrationdaemon\\logs\\error.log\nRunning without a queue...<\/code><\/pre>\n<p>On Linux, execute the following commands to start the integration daemon:<\/p>\n<pre><code>cd INTEGRATION_HOME\n.\/start_daemon.sh<\/code><\/pre>\n<h3>Stop Integration Daemon<\/h3>\n<p>On Microsoft Windows, if the integration daemon was installed as a Windows Service, then simply stop the service named ExtraViewIntegrationDaemon. To stop the integration daemon on the command-line, type [Ctrl]+C on the Command Prompt window where you started the integration daemon. For example:<\/p>\n<pre><code>...\nRunning without a queue...\n[TYPE Ctrl+C HERE]\nTerminate batch job (Y\/N)? y\nC:\\ExtraView\\integrationdaemon&gt;<\/code><\/pre>\n<p>On Linux, stop the start_daemon.sh script when it is running in the foreground. If the integration daemon is running in the background (e.g., using nohup or &amp;), then find the process id of the java process running the <span class=\"fixedWidthFont\">com.extraview.sccintegration.common.IntegrationDaemon<\/span> program and stop or kill the process.<\/p>\n<h3>State File \u2013 state.properties<\/h3>\n<p>Certain dynamic runtime state variables are maintained in a persistent properties file, named state.properties. This file is maintained in the \u201cdata\u201d directory and it must be available for writing by the application (e.g., privileges are set appropriately and the file must not be \u201cin use by another application\u201d). The state file contains the state of progress data about the application, such as the latest ExtraView history already processed or the latest change number processed in Perforce. Since state information is maintained internally during the operation of the daemon, it will do no good to modify the values in this file while the daemon is running. The values can be modified when the daemon is not running, and the new values will be used when the daemon starts. The following keys and values are examples of state properties; note that all timestamps are maintained in a universal timestamp format, including time zone.<\/p>\n<pre><code>EV_TIMESTAMP=2004-11-27 14:26:49.000 -0800\nP4_CHANGE=48\nP4_TIMESTAMP=2004-11-29 13:05:38.000 -0800<\/code><\/pre>\n<p>The state.properties file is located in the <code>INTEGRATION_HOME\/data\/Perforce<\/code> folder. The file must be writable for the integration daemon process. It is possible to edit this file manually to rework some transactions or correct an error. However, if you do this, you must be careful to preserve the syntax and format of the file.<\/p>\n<h3>Error Log<\/h3>\n<p>The default location for the file error.log is in the logs subdirectory of the directory in which the Integration Daemon is installed. The log file contains entries recounting integration daemon activity, including exceptions and other entries depending upon the log level setting. Log information includes the P4 job names that matched and mapped to ExtraView issues, ExtraView issue ids that matched and mapped to P4 jobs, the names\/ids of newly created jobs\/issues, actions that failed, and notification of the updating of cutoff thresholds. If the daemon shuts down due to a failure, the log will include as much information about the failure as it is able to ascertain.<\/p>\n<div class=\"textGreyBg\">Note: Configuration errors such as fields mapped incorrectly, may cause the daemon to shut down, and a log entry to be created. This is because continued operation may result in a loss of synchronization of the ExtraView and P4 databases.<\/div>\n<h3>Debug Log<\/h3>\n<p>The Perforce interface log file named debug.log can be found in the same logs directory as the error.log file described above, although this is configurable with specific settings in the p4.properties configuration file. This log file contains entries specific to the Perforce side of the integration, such as commands issued to the Perforce server, any errors or warnings generated while communicating or performing certain operations on the Perforce server, etc.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Summary of Steps to Start Integration Daemon The following steps are documented for both Microsoft Windows and Linux operating system installations. On Windows, the servers are normally started as Windows Services, although they can be started from the command-line for troubleshooting purposes. On Linux and other operating systems the servers are started on the command-line&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":24457,"menu_order":12,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_lmt_disableupdate":"no","_lmt_disable":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"class_list":["post-24463","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Running the Integration Daemon - Product Documentation<\/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:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Running the Integration Daemon - Product Documentation\" \/>\n<meta property=\"og:description\" content=\"Summary of Steps to Start Integration Daemon The following steps are documented for both Microsoft Windows and Linux operating system installations. On Windows, the servers are normally started as Windows Services, although they can be started from the command-line for troubleshooting purposes. On Linux and other operating systems the servers are started on the command-line...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/\" \/>\n<meta property=\"og:site_name\" content=\"Product Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-04-23T16:46:01+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/\",\"url\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/\",\"name\":\"Running the Integration Daemon - Product Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\"},\"datePublished\":\"2024-02-15T22:53:34+00:00\",\"dateModified\":\"2025-04-23T16:46:01+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ExtraView 25\",\"item\":\"https:\/\/docs.extraview.com\/v25\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Integration Guides\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Perforce Integration Guide\",\"item\":\"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Running the Integration Daemon\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#website\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"name\":\"ExtraView Product Documentation\",\"description\":\"ExtraView Documentation\",\"publisher\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#organization\",\"name\":\"ExtraView Corporation\",\"url\":\"https:\/\/docs.extraview.com\/v25\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"contentUrl\":\"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png\",\"width\":512,\"height\":512,\"caption\":\"ExtraView Corporation\"},\"image\":{\"@id\":\"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Running the Integration Daemon - Product Documentation","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:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/","og_locale":"en_US","og_type":"article","og_title":"Running the Integration Daemon - Product Documentation","og_description":"Summary of Steps to Start Integration Daemon The following steps are documented for both Microsoft Windows and Linux operating system installations. On Windows, the servers are normally started as Windows Services, although they can be started from the command-line for troubleshooting purposes. On Linux and other operating systems the servers are started on the command-line...","og_url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/","og_site_name":"Product Documentation","article_modified_time":"2025-04-23T16:46:01+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/","url":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/","name":"Running the Integration Daemon - Product Documentation","isPartOf":{"@id":"https:\/\/docs.extraview.com\/v25\/#website"},"datePublished":"2024-02-15T22:53:34+00:00","dateModified":"2025-04-23T16:46:01+00:00","breadcrumb":{"@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/running-integration-daemon-6\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":2,"name":"ExtraView 25","item":"https:\/\/docs.extraview.com\/v25\/"},{"@type":"ListItem","position":3,"name":"Integration Guides","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/"},{"@type":"ListItem","position":4,"name":"Perforce Integration Guide","item":"https:\/\/docs.extraview.com\/v25\/extraview-25\/integration-guides-1\/perforce-integration-guide-1\/"},{"@type":"ListItem","position":5,"name":"Running the Integration Daemon"}]},{"@type":"WebSite","@id":"https:\/\/docs.extraview.com\/v25\/#website","url":"https:\/\/docs.extraview.com\/v25\/","name":"ExtraView Product Documentation","description":"ExtraView Documentation","publisher":{"@id":"https:\/\/docs.extraview.com\/v25\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/docs.extraview.com\/v25\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/docs.extraview.com\/v25\/#organization","name":"ExtraView Corporation","url":"https:\/\/docs.extraview.com\/v25\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/","url":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","contentUrl":"https:\/\/docs-stg.extraview.com\/wp-content\/uploads\/2024\/03\/favicon.png","width":512,"height":512,"caption":"ExtraView Corporation"},"image":{"@id":"https:\/\/docs.extraview.com\/v25\/#\/schema\/logo\/image\/"}}]}},"taxonomy_info":[],"featured_image_src_large":false,"author_info":{"display_name":"carl.koppel","author_link":"https:\/\/docs.extraview.com\/v25\/author\/carl-koppel\/"},"comment_info":0,"_links":{"self":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24463","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/comments?post=24463"}],"version-history":[{"count":1,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24463\/revisions"}],"predecessor-version":[{"id":29754,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24463\/revisions\/29754"}],"up":[{"embeddable":true,"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/pages\/24457"}],"wp:attachment":[{"href":"https:\/\/docs.extraview.com\/v25\/wp-json\/wp\/v2\/media?parent=24463"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}