Imported Upstream version 0.8.7g
[debian/cacti] / docs / html / install_windows.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Installing Under Windows</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="The Cacti Manual"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="Installation"
14 HREF="installation.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Apply Patches"
17 HREF="unix_apply_patches.html"><LINK
18 REL="NEXT"
19 TITLE="Upgrading Cacti"
20 HREF="upgrade.html"><LINK
21 REL="STYLESHEET"
22 TYPE="text/css"
23 HREF="manual.css"></HEAD
24 ><BODY
25 CLASS="CHAPTER"
26 BGCOLOR="#FFFFFF"
27 TEXT="#000000"
28 LINK="#0000FF"
29 VLINK="#840084"
30 ALINK="#0000FF"
31 ><DIV
32 CLASS="NAVHEADER"
33 ><TABLE
34 SUMMARY="Header navigation table"
35 WIDTH="100%"
36 BORDER="0"
37 CELLPADDING="0"
38 CELLSPACING="0"
39 ><TR
40 ><TH
41 COLSPAN="3"
42 ALIGN="center"
43 >The Cacti Manual</TH
44 ></TR
45 ><TR
46 ><TD
47 WIDTH="10%"
48 ALIGN="left"
49 VALIGN="bottom"
50 ><A
51 HREF="unix_apply_patches.html"
52 ACCESSKEY="P"
53 >Prev</A
54 ></TD
55 ><TD
56 WIDTH="80%"
57 ALIGN="center"
58 VALIGN="bottom"
59 ></TD
60 ><TD
61 WIDTH="10%"
62 ALIGN="right"
63 VALIGN="bottom"
64 ><A
65 HREF="upgrade.html"
66 ACCESSKEY="N"
67 >Next</A
68 ></TD
69 ></TR
70 ></TABLE
71 ><HR
72 ALIGN="LEFT"
73 WIDTH="100%"></DIV
74 ><DIV
75 CLASS="CHAPTER"
76 ><H1
77 ><A
78 NAME="INSTALL_WINDOWS"
79 ></A
80 >Chapter 3. Installing Under Windows</H1
81 ><P
82 ></P
83 ><P
84 ><B
85 >Software Components Required</B
86 ></P
87 ><OL
88 TYPE="1"
89 ><LI
90 ><P
91 >                                       (Optional) Apache&#62; - This software is optional if running Windows Internet Information Server.
92                                 </P
93 ></LI
94 ><LI
95 ><P
96 >                                       Cacti&#62; - Install from the zip distribution and install in the web root or your choice.
97                                         Many choose to install into a "Cacti" sub folder.
98                                 </P
99 ></LI
100 ><LI
101 ><P
102 >                                       Spine - Install from the zip distribution into the <TT
103 CLASS="FILENAME"
104 >c:\cacti</TT
105 >
106                                         directory.  Make sure your <TT
107 CLASS="FILENAME"
108 >spine.conf.dist</TT
109 > is located in that directory as well.
110                                 </P
111 ></LI
112 ><LI
113 ><P
114 >                                       RRDTool - Install from the Cacti website.  Install it into the <TT
115 CLASS="FILENAME"
116 >c:\cacti</TT
117 > directory.
118                                 </P
119 ></LI
120 ><LI
121 ><P
122 >                                       PHP 4.3.6+ or 5.x - Install into the <TT
123 CLASS="FILENAME"
124 >c:\php</TT
125 > folder.  If you choose
126                                         to install into <TT
127 CLASS="FILENAME"
128 >c:\Program Files\php</TT
129 >, you will have to use 8.3 filenames
130                                         to reference it's binaries in Cacti.
131                                 </P
132 ></LI
133 ><LI
134 ><P
135 >                                       MySQL 4.x or MySQL 5.x - Install into the default location.  This is typically
136                                         <TT
137 CLASS="FILENAME"
138 >c:\Program Files\MySQL\MySQL Server X.XX</TT
139 >.
140                                 </P
141 ></LI
142 ><LI
143 ><P
144 >                                       (Optional) Cygwin - Download and execute <TT
145 CLASS="FILENAME"
146 >setup.exe</TT
147 > from the Cygwin
148                                         website.  Keep the <TT
149 CLASS="FILENAME"
150 >setup.exe</TT
151 > file for later use.
152                                 </P
153 ></LI
154 ><LI
155 ><P
156 >                                       (Optional) Net-SNMP - Install to the <TT
157 CLASS="FILENAME"
158 >c:\net-snmp</TT
159 > directory.  If you
160                                         choose to use <TT
161 CLASS="FILENAME"
162 >c:\Program Files\net-snmp</TT
163 > you will have tu use 8.3 filenames
164                                         to reference it's binaries in Cacti.
165                                 </P
166 ></LI
167 ></OL
168 ><P
169 ></P
170 ><P
171 ><B
172 >Configure PHP</B
173 ></P
174 ><OL
175 TYPE="1"
176 ><LI
177 ><P
178 >                                       If using PHP 4, move the files in <TT
179 CLASS="FILENAME"
180 >c:\php\dlls</TT
181 > to <TT
182 CLASS="FILENAME"
183 >c:\php</TT
184 >
185                                 </P
186 ></LI
187 ><LI
188 ><P
189 >                                       Add the following directory to the existing Windows System <KBD
190 CLASS="USERINPUT"
191 >PATH</KBD
192 > environment variable:
193                                         <TT
194 CLASS="FILENAME"
195 >c:\php</TT
196 >.  The Windows path can be accessed via the Control Panel at: System |
197                                         Advanced | Environment Variables | System Variables.
198                                 </P
199 ></LI
200 ><LI
201 ><P
202 >                                       Add the following directory to a new Windows System environment variable called <KBD
203 CLASS="USERINPUT"
204 >PHPRC</KBD
205 >:
206                                         <TT
207 CLASS="FILENAME"
208 >c:\php</TT
209 >.
210                                 </P
211 ></LI
212 ><LI
213 ><P
214 >                                       Add a new Windows System environment variable called <KBD
215 CLASS="USERINPUT"
216 >MIBDIRS</KBD
217 >.  If using
218                                         PHP 4, set it to <TT
219 CLASS="FILENAME"
220 >c:\php\mibs</TT
221 >.  If using PHP 5, set it to <TT
222 CLASS="FILENAME"
223 >c:\php\extras\mibs</TT
224 >
225                                 </P
226 ></LI
227 ><LI
228 ><P
229 >                                       If using PHP 4.3.5 or less, create the following directory <TT
230 CLASS="FILENAME"
231 >c:\tmp</TT
232 >.
233                                 </P
234 ></LI
235 ><LI
236 ><P
237 >                                       Rename the file <TT
238 CLASS="FILENAME"
239 >c:\php\php.ini.dist</TT
240 > to <TT
241 CLASS="FILENAME"
242 >php.ini</TT
243 >, and make the
244                                         following changes to it:
245                                 </P
246 ><P
247 >                                       If using PHP 4 add/uncomment the following lines.
248                                 </P
249 ><PRE
250 CLASS="SCREEN"
251 ><KBD
252 CLASS="USERINPUT"
253 >extension_dir = c:\php\extensions
254 extension=php_snmp.dll
255 extension=php_sockets.dll
256 cgi.force_redirect = 0</KBD
257 ></PRE
258 ><P
259 >                                       If using PHP 5 uncomment the following lines.
260                                 </P
261 ><PRE
262 CLASS="SCREEN"
263 ><KBD
264 CLASS="USERINPUT"
265 >extension_dir = c:\php\ext
266 extension=php_mysql.dll
267 extension=php_snmp.dll
268 extension=php_sockets.dll
269 cgi.force_redirect = 0</KBD
270 ></PRE
271 ><P
272 >                                       If using PHP 4.3.5 or less include the following line.  If using 4.3.6 or greater, you should remove this line if present.
273                                 </P
274 ><PRE
275 CLASS="SCREEN"
276 ><KBD
277 CLASS="USERINPUT"
278 >session.save_path=c:\tmp</KBD
279 ></PRE
280 ></LI
281 ><LI
282 ><P
283 >                                       In earlier installation guides to PHP, they recommended moving certain DLL's to the <TT
284 CLASS="FILENAME"
285 >                                       c:\winnt\system32</TT
286 > directory.  If so, you will have to remove those files.  Please
287                                         review the PHP installation documentation for instructions on removing those files.
288                                 </P
289 ></LI
290 ><LI
291 ><P
292 >                                       If you want to allow template importing, uncomment the following line:
293                                 </P
294 ><PRE
295 CLASS="SCREEN"
296 ><KBD
297 CLASS="USERINPUT"
298 >file_uploads = On</KBD
299 ></PRE
300 ></LI
301 ><LI
302 ><P
303 >                                       Give the user who will be running the scheduled task, modify rights to the <TT
304 CLASS="FILENAME"
305 >.index</TT
306 >
307                                         file in the location pointed to by the <KBD
308 CLASS="USERINPUT"
309 >MIBDIRS</KBD
310 > Windows System environment variable.
311                                 </P
312 ></LI
313 ></OL
314 ><P
315 ></P
316 ><P
317 ><B
318 >Configure the Webserver (Apache)</B
319 ></P
320 ><OL
321 TYPE="1"
322 ><LI
323 ><P
324 >                                       Make sure you have stopped any IIS web servers before you proceed with Apache installation, or make
325                                         sure Apache is configured on an alternate port.
326                                 </P
327 ></LI
328 ><LI
329 ><P
330 >                                       If you are using <B
331 CLASS="EMPHASIS"
332 >Apache 1.3.x</B
333 >, installation of PHP 5 is not recommended.
334                                         If using PHP 4, add the following lines to your <TT
335 CLASS="FILENAME"
336 >httpd.conf</TT
337 > file.  You can edit
338                                         that file by selecting Start | All Programs | Apache HTTP Server X.XX | Configure Server | Edit the
339                                         httpd.conf file pick from the Taskbar.
340                                 </P
341 ><P
342 >                                       If using Apache 1.3.x and PHP 4, then add the following lines:
343                                 </P
344 ><PRE
345 CLASS="SCREEN"
346 ><KBD
347 CLASS="USERINPUT"
348 >LoadModule php4_module c:\php\sapi\php4apache.dll
349 AddModule mod_php4.c
350 AddType application/x-httpd-php .php
351 DirectoryIndex index.html index.htm index.php</KBD
352 ></PRE
353 ><P
354 >                                       If using Apache 2.x and PHP 4, then add the following lines:
355                                 </P
356 ><PRE
357 CLASS="SCREEN"
358 ><KBD
359 CLASS="USERINPUT"
360 >LoadModule php4_module c:\php\sapi\php4apache2.dll
361 AddType application/x-httpd-php .php
362 DirectoryIndex index.html index.htm index.php</KBD
363 ></PRE
364 ><P
365 >                                       If using Apache 2.x and PHP 5, then add the following lines.
366                                 </P
367 ><PRE
368 CLASS="SCREEN"
369 ><KBD
370 CLASS="USERINPUT"
371 >LoadModule php5_module c:\php\php5apache2.dll
372 AddType application/x-httpd-php .php
373 DirectoryIndex index.html index.htm index.php</KBD
374 ></PRE
375 ></LI
376 ></OL
377 ><P
378 ></P
379 ><P
380 ><B
381 >Configure the Webserver (IIS)</B
382 ></P
383 ><OL
384 TYPE="1"
385 ><LI
386 ><P
387 >                                       Start the Internet Information Services (IIS) Manager, right click on the <SPAN
388 CLASS="GUILABEL"
389 >Default Web Site</SPAN
390 > (in most cases) and select <SPAN
391 CLASS="GUILABEL"
392 >Properties</SPAN
393 >.
394                                 </P
395 ></LI
396 ><LI
397 ><P
398 >                                       Under the <SPAN
399 CLASS="GUILABEL"
400 >Home Directory</SPAN
401 > tab, select <SPAN
402 CLASS="GUILABEL"
403 >Configuration</SPAN
404 >
405                                         and click <SPAN
406 CLASS="GUILABEL"
407 >Add</SPAN
408 >. Browse to the path of <TT
409 CLASS="FILENAME"
410 >php4isapi.dll</TT
411 > or
412                                         <TT
413 CLASS="FILENAME"
414 >php5isapi.dll</TT
415 >, and type in .php as the extension.  Note: if using IIS6,
416                                         Enable All Verbs and Script Engine.
417                                 </P
418 ></LI
419 ><LI
420 ><P
421 >                                       Under the <SPAN
422 CLASS="GUILABEL"
423 >ISAPI Filters</SPAN
424 > tab, click <SPAN
425 CLASS="GUILABEL"
426 >Add</SPAN
427 > and browse
428                                         to the <TT
429 CLASS="FILENAME"
430 >php4isapi.dll</TT
431 > or <TT
432 CLASS="FILENAME"
433 >php5isapi.dll</TT
434 > file. Name the filter
435                                         "php" and click OK.
436                                 </P
437 ></LI
438 ><LI
439 ><P
440 >                                       Under the <SPAN
441 CLASS="GUILABEL"
442 >Documents</SPAN
443 > tab, add <TT
444 CLASS="FILENAME"
445 >index.php</TT
446 > to the list.
447                                 </P
448 ></LI
449 ><LI
450 ><P
451 >                                       If using IIS6, goto <SPAN
452 CLASS="GUILABEL"
453 >Web Service Extensions</SPAN
454 > and add a new Web Service Extension.
455                                         Name the extension "php", and click <SPAN
456 CLASS="GUILABEL"
457 >Add</SPAN
458 > and browse to the <TT
459 CLASS="FILENAME"
460 >php4isapi.dll</TT
461 >
462                                         or <TT
463 CLASS="FILENAME"
464 >php5isapi.dll</TT
465 > file, enable <SPAN
466 CLASS="GUILABEL"
467 >Set Extension</SPAN
468 > status to Enable, and click OK.
469                                 </P
470 ></LI
471 ><LI
472 ><P
473 >                                       Give the IUSR_XXXX and IIS_WPG users read &#38; execute permissions to the file <TT
474 CLASS="FILENAME"
475 >%windir%\system32\cmd.exe</TT
476 >.
477                                         They will also need read permissions on <TT
478 CLASS="FILENAME"
479 >cacti_web_root/cacti</TT
480 > and it's subfolders.
481                                 </P
482 ></LI
483 ><LI
484 ><P
485 >                                       If using IIS6, give the IIS_WPG user modify permissions to the folders <TT
486 CLASS="FILENAME"
487 >cacti_web_root/cacti/log</TT
488 >
489                                         and <TT
490 CLASS="FILENAME"
491 >cacti_web_root/cacti/rrd</TT
492 >.
493                                 </P
494 ></LI
495 ><LI
496 ><P
497 >                                       Completely stop and start the IIS service using the following commands:
498                                 </P
499 ><PRE
500 CLASS="SCREEN"
501 ><KBD
502 CLASS="USERINPUT"
503 >net stop iisadmin
504 net start w3svc</KBD
505 ></PRE
506 ></LI
507 ></OL
508 ><P
509 ></P
510 ><P
511 ><B
512 >Install Cygwin (optional)</B
513 ></P
514 ><OL
515 TYPE="1"
516 ><LI
517 ><P
518 >                                       Installing a single instance of Cygwin, and using it for all applications that require it is
519                                         recommended so you do not have different versions of the Cygwin dlls laying around on your system,
520                                         which can cause conflicts.
521                                 </P
522 ></LI
523 ><LI
524 ><P
525 >                                       Run <TT
526 CLASS="FILENAME"
527 >setup.exe</TT
528 > you previously download.
529                                 </P
530 ></LI
531 ><LI
532 ><P
533 >                                       Once you reach the portion of setup entitled Select Packages, install the following:
534                                 </P
535 ><PRE
536 CLASS="SCREEN"
537 ><KBD
538 CLASS="USERINPUT"
539 >Base (include all items)
540 Libs
541         libart_lgpl
542         libfreetype26
543         libpng12
544         zlib
545         openssl
546 Utils
547         patch
548 Web
549         wget</KBD
550 ></PRE
551 ></LI
552 ><LI
553 ><P
554 >                                       Add <TT
555 CLASS="FILENAME"
556 >c:\cygwin\bin</TT
557 > to your Windows System PATH environment variable.
558                                 </P
559 ></LI
560 ><LI
561 ><P
562 >                                       Move <TT
563 CLASS="FILENAME"
564 >setup.exe</TT
565 > to <TT
566 CLASS="FILENAME"
567 >c:\cygwin</TT
568 > for future use.
569                                 </P
570 ></LI
571 ></OL
572 ><P
573 ></P
574 ><P
575 ><B
576 >Install RRDTool</B
577 ></P
578 ><OL
579 TYPE="1"
580 ><LI
581 ><P
582 >                                       Extract the RRDTool zip file from the Cacti web site to <TT
583 CLASS="FILENAME"
584 >c:\cacti\rrdtool.exe</TT
585 >.
586                                 </P
587 ></LI
588 ></OL
589 ><P
590 ></P
591 ><P
592 ><B
593 >Install MySQL</B
594 ></P
595 ><OL
596 TYPE="1"
597 ><LI
598 ><P
599 >                                       Extract the MySQL zip file to a temp directory and run <TT
600 CLASS="FILENAME"
601 >setup.exe</TT
602 >.
603                                 </P
604 ></LI
605 ><LI
606 ><P
607 >                                       Install MySQL to the default directory, or for the purposes of this manual to the <TT
608 CLASS="FILENAME"
609 >c:\mysql</TT
610 > directory.
611                                 </P
612 ></LI
613 ><LI
614 ><P
615 >                                       If running an older version of MySQL, start it by running <TT
616 CLASS="FILENAME"
617 >c:\mysql\bin\winmysqladmin.exe</TT
618 >.
619                                         In more recent versions, this is not required.
620                                 </P
621 ></LI
622 ><LI
623 ><P
624 >                                       Set a password for the root user
625                                 </P
626 ><PRE
627 CLASS="SCREEN"
628 ><SAMP
629 CLASS="PROMPT"
630 >shell&gt;</SAMP
631 > <KBD
632 CLASS="USERINPUT"
633 >cd mysql\bin</KBD
634 >
635 <SAMP
636 CLASS="PROMPT"
637 >shell&gt;</SAMP
638 > <KBD
639 CLASS="USERINPUT"
640 >mysqladmin --user=root password somepassword</KBD
641 >
642 <SAMP
643 CLASS="PROMPT"
644 >shell&gt;</SAMP
645 > <KBD
646 CLASS="USERINPUT"
647 >mysqladmin --user=root --password reload</KBD
648 ></PRE
649 ></LI
650 ><LI
651 ><P
652 >                                       Create the MySQL database:
653                                 </P
654 ><PRE
655 CLASS="SCREEN"
656 ><SAMP
657 CLASS="PROMPT"
658 >shell&gt;</SAMP
659 > <KBD
660 CLASS="USERINPUT"
661 >mysqladmin --user=root --password create cacti</KBD
662 ></PRE
663 ></LI
664 ><LI
665 ><P
666 >                                       Import the default Cacti database:
667                                 </P
668 ><PRE
669 CLASS="SCREEN"
670 ><SAMP
671 CLASS="PROMPT"
672 >shell&gt;</SAMP
673 > <KBD
674 CLASS="USERINPUT"
675 >mysql --user=root --password cacti &lt; c:\apache2\htdocs\cacti\cacti.sql</KBD
676 ></PRE
677 ></LI
678 ><LI
679 ><P
680 >                                       Create a MySQL username and password for Cacti.
681                                 </P
682 ><PRE
683 CLASS="SCREEN"
684 ><SAMP
685 CLASS="PROMPT"
686 >shell&gt;</SAMP
687 > <KBD
688 CLASS="USERINPUT"
689 >mysql --user=root --password mysql</KBD
690 >
691 <SAMP
692 CLASS="PROMPT"
693 >mysql&gt;</SAMP
694 > <KBD
695 CLASS="USERINPUT"
696 >GRANT ALL ON cacti.* TO cactiuser@localhost IDENTIFIED BY 'somepassword';</KBD
697 >
698 <SAMP
699 CLASS="PROMPT"
700 >mysql&gt;</SAMP
701 > <KBD
702 CLASS="USERINPUT"
703 >flush privileges;</KBD
704 ></PRE
705 ></LI
706 ><LI
707 ><P
708 >                                       If you are running MySQl 4.1 and above, you will need to apply the old password setting in order
709                                         to authenticate with Cacti.  To make this change, stop the MySQL service and add the following to
710                                         the Start Parameter field.  Start it again once it has been added.
711                                 </P
712 ><PRE
713 CLASS="SCREEN"
714 ><KBD
715 CLASS="USERINPUT"
716 >--old-password</KBD
717 ></PRE
718 ><P
719 >                                       You will also need to update the cactiuser account with the old password style.
720                                 </P
721 ><PRE
722 CLASS="SCREEN"
723 ><SAMP
724 CLASS="PROMPT"
725 >shell&gt;</SAMP
726 > <KBD
727 CLASS="USERINPUT"
728 >UPDATE mysql.user SET Password = OLD_PASSWORD('cactipwd')
729                                 WHERE Host = 'localhost' AND User = 'cactiuser';</KBD
730 >
731 <SAMP
732 CLASS="PROMPT"
733 >mysql&gt;</SAMP
734 > <KBD
735 CLASS="USERINPUT"
736 >FLUSH PRIVILEGES;</KBD
737 ></PRE
738 ></LI
739 ></OL
740 ><P
741 ></P
742 ><P
743 ><B
744 >Install Net-SNMP</B
745 ></P
746 ><OL
747 TYPE="1"
748 ><LI
749 ><P
750 >                                       If you plan to use any hosts with SNMP v2c support, and are using early versions of PHP, you must
751                                         download and install the <SPAN
752 CLASS="APPLICATION"
753 >Net-SNMP</SPAN
754 > libraries.  <SPAN
755 CLASS="APPLICATION"
756 >Net-SNMP</SPAN
757 >
758                                         provides installers     to install their product.  However, caution must be taken if you choose to use
759                                         long file names as Cacti does not them as long file names.  You will have to user 8.3 notation.  For
760                                         example <TT
761 CLASS="FILENAME"
762 >c:\Program Files\Net-SNMP\bin</TT
763 > becomes <TT
764 CLASS="FILENAME"
765 >c:\progra~1\net-snmp\bin</TT
766 >.
767                                 </P
768 ></LI
769 ></OL
770 ><P
771 ></P
772 ><P
773 ><B
774 >Install <SPAN
775 CLASS="APPLICATION"
776 >Spine</SPAN
777 ></B
778 ></P
779 ><OL
780 TYPE="1"
781 ><LI
782 ><P
783 >                                       Extract the <SPAN
784 CLASS="APPLICATION"
785 >Spine</SPAN
786 > zip file to <TT
787 CLASS="FILENAME"
788 >c:\cacti</TT
789 > and modify the <TT
790 CLASS="FILENAME"
791 >spine.conf.dist</TT
792 > file to
793                                         include the following statements.
794                                 </P
795 ><PRE
796 CLASS="SCREEN"
797 ><KBD
798 CLASS="USERINPUT"
799 >DB_Host        127.0.0.1 or hostname (not localhost)
800 DB_Database     cacti
801 DB_User         cactiuser
802 DB_Password     cacti
803 DB_Port         3306</KBD
804 ></PRE
805 ><P
806 >                                       All other pre 0.8.6 settings are obsolete.
807                                 </P
808 ></LI
809 ><LI
810 ><P
811 >                                       <SPAN
812 CLASS="APPLICATION"
813 >Spine</SPAN
814 > now comes with a binary distribution.  However, we strongly suggest that you install
815                                         Cygwin and then remove all the DLL files and <TT
816 CLASS="FILENAME"
817 >sh.exe</TT
818 > from the
819                                         <TT
820 CLASS="FILENAME"
821 >c:\cacti</TT
822 > directory.
823                                 </P
824 ></LI
825 ></OL
826 ><P
827 ></P
828 ><P
829 ><B
830 >Configure Cacti</B
831 ></P
832 ><OL
833 TYPE="1"
834 ><LI
835 ><P
836 >                                       Edit <TT
837 CLASS="FILENAME"
838 >cacti_web_root/cacti/include/config.php</TT
839 > and specify the MySQL user,
840                                         password, database, and database port for your Cacti configuration.
841                                 </P
842 ><PRE
843 CLASS="SCREEN"
844 ><KBD
845 CLASS="USERINPUT"
846 >$database_default = "cacti";
847 $database_hostname = "localhost";
848 $database_username = "cactiuser";
849 $database_password = "cacti";
850 $database_port = "3306";</KBD
851 ></PRE
852 ></LI
853 ><LI
854 ><P
855 >                                       Point your web browser to:
856                                 </P
857 ><PRE
858 CLASS="SCREEN"
859 >http://your-server/cacti/</PRE
860 ><P
861 >                                       Log in using the username and password of admin/admin.  You will be required to change this
862                                         password immediately.
863                                 </P
864 ></LI
865 ><LI
866 ><P
867 >                                       From Cacti, go to <SPAN
868 CLASS="GUILABEL"
869 >Settings</SPAN
870 >-&gt;<SPAN
871 CLASS="GUILABEL"
872 >Paths</SPAN
873 > and verify/udate
874                                         your paths to point to the correct locations.  Recommended examples are posted below.  If you
875                                         plan on using <SPAN
876 CLASS="APPLICATION"
877 >Spine</SPAN
878 >, then it is very important that all paths include forward slashes instead
879                                         of backslashes.
880                                 </P
881 ><P
882 >                               <B
883 CLASS="EMPHASIS"
884 >PHP Binary Path:</B
885 >
886                                 </P
887 ><PRE
888 CLASS="SCREEN"
889 >c:/php/php.exe</PRE
890 ><P
891 >                                       <B
892 CLASS="EMPHASIS"
893 >RRDTool Binary Path:</B
894 >
895                                 </P
896 ><PRE
897 CLASS="SCREEN"
898 >c:/cacti/rrdtool.exe</PRE
899 ><P
900 >                                       <B
901 CLASS="EMPHASIS"
902 >SNMPGET, SNMPWALK, SNMPBULKWALK, SNMPGETNEXT Paths:</B
903 >
904                                 </P
905 ><PRE
906 CLASS="SCREEN"
907 >c:/progra~1/net-snmp/bin/snmpget.exe</PRE
908 ><PRE
909 CLASS="SCREEN"
910 >c:/progra~1/net-snmp/bin/snmpwalk.exe</PRE
911 ><PRE
912 CLASS="SCREEN"
913 >c:/progra~1/net-snmp/bin/snmpbulkwalk.exe</PRE
914 ><PRE
915 CLASS="SCREEN"
916 >c:/progra~1/net-snmp/bin/snmpgetnext.exe</PRE
917 ><P
918 >                                       <B
919 CLASS="EMPHASIS"
920 >Cacti Logfile Path:</B
921 >
922                                 </P
923 ><PRE
924 CLASS="SCREEN"
925 >c:/mycacti/website/cacti/log/cacti.log</PRE
926 ><P
927 >                                       <B
928 CLASS="EMPHASIS"
929 ><SPAN
930 CLASS="APPLICATION"
931 >Spine</SPAN
932 > Path:</B
933 >
934                                 </P
935 ><PRE
936 CLASS="SCREEN"
937 >c:/cacti/<SPAN
938 CLASS="APPLICATION"
939 >Spine</SPAN
940 >.exe</PRE
941 ></LI
942 ><LI
943 ><P
944 >                                       Click on Devices.  Delete the Localhost devices as it intended for Linux environments  In the upper
945                                         right corner, click Add.  Fill in the following information and then click Add.
946                                 </P
947 ><PRE
948 CLASS="SCREEN"
949 ><KBD
950 CLASS="USERINPUT"
951 >Description: My Windows localhost
952 Hostname: localhost
953 Host Template: Windows 2000/XP</KBD
954 ></PRE
955 ></LI
956 ><LI
957 ><P
958 >                                       You should now be looking at the localhost device screen.  Right under it's name, there should be
959                                         some SNMP information listed, if not you should double check the SNMP settings on the server and
960                                         firewall settings.  In the upper right-hand corner, click on Create Graphs for this Host. On the
961                                         following screen, select a disk partition and network interface.  At the bottom of the page,
962                                         click on Create.
963                                 </P
964 ></LI
965 ><LI
966 ><P
967 >                    Log into the user account you'll be using  for the scheduled task and  verify starting a Cacti
968                                         polling cycle works.  Do this by running the following from the command prompt:
969                                 </P
970 ><PRE
971 CLASS="SCREEN"
972 ><KBD
973 CLASS="USERINPUT"
974 >php c:/cacti_web_root/cacti/poller.php</KBD
975 ></PRE
976 ><P
977 >                                       The output should look something like the following:
978                                 </P
979 ><PRE
980 CLASS="SCREEN"
981 ><KBD
982 CLASS="USERINPUT"
983 >C:\&#62;php c:\inetpub\wwwroot\cacti\poller.php
984 OK u:0.00 s:0.06 r:1.32
985 OK u:0.00 s:0.06 r:1.32
986 OK u:0.00 s:0.16 r:2.59
987 OK u:0.00 s:0.17 r:2.62
988 10/28/2005 04:57:12 PM - SYSTEM STATS: Time:4.7272 Method:cmd.php Processes:1 Threads:N/A Hosts:1 HostsPerProcess:2 DataSources:4 RRDsProcessed:2</KBD
989 ></PRE
990 ><P
991 >                                       After this has ran once, you should have <TT
992 CLASS="FILENAME"
993 >cacti.log</TT
994 > in <TT
995 CLASS="FILENAME"
996 >/cacti/log/</TT
997 >
998                                         and rrd files in /cacti/rra/.
999                                 </P
1000 ></LI
1001 ><LI
1002 ><P
1003 >                                       You are going to need to schedule a task while logged on as an Administrator.  This task is
1004                                         required to you can run <TT
1005 CLASS="FILENAME"
1006 >poller.php</TT
1007 > every 5 minutes. Make sure the
1008                                         Task Scheduler service is started and follow the steps below to begin.
1009                                 </P
1010 ><P
1011 >                                       <B
1012 CLASS="EMPHASIS"
1013 >Note:</B
1014 > The following instructions are based on Windows XP and Windows Server
1015                                         2003. You should be able to follow these instructions close enough for Windows 2000 as well.
1016                                 </P
1017 ><P
1018 ></P
1019 ><OL
1020 TYPE="a"
1021 ><LI
1022 ><P
1023 >                                                       Select <SPAN
1024 CLASS="GUILABEL"
1025 >Start</SPAN
1026 > --&#62; <SPAN
1027 CLASS="GUILABEL"
1028 >Settings</SPAN
1029 > --&#62; <SPAN
1030 CLASS="GUILABEL"
1031 >Control Panel</SPAN
1032 > and double
1033                                                         click on  <SPAN
1034 CLASS="GUILABEL"
1035 >Scheduled Tasks</SPAN
1036 >.
1037                                                 </P
1038 ></LI
1039 ><LI
1040 ><P
1041 >                                                       Double click on <SPAN
1042 CLASS="GUILABEL"
1043 >Add Scheduled Task</SPAN
1044 >.
1045                                                 </P
1046 ></LI
1047 ><LI
1048 ><P
1049 >                                                       Click <SPAN
1050 CLASS="GUILABEL"
1051 >Next</SPAN
1052 > and <SPAN
1053 CLASS="GUILABEL"
1054 >Browse</SPAN
1055 > on the following screen. Find <TT
1056 CLASS="FILENAME"
1057 >c:\php</TT
1058 > and select
1059                                                         <TT
1060 CLASS="FILENAME"
1061 >php.exe</TT
1062 >.  Choose <SPAN
1063 CLASS="GUILABEL"
1064 >Daily</SPAN
1065 > on and click <SPAN
1066 CLASS="GUILABEL"
1067 >Next</SPAN
1068 >.
1069                                                 </P
1070 ></LI
1071 ><LI
1072 ><P
1073 >                                                       Click <SPAN
1074 CLASS="GUILABEL"
1075 >Next</SPAN
1076 > again without changing the time or date settings.
1077                                                 </P
1078 ></LI
1079 ><LI
1080 ><P
1081 >                                                       When entering a username and password make sure the user has read and write access to the following directories:
1082                                                 </P
1083 ><PRE
1084 CLASS="SCREEN"
1085 ><KBD
1086 CLASS="USERINPUT"
1087 >cacti_web_root/cacti/rra
1088 cacti_web_root/log</KBD
1089 ></PRE
1090 ><P
1091 >                                                       Make sure the user has read, write, and execute access to the following directories:
1092                                                 </P
1093 ><PRE
1094 CLASS="SCREEN"
1095 ><KBD
1096 CLASS="USERINPUT"
1097 >c:\php
1098 c:\php\sapi</KBD
1099 ></PRE
1100 ></LI
1101 ><LI
1102 ><P
1103 >                                                       Click <SPAN
1104 CLASS="GUILABEL"
1105 >Next</SPAN
1106 > and <SPAN
1107 CLASS="GUILABEL"
1108 >Finish</SPAN
1109 > to close the wizard.
1110                                                 </P
1111 ></LI
1112 ><LI
1113 ><P
1114 >                                                       Right click on the task you just created, and select <SPAN
1115 CLASS="GUILABEL"
1116 >Properties</SPAN
1117 >.
1118                                                 </P
1119 ></LI
1120 ><LI
1121 ><P
1122 >                                                       Select the <SPAN
1123 CLASS="GUILABEL"
1124 >Schedule</SPAN
1125 > tab.
1126                                                 </P
1127 ></LI
1128 ><LI
1129 ><P
1130 >                                                       Make sure <SPAN
1131 CLASS="GUILABEL"
1132 >Daily</SPAN
1133 > is selected and click the <SPAN
1134 CLASS="GUILABEL"
1135 >Advanced</SPAN
1136 > button.
1137                                                 </P
1138 ></LI
1139 ><LI
1140 ><P
1141 >                                                       Check the <SPAN
1142 CLASS="GUILABEL"
1143 >Repeat</SPAN
1144 > checkbox, set it for 5 minutes and set the duration for 24 hours.
1145                                                 </P
1146 ></LI
1147 ><LI
1148 ><P
1149 >                                                       Click <SPAN
1150 CLASS="GUILABEL"
1151 >Ok</SPAN
1152 >
1153                                                 </P
1154 ></LI
1155 ><LI
1156 ><P
1157 >                                                       In the <SPAN
1158 CLASS="GUILABEL"
1159 >Run</SPAN
1160 > textbox enter the following text making sure to use the appropriate paths.
1161                                                 </P
1162 ><PRE
1163 CLASS="SCREEN"
1164 >c:\php\php.exe c:\mycacti\website\cacti\poller.php</PRE
1165 ><P
1166 >                                                       The start in box should say <TT
1167 CLASS="FILENAME"
1168 >c:\mycacti\website\cacti</TT
1169 >.
1170                                                 </P
1171 ></LI
1172 ></OL
1173 ></LI
1174 ></OL
1175 ><P
1176 ></P
1177 ><P
1178 ><B
1179 >Apply Patches</B
1180 ></P
1181 ><OL
1182 TYPE="1"
1183 ><LI
1184 ><P
1185 >                                       There are two methods of applying patches to Cacti:
1186                                 </P
1187 ><P
1188 ></P
1189 ><OL
1190 TYPE="a"
1191 ><LI
1192 ><P
1193 >                                                       If you have Cygwin installed, then the patch instructions which use wget and patch, will work.
1194                                                 </P
1195 ></LI
1196 ><LI
1197 ><P
1198 >                                                       The other method requires you to visit http://www.cacti.net/downloads/patches/0.8.6h/pre-patched/
1199                                                         and manually download and replace the patched files.
1200                                                 </P
1201 ></LI
1202 ></OL
1203 ></LI
1204 ><LI
1205 ><P
1206 >                                       You might need to reapply file/folder security on the files patched. Double check they are correct.
1207                                 </P
1208 ></LI
1209 ></OL
1210 ></DIV
1211 ><DIV
1212 CLASS="NAVFOOTER"
1213 ><HR
1214 ALIGN="LEFT"
1215 WIDTH="100%"><TABLE
1216 SUMMARY="Footer navigation table"
1217 WIDTH="100%"
1218 BORDER="0"
1219 CELLPADDING="0"
1220 CELLSPACING="0"
1221 ><TR
1222 ><TD
1223 WIDTH="33%"
1224 ALIGN="left"
1225 VALIGN="top"
1226 ><A
1227 HREF="unix_apply_patches.html"
1228 ACCESSKEY="P"
1229 >Prev</A
1230 ></TD
1231 ><TD
1232 WIDTH="34%"
1233 ALIGN="center"
1234 VALIGN="top"
1235 ><A
1236 HREF="index.html"
1237 ACCESSKEY="H"
1238 >Home</A
1239 ></TD
1240 ><TD
1241 WIDTH="33%"
1242 ALIGN="right"
1243 VALIGN="top"
1244 ><A
1245 HREF="upgrade.html"
1246 ACCESSKEY="N"
1247 >Next</A
1248 ></TD
1249 ></TR
1250 ><TR
1251 ><TD
1252 WIDTH="33%"
1253 ALIGN="left"
1254 VALIGN="top"
1255 >Apply Patches</TD
1256 ><TD
1257 WIDTH="34%"
1258 ALIGN="center"
1259 VALIGN="top"
1260 ><A
1261 HREF="installation.html"
1262 ACCESSKEY="U"
1263 >Up</A
1264 ></TD
1265 ><TD
1266 WIDTH="33%"
1267 ALIGN="right"
1268 VALIGN="top"
1269 >Upgrading Cacti</TD
1270 ></TR
1271 ></TABLE
1272 ></DIV
1273 ></BODY
1274 ></HTML
1275 >