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: For instructions on how to manually install the JSS on Windows, see the Manually Installing the Jamf Software Server technical paper.

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 a 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 the MySQL Command Line Client.

  2. When prompted, enter the password for the MySQL “root” user.

  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. Create a new MySQL user:

    CREATE USER 'jamfsoftware'@'localhost' IDENTIFIED BY 'jamfsw03';
  5. Grant access to that user so that it can access the database:

    GRANT ALL ON jamfsoftware.* TO 'jamfsoftware'@'localhost';

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

    CREATE USER 'customUsername'@'localhost' IDENTIFIED BY 'customPassword';

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

Step 3: Run the JSS Installer

The JSS Installer for Windows installs Apache Tomcat and the JSS web application.

Note: To obtain the JSS Installer for Windows, log in to Jamf Nation and click Show alternative downloads below the Casper Suite DMG on the following page:

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

Note: The installer must be run as an administrator.

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-2017 Jamf. All rights reserved.