Installatie handleiding ToastAR & HoastAR Januari 2016 ToastAR
SLIMMER ONDERNEMEN MET COMMUNICATIESYSTEMEN Auteur Vincent de Lange Design Vincent van der Toorn Versie 1.0 Datum Januari 2016 Ask Roger B.V. 2016 Alle auteursrechten voorbehouden aan Ask Roger B.V. 2
Inhoudsopgave Server Setup 4 1. HoastAR 4 1.1 Vereisten 4 1.2 Installeren HoastAR 4 1.3 Licenties genereren en koppelen 4 1.4 Service 4 1.5 Internet Information Services website opzetten 5 2. Regelpaneel HoastAR 6 3. MetaDirectory 6 3.2 Database management 6 Client Setup 7 4.1 Vereisten 7 4.2 Installeren ToastAR 7 4.3 Configureren ToastAR 7 3. Titel Hoofdstuk 8 3
Server Setup 1. HoastAR De HoastAR zorgt ervoor dat er een volledige tweewegcommunicatie uitgevoerd kan worden met een apparaat op het internet. De HoastAR draait als een service op de server en heeft zijn eigen IP-adres. 1.1 Vereisten Een geïnstalleerde server voorzien van: Framework 4.5 C++ redistributables IIS (voor extension, maar mag ook een andere server zijn) De HoastAR van AskRoger! neemt ongeveer 7 MB schijfruimte in beslag, inclusief de installatie van het framework en C++ redistributable die ongeveer 40 MB inneemt. 1.2 Installeren HoastAR 1. Voer het setup-bestand voor HoastAR uit. Het welkom scherm wordt geopend. 2. Klik op Next. 3. Ga akkoord met de End User License Agreement en klik op Next. 4. De HoastAR maakt automatisch het pad aan waar de HoastAR geïnstalleerd wordt. Indien gewenst kan het installatie pad gewijzigd worden. Klik op Next. 5. Klik op Install om de installatie te beginnen. De setup installeert de HoastAR. 6. Klik de Finish knop om de setup te beëindigen. 1.3 Licenties genereren en koppelen De HoastAR registreert door middel van de aantal licenties hoeveel ToastArs er kunnen communiceren met de HoastAR. De aantal licenties worden opgeslagen in een.lic bestand. Volg de volgende stappen voor het generen van het.lic bestand: 1. Voer Roger365 LicenseGenerator uit (\\ askroger.local\dfs\algemeen\development\ TestLicentie) 2. Kies voor optie c (create remote lic). 3. Druk op ENTER. 4. Typ HWID in. Deze is te vinden in als de hoastar vanuit de commandline wordt uitgevoerd met optie c. Serial: XXXXXXXX. 5. Druk op ENTER 6. Typ de geldigheidsduur in dagen. (-1 of waarde) 7. Druk op ENTER 8. Op de vragen die nu gesteld worden kan er gekozen worden voor N, gevolgd door een ENTER. 9. Bij de laatste vraag, Use HoastAR, kies je voor Y. 10. Value for license, geef aantal licenties op. Dit zijn gebruikers van de ToastAR. 11. Druk op ENTER. 12. Het bestand Ar.lic is aangemaakt in het pad waar de Roger365 LicenseGenerator vanuit is gestart. Verplaats dit bestand naar de HoastAR map. 4
1.4 Service Nadat de installatie van de HoastAR en de licenties zijn aangemaakt, zal de HoastAR gestart moeten worden als een service. 1. Klik op Start, en klik dan op Configuratiescherm. 2. Klik op Systeembeheer. 3. Open Services. * 4. Zoek naar de HoastAR. 5. Klik in het werkbalk op Start service. Service HoastAR wordt gestart. * Open Services vanuit het zoek veld: 1. Klik Start. 2. In het zoekveld, typ services.msc en druk ENTER. 1.5 Internet Information Services website opzetten In Internet Information Services (IIS) Manager moet er een website aangemaakt worden waar de bestanden voor de inhoud van de ToastAR integratie komen. Begin met de ToastAR Website instelllen sectie uit de Integratie handleiding. Volg hierna de volgende stappen button ( ) om te navigeren en de folder te vinden. 6. Selecteer de protocol voor de website vanuit de type lijst. 7. De standaard ip-adres is Geen toewijzingen. Als je een static ip-adres wilt voor de website, typ deze dan hier in. 8. Typ een poort nummer. 9. Optioneel, typ een Hostnaam voor de website. 10. Als er verder geen wijzigingen aan de website gemaakt hoeft te worden, selecteer de checkbox Website onmiddellijk starten. 11. Klik OK. 12. Ga naar Application Pools. 13. Controleer of de application pool versie draait op.net Framework 4.0 Rechtermuisklik op de application pool en klik op Basisinstellingen. Publiceren van de webbestanden De HTML bestanden voor de ToastAR moeten geplaatst worden in de fysieke pad die in stap 5 is aangemaakt. Open Web.Config in een tekstverwerkingsprogramma zoals Notepad en wijzig de ServerUrl. * Open IIS Manager vanuit het start menu: 1. Klik Start, en klik dan op Configuratiescherm. 2. Klik op Systeembeheer. 3. In de instellingen scherm, dubbelklik op Internet Information Services(IIS) Manager. 1. Open IIS Manager. * 2. In de Verbindingen paneel, klik met de rechtermuisknop op Sites en klik dan op Website toevoegen. 3. Typ bij Sitenaam een gebruiksvriendelijke naam voor de website. 4. Klik op Selecteren.. als je een andere application pool wilt dan die er nu wordt aangegeven. In de application pool dialoogvenster, selecteer een application pool vanuit de lijst en klik op OK. 5. In de fysieke pad, typ de fysieke pad naar de website folder of klik op de browse * Open IIS Manager vanuit het zoek veld: 1. Klik Start. 2. In het zoekveld, typ inetmgr en druk ENTER. Als IIS niet op de server is geïnstalleerd, doe dit dan als volgt: 1. Klik Start, en klik dan op Configuratiescherm. 2. Klik op Programma s en onderdelen. 3. In de linkerpaneel, klik op Windows onderdelen in- of uitschakelen. 4. Selecteer in het Windows onderdelen 5
dialoogvenster, Internet Information Services. 5. Klik OK. Denk er ook aan om de firewall instellingen te wijzigen voor de poort waar de website op gaat draaien Windows Firewall with Advanced Security 1. Selecteer Inbound Rules 2. Kies New Rule 3. Rule type a. Selecteer port 4. Protocols and Ports a. Selecteer TCP b. Selecteer Specific local ports en typ hier het poortnummer van de website 5. Profile a. Selecteer Domain en Private 2. Regelpaneel HoastAR In de HoastAR installatiemap staat de regelpaneel van de HoastAR onder de naam AR.ToastAR.Host.Administrator. Aanmaken van een profiel: 1. Open AR.ToastAR.Host.Administrator 2. Login met Gebruikersnaam: Admin, en Wachtwoord: Admin 3. Klik op Profiles. Klik op New. 4. Typ een Profiel naam 5. Klik op Add om een nieuw DC aan te maken. 6. Typ als Extension URL het pad in waar de HTML bestanden zijn geplaatst. 7. Klik op Save. Gebruikers koppelen aan de ToastAR: 1. Open AR.ToastAR.Host.Administrator 2. Login met Gebruikersnaam: Admin, en Wachtwoord: Admin 3. Klik op Users. Klik op Add 4. Typ Login name: gevolgd door het emailadres in. (sip:gebruiker@bedrijf.nl) 5. Typ Password: een password voor deze gebruiker. Dit wachtwoord wordt later bij het eerste gebruik van de ToastAR in de ToastAR ingevuld. 6. Klik op Save. 7. Dubbelklik op de gebruiker die in de lijst is gekomen. 8. Kies een profiel uit de lijst 9. Klik op Save. 3. MetaDirectory De MetaDirectory is verantwoordelijk voor het ter beschikking stellen van de initiële contactdata. Hiervoor maakt de MetaDirectory een lokale kopie van aangegeven data. Gegevens die hier in ieder geval beschikbaar moeten zijn: Uniek id Weergavenaam Telefoonnummers Wanneer van toepassing, sip adress De gegevens vanuit de MetaDirectory worden gebruikt voor zoekacties van de cliënt, dat betekent onder andere dat het zoekscherm alleen data toont die hier aanwezig is. Het is gebruikelijk dat de MetaDirectory op dezelfde server wordt geplaatst als de HoastAR. Importeren van de data kan op verschillende manieren, waaronder ODBC-koppelingen en het inlezen van CSV bestanden en is afhankelijk van de CRM integratie. 3.2 Database management Een replicator moet nu gekoppeld worden aan een dc. Standaard wordt ieder nieuw aangemaakte replicator toegevoegd aan de meta (default). Als er meerdere dc s zijn aangemaakt, dan kan een replicator onderverdeeld worden in groepen. Een gebruiker die dan een bepaalde dc als profiel toegewezen heeft gekregen, ziet data uit het csv bestand die in de replicator staat en die onder zijn dc is toegevoegd. 6
Client Setup 4.1 Vereisten Een geïnstalleerde client voorzien van: Framework 4.5 Lync De ToastAR van AskRoger! neemt ongeveer 3 MB schijfruimte in beslag, inclusief de installatie van het framework die ongeveer 40 MB inneemt. 4.2 Installeren ToastAR 2. Klik op General. 3. Typ de servernaam of het ip adres van de server in. 4. Klik op Save. 5. Open het config scherm opnieuw. 6. Klik op KeyBindings 7. Vink Start call aan en kies een sneltoets om mee te bellen (bijvoorbeeld F8) 8. Klik op Save. 9. Klik nogmaals met je rechtermuisknop op de ToastAR icoon. 10. Klik op Login. 11. De ToastAR is actief. 1. Download het ToastAR setup bestand van http://<servernaam hostar>:809 2. Voer het setup-bestand voor ToastAR uit. Het welkom scherm wordt geopend. 3. Klik op Next. 4. Ga akkoord met de End User License Agreement en klik op Next. 5. De ToastAR maakt automatisch het pad aan waar de HoastAR geïnstalleerd wordt. Indien gewenst kan het installatie pad gewijzigd worden. Klik op Next. 6. Klik op Install om de installatie te beginnen. De setup installeert de ToastAR. 7. Klik de Finish knop om de setup te beëindigen. 4.3 Configureren ToastAR In de taakbalk draait de ToastAR. Mocht deze niet draaien, ga dan naar de installatie pad van de ToastAR en voer de.exe bestand uit. 1. Klik met je rechtermuisknop op het icoon en klik op Config 7