Blackberry MAT-03196-001 manual

Inst allati on & Getting S t arted Guide BlackBerry Enterprise Server for Lotus Domino V ersio n 2.0[...]

BlackBerry TM Enterp rise Server Software Inst allation & User’s Gu ide. Last revised 05/01/01 Part N umber : MAT -031 96-0 01 At time of printing, do cumentation com plies with softwa re version: 2.0. © 199 7-2001, Research In Motio n Limit ed. All r ights res erved. RIM, Research In Motion, the RIM logo, BlackBerry, RIM 950 Wireless Handhe[...]

Content s Overvie w ......... ....... ........... ........... ........ .......... ........... ........... ....... ...... 5 About B lackBerr y and th e BlackBe rry Enter prise Se rver.... 5 About thi s guide............ ....... ........... ........... ....... ........... ........... .. 7 In your packa ge ......... ........ ........... .......... ...[...]

Sending a n All Points Bulletin ... ........... ........... ........... ....... ... 58 BESMoni tor and BESAl ert ......... ....... ........... ........... ........... ....... ... 61 Checking server status ......... ....... ........... ........... ....... ........... ... 61 Configu ring BESAlert........... ........... ........... ....... ...........[...]

1 Over view BlackB erry™ is a mobile emai l solution that consists of the BlackB erry hand held, doc king cr adle, Blac kBerr y Desktop So ftwar e, and fla t-rate airt ime on a na tionwide wireless network. About BlackBe rry and th e BlackBerry Enterprise Server The B lac kBer ry En ter pr ise S erv er pe rfo rms e ma il red ire cti on f or all B[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Overview — About BlackBerry an d the Bla ckBerry Ente rprise Server 6 The BlackBer ry Enterprise Server runs a s a Lotus Domino Server task that can monitor many users at once over a single admin istra tive conn ection to th e Lotus D omino se rver. T he BlackB erry Enterprise Ser ver mainta[...]

Overview — About this guide Installat ion and Getting Start ed Guide 7 Abou t this g uide This BlackBerry Enterprise Server Software Installation an d Getting Star ted Gu ide will help you se t up your syste m for inst allation, ins tall the server so ftware, and get st arted with the serv er administra tion tools. Please consult the BlackBerry E[...]

[...]

2 Setup and in st allation This chapter inc ludes the following component s: • System requ irement s and pre-installat ion checklist • Insta lling Blac kBerry E nterprise Ser ver Softwa re • Import ing system inf ormation • Cre ating the Blac kBerr yAdmin s group • Uninst alling BlackBer ry Enterpris e Server Softwar e System requirement [...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Pre-Installation checklist 10 Pre-Inst allation checklist Use this c hecklist t o track the s pecific inform ation required w hen you inst all the Blac kBerry En terprise S erver. Kee p this informa tion for future refer ence. The inform ation you enter w ill be requ[...]

Setup and installation — Pre-Installation checklist Installation & Get ting Started Guide 11 Information You will be a sked for the S RP Identifi er and the S RP Auth enti cation Ke y. You can fi nd this info rmat ion on the la bel on your BlackBerr y Enterprise Serve r for Lotus Domino instal lation CD. It is highly recomm ended th at you wr[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Firewall configuration 12 Firewall config uration The BlackB erry Enterpr ise Server init iates connec tions to the wireless network in an out bound dir ection. To s upport Blac kBerry in an envir onment with a firewa ll in place, the firew all must be configured to [...]

Setup and installation — Firewall configuration Installation & Get ting Started Guide 13 firewall , the proxy must be transparent . Please ensure that your firewall is configur ed to accommodate these types of connection s. Note A transparent proxy does NOT modify requests or responses through the proxy during proxy aut hentication and identi[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Important setup ove rview 14 Import ant setup ov erview To ensure suc cessful insta llation and setu p of the Black Berry Enterpri se Server, pleas e follow this setup order. (Det ailed procedures follow for ea ch step in t he overview .) • Log in w ith an Admin is[...]

Setup and installat ion — Installing the server Installation & Get ting Started Guide 15 Inst alling the server Follow t hese steps to in stall th e BlackB erry Enterpri se Server . 1. Insert the Blac kBerry Ent erprise Server for Lotus Domin o CD into the C D drive o f the co mputer that w ill run t he Bla ckBerry Ente rprise Serv er. 2. Dou[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Installing the server 16 3. Clic k Next . The License Agreemen t window appears.[...]

Setup and installat ion — Installing the server Installation & Get ting Started Guide 17 4. Please read the l icense agreement ca refully; proceeding wit h the instal lation ind icates that you acc ept its conditi ons. Click Yes to cont inue. The Setup Type window a ppears.[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Installing the server 18 5. To install the BlackBer ry Enterprise Server, selec t BlackBer ry Server and Utilitie s . This option in stalls the BlackB Erry Ente rprise Serv er task and the a dminist rator int erface. If you are installin g a BlackBerry Enterprise Ser[...]

Setup and installat ion — Installing the server Installation & Get ting Started Guide 19 6. In the Bla ckBe rry E nter pri se Ser ver fo r Lot us Do mino Se tup screen labelled System Attenda nt ,i nt h e System A ttendant field, type th e email address of the Sy stem Administ rator. Use a valid email addr ess that can send and receive Alert [...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Installing the server 20 8. In the Bla ckBe rry E nter pri se Ser ver fo r Lot us Do mino Se tup screen labe lled SRP Host and Authenticat ion Information , enter the following valu es under Connection to SRP: •I n t h e Hos t Name fiel d, enter the SRP Address (a [...]

Setup and installat ion — Installing the server Installation & Get ting Started Guide 21 throug h a tran spare nt pr oxy se rver . •I n t h e Port field, the SRP Port, configured during the fire wall c onf igur ation p roc ess, i s set to 3 101 , and is typically not cha nged. This is an outbou nd-initi ated connec tion. Click Next to conti[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Installing the server 22 CD. These va lues are unique to each host license. Each BlackB erry Enterpr ise Server requ ires its own unique SRP Identifier and Authentication Key. 11. Cl ick Ne xt to contin ue. 12. T he Choose Destination Location window appears. In the [...]

Setup and installat ion — Installing the server Installation & Get ting Started Guide 23 Note The default path for the BlackBerry E nterprise Serve r is C:Program FilesResearch In MotionBlackBerry Enterprise Server[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Installing the server 24 13. In the Select Program Folder window, e nsure the corr ect folder is selected an d click Next to compl ete the insta llat ion. 14. When the installa tion is complet e, you will see a confirm ation window .[...]

Setup and installat ion — Installing the server Installation & Get ting Started Guide 25 15. Cl ick Finish to close the w indow.[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Creating th e BlackBerryA dmins group 26 Creating the Bl ackBerryAdmins group You must crea te a BlackBerryA dmins group in t he Lotus Domi no admin istration serv er directory and replicate it in the Black Berry Ente rprise Server Do mino director y, then add Lotus [...]

Setup and installation — Creating the BlackBerryAdmins group Installation & Get ting Started Guide 27 3. In t he Groups men u list, click Create to add th e group. 4. Sel ect the Basic s tab. •I n t h e Group na me field, type: BlackBerryAdmins •I n t h e Group type fie ld, type or select ACL . •I n t h e Description field, ty pe a desc[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Creating th e BlackBerryA dmins group 28[...]

Setup and installation — Creating the BlackBerryAdmins group Installation & Get ting Started Guide 29 5. Sel ect the Administration ta b. •I n t h e Owner s field, ty pe the nam es of the users w ho are allo wed to cha nge th e gr oup m emb ersh ip. •I n t h e Administrators field, type the users wh o are allowed to edit the Group docu me[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Adding administrators to the BlackBerryAdmins 30 Adding administ rators t o the BlackBerryAdmins g roup After yo u installed the Bla ckBerry Ent erprise Server , you created a special Grou p called the BlackBerryAdmin s Group and ad ded it to the Name and A ddress Bo[...]

Setup and installation — Starting the server add-in task Installation & Get ting Started Guide 31 S t arting the server add-in task Once the server has been crea ted, and the BlackBer ryAdmins group added, st art the Bl ackBerry Enter prise Serv er. In the Lotus Se rver Console on the Black Berry Enterprise Se rver machine, type load BES or r[...]

If you r firewal l has bee n configure d to pr oxy conne ction s on port 3101 t o srp host , try using the proxy to connect. To do this you must know the intern al IP address of the firewall or the proxy serv er through w hich y ou ar e trying to s end th e reque st. For exa mple, if the IP addre ss of the firewall/ proxy server is 192 .168.0.1 , y[...]

Setup and installation — Uninstalling the software Installation & Get ting Started Guide 33 This messa ge indicates th at the conne ction was broken by the firewall o r proxy before the test program could connect with the SRP server. To resolve thi s error, check with you r firewall admin istrato r to ens ure th at a n out bou nd con nec ti o[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Setup and installation — Uninstalling the sof t ware 34 3. In the Add/Remove Programs Properties w indow, select BlackBerry Ente rprise Server for Lotus Do mino and clic k Add/Remove . A Confi rm File Deletion dialog appears. 4. Clic k OK to remove t he BlackBerr y Enterprise Ser v er softw [...]

Setup and installation — Uninstalling the software Installation & Get ting Started Guide 35 5. A confirma tion window will appear when a ll programs hav e been successfully removed. Note Uninstalli ng the applicat ion does not remove the us er configuration and mess age queue databases. If you wish to remove these as well, these items can be [...]

[...]

3 Administ ration t asks You can p erfor m use r- and ha ndhe ld-or iente d admini str ative function s through the BESAdm in utility. This tool wa s installed if you se lec ted Utilities during insta llation. Opening t he BESAd min windo w The insta ll process place d a file named BESA dmin.exe in t he folder Program F ilesResearch In Mot ionBl[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Opening the B ESAdmin window 38 2 . I nt h ed i a l o gb o x ,t y p et h ec o m m o nn a m eo rN E T B I O Sn a m eo f t h es e r v e rt ow h i c hy o uw a n tt oc o n n e c t( f o re x a m p l e ,S erver1, where the full ser ver name is S erver1 /Server/BlackBer r y).[...]

Administration tasks — C onnecting a handheld to t he cradle Installat ion and Getting Started Guide 39 Conn ectin g a handhe ld to the cradle System ad ministr ators can use th e cradle to add us ers, assign P IN numbers, and generate encry ption keys. Note Please ensure that you use only the cra dle provided by Research In Motion.[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Connecting a handheld t o the cradle 40 T o connect the handheld 1. Co nnect t he crad le cable to the C OM port on the ma chine runni ng BESAdmin. 2. In the BE SAdmin window , click Tools .C l i c k Se ttings to ope n the Se ttings win dow. 3. The Setting s window wil[...]

Administration tasks — Adding users Installat ion and Getting Started Guide 41 Removing a handheld from the cradle Adding users One of t he BES Adm in to ol’ s prim ary fu nct ions i s to ad d a han dhel d to a BlackBerry Ente rprise Server. You can add a user with or without a pers onal identificat ion number (PIN ). To add a user and a PIN at[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Adding users 42 2 . S e l e c tt h en a m eo ft h eu s e rt ob ea d d e da n dc l i c k OK . You will see a “successfully add ed” message. Click OK to c lose the message. Adding a user and a PIN You can a ttri bute t he hand held ’s PIN t o a speci fic use r when[...]

Administration tasks — Adding users Installat ion and Getting Started Guide 43 2. Place the user’s handheld in the crad le. The server will detect the hand held and autom atica lly add the PI N to the Handh eld PIN field. 3. Select the name of the user to be ad ded and click OK .Ad i a l o g box appears asking if you would like to generate an e[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Enabling and disabling a handheld 44 Enabling and disabling a handh eld The BlackBer ry Enterprise S erver lets you dis able or enable a handheld without actually removin g that user from the server. You may want to use this functio n if, for example, a user is traveli[...]

Administration tasks — E nabling and disabling a handheld Installat ion and Getting Started Guide 45 T o disable a handheld 1. In the BESAdmin wind ow, select the Bla ckBerry E nterprise Server wh ere the user is enabled. 2. Sel ect the user. Click Dis able Use r to prevent email from being forward ed to the user’s handheld. 3. You will be as k[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Purging pending m essages 46 T o remove a user You can remove a user from a Black Berry Enterprise Ser ver using the BESAdmin tool. 1. In the BESAdmin wind ow, select the Bla ckBerry E nterprise Server where the user is registered. 2. Select the user. Click Rem ove fro[...]

Administration tasks — Generat ing encryption keys Installat ion and Getting Started Guide 47 Clearing in-cradle st atus By default , email will not be redirected to the han dheld as long as it is in the cra dle. Occasiona lly, an interru ption in networ k communicatio ns may prevent the BlackBer ry Desktop Manager from cl earing th e in-cradle s[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Monitoring email statistics 48 Monitoring em ail st atistics The BESAdmin t ool reports on each use r’s email flow from server to handhel d. The informat ion in the Statist ics fields lets you verify t hat the server is redirecting email properly . T o monitor st a t[...]

Administration tasks — Reading the status fields Installat ion and Getting Started Guide 49 Reading the s t atus fields In the BESAdmin wind ow, each user will have a set of propert ies (found in the Properties window). Th e BlackBerry tab in this window di splays numb ers, dates and times to in dicate the sta ge a nd status o f emai l for th at [...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Sending a m essage to one user 50 Sending a messa ge to one use r I f y o uw i s ht os e n d a ne m a i lm e s s a g e t o a n yh a n d h e l du s e r o na Black Berry E nterp ris e Serv er, yo u can do s o from t he BE SAdmin tool. 1. Ensure th at you are connected to[...]

Administration tasks — Changing a user ’s handheld Installat ion and Getting Started Guide 51 3. Type information into the Subject and Message fields of the wind ow, and click OK . The m essage will be sen t to the recipient’s In box, and procee d to that person ’s handheld. You will receiv e a “successful” messa ge. Click OK to close t[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Viewing global statistics 52 V iewin g global st atistics You can view the c ombined stat istics of all hand helds on a particu lar BlackBerry En terprise Server. T o view global st atistics In the BESA dmin window, sele ct Tools > Global Statistics .T h e Global St[...]

Administration tasks — Viewing global statistics Installat ion and Getting Started Guide 53 Note If the name of your server does not appear in the drop- down list in t he Server Name field, click Add . The A dding BES Server dialog box appears. T ype the name of the server into the box and click OK .[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Viewing global statistics 54 T o view Global St a t s in Perfo rmance Monitor Perform ance Monit or allows you to view d ynamic global st atistics. T h es t a t i s t i c sa v a i l a b l ei nP e r f o r m a n c eM o n i t o ra r et h es a m ea s those li sted under ?[...]

Administration tasks — Viewing global statistics Installat ion and Getting Started Guide 55 3. In the P erformanc e Object fi eld, select BlackBerry Server from the drop-down lis t. 4. Either c lick All Counte rs or click Select counters from lis t to select indi vidual counter s from the drop-down list. Note T o see a description of each counter[...]

BlackBerry Enterprise Serv er Software for Lotus Domino Administration tasks — Viewing global statistics 56 T o v i ew G lo ba l Sta ts i n S N M P SNMP also allow s you to view dynamic global s tatistics . The stati stics th at you c an view in SNMP ar e the s ame as the ones l iste d under “View ing Global Stats ”. Viewing Globa l Stats in [...]

4 Server-l evel administr ation You can administer tasks tha t affect all users from the BESAdmin window . Addi ng hand held li cense s The Licen se Manager tra cks BlackBe rry client licen ses. Each time you open and exit the Add Users w indow, th e License Mana ger will tell you if y ou require more license s. Once you’ve pu rchased more l i c [...]

BlackBerry Enterprise Serv er Software for Lotus Domino Server-level administration — Send ing an All Point s Bulletin 58 Sending an All Point s Bulletin Use the All Points Bu lletin (APB) feature to se nd an email message to multiple handhel d users. You can choose to send your message to all users on a specific server, or to all users o n all y[...]

Server-level administration — Sending an All Points Bulletin Installat ion and Getting Started Guide 59 3. Type informati on into th e Subject and M essage field s of the window an d click OK . The messa ge will be sent to the users associat ed with th e server t hat you’v e specified.[...]

[...]

5 BESMonitor and BESAlert The BESMonito r program is install ed automatically w hen you select Utilities d uring insta llation. Th is program can b e installed on the BlackBerr y Enterprise Server or on anot her computer, and can b e used to monitor multiple BlackBerry Enterpri se Servers. By default, th e BlackBerry Enterprise Ser ver records sign[...]

BlackBerry Enterprise Serv er Software for Lotus Domino BESMonitor and BESAlert — Checking server s tatus 62 It is possible to mo nitor the BlackBer ry Enterprise Ser ver using the BESMonit or icons. If you doubl e-click the icon, a dialog box open s to show the name of the server being monitor ed, its status, and its glob al st atisti cs. Icon T[...]

BESMonitor and BES Alert — Con figuring BESAlert Installat ion and Getting Started Guide 63 Configuring BESAlert You can configure the B ESAlert program to sen d you a copy of events whenev er an Error, Warning or Information event (with event ID 5) i s logged. T o configure BESAlert notifications 1. To open the BESMonitor window, click Sta rt &g[...]

BlackBerry Enterprise Serv er Software for Lotus Domino BESMonitor and B ESAlert — C onfiguring BESAlert 64 3. In th e Notification Account Name field, type the full SMTP address from whi ch the BESAlert messa ges will be sent (for example, BESAlert@a cme.com). 4. In th e Notification Host Name field, ty pe the nam e of the machine on w hich the [...]

BESMonitor and BES Alert — Con figuring BESAlert Installat ion and Getting Started Guide 65 secti on li sts th e des tina tion s or u sers w ho w ill r eceiv e thes e event reports. To add new n ames to the User Noti fication list, click Add ; to update names currently in the User Notification list, clic k Edit . The User Configuration window app[...]

11.[...]

6 Freque ntly aske d question s For additio n al support: • Email: support @blackber ry.net • Phon e: 1-887 -255-23 77 (U.S. and Can ada) • Web: www.b lackberry.net ( for general informat ion about the BlackBerr y Wireless Email Solutio n) What should I do when the BESMonitor st atus shows “SRP Connect ion Down”. Symptoms The BESMonit or [...]

BlackBerry Enterprise Serv er Software for Lotus Domino Frequently asked questions 68 1. Copy bbsrptest .exe to the machine tha t is running Black Berry Ente rprise Serv er. 2. Open a command prompt and run the program with one addition al parameter: bb srptest srphos tname. (Refer to your Installa tion Check List on pa ge 11, under “SRP Ho st”[...]

Frequently asked questions Installat ion and Getting Started Guide 69 This messa ge indicates th at the connec tion was bro ken (by the firewall or proxy) before the test progr am could connec t to the SRP host serv er. The error code that is listed is the Winsock error code. Why isn’t this laptop user's handheld receiving messages ? Symptom[...]

[...]

BlackBerry Enterprise Server Sof tware License Agreement This is a legal a greement betwee n you, the Customer ( "You"), and Research In Motion Limited ("RIM"). BY INSTAL LING, USING OR MAKING ONE OR MORE COPIES OF THIS SOFTWARE (OR ANY COMBINATION OF THE FOREGOING), YOU ARE A GREEING TO BE BO UND BY T HE TE RMS OF T HI S AGR EE[...]

BlackBerry Enterprise Serv er Software for Lotus Domino BlackBerry En terprise Serv er Software License Agreem ent 72 2.0 Grant of License 2.1 This RIM So ftware Licens e Agreement ("LICEN SE") hereby grants You a non -exc lusi ve, non-tr ansfe rab le rig ht to i nstal l and us e one copy of the SOFTWARE on a single CPU resid ing on Your [...]

BlackBerry Ente rprise Server Software License Agreement Installat ion and Getting Started Guide 73 4.0 T erm 4.1 The gr ant of rig hts s hall be n on-e xclus ive, non -tran sfe rable a nd perpetua l provided that You do no t breach the terms a nd conditions of this Agree m ent or any ot her agreeme nt with RIM an d further prov ided t ha t you co [...]

BlackBerry Enterprise Serv er Software for Lotus Domino BlackBerry En terprise Serv er Software License Agreem ent 74 implied warranty lasts. Th us, the above limi tatio ns or ex clusi ons may not apply to You. 5.5 IN NO EVENT SHALL RIM BE LIA BLE FOR ANY OTHER DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS,[...]

Index A about BESAdmin , 37 BESMonit or, 61 the BlackBerr y encryption model, 4 7 the ser ver, 5 this guide, 7 adding au s e ra n dP I N , 4 2 adminis trato rs, 30 hand held l ice nse s, 57 users, 41 adminis trati ve functi ons, 3 7 administr ator logging i n, 1 4 all point s bulletin, 58 B before y ou ins tall , 10 BESAdmin about, 37 opening windo[...]

encryption model, ab out, 47 error connection lost, 32 statistic s for users, 50 error code 10060, 3 1 10061, 3 3 11001, 3 3 F firewall configurat ion requirements, 1 2 frequently ask ed questions, 67 G generat ing encryption keys , 47 glob al st ats performance mon itor, 54 H hand held chang ing a user’s, 51 disablin g a, 45 enablin g a, 44 lice[...]

sent from handhe ld - statis tic, 49 mon itorin g email s tatistics , 48 P pending messag es, purging, 46 performance monitor, vie wing glob al st ats, 54 permissions on Domino server, 41 ping test, 33 por t 3101, 6, 12 pre-insta llation ceh cklist, 10 pre-insta llation ch ecklist, 10 properties window , 49 purging pen ding messages, 46 R read ing [...]

remov ing, 4 5, 4 6 V viewin g glob al stat ist ics, 52 globa l stats in perfor mance monitor, 54 viewing gl obal statistic s, 52[...]