7.3. Custom Varnish Web Policy Agent Installation

Varnish is unique because modifications are done in Command Line Mode where you can use it to create a new server configuration template/vcl file, such as instance/agent_1/config. This file is then used to start Varnish to create the file or directory links to the Varnish vmods, where it will be properly loaded when Varnish is started.

You can use the following commands for customizing your Varnish policy agent.

  • agentadmin -l

    Lists all of the agent instances

  • agentadmin -r agent_1

    Removes the agent_1 instance create in the example

  • agentadmin -e password

    Encrypts the password using an base64 output for the encoded password and encryption key

  • agentadmin -o openamurl -a agenturl -i agent_profile_id -p /path/to/passwordfile -c /usr/lib/varnish/vmods

    Creates the agent instance with the configuration parameters. Based on the examples in the procedures, you would get the following:

    • openamurl for the OpenAM server at http://openam.example.com:80/openam

    • agenturl of the Agent server url is http://www.website.example.com:80

    • agent_profile is the agent profile name shown in OpenAM

    • /path/to/passwordfile is the path where you saved the agent profile password file

    • /path/to/varnish/vmod is the path to the Varnish vmods directory /usr/lib/varnish/vmods

  • agentadmin -v

    View the version

  • agentadmin -?

    Displays a list of all possible options supported by Varnish