Install the JSS on Linux

Requirements

Installing the JSS on Linux requires a server with:

  • A 64-bit capable Intel processor

  • 2 GB of RAM

  • 400 MB of disk space available

  • One of the following operating systems:

    • Ubuntu 12.04 LTS Server (64-bit)

    • Ubuntu 14.04 LTS Server (64-bit)

    • Red Hat Enterprise Linux (RHEL) 6.4, 6.5, 6.6, or 7.0

  • Open Java Development Kit (OpenJDK) 7 or 8
    For installation instructions, go to http://openjdk.java.net/install/.

  • MySQL Enterprise Edition 5.5.x or 5.6.x (recommended), or MySQL Community Server 5.5.x or 5.6.x, available at:
    https://www.mysql.com/downloads/

  • Ports 8443 and 8080 available

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 a command prompt and access the MySQL command-line utility as “root” by typing something similar to the following:

    mysql -u root -p

    If you did not create a root password when installing MySQL, do not type -p.
    If MySQL is not in the path or it is installed in a custom location, enter the installation path in place of mysql.

  2. If 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. 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 My SQL 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 Linux installs Apache Tomcat and the JSS web application.

  1. Copy the JSS Installer for Linux (jssinstaller.run) to the server.
    Note: To obtain the JSS Installer for Linux, log in to JAMF Nation and click Show alternative downloads below the Casper Suite DMG on the following page:
    https://jamfnation.jamfsoftware.com/myAssets.html

  2. Log in to the server as a user with superuser privileges.

  3. Initiate the installer by executing a command similar to the following:

    sudo sh /path/to/jssinstaller.run

  4. When the requirement check is complete, type “y” to proceed.

  5. (RHEL only) When the installation is complete, edit the firewall configuration to allow access to port 8443 by executing:

    sudo system-config-firewall-tui

  6. (RHEL only) Choose Other or Customize, and manually add port 8443 with TCP protocol. The option you choose depends on whether you have a GUI or shell-only interface.

  7. Access the JSS from an enrolled computer by opening a web browser and typing the protocol, IP address or DNS name of the server, and port. For example:
    https://jss.mycompany.com:8443/

  8. If you entered a custom database name, username, or password when you created the jamfsoftware database, or MySQL is using a port other than 3306, the Database Connection Properties pane is displayed. Before you can access the JSS, you must follow the onscreen instructions to create a connection between the JSS and the jamfsoftware database.

Copyright | Privacy | Terms of Use | Security
Copyright JAMF Software, LLC 2016