...
at.java_home.path
specifies a path to java executable to launch the Service with.It should be set only in one case - if Jira is not running on Java 8. Read more here.
Default Value: not set
at.java_startup.args
- defines the list of additional java command line options when starting the ActivityTimeline service.It is possible to set custom java heap memory settings, temp folder path etc.
Default Value: not set
at.service.port
- defines port that ActivityTimeline will launch the service on. By default, the app picks a random free port available in the operating system. You may set this setting and the app will always use the specified port number.Possible values: number in range between 1025 and 65536
Default Value: not set
at.manager_service.port
- defines port that ActivityTimeline manager service will listen to. It controls the state of ActivityTimeline service. By default, the app picks a random free port available in the operating system. You may set this setting and the app will always use the specified port number.Possible values: number in range between 1025 and 65536
Default Value: not set
at.jira_connection.url
- Defines a local accessible Jira home URL or IP address with context path. This setting is determined automatically and there is no need to customize it in 99% of environments.Allowed value: string, Url or IP address of Jira including context path. Example: https://1.2.3.4:8080/jira
Default Value: not set
at.jira.node1.url
,at.jira.node2.url
,at.jira.node3.url
,at.jira.node4.url
-Status colour Blue title 9.4.0+ at.jira.node5.url
,at.jira.node6.url
,at.jira.node7.url
,at.jira.node8.url
Status colour Blue title 9.6.0+
These settings can override the connection URL of each Jira node. Allows to manually specify local URL of each Jira DC node (e.g. when using external proxy/lb, different docker public/private ports etc.). Supports up to 4 Jira DC nodes
or up to 8 Jira DC nodesStatus colour Blue title 9.4.0+
.Status colour Blue title 9.6.0+ Format: [node id]@[node url]
Example: "at.jira.node1.url=node-11111111@http://serveraddress:8080"
Default Value: not set
at.force_https_for_internal_communication_between_nodes
- This setting can force internal communication to use https scheme instead of http. By default, the system automatically picks the proper scheme based on available Jira instance Tomcat connectors. It could be set to true only if there is a Jira Connector on https scheme with configured SSL on Tomcat: SSLEnabled=”true”.Possible values: true; false
Default Values: not set
at.db_connections_max
- This setting specifies the maximum number of active connections to database the app can maintain at any given time. By default, it can maintain up to 25 simultaneous active connections. The value must be larger thanStatus colour Blue title 8.2.0+ at.db_connections_max_idle
andat.db_connections_min_idle
.Possible values: integer number starting from 10
Default Value: not set
at.db_connections_max_idle
- This setting specifies the maximum number of idle connections to database the app can maintain at any given time. By default, it maintains up to 15 idle connections. The value must be larger thanStatus colour Blue title 8.2.0+ at.db_connections_max_idle
and less thanat.db_connections_max
.Possible values: integer number starting from 5
Default Value: not set
at.db_connections_min_idle
- This setting specifies the minimum number of idle connections to database the app should maintain at any given time. By default, it maintains 1 idle connection. The value must be less thanStatus colour Blue title 8.2.0+ at.db_connections_max_idle
andat.db_connections_max
.Possible values: integer numbers starting from 1
Default Value: not set
...
This usually happens if there is no connection between ActivityTimeline app/Jira and ActivityTimeline service process; Or when ActivityTimeline service cannot start.
Troubleshooting options:
Make sure there is at least 1.5GB of free RAM still available for Jira process before enabling ActivityTimeline app. ActivityTimeline app & service is using up to 1GB of RAM in the default configuration.
Status colour Blue title before 9.0.0 Make sure Jira is running on Java 8. If Jira is running on Java 11 or higher then please make sure to follow this guide to configure ActivityTimeline service to utilize Java 8 even if Jira is running on Java 11 at this page:ActivityTimeline on Jira Server/DC that is running on Java 11If Jira instance is configured to have just an AJP Tomcat connector for communication with Apache HTTPD proxy service then it is required to add an additional http or https scheme Connector in Jira’s Tomcat server.xml configuration file.
Check firewall rules. Please make sure the firewall does not block local (localhost) connection between Jira process and ActivityTimeline process or their ports. You may set specific ports for ActivityTimeline service/manager service (mentioned above) if you would like to define specific firewall rules for them.
Check antivirus software configuration and its vault on the Jira server. An antivirus software may quarantine the app file or block the service process in very rare cases.
Updates from Jira are not reflected on ActivityTimeline dashboards
This can happen if the synchronization job fails to pull the latest incremental updates from Jira API.
For example, if specific user was set as Synchronization User and then got disabled or removed from Jira later on.
Troubleshooting options:
Update the default Synchronization User (admin user who installed the app) or “ActivityTimeline Addon Sync User” (addon_activitytimeline_sync_user) if:
that user was disabled or removed from Jira
that user does not have Browse Project permission to specific Jira Projects
Open Jira → ActivityTimeline → Configuration → Setup Wizard page. Choose to use current user or custom app user (addon_activitytimeline_sync_user) and click NEXT button. You may close the page now and skip the remaining steps of Setup Wizard as the synchronization user is already updated and saved.
Issues from some projects are missing on ActivityTimeline dashboards
This can happen if the specific projects are not enabled to be managed within ActivityTimeline app or synchronization user does not have Jira permission to “see” issues of that project (Browse Project permission).
Troubleshooting options:
Check if that project is enabled in ActivityTimeline at Jira → ActivityTimeline → Configuration → Projects page. Check if there is a checkbox ticked next to the missing project. Tick that checkbox and then click on a small green sync icon next to it to reload/refresh issues of that project into ActivityTimeline dashboards.
Check permissions of Synchronization user (you may login into Jira as that user and check if issues or required projects are visible to that user).
ActivityTimeline dashboards behave slower than usual
This can happen if there is an increased number of simultaneous users that perform changes on ActivityTimeline dashboards, generate reports and track time.
Troubleshooting options:
Increase the default memory limit for ActivityTimeline app/service. Instructions are available at the following page: Increasing memory for ActivityTimeline Service on a large Jira Server/DC instance
The previous ActivityTimeline service process did not stop after Jira restart
This situation can happen in a very rare occasion when there are no enough system resources like RAM to initiate a proper shutdown of ActivityTimeline service and free up its resources.
By default, ActivityTimeline service checks if it is bound to a Jira/ActivityTimeline app process every 10 minutes. If it finds out that it is orphan (was linked to the previous Jira process) then it will automatically terminate itself.
Troubleshooting options:
If ActivityTimeline did not shutdown itself properly after more than 15 minutes then it is possible to simply kill the process using native Linux or Windows commands/UI.
You can find the process by the launch parameters of the process and terminate it manually:
Linux:
ps -ef | grep ActivityTimelineService.jar
sudo kill -9 <PROCESS_ID_FROM_PREVIOUS_COMMAND>
Windows
Open process explorer
find java.exe process that has ActivityTimelineService.jar listed in the launch parameters
terminate that process
If you are experiencing some other problem that is not described here, please don’t hesitate to contact our team at support@reliex.com.