Installing the JSS

Installing the JAMF Software Server (JSS) involves the following steps:

  1. Install the required software (if you haven’t already).

  2. Create the jamfsoftware database.

  3. Run the JSS Installer.

Before you begin, make sure your server meets the JSS Installer requirements. (For more information, see Requirements.)

Note: If you are installing the JSS on a server with macOS Server v5.0.x installed, the macOS Server Profile Manager service will not be accessible after the installation is complete.

Step 1: Install the Required Software

Java and MySQL must be installed on the server before you can create the jamfsoftware database and run the JSS Installer. For instructions on how to install and configure Java and MySQL, see the following Knowledge Base article:

Installing Java and MySQL

Step 2: Create the jamfsoftware Database

Create a MySQL database in which the JSS can store its data and a MySQL user that can access the database.

A default MySQL database name, username, and password are used throughout the instructions in this section. It is recommended, however, that you use a custom username and password that comply with your organization's security requirements. It is also recommended that you not use “root” as the username. A different database name can also be set if desired.

The default MySQL settings used in the instructions below are:

  • Database name: jamfsoftware

  • Username: jamfsoftware

  • Password: jamfsw03

Note: If you customize any of the MySQL settings, you will be prompted to enter them on the Database pane when you run the JSS Installer.

  1. Open Terminal and access the MySQL command line as "root" by typing:

    mysql -u root -p

    If MySQL is not in the path or it is installed in a custom location, access the MySQL command line by updating the path or by typing:

    /path/to/mysql -u root -p

    Note: The default path for MySQL is /usr/local/mysql/bin/.

  2. When prompted, enter the password for the MySQL “root” user.
    If you did not create a root password, press the Return key.

  3. Create a database by executing:

    CREATE DATABASE jamfsoftware;

    You can customize the database name by replacing jamfsoftware with the desired name as shown in the following example:

    CREATE DATABASE myDatabaseName;

  4. Grant privileges to a MySQL user so that it can access the new database:

    GRANT ALL ON jamfsoftware.* TO 'jamfsoftware'@localhost IDENTIFIED BY
    'jamfsw03';

    You can customize the MySQL username and password by replacing 'jamfsoftware' and 'jamfsw03' with the desired username and password as shown in the following example:

    GRANT ALL ON myDatabaseName.* TO 'customUsername'@localhost IDENTIFIED BY 'customPassword';

Step 3: Run the JSS Installer

The JSS Installer for Mac (JSS Installer.mpkg) installs Apache Tomcat and the JSS web application.

To run the JSS Installer for Mac, copy it to the server. Then open the installer and follow the onscreen instructions.

Related Information

For related information, see the following section in this guide:

Installed Files and Folders
Learn about the files and folders that are installed by the JSS Installer.

For related information, see the following Knowledge Base article:

Apache Tomcat Version Installed by the JSS Installer
View the Tomcat version that is installed by the JSS Installer.

Copyright | Privacy | Terms of Use | Security
© copyright 2002-2016 Jamf. All rights reserved.