Commit c8740407 authored by Mathis Raguin's avatar Mathis Raguin Committed by Marin Hannache
Browse files

edit: update documentation and add missings pages


With-contribution-by: default avatarLyro1 <liro1du78@live.fr>
Signed-off-by: Mathis Raguin's avatarMathis Raguin <mathis.raguin@epita.fr>
parent f56391ab
......@@ -11,22 +11,18 @@ The Bocal account is created at the beginning of the scholarship, allowing
students to:
* Check one's emails on [Office365](https://login.microsoftonline.com/)
* Connect to Ionis-Portal (wifi)
* Connect to the [Bocal intranet](http://intra.bocal.org)
* Connect to Ionis Portal and IONIS (wifi)
* Connect to the [Bocal intranet](http://console.bocal.org)
For new accounts, created after 2016, only "password" is given. However, for
previous accounts, 4 were given:
* password: to check one's emails and to connect to ionis-portal (wifi)
* pwd_socks: to log on netsoul
* pwd_ppp: to connect to the [Bocal intranet](http://intra.bocal.org)
* pwd_num: for digicodes (not used anymore)
Your bocal password cannot be changed manually but it can be regenerated on the
[Bocal intranet](http://console.bocal.org/#/profile).
## Epita
Every EPITA student is given a CRI account. It serves purposes such as :
Every EPITA student is given a CRI account. It serves purposes such as:
* UNIX sessions on PXE
* UNIX exams (SPÉ/ING)
* CRI's intranet
* Assistants' intranets
* Some workshops (THLR, algorithms, etc...)
# AFS (Andrew File System)
Since the start of the 2016 school-year, [AFS](https://www.openafs.org/) replaces [GlusterFS](https://www.gluster.org) for network shares and student accounts.
The [AFS](https://www.openafs.org/) is a distributed network file system. Which
means that any file saved inside the AFS folder will be available on every
computer at EPITA.
## Linux session
......@@ -20,7 +22,7 @@ It is possible to retrieve initial configuration in the folder : `/afs/cri.epita
## Access AFS folder of an other user
If you know the login and password of an user, you can access his afs folder from an other session. It might be useful, for instance, if you can't log in your session because of corrupted config files and want to edit them using the anonym epita account.
If you know the login and password of an user, you can access his afs folder from another session. It might be useful, for instance, if you can't log in your session because of corrupted config files and want to edit them using the anonym epita account.
To get the rights to edit the content of the afs folder of an user called `login`, you shall follow this process :
......
# Git configuration
Students at EPITA have to use SSH Key-Based Authentication to access their Git
repositories.
## Generating an SSH Key Pair
OpenSSH provides a tool called `ssh-keygen` to generate and modify key pairs.
You can learn more about its options by running `man 1 ssh-keygen`.
A key pair is composed of a private key (without extension by default) and a
public key (.pub by default).
To generate a key pair, you can use:
```bash
ssh-keygen -f "$HOME/.ssh/id_rsa" -b 4096
```
/!\ It is not recommended to generate a private key without passphrase.
## Pushing your public key
Now that you own a key pair, you need to push your public key on the
[CRI Website](https://cri.epita.fr/accounts/profile/). Your keys can be managed
using `My SSH Keys`.
Your public key can be retrieved using:
```bash
cat "$HOME/.ssh/id_rsa.pub"
```
## Configuring Git
While `git-config` can be used for much more than just configuring your
identity, this will be the only part covered in this documentation.
Your identity, composed of a name and an email will be used to author your
commits. You can set them by using the following commands:
```bash
git config --global user.name 'Firstname LASTNAME'
git config --global user.email 'firstname.lastname@epita.fr'
```
## git-autoconfig
A tool called git-autoconfig is available on Archlinux SUP. This script will
generate a key, configure your git and push your public key on the CRI website.
While this is the easiest way, this tool has its limitations. It is instead
recommended to follow the steps above for learning purpose.
......@@ -15,17 +15,13 @@ The password must be as follow:
To change one's password, one has to go to the
[CRI intranet](https://cri.epita.fr/accounts/profile/).
# Password recovery
# Changing your Bocal password
## Recovering your CRI password
Your bocal password cannot be changed manually but it can be regenerated on the
[Bocal intranet](http://console.bocal.org).
If you lost your CRI password, which is giving you access to the school's
computers, you can reinitialize it following this
[link](https://cri.epita.fr/accounts/auth/reset/).
You will be asked your login and an email will be send to the @epita.fr email
address linked to your CRI account, with instructions and a link for
reinitialization.
# Password recovery
## Recovering your Bocal password
......@@ -42,3 +38,13 @@ If the phone number kept by the Bocal for password recovery is missing or
simply erronous, you **must** send a ticket at
[tickets@cri.epita.fr](tickets@cri.epita.fr) indicating your login and a french
phone number.
## Recovering your CRI password
If you lost your CRI password, which is giving you access to the school's
computers, you can reinitialize it following this
[link](https://cri.epita.fr/accounts/auth/reset/).
You will be asked your login and an email will be send to the @epita.fr email
address linked to your CRI account, with instructions and a link for
reinitialization.
# WiFi
Students have an open access to WiFi connection at school. EPITA provides two
differents networks with various specifications detailled below.
```nohighlight
Your Bocal logins are required to connect to the WiFi network.
```
## IONIS
The IONIS WiFi hotspot **requires a 5 Ghz WiFi card**. The IONIS WiFi is
recommended as it provides a faster and more stable connection.
To connect on IONIS, follow these steps:
1. Connect to the IONIS WiFi hotspot
2. You will be asked for your logins. You need to log with your epita's email address and *Bocal*'s password.
## Ionis Portal
Ionis Portal is an open WiFi access handled by the Bocal.
**Unlike IONIS, you will have to enter your credentials each time you want to
use the WiFi network.**
To connect on Ionis Portal, follow these steps:
1. Connect to the Ionis Portal WiFi hotspot
2. Open your web browser, a connection page should open-up (if not, open a website using **http**).
3. Login with your *Bocal* logins
4. Wait a few seconds before the connection is verified and established.
......@@ -5,6 +5,8 @@ pages:
- Home: 'index.md'
- Documentation:
- PIE: 'pie.md'
- 'git.md'
- 'wifi.md'
- Netboot : 'archlinux_netboot.md'
- AFS: 'afs.md'
- 'news.md'
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment