openSIPS | Resources / DocsTsMem

Resources -> Documentation -> Out Of Memory

What to do if "out of memory" or "no more memory" messages are generated by OpenSIPS?

Potential causes

There are two cause that may lead to memory starvation:

a) a small pool of memory - the configured memory is not enough and no more memory can be allocated.

b) memory leak - some memory id not properly freed, making all the memory unavailable (not used, but still allocated)

Determining the cause

If the memory starvation is because of a too small pool of memory, by stopping the traffic on the proxy (without stopping the proxy), the allocated memory will be freed in time (as transactions and location records are freed). TEST: wait ~ 20 minutes without any kind of load the proxy. Test the proxy by placing several calls; if the memory errors pop up again once the traffic is resumed, it means it's a memory leak somewhere; If not sure of the result, consider it's a memory leak.

How to handle it

If the memory pool is too small, just go in config.h and increase the size of the memory pool - for SHM or PKG.

If it is about a memory leak, you need to compile the debug support into memory manager. To do so, follow the next steps:

1. edit Makefile.defs file and remove from the DEFS string the F_MALLOC define (delete "-DF_MALLOC" line) and add the DBG_QM_MALLOC define (insert a "-DDBG_QM_MALLOC" line).

2. recompile everything

3. set memlog=1 in your configuration script (to get the memory messages) - it must be lower than debug.

4. restart your proxy

Now, you may check the memory status in two situations:

1. **At shutdown** - just stop the proxy - the memory manager will dump the memory status. Normally most of the memory is cleaned during shutdown. If there is memory leak, it should be visible as not-freed memory. A memory status looks like:

     0(17665) Memory status (shm):
     0(17665) qm_status (0xb5a7e000):
     0(17665)  heap size= 33554432
     0(17665)  used= 1592952, used+overhead=1811564, free=31742868
     0(17665)  max used (+overhead)= 1811564
     0(17665) dumping all alloc'ed. fragments:
     0(17665)       0. N  address=0xb5ab240c frag=0xb5ab23f4 size=4 used=1
     0(17665)             alloc'd from mem/shm_mem.c: shm_mem_init_mallocs(199)
     0(17665)         start check=f0f0f0f0, end check= c0c0c0c0, abcdefed
     0(17665)       1. N  address=0xb5ab2440 frag=0xb5ab2428 size=4 used=1 
     0(17665)             alloc'd from timer.c: init_timer(52)
     0(17665)         start check=f0f0f0f0, end check= c0c0c0c0, abcdefed

2. **At run time** - you may check the memory status by sending SIGUSR1 signal to the process (do "kill -SIGUSR1 OPENSIPS_PID") - it will dump the SHM and PKG (only for that process) memory status. It is highly recommended to do this after waiting about 20 minutes to be sure that as much as possile memory is freed - all temporary memory used during processing is freed by lack of load on the proxy. Go through the log and see if there is something suspicious, like too much memory still allocated from same place, etc...

If you have no clue how to interpret the logs for memory status, post it on a FTP or HTTP server and send the link on the devel@lists.opensips.org mailing list.

Resources -> Documentation -> Out Of Memory

Potential causes

Determining the cause

How to handle it

OpenSIPS Getting Started

OpenSIPS Devel Course

OpenSIPS 1.8.0

Dynamic Routing

APT repository

OpenSIPS 1.7.2

SIP Validation Support

DNS Caching Support

Distributed Dialog Profiles

Configuration and Scripting Tool

Cassandra driver

LUA integration

OpenSIPS Pavilion @ ITExpo 2012

OpenSIPS and HOMER

OpenSIPS eBootcamp

OpenSIPS 1.7.1

Ratelimit

OpenSIPS VM 1.7.0

MI via HTTP

Events via RabbitMQ

Key-Value Cache/DBs

GRUU support

OpenSIPS 1.8.0 preview

OpenSIPS eBootcamp

OpenSIPS 1.7.0

ClueCon 2011

New in 1.7.0

SVN Freeze

Topology Hiding

New AVP naming

DB Optimization

Event Notification Interface

OpenSIPS eBootcamp

UAC_REGISTRANT module

Performance degradation with complexity

Load and performance monitoring

OpenSIPS 2.0

OpenSIPS Online Meeting

OpenSIPS Social Event

OpenSIPS eBootcamp

OpenSIPS 1.6.4

OpenSIPS media timeout