Development Guides Home >> Guide to Locales
Guide to Locales - Distribute a Custom Locale
Introduction
This guide explains how to distribute a custom locale from one server to another.
In the following examples, German (de) is the customized locale to distribute. To distribute a custom locale to multiple target servers, you must repeat steps 3 through 5 on each target server.
Not all locales are available by default. You can view the system's locales in the /var/cpanel/locale directory. These files possess the .cdb extension.
Distribute a custom locale
Log in to the source server
SSH in to the source server as the root user.
Run the /usr/local/cpanel/scripts/locale_export script
Run the following command, where de represents the locale that you wish to export:
/usr/local/cpanel/scripts/locale_export --locale=deThis command creates the /var/cpanel/locale/export/de.xlf file.
To view additional options for this script, run the /usr/local/cpanel/scripts/locale_export --help command.
Use the scp command to copy the file to the target server
For example, use the following command to distribute the de.xlf file to the server.example.com server:
scp /var/cpanel/locale/export/de.xlf root@server.example.com:/var/cpanel/locale/export/de.xlfThis command copies the locale file to the /var/cpanel/locale/export/de.xlf file on the server.example.com server.
Log in to the target server
SSH in to the target server as the root user.
Run the /usr/local/cpanel/scripts/locale_import script to import the locale
Run the following command, where de represents the locale that you wish to import:
/usr/local/cpanel/scripts/locale_import --locale=deTo view additional options for this script, run the /usr/local/cpanel/scripts/locale_import --help command.
Recommended tips and tricks
- You may wish to set up a cron job to automate this process. For more information, read our Cron Jobs documentation.
- You can use FTP to distribute the locale file to your servers. For more information, read our FTP Accounts documentation.