NetBackup Locale Implementation

Article: 100021980
Last Published: 2015-09-11
Ratings: 0 0
Product(s): NetBackup & Alta Data Protection

Problem

NetBackup Locale Implementation

Solution

Note: The common locale defined by .conf (or LC.CONF) fileand mentioned on this documentation is a locale that the particular NetBackupprocesses use to exchange the locale information among heterogeneous platforms.This implementation is not used for converting the path information ofbackup/restore target data objects between NetBackup master server and clientwith different encodings each other. In other words, NetBackup doesn't use thisimplementation to recognize a folder name or a file name stored in the NetBackupcatalog database. Veritas recommends for customers to edit the content of .confonly for the troubleshooting purpose.

=====================
What .conf( LC.CONF ) File Is
=====================
The locale implementation inNetBackup uses a mapping technique that allows the interoperability amongheterogeneous platforms with non-standardized locale naming conventions. Forexample, Japanese Shift_JIS locale is named 'ja_JP.SJIS' on HP-UX but'ja_JP.PCK' on Solaris. NetBackup manages this problem using a file called .conffound in the directory /usr/openv/msg for UNIX/Linux and LC.CONF in \Veritas\msgfor Windows.

The .conf file serves several functions so there aredifferent types of lines found in the file. The each line has a 2 letteridentifier starting TL, TM or OR. The current lines are:

  • TL : Locale definition line, for defining time format
  • TM: Locale mapping line
  • OR: Oracle locale mapping line

======
TLLine
======
A TL defines the name of a common locale and the time/dateformat for it. (The common locale is a locale used by NetBackup and is passedbetween clients and servers.) The TL line uses the followingformat:

TL <lc><common_local_name> <time_definition><date_definition>
  • TL: Common localedefinition

  • lc  :The length of the common locale name character. This is used to determine howlong the locale name is. This allows embedded spaces in the localename.

  • common_local_name: The name of a common locale beingdefined

  • time_definition: The format of the time. The first character this field defines the timeseparator character, normally ':'. Then time is described with a string of thefollowing form: ":hh:mn:ss" This means colon separator hours:minutes:secondsvalid key fields are hh,mn,ss,HH.  An hh indicates 24 hour time. HHindicates 12 hour AM/PM format (notsupported).

  • date_definition: defines the date format the same way the time format does. The keys areyy,yyyy,mm,dd. yy = 2 character year. yyyy = 4 character year. mm = monthnumber. dd = the day of the month. ex .yyyy.mm.dd would display 1997.3.26 forMarch 26, 1997. Not that anything after the date definition will beignored.

=======
TMLine
=======

A TM defines the name of a real locale and the mapping toa common locale defined by a TL line. The TM line uses the followingformat:

TM <lc><real_locale> <lc2> <common_locale>
  • TM: Real locale definitionline

  • lc: The length of a real localename

  • real_locale: The name of a real locale being mapped to a commonlocale

  • lc2: The length of a common locale name being mappedto

  • common_locale: The name of a common locale that real_locale will mapto

There must be a TM line in .conf file forevery real locale that may be used that is not a common locale. For example,'ja_JP.SJIS' on HP-UX may be a valid locale and should be defined with a TLline. On Solaris, 'ja_JP.SJIS' is not a valid locale. The locale for JapaneseShift_JIS on Solaris is 'ja_JP.PCK'. There must be a TM line type to map'ja_JP.PCK' to 'ja_JP.SJIS'. The line would appear as follows:

TM9  ja_JP.PCK         10ja_JP.SJIS           . Solaris SJIS

=======
OR Line
=======
Note: this section isused only if the NetBackup Oracle Agent is installed on the client.

A ORdefines the mapping between a real locale that has been defined in a TM line andan Oracle locale that is set using Oracle's NLS_LANG parameter. The NLS_LANGparameter sets the language, territory, and client's character set to be used byOracle for the client application. For any real locale that is being used, thereshould be a corresponding oracle locale value that will be used for Oraclemessage and name data to be displayed in the client application. The OR lineuses the following format:

