This is the JMP Live 16.0 administrator help. Other versions include 15.2, 15.1, and 15.0 (English).

JMP Live Help
Create visualizations with your data in JMP and share your analyses as posts in JMP Live. Anyone viewing these posts has the interactive capabilities of JMP to explore your data.
Find out more about these JMP Live topics:
Publish JMP Graphs and Reports
Create your graphs and reports in JMP and publish them as a JMP Live post. Posts can be private or shared with everyone or a group. If you publish several reports at once, they appear in a folder.
For details about how to publish your graphs and reports from JMP, see https://www.jmp.com/support/help/en/16.0/#page/jmp/save-and-share-reports.shtml.
Figure 1.1 JMP Live Thumbnails
Thumbnails
Icons indicate the following information:
Image shown here
The post is private; only you (and administrators) can see it
Image shown here
The post is shared with everyone
Image shown here
The post is shared with groups
Image shown here
The public post has been featured by an administrator
Image shown here
The post is a folder and can contain several reports
Image shown here
How many views the post has
Image shown here
How many user comments the post has
Image shown here
You have not bookmarked the post
Image shown here
You have bookmarked the post
Figure 1.2 Example of a JMP Live Post
Example of a Post
Interact with Posts
Find out what you can do to JMP Live posts:
Open Posts
Tip: To navigate in JMP Live using a keyboard, use the Tab and Enter keys.
1.
Click an option under Home or click Featured:
My Dashboard contains your posts, posts of people that you follow, and posts in groups that you belong to.
Bookmarks contains posts that you have bookmarked.
All Posts contains all posts from your dashboard and all public posts (shared with everyone).
Featured contains any posts that are featured by a JMP Live administrator.
Figure 1.3 Home Options
Home Options
2.
Click a post to open it.
A single post opens directly. If there are several posts, a folder opens and you can click the post that you want to see.
Tip: In a folder, use the navigation icons to move between posts.
3.
(Optional) To see detailed information about a post, click Details Image shown here. From a thumbnail, click More Image shown here > Details.
Figure 1.4 Open the Details Pane from a Thumbnail
Open the Details Pane from a Thumbnail
Update Posts
In the Details pane, you can update posts that you own.
1.
In your post, click Details Image shown here or from a thumbnail, click More Image shown here > Details.
2.
Next to the section that you want to update, click Edit Image shown here.
You can update the title, thumbnail image, description, sharing settings, and more.
Tip: In the post description, you can use these HTML tags: <a href= "target">, <b>, <em>, <i>, <strong>, and <u>.
Figure 1.5 Update a Post’s Details
Update a Post’s Details
For more details, see these topics:
Share Posts
When you publish a JMP report, you choose how you want to share it. You can keep the post private, share it with everyone, or share it with specific groups (the post appears on both the group page and on the members’ Home pages). You can also change the sharing settings on a post or folder that you own in JMP Live.
Change the sharing settings on a post
1.
In your post, click Details Image shown here.
2.
Next to Shared with, click Edit Image shown here.
3.
Select an option.
Tip: To stop sharing a post, set the option to Only Me. You can also quickly stop sharing a post with groups from a thumbnail by clicking Image shown here > Stop sharing with groups.
4.
Click Save.
Share posts on social media or with a link
In your post, click Share Image shown here or if you do not see the Share icon, click More Image shown here > Share > Copy Link.
You can share a post in any of these ways:
On social media: such as Facebook, Twitter, LinkedIn
Note: These options do not appear if your JMP Live administrator has disabled them.
Email or copy a link
Copy embedded HTML code (for a web page)
Figure 1.6 Sharing Options
Sharing Options
Tip: If you are sharing your own post, and it is private (only you can see it), you will not see all of these options. You must first share your post with everyone to see these options.
Comment on Posts
Tip: You can see how many user comments are on a post in the thumbnail next to the Comments icon Image shown here.
To see or add comments to a post or folder:
1.
In a post or folder, click Image shown here or Image shown here.
Any existing comments appear.
Note: In addition to user comments, you might also see system comments, which are mainly informative. System comments are not included in the comment count.
2.
In the Write your comment here box, enter a comment. To respond to an existing comment, click Reply and enter a comment.
Tip: You can use basic HTML, such as bold (<b> or <strong>), italics (<i> or <em>), preformatted (<pre>), or underline (<u>). You can also use markdown, such as headings (#, ##, etc.), bold (**text**), and italics (*text*).
3.
Click Submit.
4.
(Optional) To edit or delete your comments, click More Image shown here and select Edit or Delete. To delete all comments on a post you own, next to the number of comments, click More Image shown here > Delete All.
Assuming that you do not turn off these notifications, you get a notification in these situations:
If someone adds or replies to a comment on a post that you own
If someone replies to a comment that you made
If someone deletes a comment that you made
Bookmark Posts
If you want to quickly access a post or a folder, you can bookmark it in JMP Live.
In a post or folder, click Bookmark Image shown here or if you do not see the Bookmark icon, click More Image shown here > Bookmark. To see all your bookmarked posts and folders, at the top, click Home > Bookmarks.
Figure 1.7 Bookmarks Page
Bookmarks Page
Tip: On the Bookmarks page, updated posts have a green dot next to their time stamp. After you view the post, the green dot disappears.
To remove a bookmark on a post or folder, click Unbookmark Image shown here or if you do not see the Unbookmark icon, click More Image shown here > Unbookmark.
Move Posts
You can move your JMP Live posts into a folder that you own. You can also move posts into a folder in a group that you are a member of. See Manage Group Posts.
1.
At the top right, click your user icon > My Profile.
2.
Under Posts, hover over a post and click the check mark at top. Repeat for any other posts you want to move.
3.
Next to Move to folder, click the arrow and select a folder.
4.
Click Move to folder Image shown here.
Remove a post from a folder
1.
In a folder, hover over a post and click the check mark at top. Repeat for any other posts you want to remove.
2.
Click Remove from folder Image shown here.
The posts are now stand-alone.
Delete Posts
To delete a single post or a folder that you own, from a post, folder, or thumbnail, click More Image shown here > Delete post.
Figure 1.8 Delete a Post
Delete a Post
Delete several posts or folders
1.
At the top right, click your user icon > My Profile. Or, if the posts you want to delete are in a folder, open the folder.
2.
Hover over a post and click the check mark at top. Repeat for any other posts you want to delete.
3.
Click Delete selected posts Image shown here.
Flag Posts or Users
If you think a post or user profile contains inappropriate content, you can flag it to the administrator:
1.
Do one of the following actions:
To flag a post: On a thumbnail or from a post, click More Image shown here > Flag as inappropriate.
To flag a user profile: From a user profile, click More Image shown here > Report User.
2.
(Optional) Add comments to explain the issue.
3.
Click Submit.
Here is what happens when a post or user profile is flagged:
1.
JMP Live administrators determine whether a flagged post should be cleared (the flag removed), hidden, or removed, and whether a flagged user profile should be cleared or hidden.
2.
If the administrator hides or removes a flagged post, or hides a flagged user profile, a notification is sent to the owner of the post or the flagged user (if they have not turned off notifications for flags). For hidden posts or users, the owner or user can attempt to fix the problem and let the administrator know. The administrator can then reinstate the post or user if they approve.
Change the Theme in Posts
To temporarily change the page appearance while you are viewing a post, at the top right, click More Image shown here > Themes.
Figure 1.9 Change the Page Theme
Change the Page Theme
Show Log Messages for Posts
In a post, you can click More Image shown here > Show Log Messages to see error messages from the server, connection messages, and any messages from the client.
Change the Layout of Posts
In a folder, click Display Image shown here to change the layout of the posts.
Interact with Data and Graphs
Find out what you can do with JMP Live data and graphs:
See Data Values or Descriptions
1.
Click or tap Identify Objects Image shown here
2.
Hover over or tap a data point or a calculation.
Figure 1.10 See a Data Point’s Values
See a Data Point’s Values
Figure 1.11 See an Explanation of a P-Value Calculation
See an Explanation of a P-Value Calculation
Tip: To hide or show reports and graphs, at the right of a title, click or tap the arrow.
Select Data and Navigate in Graphs
How you select data in a graph (points, bars, and so on) depends on whether you are on a computer or a mobile device. The default mode is to select a single data point.
On a computer
On a mobile device
Select or deselect a single data point
Click a data point.
Tap Select One Object Image shown here then tap a data point.
Select or deselect multiple data points
Hold down the Shift key and click multiple data points.
Tap Select Multiple Objects Image shown here then tap multiple data points.
Identify a single data point
Hover over a single data point.
Tap Identify Objects Image shown here then tap a data point.
Select data points by brushing
Click and drag a rectangle over data points. Click and drag in the center to move the rectangle, or drag the corners to resize it.
Tap Select Multiple Objects Image shown here then draw a rectangle over the data points. Drag the center to move the rectangle, or drag the corners to resize it.
Zoom
Click Magnifier Image shown here and click a point or drag a rectangle. The center of the rectangle is now the center of the zoom area.
To zoom out, double-click in the graph, or press Shift and click in the graph.
You can also use the scroll wheel on your mouse to zoom in and out. If you are not in Zoom mode, press Alt before zooming with the scroll wheel.
Tap Magnifier Image shown here and pinch zoom.
Pan in a graph
Click Grabber Image shown here and click and drag in the graph. Or, press Alt and click and drag in the graph.
Tap Grabber Image shown here and move the graph with your finger.
Pan axes
Click the middle of an axis and drag.
Touch the middle of an axis and drag.
Scale axes
Click at either end of an axis and drag.
Touch either end of an axis and drag.
Return axes or graphs to their original state
Press Alt and double-click in the graph, or click More Image shown here or Image shown here > Reset All Axes.
Double-tap in the graph, or tap More Image shown here > Reset All Axes.
Note: In interactive HTML, some graphs do not support panning and zooming. Panning and zooming is fully supported in JMP Live.
See Linked Data
If your JMP report contains multiple graphs, data in all graphs are linked. So if you select data, it is highlighted in all associated graphs.
Figure 1.12 Select Data in Linked Graphs
Select Data in Linked Graphs
In this example, a histogram bar in the top graph is selected. The corresponding rows are highlighted in the scatterplot and in the marginal histogram.
Exclude and Hide Data
Once you have selected data, you can exclude it from report calculations and hide it in graphs. Reports and graphs automatically update.
Figure 1.13 Report Menu Options
Report Menu Options
To exclude and hide data, use the options in the More Image shown here menu on the right:
Note: If the report contains a Local Data Filter, most of these options do not appear, since you use the Local Data Filter instead.
Exclude and Hide Selected Rows: Excludes and hides selected data.
Include and Show All Rows: Includes and shows any excluded or hidden data.
Invert Row Selection: Changes the current selection to the deselected data.
Filter Data
If the original JMP report included a Local Data Filter, you can use the filter to focus on specific data and see the impact on graphs and reports.
Figure 1.14 Filter Data in Graphs
Filter Data in Graphs
In this example, the filter choices are showing only females between 51 and 63 inches tall who are between the ages of 12 and 14.
Tip: If several categories are selected and you want to select a single category, click the category (not the check box).
Local Data Filter Options
Conditional Filtering
Limits the options in the Local Data Filter by condition. For more information, see Using JMP.
Note: This option does not appear if there is more than one OR group, or if the columns are not hierarchical.
Invert filter
Inverts currently selected filters.
Select filtered rows in graphs
Selects all filtered rows in graphs.
Show filtered rows in graphs
Shows all filtered rows in graphs.
Include filtered rows in calculations
Only filtered rows are included in report calculations.
Update Data
If the data associated with a post changes, you can update the data in JMP Live without republishing the post. The post updates automatically once the data is updated.
JMP Live administrators and the publisher of a post can update data.
1.
In a post, click Details Image shown here or Warnings Image shown here.
2.
Under Data, click Expand to open the pane.
3.
Click Manage.
4.
Click Update Data.
5.
Click in the Select data tables box, or next to a data table, click Update.
6.
Navigate to the updated data table on your computer and click Open.
7.
Click Submit.
8.
(Optional) To undo the update and revert to the previous version, click Undo Last Update, and then click Revert.
Switch Data Columns
If the original JMP report included a Column Switcher, you can quickly analyze different variables without re-creating the analysis. When you choose a different variable in JMP Live, the analyses automatically recalculate using the new variable.
In this example using Fisher’s Iris data, the JMP report includes a Column Switcher and a Local Data Filter.
Figure 1.15 Initial Selections
Initial Selections
Initially, Petal length (the original column) is selected in the Column Switcher. All species are showing in the Local Data Filter. These selections are reflected in the graph and calculations.
Figure 1.16 Updated Selections
Updated Selections
Here, Petal width is selected in the Column Switcher, and only the species versicolor is selected in the Local Data Filter. The graph and calculations update to reflect these selections.
Control Chart Warnings
Posts that contain control charts can generate notifications if there are control chart warnings. Notifications are sent to the publisher of the post and members of any groups that the post is shared with (if warnings are enabled for the group). See JMP Live Groups.
Depending on individual settings, notifications appear in JMP Live and via email. Email notifications contain more detail about the warnings.
Tip: At an individual level, you can specify which notifications you get and how often. See Manage Notifications on Posts.
When you publish a JMP report that contains a control chart, you can specify whether to enable warnings. You can also enable warnings from a JMP Live post.
Enable or disable warnings
1.
In a post that contains a control chart, click Details Image shown here or Warnings Image shown here.
2.
Under Warnings, click on or off.
3.
(Warnings on only) If the post has active warnings, choose whether to notify people about these warnings.
See details about warnings
1.
In a post or from a thumbnail, click Warnings Image shown here.
2.
Under Warnings, click Expand to open the pane.
Figure 1.17 Example of Control Chart Warnings
Example of Control Chart Warnings
3.
(Optional) For more detailed information, click Open Log.
To copy the log information, click Copy Image shown here.
Download Data or Scripts
When you publish a JMP report to JMP Live, you can specify whether to allow users to download the data and script associated with the report. You can also change the download setting from a JMP Live post.
Change the download setting
Note: You can change the download setting from a JMP Live post only if you published the data when you published the JMP report.
1.
In a post, click Details Image shown here.
2.
Next to Allow download, click Edit Image shown here.
3.
Select or deselect Allow download.
4.
Click Save.
Download data or scripts
1.
In a post, click Details Image shown here.
2.
Under Data or Script, click Download Image shown here.
3.
(Optional) To copy a script, click Copy Image shown here.
The Script pane and download options do not appear if the publisher chose not to allow downloading.
Customize Graphs
Note: These customizations are temporary while you are in the post.
Use the options in the More Image shown here menu next to a report to customize graph elements.
Figure 1.18 Change the Marker Size
Change the Marker Size
The options in this menu can vary depending on the type of graph or JMP platform. For example:
In scatterplots and histograms, you can change the marker size.
In profilers, you can reset the profiler to its original state, or re-scale the vertical axis to include the response.
In data filters, you can choose how you want to filter data.
In bubble plots, you can change the appearance of the bubbles, add a time label, or change the aggregation method.
JMP Live Groups
There are different types of groups in JMP Live:
Personal groups: Users and administrators can create personal groups. Personal groups can be owned by the creator or administrators can change the owner. Only people that you add to a personal group can see the group and its posts.
Open, Closed, or Hidden groups: Only administrators can create these types of groups.
Open: Anyone can find the group, join the group, and see the posts and members.
Closed: Anyone can find the group, but only members can see the posts and members. People can request to join the group.
Hidden: Only members can find the group and see posts and members.
On the Groups page, you see My Groups or All Groups:
My Groups: Shows all groups that you are a member of.
All Groups: Shows all groups that you are a member of and all open and closed groups that you can join or ask to join.
You can also find a group, filter by a group type, or create a new group.
Figure 1.19 My Groups Page
When you add someone to a group, they are added automatically. They can choose to leave the group by clicking More > Leave group.
Find out what you can do in JMP Live groups:
Create Groups
1.
Click Groups.
2.
At top, click Create .
Figure 1.20 Create a New Group
3.
Name the group.
4.
(Optional) Add a group description.
5.
Under Add members, click the down arrow and select user names. To find a user name, start entering it. Clickable suggestions appear as you type.
6.
(Optional) Choose whether members get notifications if there are active warnings in posts that contain control charts.
7.
As an administrator, you can choose the group type:
Open: Anyone can find the group, ask to join the group, see who is in it, and what they post.
Closed: Anyone can find the group, but only members can see posts and who is in the group. People can request to join the group.
Hidden: Only members can find the group, see posts, and who is in the group. Owned by the administrator who is creating the group.
Personal: Only members can find the group, see posts, and who is in the group. Owned by a member that you specify.
8.
Click Create.
9.
(Optional) To share posts with groups, see Share Posts.
Add Members
1.
Click Groups > My Groups.
2.
Next to a group, click More > Add members.
3.
Click the down arrow and select user names. To find a user name, start entering it. Clickable suggestions appear as you type.
4.
Click Add.
Remove Members
1.
Click Groups > My Groups.
2.
Next to a group, click More > Manage members.
3.
Click Manage Group.
Note: You must be an administrator of the group to see this option and remove members.
4.
Select the box next to the name of the members that you want to remove.
5.
Click Delete and click Confirm.
Change Member Permissions
1.
Click Groups > My Groups.
2.
Next to a group, click More > Manage Members.
Note: You must be an administrator of the group to see this option and manage members.
3.
Select the check boxes to set these permissions:
Can Publish: Member can publish posts to the group.
Can Remove Posts: Member can remove posts from the group. Removing a post makes the post visible to only its original owner, unless the post is shared with another group.
Group Admin: Member is a group administrator. Administrators can add or remove members, change member permissions, remove posts, or delete the group.
Manage Join Requests
People can request to join closed groups. You can approve or deny requests.
1.
Click a Group request notification or click Groups > All Groups and click the name of the group that you want to manage requests for.
2.
Click Requests.
3.
Click Approve or Deny next to the member’s name.
Edit Groups
1.
Click Groups > My Groups.
2.
Next to a group, click More > Edit Group.
3.
Update the group name or description.
4.
Click Save.
Delete Groups
1.
Click Groups > My Groups.
2.
Next to a group, click More > Delete Group.
3.
Click Confirm.
When you delete a group, posts shared with the group are not deleted:
If the post is shared with the deleted group only, it becomes private to the owner of the post.
If the post is shared with other active groups, it is removed only from the deleted group.
Manage Group Posts
For groups that you are a member of, you can move your JMP Live posts into group folders or you can remove your posts from groups.
Move your posts into group folders
If you are a member of a group and can publish to the group, you can move your JMP Live posts into a group folder. Administrators can move posts from users’ profiles to folders owned by the user or folders in a group where the user has publish permission.
1.
At the top right, click your user icon > My Profile.
2.
Hover over posts and click the check mark.
3.
Next to Move to folder, click the arrow and select a group folder.
4.
Click Move to folder .
Note: If a folder containing your posts is removed from a group, your posts remain in the folder until you remove them. For details about how to remove posts from folders, see Move Posts.
Remove posts from groups
You can remove your own posts from a group that you are a member of. To remove others’ posts from a group, you need permission to remove posts from the group or you need to be a group administrator.
1.
Click Groups > My Groups.
2.
Click a group name.
3.
Hover over posts and click the check mark.
4.
Click Remove from group .
Search for Posts, Users, or Groups
To search all of JMP Live, enter a keyword in the search box at top right. Click Posts, Users, or Groups to see specific types of results.
Figure 1.21 Search by Keyword
Search by Keyword
Here are some things that you can do from the search results:
Posts
To open a post, click the title or image.
To open the post author’s profile, click their user name.
To bookmark a post, click Bookmark Image shown here.
To flag a post as inappropriate, click More Image shown here > Flag as inappropriate.
To delete a post that you own, click More Image shown here > Delete post.
Users
To follow a user, click Follow. If you follow someone, their posts appear on your dashboard.
To open a user’s profile, click their user name.
Groups
To join a group, click Join.
To leave a group, click More Image shown here > Leave group.
If you are a group administrator, click More Image shown here and do any of the following:
Add or manage members
Enable or disable warnings on control charts shared with a group
Edit a group’s name and description
Delete a group
You can also click Groups in the top navigation bar and enter a group in Find group.
Use Filters
You can use filters to narrow your searches on posts or groups.
Filter Posts
1.
Click Home and click My Dashboard, Bookmarks, or All Posts, depending on where you want to search.
2.
At the top right, click Filters Image shown here.
Figure 1.22 Filter Options on Posts
Filter Options on Posts
3.
Enter any combination of keywords, user or group names, or dates.
4.
Click outside of the Filters pane to see the results.
5.
To stop filtering, click Clear Filters.
Filter Groups
1.
Click Groups and click My Groups or All Groups, depending on where you want to search.
2.
At the top right, click Filters Image shown here.
Figure 1.23 Filter Options on Groups
Filter Options on Groups
3.
Enter keywords in the group name. You can also select a group type.
4.
Click outside of the Filters pane to see the results.
5.
To stop filtering, click Clear Filters.
Edit Your Profile or Account
Edit your profile
1.
At the top right, click your user icon > My Profile.
2.
Click Edit Image shown here.
3.
Change your picture or display name.
4.
Click Save.
Verify your account details
1.
At the top right, click your user icon > Settings.
2.
Verify your login name or the email associated with your account.
3.
(Local authentication method only) Verify or change your password.
4.
Change your notification settings. See Change Notification Settings.
5.
To use JSL to create and publish JMP Live reports, you need an API key. Click Generate API Key and make a note of your key. For details, see Get an API Key.
Figure 1.24 Edit Your Account Settings
Edit Your Account Settings
Manage Notifications on Posts
Note: This section covers user notifications. For administrator notifications, see Manage Admin Notifications.
Notification Types
In JMP Live, depending on your notification settings, you might be notified when these things happen:
someone new starts following you
someone adds or replies to a comment on one of your posts
someone replies to or deletes a comment that you made
a request that you made to join a group is approved or denied, or you are added or removed from a group
someone requests to join a closed group that you are an administrator of
someone flags a post that you created or flags your user profile
an administrator deletes one of your posts, or a folder that includes one of your posts, or if one of your posts is removed from a group
a control chart that you published or that is shared with a group that you are a member of has warnings
Open or act on notifications
To see your notifications, click Notifications Image shown here. From here, you can perform the following actions:
Click a notification to take you to its source. For example, if someone comments on your post, the post opens so that you can see the comment.
Click More Image shown here > Clear Notification to clear a single notification.
Click Mark All as Read Image shown here to turn notifications from gray (not read) to white (read) and remove the notification number flag.
Click Clear All Image shown here to remove all notifications.
Click Settings Image shown here to manage your notifications. See Change Notification Settings.
Click See All to see all notifications in a larger window.
Change Notification Settings
On the Notification Settings page, you can choose which types of notifications you want to receive and how often you want to get email notifications.
Stop receiving a notification: Under On JMP Live, click the switch to off (green).
Change how often you get email notifications: Under E-mail, choose a frequency.
Figure 1.25 Example of Notification Settings
Example of Notification Settings
Administrator Options
From the Admin menu in JMP Live, you can do the following:
Manage Admin Notifications
As an administrator, you are notified in situations like these:
when someone flags a post or user profile as inappropriate
when someone updates a flagged post or user profile
when someone requests to join a group that has no group administrator
when a post fails to regenerate
To see your administrative notifications, click Notifications > Admin. You can perform these actions:
Click a notification to take action on it or see details. See also Manage Flagged Content.
Next to a notification, click More > Clear Notification to delete it. This deletes only the notification, not the flag, which is tracked on the Flagged Content page.
Manage Users
To see and manage all JMP Live users, click Admin > Users.
For each user, you can change these aspects:
the user’s display name
whether the user can access JMP Live (is enabled)
whether the user can publish content to JMP Live
whether the user has administrative privileges
whether the user can use an API key to publish JMP Live reports
If you are using Local authentication, you can also create a new JMP Live user.
Manage Groups
To see and manage all JMP Live groups, click Admin > Groups.
For each group, you can see the group name, type, and description, the number of members, and the number of posts. There is also a group ID number.
You can do any of these actions:
Search for a group by entering a keyword in the Search bar at top.
Click a group to select it. Use the buttons at top to see members, edit a group, or delete a group. For more details, see JMP Live Groups.
Click a group name to open the group.
Click Create Group to create a new group.
Click a group name to add or remove members, change member permissions, review requests to join the group, edit the group, or delete the group. For details, see Administrator Options.
Manage Flagged Content
To manage posts or user profiles that are flagged as inappropriate, click Admin > Flagged Content.
You can do any of these actions:
Click the post title or user name to see the post or user profile. For posts, click the Details icon to see more information about the post.
Clear the flags if the content or user profile is deemed appropriate.
Hide the content or user profile for now. You can approve the content or user profile if it is updated or deemed appropriate, or you can delete it.
Delete the post completely from JMP Live.
Manage Settings
As an administrator, you can change run-time settings and view configuration settings. Configuration settings are read-only, but can be changed in the environment (.env) files, normally located here:
C:\Program Files\SAS\JMP Live\JMP Live
C:\Program Files\SAS\JMP Live\JMPPool
Note: For a description of settings that are not described here, see the env.example files.
Update the environment files to specify any settings that you want to change the default value for. The environment files contain only exceptions to the default settings.
Runtime Settings
Admin announcement
Enter an announcement that appears to all logged in users at the top of each page. The maximum number of characters is 280.
Admin e-mail address
Enter an email address for the JMP Live administrator.
Admin e-mail address no reply
Enter an email address from which to send automatic replies coming from JMP Live. Replies to this address are not monitored.
Allows anonymous access
Choose whether anonymous users (people not logged in to JMP Live) can access JMP Live (on), or if a login is required (off). If you turn this option on, when someone sends a link to a JMP Live post that is shared with everyone, anonymous users can see the post on JMP Live.
Loggly sub-domain
Set the Loggly sub-domain to send log records to. For a description of Loggly, see Loggly token.
Loggly token
Set the token to use when sending log records to Loggly. Loggly is a website log indexing service that helps you make sense of your web logs.
Prevent index page caching
Choose whether cache-control headers are passed with a post’s index file, which prevents a browser from caching the headers (on) or not passed (off).
View expire seconds
Set the number of seconds that must elapse before a user’s view of a post counts as an additional view of the post.
Automatic HTML regeneration
Choose whether HTML generated by older JMP versions is automatically regenerated in the background (on) or not (off). If this setting is on, existing HTML posts are queued for regeneration, and newly published posts and posts visited by users are regenerated immediately.
Auto-Regen max age days
If Automatic HTML Regeneration is turned on, set the age of reports (in days) to add to the regeneration queue. If set to zero, no more reports are added to the queue, but any existing reports in the queue are regenerated.
Regeneration frequency (seconds)
(Applicable only if Automatic HTML Regeneration is set to on.) Set the number of seconds to wait between automatic HTML regenerations.
Max active regenerations
(Applicable only if Automatic HTML Regeneration is set to on.) Set the maximum number of HTML regenerations that can take place at one time. The range is from 1 to 8.
SMTP ignore TLS
Choose whether the SMTP connection should ignore Transport Layer Security (TLS) (on) or not ignore TLS (off).
SMTP password
(Required for sharing by email.) Set the password for connecting to the SMTP server.
SMTP port
(Required for sharing by email.) Set the port number to use for connecting to the SMTP server.
SMTP server address
(Required for sharing by email.) Set the name of the SMTP server to use for sending email.
SMTP user
(Required for sharing by email.) Set the user name for connecting to the SMTP server.
Maximum avatar size KB
Set the maximum size in kilobytes of a user’s profile picture.
Maximum package size MB
Set the maximum size of an individual post in megabytes. This includes all uploaded assets, such as HTML files, thumbnail images, and data tables.
User storage limit MB
Set the per-user limit on storage in megabytes. A value of zero means that there is no limit.
Publish throttle count
Set the number of times a user is allowed to publish posts to JMP Live within the value specified in Publish Throttle Minutes. A value of zero means that there is no limit.
Publish throttle minutes
Set the amount of time within which a user is allowed to publish, at most, the number of posts specified in the Publish Throttle Count. A value of zero means that there is no limit.
Replace throttle count
Set the number of times a user is allowed to replace posts to JMP Live within the value specified in Replace Throttle Minutes. A value of zero means that there is no limit. If you specify a negative value, the Publish Throttle Count value is used.
Replace throttle minutes
Set the amount of time within which a user is allowed to replace, at most, the number of posts specified in the Replace Throttle Count. A value of zero means that there is no limit. If you specify a negative value, the Publish Throttle Minutes value is used.
Configuration Settings
Enable API key
Indicates whether the server API should be protected by an API key.
Authentication scheme
Set the authentication scheme that JMP Live uses. Possible values include keycloak, ldap, and local. This should be set once and never changed unless starting over with an empty database.
Cookie expire time
Set the amount of time a session’s cookie is valid. You cannot enter a value below five seconds.
Database maximum connections (JMP Live)
The maximum number of concurrent database connections that any one instance of JMP Live attempts to sustain. The default value is 25.
Base URL
Base URL for this JMP Live server.
JMP Live launch time
Shows the time at which this instance of JMP Live was initially launched.
Default Loggly token
Set the default token to use when sending log records to Loggly. For a description of Loggly, see Loggly token.
Allow social sharing
Choose whether to allow users to share links to posts on social media.
SSL certificate authority file
Set the path to the certificate authority file. This file contains the public key signatures of the chain of signing authorities that have signed the SSL certificates.
SSL .crt file
Set the path to the .crt file. A .crt file is a digital certificate file that is used with a web browser to verify a secure website’s authenticity.
SSL certificate expiration date
Date that the current SSL certificate file expires.
SSL key file
Set the path to the certificate key file. A certificate key file is a private text file used initially to generate a Certificate Signing Request. It is used later to secure and verify connections using the certificate that was created by that request.
Monitor the Status of JMP Pools
A JMP pool has a number of JMP sessions running on different ports. You can monitor the status of JMP pools under Admin > JMP Pool Status. Click the gray arrow beside the web address to see the JMP sessions for that pool.
Figure 1.26 JMP Pool Status
The Summary at the top shows you how many JMP sessions are available, in use, closed, or launching, and how many JMP sessions you have in total. You also see CPU and memory statistics indicating how busy the sessions are.
If a session is in use, you can see who is using it, when it was launched, and the JMP report associated with the JMP session.
The window refreshes automatically every five seconds. You can perform any of the following actions:
Click Refresh to refresh on demand.
Click Pause to stop refreshing the window automatically.
Click Play to start refreshing automatically again.
Restart a Session
If a session in a pool appears to be hanging, you have two options:
First, click Recycle to make the session available to someone else. In the Summary, the session should go from In Use or Launching to Available.
If Recycle does not work, click Terminate to completely shut down the session and make it available.
To restart all sessions in a pool, click Recycle or Terminate next to the pool’s web address.
Manage the Audit Log
In the audit log, you can track changes that users make in JMP Live, such as publishing a post, deleting a post, creating a user, following someone, and so on. The audit log is a record that administrators can use to see user activity and troubleshoot issues. Click Admin > Audit Log to open the audit log.
Search the Audit Log
You can search the audit log by a specific action type, outcome, user, post, IP address, or date. Limit your search using any combination of these filters:
Search by action:
1.
Click All actions.
2.
(Optional) Hover over an action to see a description.
3.
Select the actions that you want to search for.
4.
Click Apply.
5.
To remove all actions, click Clear and then click Apply.
Search by post: In the Find object box, enter the post ID. You can find the post ID at the end of the URL of a JMP Live post.
Search by user: In the Find user box, enter a person’s display name or user ID.
Filter by outcome: Click Succeeded? and check the box next to Yes or No and then click Apply.
Limit the date range: Click All dates and choose a date, or click Custom dates to enter a specific date range.
Search by IP address: In the Find IP address box, enter an IP address.
Search details: In the Search details box, enter text to search in the Details column (which uses JSON formatting).
In the results, you can see when and by whom an action was performed. You can also perform these actions:
Click an Object ID to see the impacted post, group, or user.
Click an Acting User to see the user’s profile associated with the action.
Remove Filters
To remove a filter from the search, below the search bar, click the x beside a user name or post ID.
Figure 1.27 Remove a Filter
Download the Audit Log
Click Download to get a CSV file of the audit log. Before you download the audit log, it is recommended to limit the results by performing a search. If you have not limited the results, the Download button might be grayed out to prevent large downloads resulting in poor performance.