Subscription Information
This feature is supported on the Self-Hosted platform, with an Enterprise+ license.
You can install and configure JFrog Insight, single node and high availability. For additional information on high availability, see high availability
Before installing Insight 1.x, you must first install JFrog Artifactory 7.x.
Warning
You must install or upgrade to Artifactory 7.27.3 or later, if you want to install Insight. For previous versions, install and use Mission Control.
Do not install Insight if you have standalone Mission Control service running. Run the migration steps before you install Insight. For more information, see Migrating from Mission Control to Insight.
Note
Use a dedicated server with no other software running to alleviate performance bottlenecks, avoid port conflicts, and avoid setting uncommon configurations.
To learn about the JFrog Platform Deployment, refer to System Architecture.
Admin Permissions for Installation
We recommend that you run the installation as a root user or provide sudo access to a non-root user.
You need to have admin permissions on the installation machine in the following cases.
Native installer - always requires admin permissions
Archive installer - requires admin permissions only during installation
Docker installer - does not require admin permissions
Warning
Insight requires the Mission Control microservice to be running on Artifactory. If you use a standalone Mission Control service, migrate to Mission Control microservice before you proceed with Insight installation. For more information, see Migrating Platform Deployments and License Buckets.
Before you proceed, see System Requirements for information on supported platforms, supported browsers, and other requirements.
Installation Steps
The installation procedure involves the following main steps:
Download Insight as per your required installer type (Linux Archive, Docker Compose, RPM, Debian).
Install Insight either as a single node installation, or high availability cluster.
Install third party dependencies (PostgreSQL and Elasticsearch databases, included in the archive)
Install Insight
Configure the service
Connection to Artifactory (
joinKeyandjfrogUrl)Additional optional configuration including changing default credentials for databases
Start the Service using the start scripts or OS service management.
Check the Service Log to check the status of the service.
Default Home Directory / $JFROG_HOME
The default Xray home directory is defined according to the installation type. For additional details see the Product Directory Structure page.
$JFROG_HOME represents the JFrog root directory containing the deployed product.
Insight Single Node Installation
The following installation methods are supported:
Interactive Script (recommended)
Linux Archive
Manual RPM
Manual Debian
Helm
Insight HA Installation
The following describes how to set up an Insight HA cluster with more than one node. For more information about HA, see System Architecture.
The following installation methods are supported.
Interactive Script
Linux Archive
Helm
Prerequisites
All nodes within the same Insight HA installation must be running the same Artifactory version.
Warning
For an Insight HA cluster to work correctly, you must have at least three nodes in the cluster.
Database
Insight HA requires an external PostgreSQL database. Make sure to install it before proceeding to install the first node. There are several ways to setup PostgreSQL for redundancy. Including: HA, Load Balancing, and Replication. For more information, see the PostgreSQL documentation
Network
All the Insight HA components (Insight cluster nodes, database server and Elasticsearch) must be within the same fast LAN.
All the HA nodes must communicate with each other through dedicated TCP ports.