This document describes getting a server and clients up and running for the first time. You have two options:
-
Run the docker image. This is the fastest way to get a basic install up and running for testing. Takes ~2 mins to download the image and initialize the server.
-
Follow these instructions for an automated install on an Ubuntu system. This is a better option for stability and customization. Takes ~20 mins to download and install dependencies, you are prompted for some important settings.
Requirements
-
A linux box. At the moment the full install is thoroughly tested end to end on Ubuntu Server 14.04 64-bit. Note that we haven’t moved to systemd yet so if you’re using Ubuntu 15.10 you will have to fix the startup scripts. See here for more details.
-
Recommend > 1GB Ram and a modern CPU if you want to run everything on one box (note that free Amazon EC2 instances don’t have enough RAM).
-
Some machines (or VMs) to talk to the server. OSX, Windows and Linux agents are supported. Client and server can run on the same host for testing purposes.
Install the Server
Download and run the installation script e.g. using wget:
wget https://raw.githubusercontent.com/google/grr/master/scripts/install_script_ubuntu.sh
sudo bash install_script_ubuntu.sh
Note that the installation script requires bash to run and does not work with plain sh.
Once this completes successfully you should have a working server with an admin interface on port 8000, open it in your browser. You should also have grr_console in your path to interact via console.
Install the Clients
The pre-packaged clients should be visible under Manage Binaries → executables → Windows → installers. Download the client you need.
Run the client on the target machine as administrator:
-
For Windows you will see a 32 and 64 bit installer. Run the installer as admin (it should load the UAC prompt if you are not admin). It should run silently and install the client to c:\windows\system32\grr\%version%\. It will also install a Windows Service, start it, and configure the registry keys to make it talk to the URL/server you specified during repack of the clients on the server.
-
For OSX you will see a pkg file, install the pkg. It will add a launchd item and start it.
-
For Linux you will see a deb and rpms, install the appropriate one. For testing purposes you can run the client on the same machine as the server if you like.
After install, hit Enter in the search box in the top left corner of the UI to see all of your clients that have enrolled with the server.