Installing on Linux Servers without a Graphical Environment - 10.x

Note: The Linux installer will not run in the MacOS terminal.

Mark the installer file as executable: chmod +x ./ACLI-9.3.0-installer.run
Start the installer with the following command: ./ACLI-9.3.0-installer.run
The installer will present a welcome message from Bob Swift and prompt to review the End User License Agreement (EULA).
____ __ _____ _ ______ / __ )____ / /_ / ___/ __(_) __/ /_ / __ / __ \/ __ \ \__ \ | /| / / / /_/ __/ / /_/ / /_/ / /_/ / ___/ / |/ |/ / / __/ /_ /_____/\____/_.___/ /____/|__/|__/_/_/ \__/ ___ __ __ _ __ / | / /_/ /___ ___________(_)___ _____ / | ____ ____ _____ / /| |/ __/ / __ `/ ___/ ___/ / __ `/ __ \ / /| | / __ \/ __ \/ ___/ / ___ / /_/ / /_/ (__ |__ ) / /_/ / / / / / ___ |/ /_/ / /_/ (__ ) /_/ |_\__/_/\__,_/____/____/_/\__,_/_/ /_/ /_/ |_/ .___/ .___/____/ ---------------------------------------------------------------------------- You're a few clicks away from unleashing hundreds of unique, automated actions across your Atlassian tools. Since I first started developing the CLI clients in 2007, we've added support for hundreds of unique actions across Jira, Confluence, Bitbucket, Bamboo, and more. I think you'll find that once you have this much control at your fingertips, you'll want to automate more and more tasks to save time, cut down on manual work, and standardize your processes. And if you have any questions, please don't hesitate to reach out. We're here to help! Thank you for inspiring us to create great products. You're the reason we build software! :) - Bob Swift ---------------------------------------------------------------------------- Please review the end user license agreement and accept the agreement in order to proceed with the installation. The Bob Swift CLI client distribution and CLI add-ons includes a variety of open source libraries. Those licenses may be found in the license folder beneath the installation folder. Press [Enter] to continue:
Review the EULA and press enter/return to proceed. Type ‘y' and press enter/return to accept or 'n’ and press enter/return to decline and cancel the installation.
Copyright (c) 2005, 2020 Appfire Technologies, Inc. All rights reserved. This software is licensed under the provisions of the "Bob Swift Atlassian App EULA" (https://bobswift.atlassian.net/wiki/x/WoDXBQ) as well as under the provisions of the "Standard EULA" from the "Atlassian Marketplace Terms of Use" as a "Marketplace Product" (http://www.atlassian.com/licensing/marketplace/termsofuse). Press [Enter] to continue: Do you accept this license? [y/n]:
Specify where you wish to install the Bob Swift CLI. This defaults to the folder “ACLI” underneath your user directory. Optionally type a new destination and press enter/return. Press enter/return without typing to accept the default.
---------------------------------------------------------------------------- Please specify the directory where Bob Swift Command Line Interface (CLI) will be installed. Installation Directory [/home/bobswift/ACLI]:
Optionally enroll in a getting started email newsletter subscription. Type ‘n' and enter/return to decline enrollment. Otherwise type 'y’ and/or enter/return to provide your contact information.
May we send you helpful getting started articles? [Y/n]: ---------------------------------------------------------------------------- Get help getting started We have a wealth of knowledge we'd like to share with you to get the most out of the CLI. Email: []: bobswift@examplegear.com First name []: Bob Last name []: Swift
If your installation directory contains a Bob Swift CLI installation prior to 9.2, then you will be prompted to confirm whether to overwrite it and given the option for the installer to make backups of user modifiable files.
Overwrite existing CLI files [y/N]: y ---------------------------------------------------------------------------- The installer found evidence of what appears to be a previous CLI installation in /home/bobswift/ACLI. The installation can make backups (.bak) of properties files and scripts. It will remove no longer needed files in the lib folder, and replace files found in the license folder. If you wish to preserve any files seperately, please make a backup of them before proceeding with the installation. Create backup (.bak) files [y/N]:
Choose how you would like to initially configure the Bob Swift CLI installation and then click “Next”. Based on your selection the installer may prompt you for additional connection properties.
In the illustration below option 1 (Atlassian’s Cloud (Jira + Confluence) is selected.
1. Configure CLI connections for:
  1. Atlassian’s Cloud (Jira + Confluence)
    Configure the CLI to connect to an Atlassian hosted instance of Jira (and Confluence if subscribed).
  2. Self hosted server(s)
    Choose this option if you self-host (in your own data center or in a private cloud) the Server or Data Center editions of Jira and/or Confluence.
  3. None (skip this configuration)
    The installer will configure example CLI connections, but will not prompt for any additional connection properties.
2. Add your installation directory to the user path…
  The installer will configure your environment to make it easier to launch the Bob Swift CLI from any location on your desktop.
3. Run a simple test of the CLI to verify it is working.
  The installer will use the configuration information from this dialog to create a test script to verify the CLI installed correctly.
  ---------------------------------------------------------------------------- Installation options Configure CLI connection(s) for: [1] Atlassian's Cloud (Jira + Confluence) [2] : Self hosted server(s) [3] None (skip configuration) Please choose an option [1] : Atlassian's Cloud (Jira + Confluence) Add '/home/bobswift/ACLI' to the user path so you can run the CLI from any directory. [Y/n]: Run a simple test of the CLI to verify it is working. [Y/n]:
Provide CLI connection properties:
Configuration options in the illustration below continue to reflect option 1 (Atlassian’s Cloud (Jira + Confluence) from the previous step.
1. Jira URL: The web address of your Atlassian hosted Jira instance.
2. Connection name (no spaces): A nickname for this connection for easy reference when issuing CLI commands to be executed using this connection. Defaults to ‘default’.
3. Login required…: Indicates if the Jira instance requires a user email and API token to connect or not (aka anonymous access). Defaults to 'Y'.
  1. User Email: The email address of the user account with which the CLI should connect.
  2. API token: The API token of the user account with which the CLI should connect. API tokens are required by the Atlassian cloud to connect (login) when not using a web browser.
    ---------------------------------------------------------------------------- Configure your Jira connection Jira URL []: https://bobswift.atlassian.net Connection name (no spaces) [default]: Login required (Untick to connect anonymously) [Y/n]: ---------------------------------------------------------------------------- User Email []: bobswift@examplegear.com API token []: a61df446ac90468fb2b8839831938e18
The installer is now to ready to install the Bob Swift CLI and apply your configuration preferences.
---------------------------------------------------------------------------- Setup is now ready to begin installing Bob Swift Command Line Interface (CLI) on your computer. Do you want to continue? [Y/n]:
The installer will now show progress of setup.
---------------------------------------------------------------------------- Please wait while Setup installs Bob Swift Command Line Interface (CLI) on your computer. Installing 0% ______________ 50% ______________ 100% ########################################
If you chose “Run a simple test of the CLI to verify it is working” earlier you will see the results of the test. The test results will vary based on your earlier configuration selections.
Info: Now testing the Bob Swift CLI. In the next screen you will see the results of the CLI gathering information about your CLI configuration. Press [Enter] to continue: CLI Testing Results Below are the results of testing the CLI using the configuration information provided earlier. Client information Client name . . . . . . . . . : cli Client version . . . . . . . : 9.3.0-SNAPSHOT Client description . . . . . : Base client for the Atlassian Command Line Interface. Client usage . . . . . . . . : The cli client is the base for all other clients and defines common actions and parameters. OS name . . . . . . . . . . . : Linux OS version . . . . . . . . . : 5.0.0-38-generic Java name . . . . . . . . . . : OpenJDK 64-Bit Server VM Java version . . . . . . . . : 11.0.6 Java arguments . . . . . . . : -Dfile.encoding=UTF-8 Used memory (MB) . . . . . . : 3 Free memory (MB) . . . . . . : 12 Total memory (MB) . . . . . . : 15 Max memory (MB) . . . . . . . : 237 Default encoding . . . . . . : UTF-8 Configuration file . . . . . : /home/bobswift/ACLI/acli.properties Server info Product . . . . . . . . . . . : Jira Hosting . . . . . . . . . . . : cloud Version . . . . . . . . . . . : 1001.0.0-SNAPSHOT Base URL . . . . . . . . . . : https://bobswift.atlassian.net Title . . . . . . . . . . . . : Jira for Bob Swift Atlassian Apps Build . . . . . . . . . . . . : 100122 Build date . . . . . . . . . : 3/18/20, 12:44 AM Current time . . . . . . . . : License information . . . . . : Not available for this Cloud instance. Client . . . . . . . . . . . : jiracloud User . . . . . . . . . . . . : anonymous Response time (milliseconds) : 982 Press [Enter] to continue:
Once concluded, the Installer presents an option to view the readme file for the installed release. Defaults to 'Y'.
---------------------------------------------------------------------------- Setup has finished installing Bob Swift Command Line Interface (CLI) on your computer. View Readme file? [Y/n]:
You can now launch the Bob Swift CLI via the console command: acli.