E-campus: Citrix-client installeren: Linux: verschil tussen versies

Uit ICTpedia
Naar navigatie springen Naar zoeken springen
Geen bewerkingssamenvatting
Geen bewerkingssamenvatting
 
(39 tussenliggende versies door 6 gebruikers niet weergegeven)
Regel 1: Regel 1:
----
----
Onderstaande pagina geeft een stap-voor-stap plan weer voor het installeren van de '''Citrix client'''.
Onderstaande pagina geeft een stap-voor-stap plan weer voor het installeren van de '''Citrix client''' op een '''Linux besturingsysteem'''.
Deze stappen gelden enkel voor een '''Linux besturingssysteem'''.
----
<font color="red">Opgelet, [[e-campus]] de eerste maal openen moet in Firefox gebeuren, anders kunnen er certificaat fouten optreden.</font>


== Benodigdheden == 
De screenshots werden gemaakt op '''''Ubuntu 18.04'''''. Dit is een '''Debian''' gebasseerde distributie.
De stappen voor een ander gebasseerde distributie zullen ook aangehaald worden maar de werkwijzes lopen bijna identiek hetzelfde.


* Een actieve internet verbinding.
'''Wil je E-campus op een ander systeem gebruiken zoals Android, Windows of MacOS, kijk dan op de [[E-campus]] pagina'''.
* Een geïnstalleerde Linux distributie.
----
* Firefox (bij voorkeur ingesteld als standaardbrowser, indien je een andere standaardbrowser gekozen hebt verloopt de procedure een beetje anders).
* Beheerdersbevoegdheid op jouw PC (indien je op jouw PC een gebruiker bent met beperkte bevoegdheden, laat de procedure dan uitvoeren door de persoon die beheerder is van jouw PC).
* Sluit alle programma's, behalve de browser waarin je dit document leest.


