rippled v1.3.x Migration Instructions

This document describes the migration process for upgrading from rippled 1.2.4 or earlier to rippled v1.3 or later. This migration process is necessary because the rippled install process has changed as of version 1.3.

This document provides migration steps for upgrading on supported platforms:

For other platforms, see the updated instructions for compiling from source. (Ubuntu, macOS, or Windows )

Migration on CentOS or Red Hat Enterprise Linux (RHEL)

Ripple's official RPM repository and instructions for using it have changed. If you have automatic updates enabled, your system should perform the migration automatically. To migrate manually from the old repository to the new one, complete the following steps:

  1. Stop the rippled server.

    $ sudo systemctl stop rippled.service
    
  2. Remove the old Ripple repository package.

    $ sudo rpm -e ripple-repo
    

    The rippled-repo package is now DEPRECATED. The package has been updated one last time for version 1.3.1. In the future, any changes to the repositories will require manual changes to the ripple.repo file.

  3. Add Ripple's new yum repository:

    $ cat << REPOFILE | sudo tee /etc/yum.repos.d/ripple.repo
    [ripple-stable]
    name=XRP Ledger Packages
    baseurl=https://repos.ripple.com/repos/rippled-rpm/stable/
    enabled=1
    gpgcheck=0
    gpgkey=https://repos.ripple.com/repos/rippled-rpm/stable/repodata/repomd.xml.key
    repo_gpgcheck=1
    REPOFILE
    
  4. Install the new rippled package:

    $ sudo yum install rippled
    

    Version 1.3.1 does not require any changes to your config files (rippled.cfg and validators.txt). This update procedure leaves your existing config files in place.

  5. Reload systemd unit files:

    $ sudo systemctl daemon-reload
    
  6. Start the rippled service:

    $ sudo systemctl start rippled.service
    

Warning: If you use automatic updates, they should continue working after performing this migration process. However, the ripple-repo package is now deprecated. As a consequence, in the future, any changes to Ripple's repositories may require you to manually update your repos file.

Migration on Ubuntu Linux

Prior to version 1.3, the supported way to install rippled on Ubuntu Linux was using Alien to install the RPM package. Starting with rippled v1.3.1, Ripple provides a native package for Ubuntu and Debian Linux, which is the recommended way of installing it. If you already have the RPM package installed, complete the installation steps to upgrade the package and switch over to the native APT (.deb) package.

If you have made any changes to your config files (/opt/ripple/etc/rippled.cfg and /opt/ripple/etc/validators.txt), apt may prompt you during installation asking if you want to overwrite your config files with the newest versions from the packages. Version 1.3 does not require any changes to the config file, so you can safely keep your existing config files unchanged.

After installing the native APT package for 1.3, you will need to reload/restart the service:

  1. Reload systemd unit files:

    $ sudo systemctl daemon-reload
    
  2. Restart the rippled service:

    $ sudo systemctl restart rippled.service
    

If you no longer need Alien for any other packages, you may optionally uninstall it and its dependencies using the following steps:

  1. Uninstall Alien:

    $ sudo apt -y remove alien
    
  2. Uninstall unused dependencies:

    $ sudo apt -y autoremove
    

Automatic Updates

The rippled v1.3 package includes an updated auto-update script that works on Ubuntu and Debian Linux. For more information, see Update rippled Automatically on Linux.