OR <lc> <real_locale> <lc2><oracle_locale>

  • lc: The length of a reallocale

  • real_locale: The Name of a real locale being mapped to an Oraclelocale

  • lc2: The length of an Oracle localename

  • oracle_locale: The Name of an Oraclelocale

===================
How the MappingWorks
===================
For example, when a NetBackup client is startedon Solaris, 'ja_JP.PCK' will be looked up in a TM line of the .conf file and thecommon locale 'ja_JP.SJIS' will found and used. If a NetBackup server is runningalso on Solaris, the .conf file will be used to map the locale back to'ja_JP.PCK'. This is done by scanning both TM and TL line types. If the localematches a common locale defined by a TL, the locale is tested by a setlocale.This will, however, fail because 'ja_JP.SJIS' is not a valid locale name onSolaris, so the search continues. When the TM line list above is reached, thename 'ja_JP.PCK' is tried with a setlocale and it will work. If no mappingworks, 'C' locale isused.

======================================================
TheContent of . conf (LC.CONF) File (Copied from NetBackup6.5.4)
======================================================
. conffile  is installed in /usr/openv/msg on UNIX/Linux.
LC.CONF file isinstalled in \Veritas\msg on Windows.

Note: <space> needs to beused for between each values instead of<tab>.

TL 1 C     :hh:mn:ss/mm/dd/yyyy   . Veritasstandard
TL 2ov    :hh:mn:ss /mm/dd/yyyy   . Veritasstandard
TL 2ar    :hh:mn:ss /dd/mm/yyyy   .Arabic
TL 2 bg    :hh:mn:ss/dd/mm/yyyy   . Bulgarian
TL 2ca    :hh:mn:ss /dd/mm/yyyy   .Catalan
TL 2co    :hh:mn:ss /dd/mm/yyyy   .Corsican
TL 2cs    :hh:mn:ss /dd/mm/yyyy   .Czech
TL 2 cy    :hh:mn:ss/dd/mm/yyyy   . Welsh
TL 2da    :hh:mn:ss /dd/mm/yyyy   .Danish
TL 2 de    :hh:mn:ss.dd.mm.yyyy   . German
TL 5de_CH :hh:mn:ss /dd/mm/yyyy   . SwissGerman
TL 2 el    :hh:mn:ss/dd/mm/yyyy   . Greek
TL 2en    :hh:mn:ss /mm/dd/yyyy   .English
TL 5 en_UK :hh:mn:ss/dd/mm/yyyy   . English UK
TL 5en_US :hh:mn:ss /mm/dd/yyyy   . EnglishUSA
TL 11 en_US.UTF-8 :hh:mn:ss/mm/dd/yyyy   . English USAUTF-8
TL 2 eo    :hh:mn:ss/dd/mm/yyyy   . Esparanto
TL 2es    :hh:mn:ss -dd-mm-yyyy   .Spanish
TL 2eu    :hh:mn:ss /dd/mm/yyyy   .Basque
TL 2 fa    :hh:mn:ss/dd/mm/yyyy   . Persian
TL 2fi    :hh:mn:ss .dd.mm.yyyy   .Finnish
TL 2fr    :hh:mn:ss /dd/mm/yyyy   .French
TL 5 fr_BE :hh:mn:ss/dd/mm/yyyy   . BelgianFrench
TL 5 fr_CA :hh:mn:ss-yyyy-mm-dd   . CanadianFrench
TL 5 fr_CH :hh:mn:ss/dd/mm/yyyy   . Swiss French
TL2 fy    :hh:mn:ss /dd/mm/yyyy   .Frisian
TL 2ga    :hh:mn:ss /dd/mm/yyyy   .Irish
TL 2 gd    :hh:mn:ss/dd/mm/yyyy   . Scots Gaelic
TL2 hu    :hh:mn:ss /dd/mm/yyyy   .Hungarian
TL 2is    :hh:mn:ss /dd/mm/yyyy   .Icelandic
TL 2it    :hh:mn:ss .dd.mm.yyyy   .Italian
TL 2iw    :hh:mn:ss /dd/mm/yyyy   .Hebrew
TL 10ja_JP.SJIS    :hh:mn:ss /yyyy/mm/dd   . JapaneseSJIS
TL 12ja_JP.EUC-JP  :hh:mn:ss /yyyy/mm/dd   . JapaneseEUC
TL 11 ja_JP.UTF-8  :hh:mn:ss /yyyy/mm/dd   . JapaneseUTF8
TL 2 ji    :hh:mn:ss/dd/mm/yyyy   . Yiddish
TL 2kl    :hh:mn:ss /dd/mm/yyyy   .Greenlandic
TL 2ko    :hh:mn:ss /dd/mm/yyyy   .Korean
TL 12 ko_KR.EUC-KR  :hh:mn:ss /dd/mm/yyyy   . KoreanEUC
TL 11ko_KR.UTF-8    :hh:mn:ss /dd/mm/yyyy   . KoreanUTF8
TL 2 lv    :hh:mn:ss/dd/mm/yyyy   . Latvian
TL 2nl    :hh:mn:ss /dd/mm/yyyy   .Dutch
TL 2 no    :hh:mn:ss.dd.mm.yyyy   . Norwegian
TL 2pl    :hh:mn:ss /dd/mm/yyyy   .Polish
TL 2 pt    :hh:mn:ss/dd/mm/yyyy   . Portuguese
TL 2ro    :hh:mn:ss /dd/mm/yyyy   .Romanian
TL 2ru    :hh:mn:ss /dd/mm/yyyy   .Russian
TL 2sh    :hh:mn:ss /dd/mm/yyyy   .Serbo-Croatian
TL 2sk    :hh:mn:ss /dd/mm/yyyy   .Slovak
TL 2 sr    :hh:mn:ss/dd/mm/yyyy   . Serbian
TL 2sv    :hh:mn:ss -yyyy-mm-dd   .Swedish
TL 5 nl_NL :hh:mn:ss/dd/mm/yyyy   . Swiss  
TL2 th    :hh:mn:ss /dd/mm/yyyy   .Thai
TL 2 tr    :hh:mn:ss/dd/mm/yyyy   . Turkish
TL 14zh_CN.GB-18030   :hh:mn:ss -yyyy-mm-dd   . Chinesegb18030
TL 13zh_CN.GB-2312    :hh:mn:ss -yyyy-mm-dd   . Chinesegb2312
TL9  zh_CN.GBK        :hh:mn:ss -yyyy-mm-dd   .Chinese gbk
TL 11zh_CN.UTF-8      :hh:mn:ss -yyyy-mm-dd   . Chineseutf8
TL 11zh_TW.BIG-5      :hh:mn:ss -yyyy-mm-dd   . Chinesebig5
TL 11zh_TW.UTF-8      :hh:mn:ss -yyyy-mm-dd   . Chinese utf8
TL 5 zh_TW :hh:mn:ss/dd/mm/yyyy   . Chinese inTaiwan

TM6  french      2fr
TM 12 fr_FR.roman8 2fr
TM5  fr_FR       2fr
TM5  Fr_FR       2fr
TM2  FR          2fr
TM3  fra         2fr
TM5  Fr-BE       2fr
TM5  Fr-CH       5fr_CH
TM5  Fr-SW       5fr_CH
TM6  german      2de
TM2  DE          2de
TM5  De_DE       2de
TM5  Gr_GR       2de
TM5  de_AT       2de
TM5  de_DE       2de
TM5  De_CH       5de_CH
TM5  Gr_SW       5de_CH
TM6  korean      2ko
TM 11  KO_KR.UTF-8  11ko_KR.UTF-8     . AIX KoreanUTF8
TM 5  KO_KR        11 ko_KR.UTF-8     . AIX KoreanUTF8
TM 10  ko_KR.utf8   11ko_KR.UTF-8     . HP_UX and Linux Korean UTF8
TM 11  ko_KR.UTF-8  11ko_KR.UTF-8     . Solaris and Linux KoreanUTF8
TM 11  ko_KR.utf-8  11ko_KR.UTF-8     . Linux Korean UTF8
TM 10  ko_KR.UTF8   11ko_KR.UTF-8     . Linux Korean UTF8
TM5  greek       2el
TM5  el_GR       2el
TM 7  spanish     2es
TM 8  american    5en_US
TM3  ENU         2en
TM 11  EN_US.UTF-8  11en_US.UTF-8     . AIX EnglishUTF8
TM 5  EN_US        11 en_US.UTF-8     . AIX EnglishUTF8
TM 10  en_US.utf8   11en_US.UTF-8     . HP_UX and Linux English UTF8
TM 11  en_US.UTF-8  11en_US.UTF-8     . Solaris and Linux EnglishUTF8
TM 11  en_US.utf-8  11en_US.UTF-8     . Linux English UTF8
TM 10  en_US.UTF8   11en_US.UTF-8     . Linux English UTF8
TM5  czech       2cs
TM6  hebrew      2iw
TM 9  norwegian   2no
TM5  No_NO       2no
TM5  no_NO       2no
TM 7  swedish     2sv
TM5  Sv_SE       2sv
TM5  Sv_SV       2sv
TM6  arabic      2ar
TM6  danish      2da
TM5  da_DK       2da
TM5  Da_DK       2da
TM 9  hungarian   2hu
TM6  polish      2pl
TM5  Po_PO       2pl
TM4  thai        2th
TM 8  arabic-w    2ar
TM5  dutch       2nl
TM5  Du_BE       2nl
TM5  Nl_BE       2nl
TM5  nl_BE       2nl
TM5  Du_DL       2nl
TM 9  icelandic   2is
TM5  is_IS       2is
TM 10 portuguese  2pt
TM5  pt_BR       2pt
TM5  Pt_PT       2pt
TM5  pt_PT       2pt
TM 7  turkish     2tr
TM5  tr_TR       2tr
TM 9  bulgarian   2bg
TM 7  english     2en
TM 12 en_GB.roman8 2en
TM5  en_GB       5en_UK
TM5  EN_GB       5en_UK
TM5  En_UK       5en_UK
TM5  en_IE       5en_UK
TM5  en_NZ       5en_UK
TM5  en_AU       5en_UK
TM5  en_CA       5en_US
TM5  en_JP       5en_UK
TM7  italian     2 it
TM2  IT          2it
TM5  it_CH       2it
TM5  it_IT       2it
TM5  It_IT       2it
TM 8  rumanian    2ro
TM 8  c-french    5fr_CA
TM5  Fr_CA       5fr_CA
TM5  Fr_CF       5fr_CA
TM7  finnish     2 fi
TM5  Fi_SU       2fi
TM5  Fi_FI       2fi
TM5  fi_FI       2fi
TM 13 Ja_JP.IBM-943    10 ja_JP.SJIS           . AIX    SJIS
TM 13Ja_JP.IBM-932     10 ja_JP.SJIS           .AIX     SJIS
TM5  Ja_JP             10ja_JP.SJIS           . AIX    SJIS
TM 10ja_JP.SJIS        10ja_JP.SJIS           . HP-UX  SJIS
TM 10ja_JP.sjis        10ja_JP.SJIS           . Linux  SJIS
TM9  ja_JP.PCK         10ja_JP.SJIS           . SolarisSJIS
TM 15 ja_JP.IBM-eucJP   12ja_JP.EUC-JP         . AIX     EUC
TM 11ja_JP.eucJP       12 ja_JP.EUC-JP         .HP-UX   EUC  and SolarisEUC
TM 11ja_JP.eucjp       12 ja_JP.EUC-JP         .LINUX   EUC
TM 10ja_JP.ujis        12ja_JP.EUC-JP         . LINUX  EUC
TM 13japanese.euc      12 ja_JP.EUC-JP         .Linux   EUC
TM2  ja                12ja_JP.EUC-JP         . SolarisEUC
TM5  ja_JP             12ja_JP.EUC-JP         . AIX     EUC   andLinux EUC
TM 11JA_JP.UTF-8       11ja_JP.UTF-8          . AIX    UTF8
TM5  JA_JP             11ja_JP.UTF-8          . AIX    UTF8
TM 10ja_JP.utf8        11ja_JP.UTF-8          . HP-UX and LinuxUTF8
TM 11ja_JP.UTF-8       11ja_JP.UTF-8          . Solaris and LinuxUTF8
TM 11ja_JP.utf-8       11ja_JP.UTF-8          . LinuxUTF8
TM 10ja_JP.UTF8        11ja_JP.UTF-8          . LinuxUTF8
TM 15 ja_JP.eucjputf8   11ja_JP.UTF-8          . LinuxUTF8
TM3  JPN              2  ja                   . WinSJIS, msg dll dependent.
TM5  japan             2ja                    .
TM3  jpn               2ja                    .
TM8  katakana          2ja                    . HP-UXkatakana
TM 11ja_JP.kana8       2ja                    . HP-UXkatakana
TM8  japanese          2ja                    .HP-UX   SJIS  and Solaris, Linux EUC***
TM 13 Zh_CN.GB18030    14 zh_CN.GB-18030       . AIX     GB18030
TM5  Zh_CN             14zh_CN.GB-18030       . AIX5.1  GB18030, pre AIX5.1 GBK
TM 13 zh_CN.gb18030     14zh_CN.GB-18030       . HP-UX and Linux GB18030
TM 13 zh_CN.GB18030     14zh_CN.GB-18030       . Solaris GB18030
TM 15 zh_CN.IBM-eucCN   13zh_CN.GB-2312        . AIX    GB2312
TM 12zh_CN.hp15CN      13 zh_CN.GB-2312        .HP-UX   GB2312
TM9  chinese-s         13zh_CN.GB-2312        . HP_UX  GB2312
TM 12zh_CN.gb2312      13 zh_CN.GB-2312        .Linux   GB2312
TM9  zh_CN.EUC         13zh_CN.GB-2312        . SolarisGB2312
TM7  chinese           13zh_CN.GB-2312        . SolarisGB2312
TM5  zh_CN             13zh_CN.GB-2312        . AIX and LinuxGB2312
TM2  zh                13zh_CN.GB-2312        . SolarisGB2312
TM9  zh_CN.gbk        9  zh_CN.GBK            . Linux   GBK
TM9  zh_CN.GBK        9  zh_CN.GBK            . Solaris GBK
TM6  zh.GBK            9  zh_CN.GBK            .Solaris GBK
TM 11ZH_CN.UTF-8       11zh_CN.UTF-8          . Aix     UTF8
TM5  ZH_CN             11zh_CN.UTF-8          . Aix     UTF8
TM 10zh_CN.utf8        11zh_CN.UTF-8          . HP-UX and Linux UTF8
TM 11zh_CN.UTF-8       11zh_CN.UTF-8          . Solaris and Linux UTF8
TM 11zh_CN.utf-8       11zh_CN.UTF-8          . Linux UTF8
TM 10zh_CN.UTF8        11zh_CN.UTF-8          . Linux UTF8
TM 10Zh_TW.big5        11zh_TW.BIG-5          . Aix BIG5
TM 10zh_TW.big5        11zh_TW.BIG-5          . HP-UX and Linux BIG5
TM 10zh_TW.BIG5        11zh_TW.BIG-5          . Solaris BIG5
TM3  CHT               11zh_TW.BIG-5          . Windows BIG5
TM5  zh_TW             11zh_TW.BIG-5          . Platformdependent
TM 11ZH_TW.UTF-8       11zh_TW.UTF-8          . Aix     UTF8
TM5  ZH_TW             11zh_TW.UTF-8          . Aix     UTF8
TM 10zh_TW.utf8        11zh_TW.UTF-8          . HP-UX and Linux UTF8
TM 11zh_TW.UTF-8       11zh_TW.UTF-8          . Solaris and Linux UTF8
TM 11zh_TW.utf-8       11zh_TW.UTF-8          . Linux UTF8
TM 10zh_TW.UTF8        11zh_TW.UTF-8          . Linux UTF8
TM 9  chinese-t   5zh-TW                      . HP-UX zh_TW.ccdc
TM3  CHS               2zh                    . Win,msg dll dependent.
TM7  russian     2 ru
TM13 serbocroatian 2 sh
TM7  slovene     2 sk
TM5  es_GT       2es
TM5  es_UY       2es
TM5  es_AR       2es
TM5  es_BO       2es
TM5  es_CL       2es
TM5  es_CR       2es
TM5  es_CO       2es
TM5  es_MX       2es
TM5  es_NI       2es
TM5  es_PA       2es
TM5  es_PE       2es
TM5  es_VE       2es
TM5  es_ES       2es
TM5  Es_ES       2es
TM5  Sp_SP       2es
TM5  es_EC       2es
TM5  es_SV       2es
TM 9  en_FW.PCK   5en_FW
TM5  en_FW       9en_FW.PCK

OR1  C                   25AMERICAN_AMERICA.US7ASCII
OR2  en                  25AMERICAN_AMERICA.US7ASCII
OR5  en_US               25AMERICAN_AMERICA.US7ASCII
OR8  american            25AMERICAN_AMERICA.US7ASCII
OR7  english             25AMERICAN_AMERICA.US7ASCII
OR 12en_GB.roman8        25AMERICAN_AMERICA.US7ASCII
OR3  ENU                 29AMERICAN_AMERICA.WE8MSWIN1252
OR5  en_GB               35 ENGLISH_UNITEDKINGDOM.WE8ISO8859P1
OR2  de                  27GERMAN_GERMANY.WE8ISO8859P1
OR5  de_DE               27GERMAN_GERMANY.WE8ISO8859P1
OR6  german              27GERMAN_GERMANY.WE8ISO8859P1
OR2  fr                  26FRENCH_FRANCE.WE8ISO8859P1
OR5  fr_FR               26FRENCH_FRANCE.WE8ISO8859P1
OR6  french              26FRENCH_FRANCE.WE8ISO8859P1
OR2  es                  26SPANISH_SPAIN.WE8ISO8859P1
OR5  es_ES               26SPANISH_SPAIN.WE8ISO8859P1
OR7  spanish             26SPANISH_SPAIN.WE8ISO8859P1
OR2  ja                  22JAPANESE_JAPAN.JA16EUC
OR5  ja_JP               22JAPANESE_JAPAN.JA16EUC
OR8  japanese            23JAPANESE_JAPAN.JA16SJIS
OR 10ja_JP.SJIS          23JAPANESE_JAPAN.JA16SJIS
OR 15ja_JP.IBM-eucJP     22JAPANESE_JAPAN.JA16EUC
OR5  Ja_JP               23JAPANESE_JAPAN.JA16SJIS
OR 13Ja_JP.IBM-932       23JAPANESE_JAPAN.JA16SJIS
OR 13Ja_JP.IBM-943       23JAPANESE_JAPAN.JA16SJIS
OR3  JPN                 23JAPANESE_JAPAN.JA16SJIS
OR 11ja_JP.eucJP         22JAPANESE_JAPAN.JA16EUC
OR9  ja_JP.PCK           23JAPANESE_JAPAN.JA16SJIS
OR2  zh                  33SIMPLIFIED CHINESE_CHINA.ZHS16GBK
OR5  zh_CN               33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR7  chinese             33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR9  chinese-s           33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR 13zh_CN.GB18030       33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR9  zh_CN.EUC           39 SIMPLIFIEDCHINESE_CHINA.ZHS16CGB231280
OR6  zh.GBK              33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR9  zh_CN.GBK           33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR 13zh_CN.gb18030       33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR 12zh_CN.hp15CN        39 SIMPLIFIEDCHINESE_CHINA.ZHS16CGB231280
OR 13Zh_CN.GB18030       33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR5  Zh_CN               33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR 15zh_CN.IBM-eucCN     39 SIMPLIFIEDCHINESE_CHINA.ZHS16CGB231280
OR9  zh_CN.gbk           33 SIMPLIFIEDCHINESE_CHINA.ZHS16GBK
OR11  ja_JP.UTF-8        23JAPANESE_JAPAN.AL32UTF8
OR10  ja_JP.utf8         23JAPANESE_JAPAN.AL32UTF8
OR11  JA_JP.UTF-8        23JAPANESE_JAPAN.AL32UTF8
OR11  zh_CN.UTF-8        33 SIMPLIFIEDCHINESE_CHINA.AL32UTF8
OR10  zh_CN.utf8         33 SIMPLIFIEDCHINESE_CHINA.AL32UTF8
OR11  ZH_CN.UTF-8        33 SIMPLIFIEDCHINESE_CHINA.AL32UTF8



Was this content helpful?