Version 7 vs 56
Version 7 vs 56
Content Changes
Content Changes
* The FAQ will be populated from the most frequently asked questions
# What is c4science ?
C4 Science is a co-creation platform, curation and code sharing. This platform includes:
* Version management system
* Common authentication to all Swiss universities to local + external collaborators
* Social dimension (wikis, bug tracking, ...)
* Code test system (continuous integration)
# You do not have permission to create new repositories
If you belong to a Swiss University, you can create repositories, projects and wiki pages. You need to connect using the SwitchAAI authentication method, or you won't be able to create objects on c4science.
# I just want a simple Git repo: help!
[[ https://c4science.ch/w/c4science/simplerepo/ | here are the instructions ]]. Do not hesitate to [[ mailto:scitas@epfl.ch]] contact us if you think something should be added/changed.
# I get a 403 error, what do I do?
If the error looks like this
`fatal: unable to access 'https://c4science.ch/diffusion/997/simplegitrepo.git/': The requested URL returned error: 403`
you probably have not set up a VCS password. Have a look [[https://c4science.ch/w/c4science/whatisvcs/ | here]].
* The FAQ will be populated from the most frequently asked questions
* If your problem isn't listed here, contact your local IT support
# What is c4science ?
c4science is a co-creation platform, curation and code sharing. This platform includes:
* Version management system
* Common authentication to all Swiss universities to local + external collaborators
* Collaboration (wikis, bug tracking, ...)
* Code test system (continuous integration)
# How long will the service be available?
C4science is here to stay. Our goal is to facilitate long term collaboration on source code for Swiss universities and their scientific partners.
# Is the data stored on a safe server within Switzerland?
We're using Switch Engines infrastructure in Lausanne Datacenter, and Zurich as backup. Data are strictly stored in Switzerland, and securely transit only within the SWITCH network.
# Who has access to my user data?
You can see [[ https://drive.switch.ch/index.php/s/aSUdxyXg3YUnSeA | section 9.1 of the SLAs ]].
# Who can use the platform?
Member of Swiss Universities have full access to the platforms. External users can register with their Google, GitHub or a local account and be added to projects and repositories by members of Swiss Universities.
# My repositories were hosted on git.epfl.ch. What happened to them?
Everything was archived and available on demand. [[ https://c4science.ch/maniphest/task/edit/form/8/?title=git.epfl.ch%20recovery | Get in touch with us. ]]
# EPFL Groups integration
You can use our import script to syncronize EPFL groups if your group is Public. This also works with any EPFL unit. Take a look in here: [[https://c4science.ch/source/phab-api/#getmystuph]]
# I registered on the platform but do not have permission to create new repositories, what is happening? OR I mistakenly registered using a local account instead of a university account ?
If you belong to a Swiss University, you can create repositories, projects and wiki pages. You need to connect using the SwitchAAI authentication method, or you won't be able to create objects on c4science.
If you already registered for a local account and now your email is in use preventing you from registering with SwitchAAI, you have a couple of options:
- Link SwitchAAI with your current account from the preferences, {nav User icon on the upper right > Settings > Authentication > External Accounts > Add External Account > SwitchAAI for Swiss Universities}
- Or, change your main email for something else, then ask for this local account to be deactivated and finally register with SwitchAAI
# I just want a simple Git repo: help!
[[ https://c4science.ch/w/c4science/simplerepo/ | here are the instructions ]]. Do not hesitate to create a [[https://c4science.ch/maniphest/task/edit/?policy.view=PHID-PLCY-qhob65lybi5itkipfvwb&policy.edit=PHID-PLCY-zom4pfmfqmxuosdjggpg&projectPHIDs=PHID-PROJ-itwdg3fgxutsrdnqjklb,PHID-PROJ-eovnjqphn4al2vpqklvn|bug report]] if you think something should be added/changed.
# How I can create a private repository that is nowhere visible and accessible?
The repositories created via [[ https://c4science.ch/w/c4science/simplerepo/ | these instructions ]] are by default only visible/accessible by the creator.
# I get a 403 error, what do I do?
If the error looks like this
`fatal: unable to access 'https://c4science.ch/diffusion/997/simplegitrepo.git/': The requested URL returned error: 403`
- You don't have access to the repository (view or push)
- You have not set up a VCS password. Have a look [[https://c4science.ch/w/c4science/whatisvcs/ | here]].
- Make sure you are using the correct c4science username, you can find it in you profile page
- Password manager
- If no username or password is asked during the request, you may have stored your credentials. Delete the credentials (depends on your operating system)
- Mac OSX: The password is stored in the Keychain application in a internet password entry type for c4science.ch
- Windows/Linux: By default the password is stored in plaintext in a file or with a password manager (keychain, windows password manager, ...).
- You should be able to find the file or the way it's been stored using this command `git config --global --get credential.helper`. If you see `credential.helper=manager` or `credential.helper=osxkeychain`it means your OS is managing the password and there is something wrong stored there.
# I don't understand what the policies (Visible/Editable/Pushable) are.
- //Visible// means that the object (repository, project,...) can be accessed in read mode.
- //Editable by// is the list of administrators (who can modify the object via the web interface)
- //Pushable by// is for repositories and is the list of entities who can push to the repo
# What are "dangerous changes"?
Here are several changes that are classified as dangerous by Phabricator:
- delete a remote branch (`git push --delete`)
- rewriting history (`git push --force`)
An administrator of the repository can allow dangerous changes, from the repo page:
{nav Actions > Manage Repository > Basics > Actions > Allow Dangerous Changes}
It's best to Disable Dangerous Changes when you are done, so you don't delete files by mistake later on.
# I use c4science to manage projects within my lab. Staff changes often. How do I give rights to a group?
C4science is global to all SwissUniversites members, thus you have to create a group in c4science to be referenced to. To do this, create a new project (or subproject) with icon type "Group" and add the appropriate users to it.
# I need to store binary files, how do I do this?
Binary files, must not be hosted directly in a repository. GIT is not made for that. You can use GIT LFS (large file storage) for that, see https://c4science.ch/w/c4science/lfs/ your files will still be referenced in the repository, but hosted outside of it.
Quotas policies can be changed without notice. Current policy is 100MB per file and 250MB per push.
# I would like to display a wiki page as homepage for a project instead of the //Recent Activity// feed.
Unfortunately, not yet -- you can add elements to the menu, task list, or modify the project description, which appears on the project page.
# C4science only provides SSH links for SVN
HTTP access is only possible for Mercurial and GIT.
# Is there a way to access a private repository without SSH key?
You can [[ https://c4science.ch/w/c4science/whatisvcs/ | use VCS ]]. Unauthenticated access must use HTTP instead of SSH, your repository view policy must be set to Public.
# Permission Denied when using a DSA SSH key
DSA/DSS keys are obsolete and the SSH client prevents its usage by default on most platform. Our server accepts such keys, but you have to allow the client to send it by modifying your SSH configuration like so:
```
Host c4science.ch
PubkeyAcceptedKeyTypes +ssh-dss
```
It is advised that you create an RSA key instead, of a minimum size of 2048-bit.
# Permission denied using SSH
## Wrong private key filename
It's possible that your key have a non standard name the your SSH client cannot find. By default, the client will look for id_rsa, id_dsa files. If you customized your key name, please specify your key in the client configuration in `~/.ssh/config` like so:
```
Host c4science.ch
User git
IdentityFile /home/aubort/.ssh/id_rsa_phab
```
## No SSH agent
* It's possible that your ssh-agent isn't running
* Here's how to start a new ssh agent and add your ssh key to it
```
eval `ssh-agent -s`
ssh-add ~/.ssh/id_rsa
```
# Invalid Shibboleth Session
* You can't log in using SwitchAAi with Invalid Shibboleth Session` error
* This can have multiple root causes, the most usual cause is the lack of email in the Shibboleth authentication
* Make sure you have an email associated with your university account
# Why can't I delete anything on c4science ?
* Deleting objects is a complicated problem, upstream Phabricator didn't find a satisfactory solution so they decided nothing can ever be deleted.
* You can see some argumentation about it:
** https://secure.phabricator.com/T8830#129742
** https://secure.phabricator.com/T5485#166598
* If you really need something to be deleted, get in touch with us
# fatal: The remote end hung up unexpectedly
- There may be multiple reasons for this error, bug in general it's that your push is too big (>= 256MB) and you're using HTTP
- Here are some possibilities
- Use SSH instead of HTTP which doesn't have limit, see [[c4science/sshkeys/]]
- You can tweak how GIT is sending the push so it doesn't break our servers by using this command
```
git config http.postBuffer 128000000
```
It's also a good idea to remove big files from your repository using BFG and add them back with GIT LFS, see [[c4science/lfs/]], or simply use LFS from now on.
# WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
* If you have this message, make sure the key fingerprint is one of the following,
```
2048 SHA256:uQ/5ZR62kzgdcmhjzmULN6wuW8J1iXWA5kNibUP9bcU c4science.ch (RSA)
256 SHA256:hlDsRQ9XEGLOM9g9tdUaigIyDNuCD80x2G2RcdJOLRo c4science.ch (ECDSA)
256 SHA256:u0EBwdqWNPdKxm4JYi8M7YfYtpl8RPG96E28bdSJ3R0 c4science.ch (ED25519)
```
* If this is not the case, there's a big problem. Please contact your local IT support
# This file is binary - blank page on the repository file browser
* If you have a file with a non-UTF8 character, the file will be treated as Binary. It'll then be hidden in the web interface
* Either use plain ASCII or UTF-8 encoding
* You can convert your file to UTF-8 using `iconv`, where ISO-8859-16 is the source encoding
```
iconv -f iso-8859-16 -t utf8 -o input.txt input.txt
```
* See [[https://secure.phabricator.com/T3788 | T3788 Improve encoding]] and [[https://secure.phabricator.com/book/phabricator/article/utf8/|UTF8]]
# You can not select this edit policy, because you would no longer be able to view the object.
When creating a Project with the default Policies (Project Members), you must add yourself to the `Initial Members`, otherwise you'll not be able to Edit the project you just created.
* The FAQ will be populated from the most frequently asked questions
# What is c4science ?
C4 Science is a co-creation platform, curation and code sharing. This platform includes:
* Version management system
* Common authentication to all Swiss universities to local + external collaborators
* Social dimension (wikis, bug tracking, ...)
* Code test system (continuous integration)
# You do not have permission to create new repositories
If you belong to a Swiss University, you can create repositories, projects and wiki pages. You need to connect using the SwitchAAI authentication method, or you won't be able to create objects on c4science.
# I just want a simple Git repo: help!
[[ https://c4science.ch/w/c4science/simplerepo/ | here are the instructions ]]. Do not hesitate to [[ mailto:scitas@epfl.ch]] contact us if you think something should be added/changed.
# I get a 403 error, what do I do?
If the error looks like this
`fatal: unable to access 'https://c4science.ch/diffusion/997/simplegitrepo.git/': The requested URL returned error: 403`
you probably have not set up a VCS password. Have a look [[https://c4science.ch/w/c4science/whatisvcs/ | here]].* If your problem isn't listed here, contact your local IT support
# What is c4science ?
c4science is a co-creation platform, curation and code sharing. This platform includes:
* Version management system
* Common authentication to all Swiss universities to local + external collaborators
* Collaboration (wikis, bug tracking, ...)
* Code test system (continuous integration)
# How long will the service be available?
C4science is here to stay. Our goal is to facilitate long term collaboration on source code for Swiss universities and their scientific partners.
# Is the data stored on a safe server within Switzerland?
We're using Switch Engines infrastructure in Lausanne Datacenter, and Zurich as backup. Data are strictly stored in Switzerland, and securely transit only within the SWITCH network.
# Who has access to my user data?
You can see [[ https://drive.switch.ch/index.php/s/aSUdxyXg3YUnSeA | section 9.1 of the SLAs ]].
# Who can use the platform?
Member of Swiss Universities have full access to the platforms. External users can register with their Google, GitHub or a local account and be added to projects and repositories by members of Swiss Universities.
# My repositories were hosted on git.epfl.ch. What happened to them?
Everything was archived and available on demand. [[ https://c4science.ch/maniphest/task/edit/form/8/?title=git.epfl.ch%20recovery | Get in touch with us. ]]
# EPFL Groups integration
You can use our import script to syncronize EPFL groups if your group is Public. This also works with any EPFL unit. Take a look in here: [[https://c4science.ch/source/phab-api/#getmystuph]]
# I registered on the platform but do not have permission to create new repositories, what is happening? OR I mistakenly registered using a local account instead of a university account ?
If you belong to a Swiss University, you can create repositories, projects and wiki pages. You need to connect using the SwitchAAI authentication method, or you won't be able to create objects on c4science.
If you already registered for a local account and now your email is in use preventing you from registering with SwitchAAI, you have a couple of options:
- Link SwitchAAI with your current account from the preferences, {nav User icon on the upper right > Settings > Authentication > External Accounts > Add External Account > SwitchAAI for Swiss Universities}
- Or, change your main email for something else, then ask for this local account to be deactivated and finally register with SwitchAAI
# I just want a simple Git repo: help!
[[ https://c4science.ch/w/c4science/simplerepo/ | here are the instructions ]]. Do not hesitate to create a [[https://c4science.ch/maniphest/task/edit/?policy.view=PHID-PLCY-qhob65lybi5itkipfvwb&policy.edit=PHID-PLCY-zom4pfmfqmxuosdjggpg&projectPHIDs=PHID-PROJ-itwdg3fgxutsrdnqjklb,PHID-PROJ-eovnjqphn4al2vpqklvn|bug report]] if you think something should be added/changed.
# How I can create a private repository that is nowhere visible and accessible?
The repositories created via [[ https://c4science.ch/w/c4science/simplerepo/ | these instructions ]] are by default only visible/accessible by the creator.
# I get a 403 error, what do I do?
If the error looks like this
`fatal: unable to access 'https://c4science.ch/diffusion/997/simplegitrepo.git/': The requested URL returned error: 403`
- You don't have access to the repository (view or push)
- You have not set up a VCS password. Have a look [[https://c4science.ch/w/c4science/whatisvcs/ | here]].
- Make sure you are using the correct c4science username, you can find it in you profile page
- Password manager
- If no username or password is asked during the request, you may have stored your credentials. Delete the credentials (depends on your operating system)
- Mac OSX: The password is stored in the Keychain application in a internet password entry type for c4science.ch
- Windows/Linux: By default the password is stored in plaintext in a file or with a password manager (keychain, windows password manager, ...).
- You should be able to find the file or the way it's been stored using this command `git config --global --get credential.helper`. If you see `credential.helper=manager` or `credential.helper=osxkeychain`it means your OS is managing the password and there is something wrong stored there.
# I don't understand what the policies (Visible/Editable/Pushable) are.
- //Visible// means that the object (repository, project,...) can be accessed in read mode.
- //Editable by// is the list of administrators (who can modify the object via the web interface)
- //Pushable by// is for repositories and is the list of entities who can push to the repo
# What are "dangerous changes"?
Here are several changes that are classified as dangerous by Phabricator:
- delete a remote branch (`git push --delete`)
- rewriting history (`git push --force`)
An administrator of the repository can allow dangerous changes, from the repo page:
{nav Actions > Manage Repository > Basics > Actions > Allow Dangerous Changes}
It's best to Disable Dangerous Changes when you are done, so you don't delete files by mistake later on.
# I use c4science to manage projects within my lab. Staff changes often. How do I give rights to a group?
C4science is global to all SwissUniversites members, thus you have to create a group in c4science to be referenced to. To do this, create a new project (or subproject) with icon type "Group" and add the appropriate users to it.
# I need to store binary files, how do I do this?
Binary files, must not be hosted directly in a repository. GIT is not made for that. You can use GIT LFS (large file storage) for that, see https://c4science.ch/w/c4science/lfs/ your files will still be referenced in the repository, but hosted outside of it.
Quotas policies can be changed without notice. Current policy is 100MB per file and 250MB per push.
# I would like to display a wiki page as homepage for a project instead of the //Recent Activity// feed.
Unfortunately, not yet -- you can add elements to the menu, task list, or modify the project description, which appears on the project page.
# C4science only provides SSH links for SVN
HTTP access is only possible for Mercurial and GIT.
# Is there a way to access a private repository without SSH key?
You can [[ https://c4science.ch/w/c4science/whatisvcs/ | use VCS ]]. Unauthenticated access must use HTTP instead of SSH, your repository view policy must be set to Public.
# Permission Denied when using a DSA SSH key
DSA/DSS keys are obsolete and the SSH client prevents its usage by default on most platform. Our server accepts such keys, but you have to allow the client to send it by modifying your SSH configuration like so:
```
Host c4science.ch
PubkeyAcceptedKeyTypes +ssh-dss
```
It is advised that you create an RSA key instead, of a minimum size of 2048-bit.
# Permission denied using SSH
## Wrong private key filename
It's possible that your key have a non standard name the your SSH client cannot find. By default, the client will look for id_rsa, id_dsa files. If you customized your key name, please specify your key in the client configuration in `~/.ssh/config` like so:
```
Host c4science.ch
User git
IdentityFile /home/aubort/.ssh/id_rsa_phab
```
## No SSH agent
* It's possible that your ssh-agent isn't running
* Here's how to start a new ssh agent and add your ssh key to it
```
eval `ssh-agent -s`
ssh-add ~/.ssh/id_rsa
```
# Invalid Shibboleth Session
* You can't log in using SwitchAAi with Invalid Shibboleth Session` error
* This can have multiple root causes, the most usual cause is the lack of email in the Shibboleth authentication
* Make sure you have an email associated with your university account
# Why can't I delete anything on c4science ?
* Deleting objects is a complicated problem, upstream Phabricator didn't find a satisfactory solution so they decided nothing can ever be deleted.
* You can see some argumentation about it:
** https://secure.phabricator.com/T8830#129742
** https://secure.phabricator.com/T5485#166598
* If you really need something to be deleted, get in touch with us
# fatal: The remote end hung up unexpectedly
- There may be multiple reasons for this error, bug in general it's that your push is too big (>= 256MB) and you're using HTTP
- Here are some possibilities
- Use SSH instead of HTTP which doesn't have limit, see [[c4science/sshkeys/]]
- You can tweak how GIT is sending the push so it doesn't break our servers by using this command
```
git config http.postBuffer 128000000
```
It's also a good idea to remove big files from your repository using BFG and add them back with GIT LFS, see [[c4science/lfs/]], or simply use LFS from now on.
# WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!
* If you have this message, make sure the key fingerprint is one of the following,
```
2048 SHA256:uQ/5ZR62kzgdcmhjzmULN6wuW8J1iXWA5kNibUP9bcU c4science.ch (RSA)
256 SHA256:hlDsRQ9XEGLOM9g9tdUaigIyDNuCD80x2G2RcdJOLRo c4science.ch (ECDSA)
256 SHA256:u0EBwdqWNPdKxm4JYi8M7YfYtpl8RPG96E28bdSJ3R0 c4science.ch (ED25519)
```
* If this is not the case, there's a big problem. Please contact your local IT support
# This file is binary - blank page on the repository file browser
* If you have a file with a non-UTF8 character, the file will be treated as Binary. It'll then be hidden in the web interface
* Either use plain ASCII or UTF-8 encoding
* You can convert your file to UTF-8 using `iconv`, where ISO-8859-16 is the source encoding
```
iconv -f iso-8859-16 -t utf8 -o input.txt input.txt
```
* See [[https://secure.phabricator.com/T3788 | T3788 Improve encoding]] and [[https://secure.phabricator.com/book/phabricator/article/utf8/|UTF8]]
# You can not select this edit policy, because you would no longer be able to view the object.
When creating a Project with the default Policies (Project Members), you must add yourself to the `Initial Members`, otherwise you'll not be able to Edit the project you just created.
c4science · Help