Difference between revisions of "E-campus: Citrix-client installeren: Linux"

From ICTpedia
Jump to: navigation, search
Line 1: Line 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'''.
Deze stappen gelden enkel voor een '''Linux besturingssysteem'''.
+
De screenshots werden gemaakt op '''''Ubuntu 18.04'''''. Dit is een '''Debian''' gebasseerde distributie.
 +
De stappen voor een '''RedHat''' gebasseerde distributie zullen ook aangehaald worden maar de werkwijzes lopen bijna identiek hetzelfde.
 
----
 
----
{{Test|
 
text=<font color="red">Opgelet, [[e-campus]] de eerste maal openen moet in Firefox gebeuren, anders kunnen er certificaat fouten optreden.</font>}}
 
  
== Benodigdheden ==
+
== 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.
 +
[[File:CitrixLinuxUbuntu01.png]]
  
* Een actieve internet verbinding.
+
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).  
* Een geïnstalleerde Linux distributie.
+
<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>
* Firefox (bij voorkeur ingesteld als standaardbrowser, indien je een andere standaardbrowser gekozen hebt verloopt de procedure een beetje anders).
+
[[File:CitrixLinuxUbuntu02.png]]
* 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.
+
  
 +
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>
 +
[[File:CitrixLinuxUbuntu03.png]]
  
== Stap voor stap ==
+
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)
* Surf naar [http://e-campus.ap.be http://e-campus.ap.be] om toegang te krijgen tot de e-campus omgeving.  
+
<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>
* Log in met je gebruikersnaam en wachtwoord.
+
[[File:CitrixLinuxUbuntu014.png]]
* Deze zijn identiek aan die voor de AP-[[e-mail|webmail]] en voor het interne netwerk binnen de campus. Klik hierna op ''Verzenden''
+
[[Afbeelding:Citrix_WinXP_v2_1.PNG|border]]
+
  
 +
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.
 +
[[File:CitrixLinuxUbuntu05.png]]
  
 +
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.
  
* Indien je gebruikersnaam en wachtwoord combinatie ongeldig is verschijnt volgende melding:
+
=== Tarball package ===
[[Afbeelding:Citrix_WinXP_v2_2.PNG|border]]
+
<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>
  
 +
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.
  
* Klik op 'Install' om de laatste versie van de Citrix plug-in te downloaden.
+
== Certificaten ==
[[Afbeelding:Citrix_WinXP_v2_3.PNG|border]]
+
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.
 +
[[File:CitrixLinuxUbuntu06.png]]
  
* Open de download of 'unzip' dit rechtstreeks.
+
Kies nu voor '''Meer informatie''' (1) om een nieuw venster te openen.
 +
[[File:CitrixLinuxUbuntu07.png]]
  
[[Afbeelding:CitrixClient_Linux_3.PNG|border]]
+
'''Toon Certificaat''' (1) zal nu de gedetailleerde weergave openen van dit certificaat.
[[Afbeelding:CitrixClient_Linux_4.PNG|border]]
+
[[File:CitrixLinuxUbuntu08.png]]
  
 +
Scroll naar onder tot je deze kan downloaden en kies voor '''PEM(cert)'''(1).
 +
[[File:CitrixLinuxUbuntu09.png]]
  
* Voer het bestand 'setupwfc' uit.
+
Sla deze op waar je zelf makkelijk aan kan (1 & 2) en open een terminal.  
 +
[[File:CitrixLinuxUbuntu10.png]]
  
[[Afbeelding:CitrixClient_Linux_5.PNG|border]]
+
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>
 +
[[File:CitrixLinuxUbuntu11.png]]
  
 +
=== Algemene certificaten ===
 +
Naast het AP-certificaat heeft Citrix nog andere certificaten nodig om te kunnen werken. Met onderstaand scriptje, zet je ze allemaal juist.
  
* Doorloop de installatieprocedure en selecteer de gewenste opties.
+
<code>
 +
cd /opt/Citrix/ICAClient/keystore/cacerts/
 +
sudo cp /etc/ssl/certs/ca-certificates.crt .
 +
awk 'BEGIN {c=0;} /BEGIN CERT/{c++} { print > "cert." c ".pem"}' < ca-certificates.crt
 +
</code>
 +
[[File:CitrixLinuxUbuntu12.png]]
  
[[Afbeelding:CitrixClient_Linux_6.PNG|border]]
+
=== 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).
 +
[[File:CitrixLinuxUbuntu13.png]]
  
* Na deze installatie wordt je automatisch doorverwezen naar het portaal om e-campus te openen.
+
Het server-adres dat je nu moet ingeven is ''<code>https://e-campus.ap.be</code>''.  
* Tot slot selecteer je het e-campus pictogram om de toepassing te starten.
+
[[File:CitrixLinuxUbuntu14.png]]
[[Afbeelding:Citrix_WinXP_v2_12.PNG|border]]
+
  
 +
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.
 +
[[File:CitrixLinuxUbuntu15.png]]
  
{{Test|
+
Selecteer nu de Applicatie die je wilt starten.(1)
text=<font color="red">'''Sommige Linux-distributies vereisen extra certificaten.'''</font>
+
[[File:CitrixLinuxUbuntu16.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'.
+
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.
 +
[[File:CitrixLinuxUbuntu17.png]]
  
* '''Fedora en Mandriva'''  
+
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.
vereisen het [[http://ictpedia.ap.be/TERENASSLCA.crt TERENASSLCA.crt]] en [[http://ictpedia.ap.be/UTN-USERFirst-Hardware.crt UTN-USERFirst-Hardware.crt]] certificaat.
+
<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>
* '''Ubuntu'''
+
[[File:CitrixLinuxUbuntu18.png]]
vereist het [[http://ictpedia.ap.be/TERENASSLCA.crt TERENASSLCA.crt]] certificaat.
+
}}
+
  
 +
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)
 +
[[File:CitrixLinuxUbuntu19.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>
=== Stap 3: Certificaat toevoegen ===
+
[[File:CitrixLinuxUbuntu20.png]]
 
+
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.
+
 
+
[[Afbeelding:citrix-client_23.PNG|300 px|right]]
+
* Het certificaat wordt toegevoegd met de ''AP 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.
+
 
+
 
+
=== Stap 3: Inloggen op e-campus ===
+
 
+
* Open de Firefox browser en surf naar https://e-campus.ap.be
+
(opm: dit werkt niet met Safari)
+
 
+
 
+
* Vul jouw gebruikersnaam en [[wachtwoord]] in en klik op ''advanced options''.
+
 
+
[[Afbeelding:citrix-client_24.PNG|border]]
+
 
+
 
+
* Verifieer de volgende instellingen en klik ''Log in''
+
 
+
[[Afbeelding:citrix-client_25.PNG|border]]
+
 
+
 
+
* De virtuele campus verschijnt.
+
 
+
[[Afbeelding:citrix-client_26.PNG|border]]
+
 
+
 
+
* Met rechtsonder de volgende foutmelding:
+
 
+
[[Afbeelding:citrix-client_27.PNG|border]]
+
 
+
* Deze foutmelding mag je als je de citrix-client geïnstalleerd hebt en het certificaat hebt toegevoegd. (Zie stap 2 en 3)
+
 
+
 
+
* Dit venster verschijnt links (jouw venster kan meer onderdelen bevatten)
+
 
+
 
+
* Klik op ''e-campus personeel of e-campus student''.
+
 
+
[[Afbeelding:citrix-client_28.PNG|border]]
+
 
+
 
+
* Volgende scherm verschijnt:
+
 
+
[[Afbeelding:citrix-client_29.PNG|border]]
+
 
+
 
+
* Indien Citrix ICA Client er niet staat klik dan op ''kiezen''.
+
* U krijgt volgend venster:
+
* Ga hier naar Programma's/Citrix ICA Client/Citrix ICA Client en klik ''Open''
+
 
+
[[Afbeelding:citrix-client_30.PNG|border]]
+
 
+
 
+
* 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|border]]
+
 
+
 
+
* 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|border]]
+
 
+
 
+
* Het programma Citrix ICA Client start op en toont de licentieovereenkomst:
+
* Klik op ''Accept'' om verder te gaan.
+
 
+
[[Afbeelding:citrix-client_32.PNG|border]]
+
 
+
 
+
* 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|border]]
+
 
+
 
+
* 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:'''
 
'''Andere besturingssystemen:'''

Revision as of 07:36, 8 April 2020


Onderstaande pagina geeft een stap-voor-stap plan weer voor het installeren van de Citrix client. De screenshots werden gemaakt op Ubuntu 18.04. Dit is een Debian gebasseerde distributie. De stappen voor een RedHat gebasseerde distributie zullen ook aangehaald worden maar de werkwijzes lopen bijna identiek hetzelfde.


Citrix Workspace downloaden

Om te starten surfen we naar Citrix (1). Klik op Downloads (2) en selecteer Citrix Workspace App(3) uit het keuzemenu. CitrixLinuxUbuntu01.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). 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 CitrixLinuxUbuntu02.png

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. 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) 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 Bestand:CitrixLinuxUbuntu014.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. CitrixLinuxUbuntu05.png

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. CitrixLinuxUbuntu06.png

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

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

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

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

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

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 . awk 'BEGIN {c=0;} /BEGIN CERT/{c++} { print > "cert." c ".pem"}' < ca-certificates.crt CitrixLinuxUbuntu12.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. 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). CitrixLinuxUbuntu13.png

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

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. CitrixLinuxUbuntu15.png

Selecteer nu de Applicatie die je wilt starten.(1) CitrixLinuxUbuntu16.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. 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. 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. 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) CitrixLinuxUbuntu19.png

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. CitrixLinuxUbuntu20.png

Andere besturingssystemen:



Gerelateerde artikels: