INNEHÅLLSFÖRTECKNING Innehållsförteckning... 1 Cellip Cellphone status Lync 2013... 2 1. Skapa en trusted applications pool... 2 2. Skapa en trusted Application... 2 3. Skapa en Trusted Application Endpoint... 3 4. Mobilnummer i AD per användare... 3 5. Installation av programmet... 4 6. Förändringar efter installation... 5 7. Krav för installation... 6 8. Felsökning... 6 1
CELLIP CELLPHONE STATUS LYNC 2013 Dokumentet är en installationsmanual för att kunna använda mobilstatus i Lync 2013 tillsammans med Cellips mobilabonnemang. Du måste ha Cellips mobilabonnemang med Lync Mex-anknytning. Applikationsinställningar Ett program som Cellip har tagit fram för att pusha ut mobilstatus till Microsoft Lync måste köras hos kunden som har Lync 2013. Nedan följer de steg som behövs för att ge det programmet tillgång till att kunna pusha ut mobilstatus till Lync 2013. 1. SKAPA EN TRUSTED APPLICATIONS POOL Först behöver en Trusted Application Pool skapas på servern där Cellips mobilstatusapplikation kan ligga. Om du vill köra applikationen på samma server som Lync 2013 är installerat på så bör det skapas en DNSport med annat namn. En Trusted Application Pool-server måste vara medlem i domänen. Cellips applikation behöver veta vilken Site den ska ligga i, vilken registrar och namnet på servern/poolen. Börja med att öppna upp Lync Server Management Shell Site och Registrar får du fram genom två enkla kommandon: o Get-CsSite o Get-CsServices Registrar Anteckna dessa så kan vi sedan skapa poolen enligt nedan: New-CsTrustedApplicationPool-Identity <fqdn> -Registrar <registrar> -Site <site> Exempel: New-CsTrustedApplicationPool -Identity app.cellip.local -Registrar lync.cellip.local -Site cellip.local Nu måste Application Pool publiceras i topologin innan vi går vidare, men tänk på att DNS-posten för app.cellip.local (eller er motsvarighet) måste ligga upp redan. Detta görs med kommandot: Enable-DcTopology Nu är poolen färdig att användas 2. SKAPA EN TRUSTED APPLICATION Nu när det finns en Applications Pool så ska vi skapa vår Trusted Application. Vad vi behöver nu är ett namn på applikationen och en lyssningsport. Lyssningsporten är porten via vilken applikationen skickar sina förfrågningar till Front End-servern över TLS. Det är viktigt att brandväggar sin kan finnas mellan Front End-servern och servern som du lagt upp poolen på kan prata med varandra över porten som du bestämmer. Vi rekommenderar att du alltid använder port 13337 Syntaxen ser ut som följande: New-CsTrustedApplication ApplicationId cellstatus TrustedApplicationPoolFqdn <fqdn> -Port <port> Där appid är namnet på applikationen, port är lyssningsporten som Front End-servern lyssnar på och fqdn är namnet på poolen som vi precis skapade 2
Exempel: NewCsTrustedApplication -ApplicationId cellstatus -TrustedApplicationPoolFqdn app.cellip.local - port 13337 Nu behöver vi få ut en ServiceGruu och den får vi från vår nya Trusted Application. För att få fram den så behöver du ange din identity som är <fqdn>/um:application:<appid> Exempel: Get-CsTrustedApplication -Identity ap.cellip.local/um:application:cellstatus Det som behövs till applikationen är Pool, Namn, Port och Gruu. Dessa kommer kallas applicationpool, applicationname, applicationport och applicationgruu under installationen/konfigurationen. Om du har följt exemplen ovan så ska det se ut så här: applicationpool app.cellip.local applicationname cellstatus applicationport 13337 applicationgruu sip:app.cellip@cellip.local;gruu;opaque=srvr:cellstatus:i_ajy_gqsvqgabed6iqyiqaa Notera denna information 3. SKAPA EN TRUSTED APPLICATION ENDPOINT Nästa steg är att skapa en Trusted Application Endpoint. Detta är till för att hålla reda på alla användares status innan de tar ett samtal på mobil och om den behöver ändras eller inte. Detta går att ställa in senare samt från vilken status som den ska ändra från. Om t.ex. en användare är offline så är det onödigt att byta till att denne är upptagen i mobiltelefonen. Det här steget kräver att de två tidigare är klara. Vi behöver veta Application Pool och Application Name. Enligt exemplen ovan så är det app.cellip.com och cellstatus. Vad som är nytt är en SipAdress och ett DisplayName. SipAdress kan inte vara samma som någon användare. Vi rekommenderar att du alltid anger SipAdress till (i vårt fall) cellstatus@cellip.local och DisplayName till Cellip Cellphone Status Application New-CsTrustedApplicationEndpoint -ApplicationId urn:application:<appid> - TrustedApplicationPoolFqdn <fqdn> -SipAddress <sipaddress> -DisplayName <displayname> Kollar vi på de tidigare exemplen så kan det se ut något så här: New-CsTrustedApplicationEndpoint -ApplicationId urn:application:cellstatus - TrustedApplicationPoolFqdn app.cellip.local -SipAddress cellstatus@cellip.local -DisplayName Cellip Cellphone Status Application Notera nu SIP-adressen som du har angett ovan (cellstatus@cellip.local) 4. MOBILNUMMER I AD PER ANVÄNDARE För att identifiera vilken användare som har vilket mobilnummer så krävs det att alla användare som ska få sin status förändrad har detta mobilnummer inlagt på sin användare i AD. Det är viktigt att dessa mobilnummer följer en formatering som går att läsas av. De bör enbart innehålla siffror. Det går bra att antingen skriva dem med 46 eller utan. 3
Figur 1: Lägg in mobilnummer per användare Format som fungerar: 46701234567 0701234567 +46701234567 0046701234567 Format som inte fungerar: 070 1234567 070 1234567 0701 234 567 Tumregeln du kan hålla dig till är att aldrig ha mellanrum efter den första 7:an. För att lägga till telefonnumret så går du in på varje användare i AD:n och lägger till numret på Mobile. Alternativt så kan du med cmdlet också uppdatera användarens mobilnummer med: Set-ADUser -Identity <ADUser> -Mobilephone <MobileNumber> Exempel: Set-adUser -Identity cellip -Mobilephone 0701234567 5. INSTALLATION AV PROGRAMMET När alla punkter är avklarade så ska programmet installeras. Kör igång CellStatus_Setup.msi. För att kunna köra programmet så krävs.net 4.0 eller senare. Det är tre sidor som behöver fyllas med uppgifter. 4
1. Här ska uppgifterna från de tidigare stegen fyllas i. Byt bara ut exempelvärdena mot dina egna Figur 1: Fyll i dina värden 2. SipAddress ska vara TrustedApplicationEndpoint som definierades tidigare. External Access Port är porten via vilken denna applikation lyssnar efter anropen om Linjestatusförändring från Cellip. Den är alltså viktigt att denna port tillåts genom brandväggen. Vi rekommenderar port 13338 till detta, men det går att definiera själv. Notera vilken port det handlar om. Informera din kundkontakt på Cellip vilken port det handlar om när det är klart. Det ska vara öppet för IP-adressen 193.150.226.49 i brandväggen också. Certificate Thumbprint behöver du inte fylla i, men om namnet på servern inte stämmer överens med certifikatet så kan du behöva specificera vilket certifikat som ska användas internt Figur 3: Ställ in SipAdress, External Access Port och Certificate Thumbprint 3. I steg 3 så kan du definiera i vilka lägen som användares närvaro ska ändras. Om du t.ex. har angett Be right back så är det kanske onödigt att statusen byter till att du är upptagen i samtal i mobilen 6. FÖRÄNDRINGAR EFTER INSTALLATION Vill du ändra några av dessa värden efter installationen så finns det en.config-fil i installationsmappen. Det är bara att uppdatera value -parametern med det nya värdet och starta om. Ifall att vi ger ut en ny version så 5
är det bara att spara ner.congif-filen för att sedan byta ut den efter installationen. På så sätt sparas all information. 7. KRAV FÖR INSTALLATION 1. Servern som har applikationen installerad på sig måste ha.net 4.0 installerad 2. Servern måste vara en del av AD och ha Active Directory module for Windows PowerShell installerad. Den hittar du under Features > Remote Server Administration Tools > Role Administration Tools > AD DS ans AD LDS Tools 3. Den externa porten måste vara öppen till servern, d.v.s. den som definieras vi installationen. Den kommer få http post-anrop från 193.105.226.49 över just den externa porten som är definierad vid installationen och överenskommen med Cellip 8. FELSÖKNING Är Cellips Cellstatus-tjänst startad? Se efter under Windows Services och starta tjänsten Ifall det blir fel med tjänsten eller annat kan du ta Windows egna Event Viewer till hjälp. Välj Windows Loggar och sedan, under Applikationer > Event Source, skriver du in Cellstatus i sökfältet 6