This guide is for standalone versions of JMP, JMP Pro, and JMP Clinical, Version 17. For clarity, this guide uses JMP to refer to JMP, JMP Pro, and JMP Clinical. If you are using any previous version, please refer to the JMP Deployment Guide for that version.
This guide describes how site administrators can install, deploy and renew annually licensed versions of JMP on macOS. An annually licensed version of JMP is a protected version that expires at the end of a license period. The version only runs when an appropriate and valid license file is present. This file allows the use of JMP until the expiration date of the license, plus a grace period for renewal.
The basic steps to follow with a new JMP purchase are:
Acquire the JMP installation files. See “Delivery of the Installation Files”.
Adjust the license files (optional). See “License Information”.
Stage the installation files. See “Staging a JMP Installation”.
Notify users of the license file location, if necessary. See “License Control”.
Notify users of the location of the installation files. See “Installing JMP”.
Each user installs and runs JMP. See “Running JMP the First Time”.
Based on how the administrator sets up the license, the user might need to point JMP to either a SAS Installation Data (SID) file or a JMP.PER file in order to run JMP.
Prior to deploying JMP, review the additional information located at jmp.com/administrator.
The set of installation files is delivered to you from SAS by Electronic Software Delivery (ESD).
You can discuss this process with your JMP account manager. See the software order e-mail sent to you from SAS for the instructions on how to download the files. You are limited to two ESD downloads.
A validated license file is required for JMP to run. The license file is created during the installation of JMP and is named JMP.PER. The data needed to create the JMP.PER file are within a text file referred to as the SAS Installation Data (SID) file. The SID file is in the sid_files folder inside the software depot.
Each major version of JMP (version #.0) requires its own license file because the contents of the license file changes with each version. The license file for a version works for all subsequent maintenance releases (version #.#) of that version.
We suggest that each user keep JMP.PER in the location in which JMP installed it. However, JMP also supports storing JMP.PER in a single, centralized location for all users to access. See “License Control” for details.
JMP reads JMP.PER for validation of license terms each time JMP is launched. All of the lines in JMP.PER are checked during the validation process. Note that the operating system is also checked because a Windows JMP.PER does not work on macOS and vice versa.
When you receive your software from SAS, your license information might be set to expire after 90 days. If so, you will receive an updated SID file in an e-mail. After receiving the updated SID file, replace the SID file in the original set of installation files that you received. This ensures that all new installations will apply the new license information. You also need to update any previous installed copies of JMP. See “"Renewing Your JMP License” for details.
JMP allows a grace period of 90 days to renew. A prompt to renew the license will appear each time you launch JMP after the 45th day of the grace period. After the grace period is over, JMP will not run until a new license is applied.
You can stage the JMP installation files in one of several ways:
Copy the entire set of files from the software depot to a shared network space. All users can install JMP from that single location.
Copy the entire set of files from the software depot to a DVD, and then distribute this disc to your users.
The JMP installer is designed to place the license file in a user folder. If a SID file is found during installation, the JMP installer creates a JMP.PER file in the following user folder:
~/Library/Application Support/JMP/17
Alternatively, you can place a single JMP.PER file in a shared location for all users to use.
When JMP is launched, JMP searches for the JMP.PER file. If the file is not found, the user is prompted for location.
The order of the search is as follows:
By default, the JMP.PER file is installed in location #3. If a license file was not installed, then JMP prompts at first launch and the location that JMP points to is written to user location #2.
If the administrator wants to create an install that has the license file in a common shared location for all users, that is possible with some post installation steps. These steps can be processed with a script or within your deployment tool.
sudo mv ~/Library/Application\ Support/JMP/17/JMP.per/Library/Application\ Support/JMP/17sudo defaults write /Library/Preferences/com.sas.jmp.plistSetinit_17_Path /Library/Application\ Support/JMP/17/JMP.persudo defaults delete ~/Library/Preferences/com.sas.jmp.plist Setinit_17_Pathsudo chmod 644 /Library/Application\ Support/JMP/17/JMP.perNote: Each user who installs JMP must have administrator rights on the machine.
The JMP administrator must notify the users of the location of the installer files. Depending on how the administrator deploys the license, the users might also need to know the location of the license file. Your software depot contains the installer files needed to install JMP. JMP and JMP Pro are in separate software depots. The software depot has a folder structure for the installers based on the operating system and version of JMP.
The installer files to launch JMP, JMP Pro, and JMP Clinical version 17.x are as follows:
| JMP | <SAS Software Depot>/JMP/JMP/17_x/Macintosh/jmp__17xx__win.dmg |
| JMP Pro | <SAS Software Depot>/JMP/JMP_Pro/17_x/Macintosh/jmppro__17xx__win.dmg |
| JMP Clinical | <SAS Software Depot>/JMP_Clinical/JMP/17_x/Macintosh/jmpclin__17xx__win.dmg |
where x corresponds to the version of JMP, JMP Pro, and JMP Clinical.
If a license file is not applied during installation, the user is asked to select the license file when JMP is launched the first time.
If the license file was applied during the installation, no further action is required.
If the license file was not applied during the installation, the user is prompted to select a license file.
If the user points to a JMP.PER file, the location of the JMP.PER file is stored in the Setinit_17_Path variable in ~/Library/Preferences/com.sas.jmp.plist. This means that if the JMP.PER file is later moved or deleted, the user is prompted to select a license file. This also means that if the JMP.PER file is stored on a network drive, that drive must be available to run JMP.
If the user points to a SID file, JMP uses the file to create a JMP.PER file and then saves the file to ~/Library/Application Support/JMP/17
When your license expires, you must renew your license with SAS. The account site representative receives a new SID file from SAS.
After receiving a new SID file as the renewal license from SAS, replace the SID file in the original set of installation files that you received from SAS. This ensures that all new installations from then on use the latest license.
Note: Although both the SID file and the JMP.PER file contain text that appears to be editable using a text editor, do not do so. Altering the SID file in any way destroys the integrity of the file. Once the file is destroyed, JMP cannot create the license file, and you cannot run JMP. Likewise, altering the JMP.PER file renders it useless and you must use your original SID file to restore the JMP application.
All installed copies of JMP must be updated. You can either:
Distribute the SID file to all users.
Create an updated JMP.PER file and distribute it to all users.
Replace your shared network copy of JMP.PER.
To update the JMP license
Start JMP.
If JMP is prompting for a new license, click Open License.
If JMP does not prompt for a new license and you want to renew the license, open a JMP script window, enter the following line, and then run the script:
Renew License();
Continue with the instructions below for updating with either a SID file or a JMP.PER file.
To update the JMP license with a SID file
At the prompt, navigate to where you saved the SID file sent to you in the e-mail from SAS.
Click Open.
(Optional) Fill in the Administrator Name and Department.
Click OK.
To update the JMP license with a JMP.PER file
At the prompt, navigate to the new JMP.PER file.
Click Open.
JMP Installation
What if I need to run JMP on my laptop away from the network location where the JMP.PER file is kept?
If a single JMP.PER file is kept in a network folder for everyone’s use and you need to run JMP on a laptop without a connection to the network, you can do so for a limited time using a temporary license. Before doing so, you must run JMP on your laptop while connected to the network so that you can point JMP initially to a valid JMP.PER file.
Connect your laptop to the network.
Start JMP to ensure that JMP on your laptop has access to the latest license file on the network.
Close JMP.
Later, when you start JMP away from your network, JMP runs using a temporary license for ninety days. After ninety days, you need to reconnect to the network.
Note: You must run JMP with a valid license file before disconnecting from the network. Otherwise, JMP will not run when disconnected.
How do I obtain maintenance updates to JMP software?
Maintenance updates are available from the JMP website (jmp.com/update).
Can I have two different versions of JMP installed on my computer at the same time?
Yes. JMP 17 can be installed on a computer with a previous version of JMP. The installation of JMP 17 does not remove the previous version and both versions are operable.
Who should I contact when my JMP license expires or is about to expire?
Contact your local internal JMP site representative or support personnel. The site representative should then contact their SAS Contracts representative for an updated license file.
Where can I find a Quality Statement concerning JMP?
JMP uses a variety of methods to see, to the extent possible, that the software produces accurate, reliable and numerically precise results. To assist customer validation or operational qualification (OQ) efforts, JMP provides a set of tests based on the Standards and Technology Statistical Reference Data (StRD) sets in an extensible framework, available for download. JMP also provides a tool for verifying that JMP software has been installed and maintained to the manufacturer’s specifications. This tool verifies the integrity of each installed file and provides a report detailing the results. This information is available from the JMP website (jmp.com/qualitystatement).
How do I report a problem I am having with JMP?
There are different options for reporting problems to JMP. Visit JMP Support to find the communication method that best works for you.
When contacting Technical Support, please have the following information available:
Your JMP site license number.
The JMP version that you are using.
For graphics problems, the brand and model of the graphics card and the version of the graphics driver might be helpful.
How do I locate my JMP site license number?
To obtain the site license number, select About JMP in the JMP menu.
How does JMP find the PER file to use?
When JMP is launched, the order of search for the PER file is as follows:
Use the value of the Setinit_17_Path variable of the com.sas.jmp.plist file at the root level
Use the value of the Setinit_17_Path variable of the com.sas.jmp.plist file at the user level
~/Library/Application Support/JMP/17 folder
A user can run a one-line script to print to the log the exact location of the PER used by JMP.
Show License Path();