====== Compiling/Installing LSMCD ======
LiteSpeed Memcached (“LSMCD”) is LiteSpeed's persistent memcache-compatible cache daemon. It’s performance and interface are similar to the popular Memcached, with the addition of high-availability replication. In LSMCD, cache data is persistent on both single and multiple box setups -- preserving all cache data through updates and instances of server failure.

===== Requirements =====
There are certain package requirements to compile and install LSMCD. LSMCD relies on these packages to work properly. The required packages differ slightly between distributions. 

==== CentOS/RHEL ====
Run the following commands from an elevated shell terminal:
<code>
yum groupinstall "Development Tools"
yum install autoconf automake zlib-devel openssl-devel expat-devel pcre-devel libmemcached-devel cyrus-sasl*
</code>

==== Debian/Ubuntu ====
Run the following commands from an elevated shell terminal:
<code>
sudo apt-get install git build-essential zlib1g-dev libexpat1-dev openssl libssl-dev libsasl2-dev libpcre3-dev -y
</code>

===== Download =====
There are multiple ways to download LSMCD. Here a few options:
  * Git: ''git clone https://github.com/litespeedtech/lsmcd.git''
  * Wget: ''wget https://github.com/litespeedtech/lsmcd/archive/master.zip''
  * Curl: ''curl -O https://github.com/litespeedtech/lsmcd/archive/master.zip''
**Note** If using ''wget'' or ''curl'', be sure to extract the archive with the following command: ''unzip master.zip''

===== Compile =====
To compile LSMCD, run the following commands from an elevated shell terminal:
<code>
cd lsmcd
./fixtimestamp.sh
./configure CFLAGS=" -O3" CXXFLAGS=" -O3"
make
</code>

LSMCD should now be built. If there were any errors please double check that all package requirements were installed. If package requirements were not the issue, please post on our forums for further assistance.

===== Install=====
To install LSMCD after it has been compiled, run the following commands from the same elevated shell terminal:
====Centos / RHEL====
<code>
sudo make install
</code>
====Debian/Ubuntu====
<code>
sudo make install
sudo chown -R username /usr/local/lsmcd</code>


LSMCD should now be installed. 

Now you will have to edit ''/usr/local/lsmcd/conf/node.conf'' to correctly set the IP address to bind.

This is the example conf file for 127.0.0.1:11211 which is included in the release:

<code>Repl.HeartBeatReq=30
Repl.HeartBeatRetry=3000
Repl.MaxTidPacket=2048000
Repl.GzipStream=YES
Repl.LbAddrs=127.0.0.1:12340
Repl.ListenSvrAddr=127.0.0.1:12340
REPL.DispatchAddr=127.0.0.1:5501
RepldSockPath=/tmp/repld.usock
CACHED.PRIADDR=127.0.0.1:11000

CACHED.ADDR=127.0.0.1:11211
#CACHED.ADDR=UDS:///tmp/lsmcd.sock
#default is 8, it can be bigger depending on cache data amount
Cached.Slices=8
Cached.Slice.Priority.0=100
Cached.Slice.Priority.1=100
Cached.Slice.Priority.2=100
Cached.Slice.Priority.3=100
Cached.Slice.Priority.4=100
Cached.Slice.Priority.5=100
Cached.Slice.Priority.6=100
Cached.Slice.Priority.7=100

Cached.ShmDir=/dev/shm/lsmcd
#If you change the UseSasl or DataByUser configuration options you need to remove the ShmDir folder and contents.
#Cached.UseSasl=true
#Cached.DataByUser=true
#Cached.Anonymous=false
#Cached.UserSize=1000
#Cached.HashSize=500000
#CACHED.MEMMAXSZ=0
#CACHED.NOMEMFAIL=false

##this is the global setting, no need to have per slice configuration. 
User=nobody
Group=nobody
#depends CPU core
CachedProcCnt=4
CachedSockPath=/tmp/cached.usock.
#TmpDir=/tmp/lsmcd
LogLevel=notice
#LogLevel=dbg_medium
LogFile=/tmp/lsmcd.log</code>


If you wish to use SASL, remove the '#' comment from the line ''#Cached.UseSasl=true''
===== Start =====
There are various different ways to start/stop LSMCD. Here are just a few ways.
==== Systemd ====
<code>
systemctl start lsmcd
systemctl stop lsmcd
systemctl enable lsmcd
systemctl disable lsmcd
</code>
==== init.d ====
<code>
service lsmcd start
service lsmcd stop
chkconfig lsmcd on
chkconfig lsmcd off
</code>
==== Manual ====
<code>
/usr/local/lsmcd/bin/lsmcdctrl start
/usr/local/lsmcd/bin/lsmcdctrl stop
</code>
===== Test =====
A quick way to test if LSMCD is running is to run the following from shell:
<code>
telnet 127.0.0.1 11211
</code>

Be sure to look into [[litespeed_wiki:lsmcd:configuration|configuring it]] next!