Skip to content

Latest commit

 

History

History
88 lines (55 loc) · 3.79 KB

changing-git-url-format-in-cluster.rst

File metadata and controls

88 lines (55 loc) · 3.79 KB
Raw
is-up-to-date

True

last-updated

4.0.0

Changing the Cluster Git URL, Studio Clustering, Clustering

Changing the Cluster Git URL

When the cluster Git URL for syncing members is changed after a cluster has been setup and started, the nodes on the disk may contain the old URL format when starting up. The following error appears in the log when switching the URL from SSH to HTTPS:

[ERROR] 2021-03-12T18:54:02,887 [pool-5-thread-10] [job.StudioClockExecutor] | Error executing Studio Clock Job
java.lang.ClassCastException: org.eclipse.jgit.transport.TransportHttp cannot be cast to org.eclipse.jgit.transport.SshTransport

To sync the Git URL format on disk with the new format set in the config, the remotes will need to be recreated

To recreate a remote:

  1. Stop the cluster

  2. Update the configuration file with the desired URL format in all your nodes

    # Cluster Git URL format for synching members.
# - Typical SSH URL format: ssh://{username}@{localAddress}{absolutePath}
# - Typical HTTPS URL format: https://{localAddress}/repos/sites
studio.clustering.sync.urlFormat: ssh://{username}@{localAddress}{absolutePath}

  3. Remove the remotes in all your nodes via the command line interface using git in the global repo and the sandbox and published repos of all the sites in the cluster.

    The global repo is located in CRAFTER_HOME/data/repos/global, the sandbox repo of a site is located in CRAFTER_HOME/data/repos/sites/<site-name>/sandbox and the published repo of a site is located in CRAFTER_HOME/data/repos/sites/<site-name>/published

    The cluster remote names are available from Cluster in the Studio global menu.

    Remember to only remove the cluster remotes. Cluster remote names start with cluster_. See example below:

    $ git remote -v
cluster_node_192.168.1.103    ssh://myuser@192.168.1.103/opt/crafter/data/repos/sites/video/sandbox (fetch)
cluster_node_192.168.1.103    ssh://myuser@192.168.1.103/opt/crafter/data/repos/sites/video/sandbox (push)
origin    https://github.com/craftercms/video-center-blueprint.git (fetch)
origin    https://github.com/craftercms/video-center-blueprint.git (push)

    To remove a remote, run git remote rm <remote_name>, where remote_name is the name of remote as seen from the Cluster screen in the Studio Main Menu. Let's use the remote name cluster_node_192.168.1.103 for our example on removing a remote

    $ git remote rm cluster_node_192.168.1.103

    To verify the remotes are gone on disk, view the current remotes and make sure that the list does not contain a remote with a name beginning with cluster_xxxx:

    $ git remote -v
origin    https://github.com/craftercms/video-center-blueprint.git (fetch)
origin    https://github.com/craftercms/video-center-blueprint.git (push)
  4. Start the cluster. Once the cluster is started, the remotes will be recreated. Verify that the URL format displayed in Cluster in the Studio global menu is the desired URL format.