1. Tips from the Trenches Rebekah Atkinson Steve Nye, Kathy Kennedy

2. Overview OSI Resources Troubleshooting – The Big Picture Backups Buffering Archive Sizing Q&A

3. OSI Resources

4. Log Files PIPC.Log (client & server) NT only, usually located in \PIPC\Dat PIMessLogFile Unix only, located in $PIHOME/log PI Server Log PI - Healthcheck PIGetMsg (PI3) PISysMgr:PIMessLog.Txt (PI2)

5. OSI Resources Documentation Interface Manuals (interfaces.osisoft.com) Point attribute section Startup file flags section Troubleshooting section Client Manuals Server Manuals

6. OSI Resources Support Web Site (support.osisoft.com) Online Call Center Tracking of calls New call entry Searchable knowledge base Bug reports Engineering Plan New Release Announcements Feel Free to call us at Tech Support

12. OSI Resources Support Web Site (support.osisoft.com) Online Call Center Tracking of calls New call entry Searchable knowledge base Bug reports Engineering Plan New Release Announcements Feel Free to call us at Tech Support

13. Troubleshooting The Big Picture

14. Consider Big Picture Ask yourself… Did it ever work? If so, what changed? New software? New hardware? Etc… Use Log Files to help isolate problem No errors in client logs - Server problem Always an error message somewhere! Know your utilities

15. Know Your Nodes

16. Connection Troubleshooting

17. Common Network Issues DNS If DNS is slow, connection may time out Check HOSTS file Multiple NIC cards WAN traffic Know your routers! Port 5450 not initialized

18. Backups

19. Archives Nightly & After Shift Pi\dat Directory Nightly & when server is shutdown Site specific files & log files Nightly Recommend Test Recovery

20. Backups Known problems with PI 3.2 SR1 Script Piartool –be ignored if system is busy One Subsystem would stop while another was starting New Beta Script Verify that the subsystem is responsive Schedule piartool -be to run 30 minutes after backup

21. Example Script Change Rem Backup files owned by pibasess %BinPath%\pibasess -stop set BaseFiles=pipoints.dat piptattr.dat piptclss.dat pidigst.dat pidignam.dat piusr.dat piusrgrp.dat piusrctx.dat piptunit.dat piptalia.dat for %i in (%BaseFiles%) do ( copy %DatPath%\%i %BackupPath% ) Rem Restart pibasess and wait for it to become responsive Rem Record timestamps before and after to document the time this requires %BinPath%\pibasess -start %BinPath%\pidiag -t "*" %AdmPath%\piartool -block pibasess -verbose %BinPath%\pidiag -t "*"

22. Buffering

23. Buffering Basics Why Buffer? Avoid data loss during PI server shutdowns Optimize your PI network transactions Faster throughput Set up a PI-API node Data collection is not affected by the PI server

24. Configuring Buffering Must configure PICLIENT.INI Turn Buffering ON Define Maximum Buffer Size Size for down time and recovery time (size in KB) Define how frequently it will attempt to reconnect (time in seconds)

25. Example PICLIENT.INI [APIBUFFER] BUFFERING=1 MAXFILESIZE=500000 RETRYRATE=120

26. Buffering Issues Remember Configuration required, NT/Unix Have plenty of disk space available Buffering isn’t working? Check BufServ Service Login Make sure /host entry matches Default PI Server in PILOGIN.INI All API programs must be stopped before bufserv can be restarted Use bufutil program

27. BUFUTIL Example

28. Archives

29. Archive Sizing Why Change Sizes? Added a new interface Added more tags to an existing interface Changed exception & compression on many tags Added Performance Equations, Totalizers, Alarm tags, and/or Manual Entry tags

30. Archive Sizing Rules of Thumb… 10-20 MB per 1000 tags Smaller than the system RAM Smaller than the backup media

32. Example Bat File REM Create New Archives REM Specify path and size. d:\pi\adm\piarcreate d:\pi\archives\piarch.004 50 d:\pi\adm\piarcreate d:\pi\archives\piarch.005 50 d:\pi\adm\piarcreate d:\pi\archives\piarch.006 50 REM Register the new archives d:\pi\adm\piartool -ar d:\pi\archives\piarch.004 d:\pi\adm\piartool -ar d:\pi\archives\piarch.005 d:\pi\adm\piartool -ar d:\pi\archives\piarch.006

33. Conclusion Know Your Resources Consider the Big Picture Develop Your Backup Strategy Buffer Your Data Optimize Your Archive Size

34. Questions??? Ready for lunch? (if you applaud, we will let you go to lunch)