Skip to content

O
OHR Support

Gitlab migration of ohwr faq

Last edited by Maciej Lipinski
Page history

Migrating to Gitlab.

Here are some of the most frequently asked questions on the new ohwr.org site.

What was communicated via e-mail? Did I miss something?

The messages sent out on Feb 7th 2019 were a note on the Gitlab migration and another for mailing list subscribers

At the final steps of the migration, ohwr.org users were informed throug the following note and subscribers to mailing lists were sent this note

Ok, what should I do after the site is migrated?

Very little. After ohwr.org comes back,

  • go to the login screen by clicking the 'Sign In/Register' button.
  • do not try to login with your current credentials: that will fail!
  • click on the 'Forgot your password?' link in the login screen. A message with a link to reset your password will be sent to your registered e-mail address.
  • that's it

What happened to mailing lists?

Maintenance of a full mailing list server proved to be extremely costly; we have reduced manpower to keep the site up. After much reflection on the best way to communicate among members of the community, we decided that setting up a discussion forum would be the best alternative. Not much is lost, as you can still receive updates via e-mail by subscribing to topics.

How can I keep being notified by ohwr.org forums ?

The topic you were subscribed to (for instance, white-rabbit-dev) is now a category within the Discourse space of https://forums.ohwr.org.

Note (see attached screenshot) the top rightmost button in the interface, right next to the 'New topic' button. You can select there the amount of notification you will get whenever something is posted in the category.

What about my mailing list subscriptions? How do I login into forums.ohwr.org?

The procedure is really similar to the one described in the above answer. Your e-mail address (the one you used to subscribe to mailing lists) will be already registered in the forums.ohwr.org system.

  • Click the 'Login' button to access the login screen.
  • There, by clicking on the 'I forgot my password' link you will get an e-mail with a password reset link.
  • That's all!

Again: what happened to my subscriptions? I want to get e-mail notifications. What should I do?

Let us imagine you want to get notifications about the category white-rabbit-dev. The steps are very simple:

What happened to my Git repository references?

Git repository reference URLs have changed, as it is not possible to keep them as they were in the former platform. This implies that you will be submitted to the (hpefully minor) inconvenience of changing remote references in your current working copies.

For example, my working copy of spec-sw has the following remotes:

$ git  remote -v
ohwr    ssh://git@ohwr.org/fmc-projects/spec/spec-sw.git (fetch)
ohwr    ssh://git@ohwr.org/fmc-projects/spec/spec-sw.git (push)
origin  git://ohwr.org/fmc-projects/spec/spec-sw.git (fetch)
origin  git://ohwr.org/fmc-projects/spec/spec-sw.git (push)

This won't work with the new ohr.org. To change them to the correct values, pick the appropriate URLs from the project page, i.e.

    ssh://git@ohwr.org:7999/project/spec-sw.git
    https://ohwr.org/project/spec-sw.git

and issue the commands

$ git remote set-url origin https://ohwr.org/project/spec-sw.git
$ git remote set-url ohwr ssh://git@ohwr.org:7999/project/spec-sw.git

Now you're set:

$ git remote -v
ohwr    ssh://git@ohwr.org:7999/project/spec-sw.git (fetch)
ohwr    ssh://git@ohwr.org:7999/project/spec-sw.git (push)
origin  https://ohwr.org/project/spec-sw.git (fetch)
origin  https://ohwr.org/project/spec-sw.git (push)

What about submodules and submodule references?

If you use submodules, you deserve what you get 😄.

More seriously, the change of repository URL risks breaking absolute submodule references. If at any commit in your repository, you have a submodule ref with one of the old URLs as address part, your build will fail.

To avoid this scenario, we have tried our best to keep mirrors of the old repositories at the same URLs as before. These are read-only, non-pushable, volatile copies that are kept for backward compatibility of submodule references only. They are accessible ONLY via HTTPS for the time being (we are looking into having access to these repos via GIT as well). If you have your submodules accessible via GIT (e.g. git://ohwr.org/hdl-core-lib/wr-cores.git), you will need to change this path to use HTTPS.

This is the least horrible way we have found till now to keep unbroken builds in case old repository URLs (and commits) are referenced. In particular, remote URLs with intermediate path components other than /project/ are certain to be invalid for any other purpose than the uses former submodule references gave to them.

If this sounds terrible, it is, but the sentence at the beginning says it all. Below are 3 simple steps to update URLs to the submodules and have your project working fine again:

  1. In the top folder of your repository with submodules, edit manually the file .gitmodules updating the URLs (for each submodule project, see what is the new HTTPS URL)
  2. Synchronize URLs of submodules:
$ git submodule sync
  1. add and commit the change
$ git add .gitmodules
$ git commit -m "update of submodule URLs after OHWR migration"

When cloning repository or submodule, I get error "fatal: unable to access 'https://[...]: gnutls_handshake() failed: Handshake failed"

You might experience this problem when using old version of GIT and trying to access ohwr.org repository via HTTPS. If this happens, you need to update your git version. We experienced this problem with git 1.9.1 while all works fine with 2.7.4.

My project looks weird and empty. Where's my stuff?

First of all, check the URL. After the migration, the hierarchical URLs of the old site were flattened. So, your project URL should look like https://ohwr.org/project/fmc-adc-400k18b4cha-iso and not like https://ohwr.org/fmc-projects/fmc-adc-400k18b4cha-iso with hierarchical information in the middle.

The first URL is the correct one, and your project and stuff is there, alive and kicking. The latter, although is an existent URL/project, is there only to keep old submodule URLs, and might eventually disappear.

Files