== Citrix Workspace downloaden ==
Om te starten surfen we naar [https://citrix.com/nl-nl/ Citrix] (1). Klik op '''Downloads''' (2) en selecteer '''Citrix Workspace App'''(3) uit het keuzemenu.


== Stap voor stap ==
[[File:CitrixLinuxUbuntu01.png]]
* Klik [http://www.citrix.com/English/ss/downloads/results.asp?productID=186&c1=sot2755 hier] om naar de download pagina te gaan.
* Kies bij 'Select a OS/Hardware' de optie 'Linux'
* Vervolgens kies je bij Clients and Plug-ins voor ''Linux Clients'' en selecteer op de volgende pagina onderaan de meest recente versie in het gewenste formaat. Deze software is geschikt voor de meest voorkomende Linux-distributies en is de allernieuwste versie van de Citrix-client.


[[Afbeelding:CitrixClient_Linux_1.PNG]]
Scroll naar beneden tot je '''Workspace app for Linux''' tegen komt en klik deze open (1 & 2). Klik hier dan op de laatste versie (3).
<q>Ten tijde van schrijven is '''Citrix Workspace app 1912 for Linux''' de laatste versie. Als bij jou de versie al hoger ligt, is dat geen probleem</q>


[[File:CitrixLinuxUbuntu02.png]]


* Als je op downloaden klikt, krijg je onderstaande pop-up (mogelijk moet je je pop-upblocker even uitschakelen), daar klik je op 'click here'.
Eens hierop geklikt, kan je onderaan de pagina, afhankelijk van jouw noden, de juiste versie van de '''Full Packages''' (2 & 3) downloaden;
- Debian Packages: Dit is een .deb bestand en werkt onder andere op Debian, Ubuntu en Linux Mint
- RPM Packages: Dit is een rpm bestand en werkt onder andere op Red Hat, CentOS en Fedora
- Tarball Packages: Dit is een installatiescript en zal op de meeste Linux distributies werken.
<q> Opgelet! Deze laatste vereist iets meer ervaring met een terminal.</q>


[[Afbeelding:CitrixClient_Linux_2.PNG]]
[[File:CitrixLinuxUbuntu03.png]]


Als je een Debian of RPM Package hebt aangeklikt, krijg je normaal een optie om deze meteen te openen met jouw '''Software Center''' (1). Klik dan op OK.(2)
<q>Als deze optie niet beschikbaar is in jouw distro, kan je de package ook opslaan en via een terminal installeren; <code>sudo dpkg -i /pad/naar/icaclient.deb</code> of <code>sudo rpm -ivh /pad/naar/icaclient.rpm</code></q>


* Open de download of 'unzip' dit rechtstreeks.
[[File:CitrixLinuxUbuntu04.png]]


[[Afbeelding:CitrixClient_Linux_3.PNG]]
Klik in het '''Software Center''' nu op install (1) om de installatie uit te voeren. Geef jouw administrator wachtwoord in om jouw rechten tijdelijk te verhogen.
[[Afbeelding:CitrixClient_Linux_4.PNG]]


[[File:CitrixLinuxUbuntu05.png]]


* Voer het bestand 'setupwfc' uit.
De Workspace software is nu geïnstalleerd op <code>/opt/Citrix/ICAClient</code>. Deze zal nog niet werken zonder correct de ssl certificaten toe te voegen.


[[Afbeelding:CitrixClient_Linux_5.PNG]]
=== Tarball package ===
<q> Sla deze stap over als je in de vorige stap het .deb of .rpm bestand gedownload hebt.</q>
Om de tarball te installeren, gaan we eerst naar de locatie van de tarball waar we deze kunnen uitpakken;
<code>cd /pad/naar/icaclient/ && tar -xzvf icaclient.tar.gz </code>


Verplaats je nu naar de uitgepakte map en voer het onderstaand commando uit.
<code>sudo ./setupwfc</code>


* Doorloop de installatieprocedure en selecteer de gewenste opties.
Dit zal een kleine wizard starten die jou door de installatie loodst. Pas de instellingen aan naar believe, al zijn de default instellingen in meeste gevallen voldoende.


[[Afbeelding:CitrixClient_Linux_6.PNG]]
== Certificaten ==
Citrix heeft enkele Certificaten nodig om de verbinding goed te laten verlopen. In vorige versies was het voldoende om een snelkoppeling te leggen naar de '''keystore''' van jouw toestel maar tegenwoordig, moeten de certificaten in <code>.pem</code> formaat in de juiste map bevinden.


=== AP certificate ===
Surf naar (bij voorkeur) met de Firefox browser [https://e-campus.ap.be E-campus] (1) en klik op het '''slotje''' (2) bovenaan naast het adres. Als je nu op het '''>''' (3) klikt, krijg je een paar details over het certificaat.


<font color="red">'''Sommige Linux-distributies vereisen extra certificaten.'''</font>
[[File:CitrixLinuxUbuntu06.png]]


* Deze certificaten kan je [https://www.terena.org/activities/tcs/repository hier] vinden en moeten manueel in volgende locatie geplaatst worden: '/usr/lib/ICAclient/keystore/cacerts'.
Kies nu voor '''Meer informatie''' (1) om een nieuw venster te openen.  


[[File:CitrixLinuxUbuntu07.png]]


* '''Fedora en Mandriva'''  
'''Toon Certificaat''' (1) zal nu de gedetailleerde weergave openen van dit certificaat.
vereisen het 'Server Certificate CA' en 'UTN-USERFirst Client Authentication and Email CA' certificaat.  


[[File:CitrixLinuxUbuntu08.png]]


* '''Ubuntu'''
Scroll naar onder tot je deze kan downloaden en kies voor '''PEM(cert)'''(1).  
vereist het ‘AddTrustExternalCARoot.crt’ certificaat.  


[[File:CitrixLinuxUbuntu09.png]]


Sla deze op waar je zelf makkelijk aan kan (1 & 2) en open een terminal.


<!--
[[File:CitrixLinuxUbuntu10.png]]
=== Stap 3: Certificaat toevoegen ===


Om gebruik te kunnen maken van een veilige verbinding wordt gebruik gemaakt van een beveiligde connectie. Hiervoor is een certificaat verreist. In deze stap installeren we dit certificaat.
Verplaats je naar de map waar het certificaat zich bevindt en voer onderstaande uit;
<code>
sudo cp ap-be.pem /opt/Citrix/ICAClient/keystore/cacerts/
</code>


[[Afbeelding:citrix-client_23.PNG|300 px|right]]
[[File:CitrixLinuxUbuntu11.png]]
* Het certificaat wordt toegevoegd met de ''Plantijn Certificaat Installer'' die je vindt op de dmg schijf die gedownload werd in vorige stap.
* Dubbelklik op de installer om de installatie te starten.
* Volg de instructies die op u scherm verschijnen.
* Het certificaat is nu geïnstalleerd.


=== Algemene certificaten ===
Naast het AP-certificaat heeft Citrix nog andere certificaten nodig om te kunnen werken. Met onderstaand scriptje, zet je ze allemaal juist.


=== Stap 3: Inloggen op e-campus ===
<code>
cd /opt/Citrix/ICAClient/keystore/cacerts/


* Open de Firefox browser en surf naar https://e-campus.plantijn.be
sudo cp /etc/ssl/certs/ca-certificates.crt .
(opm: dit werkt niet met Safari)


sudo awk 'BEGIN {c=0;} /BEGIN CERT/{c++} { print > "cert." c ".pem"}' < ca-certificates.crt
</code>


* Vul jouw gebruikersnaam en [[wachtwoord]] in en klik op ''advanced options''.
[[File:CitrixLinuxUbuntu12.png]]


[[Afbeelding:citrix-client_24.PNG]]
=== Rehash ===
Om de certificaten bruikbaar te maken binnen Citrix, moet deze nog verwerkt worden door een teel van Citrix zelf. Voer onderstaande uit en de installatie zou klaar moeten zijn.
<q> Als er noodzakelijke certificaten veranderen, moeten deze ook terug toegevoegd worden en is een rehash ook opnieuw nodig.</q>
<code>sudo /opt/Citrix/ICAClient/util/ctx_rehash</code>


== Citrix Workspace uitvoeren ==
Als de installatie goed verlopen is, kan je nu een snelkoppeling van Citrix Workspace terugvinden in jouw startmenu. Voer deze uit en ''accepteer de EULA'' (1).


* Verifieer de volgende instellingen en klik ''Log in''
[[File:CitrixLinuxUbuntu13.png]]


[[Afbeelding:citrix-client_25.PNG]]
Het server-adres dat je nu moet ingeven is ''<code>https://e-campus.ap.be</code>''.  


[[File:CitrixLinuxUbuntu14.png]]


* De virtuele campus verschijnt.
Geef nu jouw '''p-/s-nummer met @ap.be'''(1) in samen met jouw wachtwoord(2). Dit is om alle beschikbare applicaties op te halen en de cache van de Workspace software te vullen. Hierna moet je '''nog een keer''' aanmelden om je effectief aan te melden bij Citrix.


[[Afbeelding:citrix-client_26.PNG]]
[[File:CitrixLinuxUbuntu15.png]]


Selecteer nu de Applicatie die je wilt starten.(1)


* Met rechtsonder de volgende foutmelding:
[[File:CitrixLinuxUbuntu16.png]]


[[Afbeelding:citrix-client_27.PNG]]
Meteen zal dit een '''full screen venster''' starten waar je wordt aangemeld op jouw applicatie. Bovenaan op de '''zwarte balk''' (1) kan je enkele opties te voorschijn toveren om je te helpen met de verbinding.


* Deze foutmelding mag je als je de citrix-client geïnstalleerd hebt en het certificaat hebt toegevoegd. (Zie stap 2 en 3)
[[File:CitrixLinuxUbuntu17.png]]


Allereerst kan je terugkeren naar jouw bureaublad en Citrix op de achtergrond open laten staan (!). Daarnaast kan je wisselen tussen verschillende Citrix applicaties die open zouden staan (2). Moet je de toetsencombinatie Control, Alt, Delete uitvoeren om bijvoorbeeld jouw wachtwoord te wijzigen, kan dat ook (3). Wil je de '''full screen''' verlaten, kies dan voor '''Window''' (4) om het venster te verkleinen. '''Disconnect''' (5) verbreekt de verbinding maar laat jouw sessie open op de server. '''Sign Out''' zal jouw sessie goed afsluiten.
<q>Let erop dat alle servers dagelijks herstart worden. Als je 's avonds nog aan het werken bent, kan je daarna best alles opslaan en afsluiten om de dag erna opnieuw te beginnen.</q>


* Dit venster verschijnt links (jouw venster kan meer onderdelen bevatten)
[[File:CitrixLinuxUbuntu18.png]]


Ondervind je problemen, kan het handig zijn voor de helpdesk om te weten op welke server jij werkt. Dez vind je terug achter de '''Startknop'''.(1) Als je klaar met werken bent, kan je op '''Start''' klikken en kies je voor '''afmelden'''.(2)


* Klik op ''e-campus personeel of e-campus student''.
[[File:CitrixLinuxUbuntu19.png]]


[[Afbeelding:citrix-client_28.PNG]]
<q>De citrix applicatie blijf op de achtergrond draaien waar je deze manueel kan stoppen (1 & 2)of opnieuw kan openen. De volgende keer dat je de Workspace opent, moet je maximum éénmaal jouw wachtwoord opnieuw ingeven.</q>


[[File:CitrixLinuxUbuntu20.png]]


* Volgende scherm verschijnt:
'''Verwante artikels'''
 
----
[[Afbeelding:citrix-client_29.PNG]]
*[[E-campus:_Citrix-client_installeren: Windows 10|Wil je E-campus openen op Windows?]]
* Indien Citrix ICA Client er niet staat klik dan op ''kiezen''.
*[[E-campus:_Citrix-client_installeren:_Mac|Wil je E-campus openen op MacOS?]]]
* U krijgt volgend venster:
*[[E-campus:_Citrix-client_installeren:_Android|Wil je E-campus openen op Android?]]
* Ga hier naar Programma's/Citrix ICA Client/Citrix ICA Client en klik ''Open''
*[[E-campus:_Citrix-client_installeren:_iOS|Wil je E-campus openen op IOS?]]
 
*[[E-campus:_Citrix-client_installeren:_ChromeOS|Wil je E-campus openen op ChromeOS?]]
[[Afbeelding:citrix-client_30.PNG]]
* Het zou kunnen dat de Citrix ICA Client de eerste keer niet automatisch opstart. In Firefox ziet u dan het volgende venster:
* Klik op Openen om de Citrix ICA Client te starten
 
[[Afbeelding:citrix-client_30.PNG]]
* Waarschijnlik verschijnt de volgende melding:
* Klik op ''Open'' om verder te gaan.
* Op je bureaublad zal een bestand worden aangemaakt met als extensie .ICA dit bestand mag in geen enkel geval verwijderd worden zolang je [[e-campus]] sessie actief is. Normaal gezien verdwijnt het bestand automatisch bij het afsluiten van de sessie, indien dit niet gebeurd mag u het handmatig verwijderen.
 
[[Afbeelding:citrix-client_31.PNG]]
* Het programma Citrix ICA Client start op en toont de licentieovereenkomst:
* Klik op ''Accept'' om verder te gaan.
 
[[Afbeelding:citrix-client_32.PNG]]
* De Windows omgeving start op.
* Eerste mogelijkheid:
** Het Windows inlogvenster verschijnt.
*** Vul daarin nogmaals je [[login|gebruikersnaam]] en [[wachtwoord]] in.
*** LET OP: het is mogelijk dat je toetsenbord reageert alsof het een qwerty indeling heeft. Dit geeft vooral een probleem i.v.m. je [[wachtwoord]]. Een afbeelding van de qwerty-indeling vind je hier: [[Afbeelding:citrix-client_99.png|30 px]]
***Na het Aanmelden kan je gewoon beginnen werken binnen de Windows omgeving. (Het toetsenbord zal weer een normale werking krijgen)
 
[[Afbeelding:citrix-client_33.PNG]]
* Tweede mogelijkheid:
** De Windows sessie start automatisch op:
*** U kan beginnen werken.
 
Om de sessie af te sluiten meldt u zich gewoon af bij Windows, het venster zal vanzelf sluiten.
-->
 
 
'''Andere besturingssystemen:'''
----
----
*[[E-campus:Citrix-client_installeren:_Windows_XP|De Citrix client installeren op Windows XP]]


*[[E-campus:Citrix-client_installeren:_Windows_Vista|De Citrix client installeren op Windows Vista]]
[[Category:Citrix]]
 
*[[E-campus:Citrix-client_installeren:_Windows_7|De Citrix client installeren op Windows 7]]
 
*[[E-campus:Citrix-client_installeren:_Mac|De Citrix client installeren op Mac OS]]
 
 
 
'''Gerelateerde artikels:'''
----
*[[Known_issues|E-campus Know issues]]

Huidige versie van 9 sep 2021 om 09:01


Onderstaande pagina geeft een stap-voor-stap plan weer voor het installeren van de Citrix client op een Linux besturingsysteem.

De screenshots werden gemaakt op Ubuntu 18.04. Dit is een Debian gebasseerde distributie. De stappen voor een ander gebasseerde distributie zullen ook aangehaald worden maar de werkwijzes lopen bijna identiek hetzelfde.

Wil je E-campus op een ander systeem gebruiken zoals Android, Windows of MacOS, kijk dan op de E-campus pagina.


Citrix Workspace downloaden

Om te starten surfen we naar Citrix (1). Klik op Downloads (2) en selecteer Citrix Workspace App(3) uit het keuzemenu.

Scroll naar beneden tot je Workspace app for Linux tegen komt en klik deze open (1 & 2). Klik hier dan op de laatste versie (3). Ten tijde van schrijven is Citrix Workspace app 1912 for Linux de laatste versie. Als bij jou de versie al hoger ligt, is dat geen probleem

Eens hierop geklikt, kan je onderaan de pagina, afhankelijk van jouw noden, de juiste versie van de Full Packages (2 & 3) downloaden; - Debian Packages: Dit is een .deb bestand en werkt onder andere op Debian, Ubuntu en Linux Mint - RPM Packages: Dit is een rpm bestand en werkt onder andere op Red Hat, CentOS en Fedora - Tarball Packages: Dit is een installatiescript en zal op de meeste Linux distributies werken. Opgelet! Deze laatste vereist iets meer ervaring met een terminal.

Als je een Debian of RPM Package hebt aangeklikt, krijg je normaal een optie om deze meteen te openen met jouw Software Center (1). Klik dan op OK.(2) Als deze optie niet beschikbaar is in jouw distro, kan je de package ook opslaan en via een terminal installeren; sudo dpkg -i /pad/naar/icaclient.deb of sudo rpm -ivh /pad/naar/icaclient.rpm

Klik in het Software Center nu op install (1) om de installatie uit te voeren. Geef jouw administrator wachtwoord in om jouw rechten tijdelijk te verhogen.

De Workspace software is nu geïnstalleerd op /opt/Citrix/ICAClient. Deze zal nog niet werken zonder correct de ssl certificaten toe te voegen.

Tarball package

Sla deze stap over als je in de vorige stap het .deb of .rpm bestand gedownload hebt. Om de tarball te installeren, gaan we eerst naar de locatie van de tarball waar we deze kunnen uitpakken; cd /pad/naar/icaclient/ && tar -xzvf icaclient.tar.gz

Verplaats je nu naar de uitgepakte map en voer het onderstaand commando uit. sudo ./setupwfc

Dit zal een kleine wizard starten die jou door de installatie loodst. Pas de instellingen aan naar believe, al zijn de default instellingen in meeste gevallen voldoende.

Certificaten

Citrix heeft enkele Certificaten nodig om de verbinding goed te laten verlopen. In vorige versies was het voldoende om een snelkoppeling te leggen naar de keystore van jouw toestel maar tegenwoordig, moeten de certificaten in .pem formaat in de juiste map bevinden.

AP certificate

Surf naar (bij voorkeur) met de Firefox browser E-campus (1) en klik op het slotje (2) bovenaan naast het adres. Als je nu op het > (3) klikt, krijg je een paar details over het certificaat.

Kies nu voor Meer informatie (1) om een nieuw venster te openen.

Toon Certificaat (1) zal nu de gedetailleerde weergave openen van dit certificaat.

Scroll naar onder tot je deze kan downloaden en kies voor PEM(cert)(1).

Sla deze op waar je zelf makkelijk aan kan (1 & 2) en open een terminal.

Verplaats je naar de map waar het certificaat zich bevindt en voer onderstaande uit; sudo cp ap-be.pem /opt/Citrix/ICAClient/keystore/cacerts/

Algemene certificaten

Naast het AP-certificaat heeft Citrix nog andere certificaten nodig om te kunnen werken. Met onderstaand scriptje, zet je ze allemaal juist.

cd /opt/Citrix/ICAClient/keystore/cacerts/

sudo cp /etc/ssl/certs/ca-certificates.crt .

sudo awk 'BEGIN {c=0;} /BEGIN CERT/{c++} { print > "cert." c ".pem"}' < ca-certificates.crt

Rehash

Om de certificaten bruikbaar te maken binnen Citrix, moet deze nog verwerkt worden door een teel van Citrix zelf. Voer onderstaande uit en de installatie zou klaar moeten zijn. Als er noodzakelijke certificaten veranderen, moeten deze ook terug toegevoegd worden en is een rehash ook opnieuw nodig. sudo /opt/Citrix/ICAClient/util/ctx_rehash

Citrix Workspace uitvoeren

Als de installatie goed verlopen is, kan je nu een snelkoppeling van Citrix Workspace terugvinden in jouw startmenu. Voer deze uit en accepteer de EULA (1).

Het server-adres dat je nu moet ingeven is https://e-campus.ap.be.

Geef nu jouw p-/s-nummer met @ap.be(1) in samen met jouw wachtwoord(2). Dit is om alle beschikbare applicaties op te halen en de cache van de Workspace software te vullen. Hierna moet je nog een keer aanmelden om je effectief aan te melden bij Citrix.

Selecteer nu de Applicatie die je wilt starten.(1)

Meteen zal dit een full screen venster starten waar je wordt aangemeld op jouw applicatie. Bovenaan op de zwarte balk (1) kan je enkele opties te voorschijn toveren om je te helpen met de verbinding.

Allereerst kan je terugkeren naar jouw bureaublad en Citrix op de achtergrond open laten staan (!). Daarnaast kan je wisselen tussen verschillende Citrix applicaties die open zouden staan (2). Moet je de toetsencombinatie Control, Alt, Delete uitvoeren om bijvoorbeeld jouw wachtwoord te wijzigen, kan dat ook (3). Wil je de full screen verlaten, kies dan voor Window (4) om het venster te verkleinen. Disconnect (5) verbreekt de verbinding maar laat jouw sessie open op de server. Sign Out zal jouw sessie goed afsluiten. Let erop dat alle servers dagelijks herstart worden. Als je 's avonds nog aan het werken bent, kan je daarna best alles opslaan en afsluiten om de dag erna opnieuw te beginnen.

Ondervind je problemen, kan het handig zijn voor de helpdesk om te weten op welke server jij werkt. Dez vind je terug achter de Startknop.(1) Als je klaar met werken bent, kan je op Start klikken en kies je voor afmelden.(2)

De citrix applicatie blijf op de achtergrond draaien waar je deze manueel kan stoppen (1 & 2)of opnieuw kan openen. De volgende keer dat je de Workspace opent, moet je maximum éénmaal jouw wachtwoord opnieuw ingeven.

Verwante artikels