wiki:InstallAdministration

Version 3 (modified by moo, 7 years ago) (diff)

--

How to Install XCache Administration Page

XCache Administration Page (referenced as admin-page below) is an important web interface that you can monitor and operate your opcode cache, seeing how well(or bad) it goes.

Installing XCache

Before you can use admin-page, XCache must be installed as either extension or zend_extension in php.

See: InstallFromSource or InstallFromBinary, and PhpIni

Generating your auth password

Admin-page is protected by http-auth, it is disabled if you haven't yet set a password. The user/pass of http-auth can be set in php.ini (see PhpIni). But you have to md5(your password) first.

setup a php page with webserver

<?php
echo md5("password");
?>

request it from browser and get 5f4dcc3b5aa765d61d8327deb882cf99. So update php.ini:

xcache.admin.user = "mOo"
xcache.admin.pass = "5f4dcc3b5aa765d61d8327deb882cf99"

This is an example only. Use your own password to get your own md5 string.

Setting up web interface

The fastest and simplest way to do so is copying your xcache/admin/ (the whole directory) to your web document-root or sub-directory of it.

Request it from your browser, a http-auth prompt will popup. Fill your user/pass in, and it's done.

If you're installing XCache with os distro package manager, rpm/apt-get/emerge etc, you might want to do a "alias" in webserver instead of copying the scripts, to stay admin-page up to date when the package is updated.

Lighttpd setting (for example only):

alias.url += ("/xcache-admin/" => "/usr/share/xcache/admin/")

Note: check open_basedir (if enabled) against /usr/share/xcache/

Customizing your config.php

Copy config.php.example to config.php, read the inline comments. It's quite simple.