Managing Customized BDB configurations: Difference between revisions

No edit summary
No edit summary
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{ZC}}
{{BC|Certified}}
 
__FORCETOC__
<div class="col-md-12 ibox-content">
=Managing Customized BDB configurations=
{{KB|{{ZC}}|{{ZCS 7.0}}||}}
{{Archive}}{{WIP}}
=Successfully maintaining a customized BDB configuration file=
=Successfully maintaining a customized BDB configuration file=
As noted in the [[Performance Tuning Guidelines for Large Deployments]] article, it may be necessary to create and maintain a customized DB_CONFIG file for a given LDAP installation.  Zimbra has created an easy to follow methodology allowing these customizations to be preserved across upgrades, and to be easily transferred to new LDAP servers at installation time.   
As noted in the [[Performance Tuning Guidelines for Large Deployments]] article, it may be necessary to create and maintain a customized DB_CONFIG file for a given LDAP installation.  Zimbra has created an easy to follow methodology allowing these customizations to be preserved across upgrades, and to be easily transferred to new LDAP servers at installation time.   
==DB_CONFIG.custom==
 
After installation of the zimbra-ldap package, the directory <tt>/opt/zimbra/openldap/var/openldap-data</tt> will exist.  Inside that directory will be the DB_CONFIG file used for the main database.  To set up a customized DB_CONFIG, copy this file to DB_CONFIG.custom in the same directory.  Then make whatever modifications necessary for the local installation to this file.  To put your DB_CONFIG.custom file into place do the following as the zimbra user:
==Primary database custom DB_CONFIG file==
 
After installation of the zimbra-ldap package, the directory <tt>/opt/zimbra/openldap/var/openldap-data</tt> will exist.  Inside that directory will be the DB_CONFIG file used for the main database.
 
===For ZCS 6.0.2 and later===
As the zimbra user, do the following:
mkdir -p /opt/zimbra/conf/custom/ldap
  cp /opt/zimbra/openldap/var/openldap-data/DB_CONFIG /opt/zimbra/conf/custom/ldap/DB_CONFIG
 
Make whatever modifications necessary for the local installation to this file.  Then:
 
$ ldap stop
$ rm /opt/zimbra/data/ldap/hdb/db/DB_CONFIG
$ ldap start
 
Your new customized DB_CONFIG will be installed. If further modifications are made to the custom DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.
 
=== For ZCS 6.0.1 and previous ===
As the zimbra user, do the following:
cp /opt/zimbra/openldap/var/openldap-data/DB_CONFIG /opt/zimbra/openldap/var/openldap-data/DB_CONFIG.custom
 
Make whatever modifications necessary for the local installation to this file.  Then:
 
  $ ldap stop
  $ ldap stop
On 5.0.x installs:
  $ rm /opt/zimbra/openldap-data/DB_CONFIG
  $ rm /opt/zimbra/openldap-data/DB_CONFIG
On 6.0.0 and 6.0.1 installs:
$ rm /opt/zimbra/data/ldap/hdb/db/DB_CONFIG
Then
  $ ldap start
  $ ldap start


Your new customized DB_CONFIG will be installed.  This is the procedure to follow any time modifications are made to /opt/zimbra/openldap/var/openldap-data/DB_CONFIG.custom.
Your new customized DB_CONFIG will be installed.  If further modifications are made to the custom DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.
 
==Accesslog database custom DB_CONFIG file==
It may also be necessary to make local modifications to the DB_CONFIG file used by the accesslog database on an LDAP master.  This is almost identical to the method for maintaining a customized DB_CONFIG file for the main database.
 
===For ZCS 6.0.2 and later===
As the zimbra user, do the following on the ldap master:
cp opt/zimbra/openldap/var/openldap-data/DB_CONFIG.accesslog /opt/zimbra/conf/custom/ldap/DB_CONFIG.accesslog


==DB_CONFIG.accesslog.custom==
Make whatever modifications necessary for the local installation to this file.  Then:
It may also be necessary to make local modifications to the DB_CONFIG file used by the accesslog database on an LDAP master.  This is almost identical to the method for maintaining a customized DB_CONFIG file for the main database.  To set up a customized DB_CONFIG file for the accesslog database, cd /opt/zimbra/openldap/var/openldap-data on the master LDAP server.  Copy DB_CONFIG.accesslog to DB_CONFIG.accesslog.custom, and then make whatever modifications are necessary for the local installation to this file.  To put this into place, on the master ldap server as the zimbra user:


  $ ldap stop
  $ ldap stop
$ rm /opt/zimbra/data/ldap/accesslog/db/DB_CONFIG
$ ldap start
The new customized DB_CONFIG file for the accesslog database will now be in place.  If further modifications are made to the custom accesslog DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.
=== For ZCS 6.0.1 and previous ===
As the zimbra user, do the following on the ldap master:
cd /opt/zimbra/openldap/var/openldap-data
cp DB_CONFIG.accesslog DB_CONFIG.accesslog.custom
Make whatever modifications necessary for the local installation to this file.  Then:
$ ldap stop
On 5.0.x installs:
  $ rm /opt/zimbra/openldap-data/accesslog/db/DB_CONFIG
  $ rm /opt/zimbra/openldap-data/accesslog/db/DB_CONFIG
On 6.0.0 and 6.0.1 installs:
$ rm /opt/zimbra/data/ldap/accesslog/db/DB_CONFIG
  $ ldap start
  $ ldap start


The new customized DB_CONFIG file for the accesslog database will now be in place.
The new customized DB_CONFIG file for the accesslog database will now be in place. If further modifications are made to the custom accesslog DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.
 
{{Article Footer|unknown|12/8/2008}}


[[Category:Certified]]
[[Category:Certified]]
[[Category:LDAP]]
[[Category:LDAP]]
[[Category:Performance and Tuning]]
[[Category:Performance and Tuning]]
[[Category:ZCS 7.0]]
[[Category:ZCS 6.0]]
[[Category:ZCS 5.0]]

Latest revision as of 00:09, 11 July 2015

Managing Customized BDB configurations

   KB 2743        Last updated on 2015-07-11  




0.00
(0 votes)

Successfully maintaining a customized BDB configuration file

As noted in the Performance Tuning Guidelines for Large Deployments article, it may be necessary to create and maintain a customized DB_CONFIG file for a given LDAP installation. Zimbra has created an easy to follow methodology allowing these customizations to be preserved across upgrades, and to be easily transferred to new LDAP servers at installation time.

Primary database custom DB_CONFIG file

After installation of the zimbra-ldap package, the directory /opt/zimbra/openldap/var/openldap-data will exist. Inside that directory will be the DB_CONFIG file used for the main database.

For ZCS 6.0.2 and later

As the zimbra user, do the following:

mkdir -p /opt/zimbra/conf/custom/ldap
cp /opt/zimbra/openldap/var/openldap-data/DB_CONFIG /opt/zimbra/conf/custom/ldap/DB_CONFIG

Make whatever modifications necessary for the local installation to this file. Then:

$ ldap stop
$ rm /opt/zimbra/data/ldap/hdb/db/DB_CONFIG
$ ldap start

Your new customized DB_CONFIG will be installed. If further modifications are made to the custom DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.

For ZCS 6.0.1 and previous

As the zimbra user, do the following:

cp /opt/zimbra/openldap/var/openldap-data/DB_CONFIG /opt/zimbra/openldap/var/openldap-data/DB_CONFIG.custom

Make whatever modifications necessary for the local installation to this file. Then:

$ ldap stop

On 5.0.x installs:

$ rm /opt/zimbra/openldap-data/DB_CONFIG

On 6.0.0 and 6.0.1 installs:

$ rm /opt/zimbra/data/ldap/hdb/db/DB_CONFIG

Then

$ ldap start

Your new customized DB_CONFIG will be installed. If further modifications are made to the custom DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.

Accesslog database custom DB_CONFIG file

It may also be necessary to make local modifications to the DB_CONFIG file used by the accesslog database on an LDAP master. This is almost identical to the method for maintaining a customized DB_CONFIG file for the main database.

For ZCS 6.0.2 and later

As the zimbra user, do the following on the ldap master:

cp opt/zimbra/openldap/var/openldap-data/DB_CONFIG.accesslog /opt/zimbra/conf/custom/ldap/DB_CONFIG.accesslog

Make whatever modifications necessary for the local installation to this file. Then:

$ ldap stop
$ rm /opt/zimbra/data/ldap/accesslog/db/DB_CONFIG
$ ldap start

The new customized DB_CONFIG file for the accesslog database will now be in place. If further modifications are made to the custom accesslog DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.

For ZCS 6.0.1 and previous

As the zimbra user, do the following on the ldap master:

cd /opt/zimbra/openldap/var/openldap-data
cp DB_CONFIG.accesslog DB_CONFIG.accesslog.custom

Make whatever modifications necessary for the local installation to this file. Then:

$ ldap stop

On 5.0.x installs:

$ rm /opt/zimbra/openldap-data/accesslog/db/DB_CONFIG

On 6.0.0 and 6.0.1 installs:

$ rm /opt/zimbra/data/ldap/accesslog/db/DB_CONFIG
$ ldap start

The new customized DB_CONFIG file for the accesslog database will now be in place. If further modifications are made to the custom accesslog DB_CONFIG file, you will need to stop ldap, remove the existing DB_CONFIG file as above, and then restart ldap to have the new custom one copied into place.

Verified Against: unknown Date Created: 12/8/2008
Article ID: https://wiki.zimbra.com/index.php?title=Managing_Customized_BDB_configurations Date Modified: 2015-07-11



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search