Installing Jaws Deploy Agent
Every machine (server) you plan to deploy to requires installation of Jaws Deploy Agent. The Agent is a lightweight background service that makes your machine JawsDeploy-enabled by:
- Communicating with Jaws Deploy server.
- Polling for work to be executed.
- Orchestrating deployment execution.
- Reporting progress back to Jaws Deploy server.
On Windows the Agent is installed as a windows service. On Linux it is installed as a systemd
service. The service name is "Jaws Deploy Agent”.
Follow these steps to install Jaws Deploy Agent:
- Go to https://app.jawsdeploy.net and select desired workspace from top bar’s dropdown.
- Click “Machines” in the left menu.
- Click “Add new machine” button.
- Download installation script that matches your machine OS (Windows or Linux).
- Copy the downloaded
install_agent
file to your machine and run it. On Windows elevated PowerShell session is required. On Linux it will require administrator’s permissions. - The installation does not require any user interaction. The agent will be installed to:
- Windows: C:\Program Files\JawsDeploy\Agent
- Linux: /opt/JawsDeploy/Agent
- Agent will start automatically and it will report itself back to Jaws Deploy server in order to perform a handshake and get attached to your workspace.
- Go back to the app and navigate to “Machines” list in your workspace.
- You will find a “Pending handshakes” section on top. Click the “Accept” button. During acceptance it is possible to specify this machine’s environment (this step is optional). The machine will appear in the list below.
Note: If there is a pending handshake that you do not recognize or which you want to re-create (e.g. to change listening port) - click “Reject” in the list of pending handshakes. - Machine is now ready to use. Set its environment add some tags and you are ready to go.