Installation‎ > ‎

Memcached

SSD was built to utilize memcached as a caching engine.  The default configuration for memcached is already contained in /opt/ssd-local/local_settings.py but it is not activated.  The default SSD configuration in /opt/ssd-local/local_settings.py is as follows:

# -- MEMCACHED CONFIGURATION  -- #
# Uncomment and set the location to your server(s) and port(s)
# Do not change the KEY_PREFIX
"""
CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
        'LOCATION': [
            'localhost:11211'
        ],
        'TIMEOUT': 300,
        'KEY_PREFIX':'ssd'

    }
}
"""

# -- SESSION CACHE
# If you have memcache installed/configured, then you can use a write-through cache
# to store session information.  If you'd rather not use the write-through cache and
# just want to use memcache then set SESSION_ENGINE to 'django.contrib.sessions.backends.cache'
# Keep in mind that sessions could be evicted or you could lose your session store if memcached
# is restarted.
# SESSION_ENGINE = 'django.contrib.sessions.backends.cached_db'

This configuration assumes you are running SSD on a single server and memcached is installed locally.  In this case, simply remove the triple quotes (""") above CACHES and below the final }.  If your memcached server is located elsewhere, change localhost:11211 to reflect the correct fully qualified hostname and port.  If you have multiple memcached servers, separate them with commas.

The SESSION_ENGINE option should also be uncommented to enable the write-through cache for sessions (sessions will be stored in memcached but also flushed to the database).  You can change this option to use only the cache for session storage if you wish.

Once the memcached configuration is complete, start the memcached daemon and then start or restart your Apache server and you should be able to load the SSD homepage at http://your_server_name

If at this point, you cannot get access the SSD homepage or you are receiving unknown errors, check the Common Issues Common Issues section of this site.

Once your system is up and running, head over to the customization page to learn how to customize the system for your organization. 

Note: Once memcached is setup properly, you can view cache information in the SSD admin by going to Admin -> Admin -> Cache Status