Upgrade Xray with FIPS

JFrog Installation & Setup Documentation

Content Type
Installation & Setup

Follow these steps to upgrade Xray with FIPS:

  1. Stop the running service:

    cd $JFROG_HOME/xray/app/bin
    ./xray.sh stop ## as xray user
    
    or via service 
    systemctl stop xray.service

    Wait for the services started by the Xray user to stop

  2. Extract the new version:

    mv jfrog-xray-<version>-linux.tar.gz /opt/jfrog/
    cd /opt/jfrog
    tar -xf jfrog-xray-<version>-linux.tar.gz
  3. Replace the $JFROG_HOME/xray/app with the new app folder:

    # Export variables to simplify commands
    export JFROG_HOME=/opt/jfrog   ## this is your old xray dir
    export JF_NEW_VERSION=/opt/jfrog/jfrog-xray-<version>-linux
    
    # Remove app
    rm -rf $JFROG_HOME/xray/app
    
    # Copy new app
    cp -fr $JF_NEW_VERSION/app $JFROG_HOME/xray/
    
    # Make sure to chown again to set the right permissions for xray user
    eg: chown -R xray:xray /opt/jfrog/xray
    
    # Remove extracted new version
    rm -rf $JF_NEW_VERSION
  4. Before starting the Xray service, set the following env variable in the file /opt/jfrog/xray/app/bin/xray.default

    export RABBITMQ_ADVANCED_CONFIG_FILE="${JF_PRODUCT_HOME}/var/etc/advanced.conf"
  5. Set permissions:

    chown -R xray:xray /opt/jfrog/xray
  6. Start the service:

    xray/app/bin/xray.sh start|stop  ## As xray user
    
    or via service 
    
    systemctl <start|stop|status> xray.service