Skip to content

Commit fa92e80

Browse files
docs: fix harmful FAQ password reset and removed PHP/MySQL features
Refs #213 Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
1 parent ed4c330 commit fa92e80

2 files changed

Lines changed: 24 additions & 32 deletions

File tree

Frequently-Asked-Questions.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -68,18 +68,17 @@ installation documents included that may also help.
6868

6969
**Q:** I have forgotten my 'admin' password to Cacti, how do I reset it?
7070

71-
**A:** To reset the admin account password back to the default of 'admin',
72-
connect to your Cacti database at the command line.
71+
**A:** Use the built-in CLI password reset tool. Run the following from your
72+
Cacti root directory as the web server user (e.g. `www-data` on Debian/Ubuntu,
73+
`apache` on RHEL/Rocky):
7374

74-
```sql
75-
shell> mysql -u root -p cacti
75+
```console
76+
php cli/change_password.php --user=admin --password=admin
7677
```
7778

78-
Now execute the following SQL:
79-
80-
```sql
81-
MySQL> update user_auth set password=md5('admin') where username='admin';
82-
```
79+
> **Warning:** Do not use direct SQL `md5()` updates. Cacti 1.x stores
80+
> passwords with bcrypt/phpass. Setting an MD5 hash via SQL will lock the
81+
> account — the login will fail even with the correct password.
8382
8483
## Monitoring
8584

@@ -244,9 +243,8 @@ change between the new small counter value and the large previous value. One way
244243
to combat this issue is to specify realistic maximum values for your data
245244
sources. RRDtool will ignore any value that is larger than the maximum value.
246245

247-
If you already have a spike on one or more of your graphs, there is a really
248-
[useful Perl script](http://cricket.sourceforge.net/contrib/files/killspike2)
249-
that will remove them for you.
246+
If you already have a spike on one or more of your graphs, Cacti includes a
247+
built-in Spikekill utility. See [Spikekill](Spikekill.md) for usage.
250248

251249
---
252250

Installing-Under-Windows.md

Lines changed: 14 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -47,17 +47,13 @@ Cacti yourself, please follow the instructions below.
4747
sort_buffer_size = 200M # Adjust for your OS memory size
4848
4949
# important for compatibility
50-
sql_mode=NO_ENGINE_SUBSTITUTION,NO_AUTO_CREATE_USER
50+
sql_mode=NO_ENGINE_SUBSTITUTION
5151
5252
innodb_flush_log_at_trx_commit = 2
5353
innodb_flush_log_at_timeout = 3
5454
innodb_file_per_table = ON
5555
5656
innodb_buffer_pool_size = 4500M # Adjust for your OS memory size
57-
58-
# for very large indexes
59-
innodb_file_format = Barracuda
60-
innodb_large_prefix = 1
6157
6258
# for SSD's on a 64 core server
6359
innodb_doublewrite = OFF
@@ -105,7 +101,8 @@ The following changes will be required regardless of your selected Webserver.
105101

106102
```ini
107103
extension_dir = c:\php\ext
108-
extension=php_mysql.dll
104+
extension=php_mysqli.dll
105+
extension=php_pdo_mysql.dll
109106
extension=php_snmp.dll
110107
extension=php_sockets.dll
111108
cgi.force_redirect = 0
@@ -147,24 +144,21 @@ The following changes will be required regardless of your selected Webserver.
147144

148145
## IIS Specific Steps
149146

150-
1. Start the Internet Information Services (IIS) Manager, right click on the
151-
Default Web Site (in most cases) and select Properties.
147+
> **Note:** PHP 8 does not provide an ISAPI module (`php8isapi.dll` does not
148+
> exist). Use PHP with IIS via **FastCGI** instead, which is the recommended
149+
> and supported method for PHP 7+ on IIS.
152150
153-
2. Under the Home Directory tab, select Configuration and click Add. Browse to
154-
the path of `php8isapi.dll`, and type in .php as the
155-
extension. Note: if using IIS6, Enable All Verbs and Script Engine.
151+
1. In IIS Manager, install the **CGI** role service if not already present.
156152

157-
3. Under the ISAPI Filters tab, click Add and browse to the `php8isapi.dll`
158-
file. Name the filter "php" and click OK.
153+
2. Add a FastCGI application: open **FastCGI Settings**, click **Add
154+
Application**, and set the full path to `c:\php\php-cgi.exe`.
159155

160-
5. Under the Documents tab, add `index.php` to the list.
156+
3. Add a Handler Mapping for `.php` extension pointing to `php-cgi.exe` using
157+
the FastCGI module.
161158

162-
6. If using IIS6, goto Web Service Extensions and add a new Web Service
163-
Extension. Name the extension "php", and click Add and browse to the
164-
`php8isapi.dll` file, enable Set Extension status to
165-
Enable, and click OK.
159+
4. Under the Documents tab, add `index.php` to the list.
166160

167-
7. Give the IIS user read & execute permissions to the required files
161+
5. Give the IIS user read & execute permissions to the required files
168162
file `%windir%\system32\cmd.exe`. They will also need read permissions on
169163
`cacti_web_root/cacti` and it's subfolders.
170164
A anm example provided by one user included the following assuming the
@@ -183,7 +177,7 @@ The following changes will be required regardless of your selected Webserver.
183177
icacls "C:\inetpub\wwwroot\cacti\include\vendor\csrf\csrf-secret.php" /grant "IUSR:(RX,W)"
184178
```
185179

186-
8. Completely stop and start the IIS service using the following commands:
180+
6. Completely stop and start the IIS service using the following commands:
187181

188182
```batchfile
189183
net stop iisadmin

0 commit comments

Comments
 (0)