AutoPkg Setup for JSS

An automated installer for AutoPkg and [JamfUploader].

What does it do?

• Installs command line tools if not present (because git is required for AutoPkg)
• Downloads, installs and configures the latest version of AutoPkg
• Configures JamfUploader

The script is idempotent. It is safe to run if the Xcode Command Line Tools and AutoPkgare already installed. They will only be updated if they are out of date. Any existing AutoPkg repos will also be updated, with the caveat that all the repos you want should be in your autopkg-repo-list file.

Prerequisites

Create a user on each JSS Instance with the following credentials (System Settings => JSS User Accounts & Groups):

• Account:
  • Username: AutoPkg
  • Access Level: Full Access
  • Privilege Set: Custom
  • Access Status: Enabled
  • Full Name: AutoPkg JSSImporter
  • Email Address: [email protected]
  • Password: ChangeMe!!!
• Privileges:
  • Categories: Create Read Update
  • Computer Extension Attributes: Create Read Update
  • File Share Distribution Points: Read
  • Packages: Create Read Update
  • Policies: Create Read Update
  • Scripts: Create Read Update
  • Smart Computer Groups: Create Read Update
  • Static Computer Groups: Create Read Update

You also need to know the password that the JSS uses to connect to the distribution point.

Setup

Either add your required credentials into the AutoPkg prefs directly, or the script will prompt you for them when you run it.

Cloud distribution point

# JSS address, API user and password
JSS_URL="https://changeme.jamfcloud.com"
JSS_API_AUTOPKG_USER="AutoPkg"
JSS_API_AUTOPKG_PW="ChangeMe!!!"

Fileshare distribution point

# JSS address, API user and password
JSS_URL="https://changeme.com:8443/"
JSS_API_AUTOPKG_USER="AutoPkg"
JSS_API_AUTOPKG_PW="ChangeMe!!!"

# Jamf Distribution Server name and password. In normal usage, this is sufficient
# due to information gathered from the JSS.
JAMFREPO_NAME="CasperShare"
JAMFREPO_PW="ChangeMeToo!!!"

Note that any paths in a config file should be absolute.

Running the script

Run the script as the regular user (not as root/sudo):

If you edited autopkg_setup.sh directly:

./autopkg_setup.sh

If supplying a config file:

./autopkg_setup.sh --prefs=/path/to/config_file.sh

Note that any paths should be absolute.

You can supply many other parameters via the command line. Run autopkg_setup.sh --help for a complete list.

Additional options

Run the script with -p or --prefs_only to simply switch preferences without installing or updating anything.

./autopkg_setup.sh --prefs=/path/to/config_file.sh --prefs-only

Run the script with -f or --force to force-update AutoPkg (requires password entry):

./autopkg_setup.sh --force