Installing IBM® Worklight® Command Line Interface (Worklight-CLI) is quite simple, and is available to be downloaded from the following URL: http://www.ibm.com/developerworks/mobile/worklight/download
After downloading Worklight-CLI, move the worklight_cli_installer_x.y.z .zip file to an appropriate folder and unzip it. The CLI is packaged as a single compressed file, which contains installation executable files for each platform, as listed:
Select and run the installer that is appropriate for your platform:
Windows: Double click install_windows.exe
Linux: $ ./install_linux.bin
Mac: Double click install_mac.app
Follow the instruction of the installation wizard to continue the installation of Command Line Interface for IBM Worklight Developers. The installation process consists of the following six panels:
Introduction panel: Gives you general instructions on how to use the GUI.
License agreement panel: Displays both the software license agreement and the non-IBM terms that you must agree to in order to move forward with the installation process.
Choose install folder panel: A default folder is provided depending on the platform you are using. You can either accept the default folder or change it.
Pre-Install summary panel: Displays detailed information about the installation that you must review. If the information is incorrect, return to the panel in which the error occurs and fix it. If the information is correct, click Install.
Installation progress panel: Display the progress of the installation of Worklight-CLI.
Post-Install panel: Displays if Worklight-CLI was successfully installed, or if an error occurred during the installation. This panel also displays the path where Worklight-CLI is installed and the path where you can find the installation logs.
At this point you have Worklight-CLI installed on your machine. So... what is next? Before you can start using Worklight-CLI, complete the following step that is appropriate for the platform where Worklight-CLI is installed.
Windows: Nothing to do! Open a CMD window and type “wl help” to start playing with Worklight-CLI.
Linux and Mac: To ensure Worklight-CLI will work as expected, you must refresh your shell by logging out/in. After doing this, open a Terminal window and type “wl help” to start playing with Worklight-CLI.
Now you are done! It wasn't so bad, right? Go ahead and start developing some cool apps!
Alternative Installation modes (only for Windows and Linux)
Worklight-CLI can be installed using console mode, which has the same panels the GUI has, but it runs in a terminal window.
At this point you must be wondering... How can I enable this way too cool installation mode?
It's quite simple, actually. Depending on your platform, run the appropriate command:
Windows: install_windows.exe -i console
Linux: ./install_linux.bin -i console
If you have more than one system to install and you already know which installation options you want, you can use the unattended installation process.
First of all, you must complete one attended installation by using the GUI or Console installation. After you complete that first attended installation, an “installer.properties” response file is created in the same folder of the installer. This file contains the options for the completed attended installation. Therefore, you can reuse this response file for subsequent installations that use the same options.
Here is a sample of what installer.properties looks like:
# Indicate whether the license agreement has been accepted
# Choose Install Folder
# Uncomment one of the properties below, and (optionally) change the value
# if you prefer to install to a non-default location.
# Linux default
# Windows default
But be careful; the installer.properties file is overwritten each time you start a new installation. To prevent the file from being overwritten, rename the file.
To enable this installation mode, run the installer with one of the following commands, depending on your platform:
Windows: install_windows.exe -i silent -f /path/to/installer.properties
Linux: ./install_linux.bin -i silent -f /path/to/installer.properties