Skip to main content

Jama Connect User Guide

Update the IP address for the application server (traditional)

If you need to update the IP address or hostname of your application server, you must also edit the Replicated configuration files to reflect this change.

If you previously used an IP address, continue using an IP address. If you previously used a hostname, continue using a hostname.

Note

If you are using DNS and the hostname for this server isn't changing (just the underlying IP), you don't need to edit any files.

  1. Make the IP/hostname changes in your network and on the server.

  2. Stop the Jama Connect services.

  3. Stop Replicated (Admin Console):

    • CentOS, RHEL 7+, and Fedora

      sudo systemctl stop replicated replicated-ui replicated-operator

    • Debian, Ubuntu, and thers

      sudo service replicated stop
sudo service replicated-ui stop
sudo service replicated-operator stop

  4. Edit the Replicated configuration files to replace all occurrences of the old IP address or hostname with the new IP address or hostname.

    • Fedora/CentOS/RHEL

      /etc/sysconfig/replicated and /etc/sysconfig/replicated-operator

    • Debian/Ubuntu

      /etc/default/replicated and /etc/default/replicated-operator

    • Others

      Contact support at support@jamasoftware.com if you can't locate the Replicated configuration files.

  5. If you have a firewall in place or use a proxy and configured no_proxy settings in Docker, update these settings with the new IP address.

  6. Restart Docker.

    • Fedora/CentOS/RHEL 7+

      sudo systemctl restart docker

    • Debian/Ubuntu and Others

      sudo service docker restart

  7. Start the Replicated service (Admin Console).

    • Fedora/CentOS/RHEL 7+

      sudo systemctl start replicated replicated-ui replicated-operator

    • Debian/Ubuntu and Others

      sudo service replicated start
sudo service replicated-ui start
sudo service replicated-operator start

  8. Once the Replicated containers are up, navigate to https://{new_ip_address}:8800, then enter the new IP address or hostname under Settings > Hostname.

  9. Log in to Jama Connect as the root user.

  10. Change the URL to reflect the new IP address.

  11. Run Fix URL references to change any existing references in the text of items that were already created.

In this section: