Task Adapter installation
Why a stand-alone tool and not SaaS?
TaskAdapter requires access to your task management system (like Atlassian JIRA), which almost always is only accessible inside a corporate network (inside VPN - Virtual Private Network) due to privacy/security considerations. While there are various ways to secure your task management system and let it be accessible outside of your VPN at the same time, they are non-trivial and require constant monitoring and threat analysis and still do not guarantee safety, so most companies decide against them and keep their systems behind VPN.
This is why we decided to make TaskAdapter a stand-alone tool that you can download and run on your local computer or a server which has access to your favorite bug tracker or task management system. This way, unlike with online data transfer tools (SaaS solutions), your data stays inside your network, as well as your user credentials (assuming both systems your want to integrate are within your network, of course). With a stand-alone tool like TaskAdapter you do not need to provide your LDAP logins to a 3rd-party SaaS solution or deal with opening your firewall to a 3rd company with unknown security rules or protocols.
So, first of all - download Task Adapter application.
TaskAdapter system requirements
TaskAdapter is implemented using Scala programming language and thus requires a JRE (Java Runtime Environment) to run. Most computers already have JRE pre-installed. How to get JRE for Windows?
Memory and CPU requirements are minimal, any system with 500Mb of memory (a fraction of what most computers have) will be fine.
Unpack the distributive into any folder (any modern operating system can open ZIP files). Open the folder where you unpacked the application to, then open “bin” sub-folder and run “launcher.bat” (for Windows) or “launcher” (for Linux and Mac OS).
Feel free to explore the start scripts in “bin” folder before launching them: they check if minimum Java version is present on your computer and then launch the app.
TaskAdapter is a web application that will run inside a minimal embedded http server on your computer. You will access it via an internet browser.
Once you launch TaskAdapter application, a default Internet browser will be automatically opened with http://localhost:10842/ta URL. Default port for Task Adapter web application is 10842.
Note that closing the browser window does not stop the server process. You can reopen the web page later while TaskAdapter server is still running. You can stop the server in the console where you started it by pressing CTRL+C. Typically you want to keep the process running if you set it up on a server to be accessible for multiple users in your organization.
Changing port number.
The port number Task Adapter will use for embedded HTTP server can be provided in command line parameters:
Or set it in “launcher.bat” (Windows) and “launcher” files (Linux and Mac OS):
Default account name is “admin” and password is “admin”. If you run this app on a shared computer (on a server) where other people can see it, it is recommended to change the password.
“admin” user can manage other users accounts and edit any data (other users’ configs, for example). Other users can only access data created by them.
When you create a synchronization config with your, say, JIRA credentials or Trello ApiKey, this information is saved in encrypted format.
Use “Configure” link in the page header to change system-wide settings.
Local / server mode
Set “Local / server” mode setting to “LOCAL” if you are running Task Adapter on your local machine. “Server” mode is used for a shared installation when multiple users will need to connect to this Task Adapter. “Server” mode will require you to UPLOAD your Microsoft Project files to Task Adapter server before it can load them and then save to a system like JIRA, Redmine or Github.
All data TaskAdapter requires to operate is stored in <user home>/.taskadapter folder. Sample path for Windows OS: c:\users\myusername.taskadapter
Log file locations: /tmp/taskadapter.log on Linux and MacOS and c:\windows\temp\taskadapter.log on Windows