Bridge Client Linux Archive Installation

This topic describes installation of the Bridge Client service using a and Linux archive. Review verify prerequisites before you begin installation.

This topic describes installation of the Bridge Client service using a Linux archive.

Review and verify prerequisites before you begin installation.

To install the Bridge Client with a Linux Archive:

Download the latest Bridge Client Linux archive from the official JFrog releases page.
Move the downloaded file to the /opt directory. The Bridge service and the user that are created during installation inherit required run and execute permissions from the /opt directory.
```
mv jfrog-bridge-<version>-linux.tar.gz /opt/
```
Go to the /opt directory. Extract the contents of the archive, and rename the extracted folder to bridge.
```
cd /opt
tar -xf jfrog-bridge-<version>-linux.tar.gz
mv jfrog-bridge-<version>-linux bridge
```
Run the installer.
```
bridge/app/bin/install.sh [-u <user_name>] [-g <group_name>] [-h]
```
where:

-h (optional) displays usage information

-u (optional) specifies the user that runs the product. The installer creates this user if it does not exist. By default, a user named bridge is created.

-g (optional) specifies the group that runs the product. The installer creates this group if it does not exist. By default, a group named bridge is created.
The installer runs as an interactive script. At the following prompt, enter the URL of the self-managed JPD that will host the Bridge client. This URL is used to register the Bridge client in the JPD topology.
```
The JFrog URL allows Bridge to connect to a JFrog Platform Instance.
(You can copy the JFrog URL from Administration > Security > General > Connection details)
JFrog URL [http(s)://<self_managed_JPD>:8082]:
```

At the following prompt, enter the Join Key defined of the self-managed JPD.

The Join Key is the secret key used to establish trust between services in the JFrog Platform.
(You can copy the Join Key from Administration > Security > General > Connection details)
Join Key:

At the following prompt, enter the Master Key of the self-managed JPD.

Provide the Artifactory's master key. 
It can be found in the data directory of the jpd under /etc/security/master.key
Master Key:

At the following prompt, enter the IP address of the machine that runs the script. Otherwise, the script will take the default value.

For IPv6 address, enclose value within square brackets as follows : [<ipv6_address>]
Please specify the IP address of this machine (Default: 0.0.0.0):

Press Enter. The installer script creates directories and completes the setup.

Installation complete. Installation log can be found at [/opt/bridge/var/log/install.log]
NOTE : Make sure /opt/bridge is owned by bridge.    
chown -R bridge:bridge /opt/bridge

If necessary, change the ownership of the entire /opt/bridge directory to the bridge user and group to prevent permission issues.
```
chown -R <user name>:<group name> /opt/bridge
```
Access the configuration file at bridge/var/etc/system.yaml and modify it to customize connection details, ports, the node ID, and other settings.
(Optional) To install the Bridge Client as a persistent service:
1. Run the installer app/bin/InstallService.sh
2. Start the service with the command systemctl start bridge.service
Use systemd or init.d commands to manage the service.

Using systemd:
```
systemctl <start|stop|status> bridge.service
```
Using init.d:
```
service bridge <start|stop|status>
```
Use the following bash command to monitor Bridge service log entries:
```
tail -f bridge/var/log/console.log
```

Bridge Client Installation in an HA Cluster

Repeat the procedure described above to install the Bridge Client service on several nodes in an HA cluster:

In step 5, use the same URL for all nodes in the cluster.
In step 8, use the unique IP address of each node.

Install Bridge Client Service on the same Virtual Machine as Artifactory

In some Self-managed installations, each JFrog component is installed on its own virtual machine. This is not necessary for the Bridge service, which has a small footprint and low bandwidth.

To install and run the Bridge Client service on a self-hosted Artifactory instance:

Install the Bridge Client Service on the Artifactory machine.
Access the configuration file at bridge/var/etc/system.yaml and modify it as shown in the example below.
- Update the router entry points to avoid port conflicts with Artifactory.
- The values of node:id and node:name must be different from the values used in the Artifactory system.yaml file. In the example, the value bridge is used.

shared:  
   node:    
     id: bridge   # Must be different from Artifactory node name
     name: bridge   # Must be different from Artifactory node name

router:   
   entrypoints:    
      externalPort: "9082"    
      internalPort: "9046"    
      traefikApiPort: "9049"    
      grpcPort: "9047"

observability:
   httpPort: "9036"
   grpcPort: "9037"

Updated 2 days ago