Quando vamos usar a estratégia Out-Of-Place patching, ao criar um novo GRID ou DB Home, os grupos de SO precisam ser compatíveis com os grupos utilizados na instalação do Oracle Home original.
Em 2021 eu escrevi o post “Como Saber Quais Grupos do Sistema Operacional Foram Usados na Instalação do Oracle Grid Infrastructure / Database ?” demonstrando como podemos descobrir os grupos de SO que foram utilizados na intalação de um Oracle Home, o que é útil quando você ainda não tem conhecimento sobre quais grupos foram utilizados na instalação existente.
Neste post eu compartilho um script shell que criei para facilitar esse processo, uma vez que precisei fazer essa descoberta em vários servidores, sendo também uma abordagem possível de encaixar dentro de alguma outra automação. A parte “gourmet” do script é a possibilidade de escolher o formato do resultado, que pode ser no padrão do FPP (Fleet Patching and Provisioning) ou no padrão do OUI (Oracle Universal Installer).
get_groups.sh
Se tiver saída para a internet, pode baixar o script diretamente com CURL:
curl -s -o get_groups.sh "https://raw.githubusercontent.com/maiconcarneiro/blog-dibiei/main/get_groups.sh"; chmod +x get_groups.sh
Código
## script: get_groups.sh v1.3
## syntax: "./get_groups.sh" or "./get_groups.sh -home <ORACLE_HOME_PATH>" or "./get_groups.sh -home all"
## ./get_groups.sh use the current $ORACLE_HOME as default path.
##
## https://dibiei.blog/2024/01/30/script-get_groups-sh-listando-os-grupos-de-so-de-um-oracle_home/
##
## Maicon Carneiro - dibiei.blog
## 11/01/2024 - v1.0 with FPP format standard
## 27/01/2024 - v1.1 support for multiple Oracle Home reading /etc/oratab
## 29/01/2024 - v1.2 support for OUI (Oracle Universal Installer) format
# 1) Execution without parameter use the current ORACLE_HOME
# 2) Execution with the PATH provided by user get the groups for the specified ORACLE_HOME
# 3) Execution with option "all" get the groups for all ORACLE_HOME listed in /etc/oratab file.
USER_OPTION=""
# Default format of the output (FPP or OUI)
# FPP = Fleet Patching and Provisioning
# OUI = Oracle Universal Installer
RESULT_TYPE="FPP"
# show script help usage
show_help() {
echo "Uso: $0 [-home <Oracle Home Path>] [-oui]"
echo " -home : Oracle Home Patch. Example: /u01/app/oracle/product/19.0.0/dbhome_1"
echo " -oui : Get the result with OUI format instead of FPP format"
exit 1
}
# check parameters
while [[ $# -gt 0 ]]; do
case $1 in
-home)
shift
if [[ $# -eq 0 || $1 == -* ]]; then
show_help
fi
USER_OPTION=$1
;;
-oui)
RESULT_TYPE="OUI"
;;
*)
show_help
;;
esac
shift
done
# Default Binary type (RDBMS or GRID)
BINARY_TYPE="RDBMS"
# YES for Fleet Patching and Provisioning (FPP) standard
FORCE_OSPER_GRP="YES"
addGroupValueFPP()
{
GRP_NAME=$1
GRP_VALUE=$2
if [ -z $GRP_LIST_FPP ]; then
GRP_LIST_FPP="$GRP_NAME=$GRP_VALUE"
else
GRP_LIST_FPP="${GRP_LIST_FPP},$GRP_NAME=$GRP_VALUE"
fi
}
addGroupValueOUI()
{
GROUP_NAME=$1
GROUP_VALUE=$2
GROUP_OUI=$GROUP_NAME
if [ "$BINARY_TYPE" == "GRID" ]; then
OUI_LINE="oracle.install.asm.${GROUP_OUI}=$GROUP_VALUE"
else
if [ "$GROUP_NAME" != "OSDBA" ] && [ "$GROUP_NAME" != "OSOPER" ]; then
GROUP_OUI="${GROUP_NAME}DBA"
fi
OUI_LINE="oracle.install.db.$GROUP_OUI"_GROUP="$GROUP_VALUE"
fi
GRP_LIST_OUI+=($OUI_LINE)
}
runGetGroups(){
if [ ! -z "$2" ]; then
LIST_TYPE=$2
fi
# set the source Oracle Home
SOURCE_ORACLE_HOME=""
OH_PARAM=$1
if [ ! -z "$OH_PARAM" ]; then
SOURCE_ORACLE_HOME=$OH_PARAM
elif [ ! -z $ORACLE_HOME ]; then
SOURCE_ORACLE_HOME=$ORACLE_HOME
else
echo "ORACLE_HOME is required."
exit 1
fi
# check if the ORACLE_HOME exists
if [ ! -f "$SOURCE_ORACLE_HOME/rdbms/lib/config.c" ]; then
echo "Invalid ORACLE_HOME: $SOURCE_ORACLE_HOME"
exit 1
fi
# check binary type
if [ -f "$SOURCE_ORACLE_HOME/crs/install/rootcrs.sh" ]; then
BINARY_TYPE="GRID"
fi
# function to read the "config.c" file and return the group value to the specific group name.
addGroupValue(){
GRP_DEFINE=$1
GRP_NAME=$2
GRP_FORCE=$3
GRP_VALUE=$(grep "#define $GRP_DEFINE" $SOURCE_ORACLE_HOME/rdbms/lib/config.c | awk -F '"' '{print $2}')
if [[ ! -z "$GRP_VALUE" || $GRP_FORCE == "YES" ]]; then
if [ "$RESULT_TYPE" == "FPP" ]; then
addGroupValueFPP $GRP_NAME $GRP_VALUE
else
addGroupValueOUI $GRP_NAME $GRP_VALUE
fi
fi
}
# get all possible OS Groups value
GRP_LIST_FPP=""
GRP_LIST_OUI=()
addGroupValue "SS_DBA_GRP" "OSDBA"
addGroupValue "SS_OPER_GRP" "OSOPER" "$FORCE_OSPER_GRP"
# these groups are specific to RDBMS binary
if [ "$BINARY_TYPE" == "RDBMS" ]; then
addGroupValue "SS_DGD_GRP" "OSDG"
addGroupValue "SS_KMT_GRP" "OSKM"
addGroupValue "SS_RAC_GRP" "OSRAC"
addGroupValue "SS_BKP_GRP" "OSBACKUP"
fi;
addGroupValue "SS_ASM_GRP" "OSASM"
if [ "$RESULT_TYPE" == "FPP" ]; then
echo "$GRP_LIST_FPP"
else
for OUI_GROUP in "${GRP_LIST_OUI[@]}"; do
echo "$OUI_GROUP"
done
fi
}
# call the runGetGroups function based on the USER Option
if [ "$USER_OPTION" == "all" ]; then
echo ""
for OH_PATH in $(grep -v "^#" /etc/oratab | awk -F ":" '{print $2}' | sort -u | grep "^/"); do
echo "Oracle Home: $OH_PATH"
echo "$(runGetGroups $OH_PATH)"
echo ""
done
else
runGetGroups "$USER_OPTION"
fi;
O script tem 3 modos de uso:
- Sem parâmetros, considera o Oracle Home atual, baseado na variável ORACLE_HOME.
- Informando um caminho de um Oracle Home específico: “-home <ORACLE_HOME>”
- Informando “-home all” para ler todos os Oracle Home listados no arquivo /etc/oratab.
E para qualquer um dos 3 modos, uma opção adicional -“oui” que muda o formato do resultado, usando o padrão do Oracle Universal Installer (OUI), ao invés do formato padrão do FPP (default).
Exemplos
1) Descobrindo os grupos do ORACLE_HOME atual, considerando a variável de ambiente da sessão:
[oracle@lab02 ~]$ ./get_groups.sh OSDBA=dba,OSOPER=dba,OSDG=dba,OSKM=dba,OSRAC=dba,OSBACKUP=dba
Com formato OUI:
[oracle@lab02 ~]$ ./get_groups.sh -oui oracle.install.db.OSDBA_GROUP=dba oracle.install.db.OSOPER_GROUP=dba oracle.install.db.OSDGDBA_GROUP=dba oracle.install.db.OSKMDBA_GROUP=dba oracle.install.db.OSRACDBA_GROUP=dba oracle.install.db.OSBACKUPDBA_GROUP=dba
2) Descobrindo os grupos de um Oracle Home específico:
[oracle@lab02 ~]$ ./get_groups.sh -home /u01/app/product/19.0.0.0/GI1921 OSDBA=asmdba,OSOPER=oinstall,OSASM=asmadmin
Com formato OUI:
[oracle@lab02 ~]$ ./get_groups.sh -home /u01/app/product/19.0.0.0/GI1921 -oui oracle.install.asm.OSDBA=asmdba oracle.install.asm.OSOPER=oinstall oracle.install.asm.OSASM=asmadmin
3) Descobrindo os grupos de todos os Oracle Home listados no arquivo /etc/oratab:
[oracle@lab02 ~]$ ./get_groups.sh -home all Oracle Home: /u01/app/oracle/product/12.2.0.1/db_1 OSDBA=dba,OSOPER=dba,OSDG=dba,OSKM=dba,OSRAC=dba,OSBACKUP=dba Oracle Home: /u01/app/oracle/product/19.0.0.0/DB1921 OSDBA=dba,OSOPER=dba,OSDG=dba,OSKM=dba,OSRAC=dba,OSBACKUP=dba Oracle Home: /u01/app/product/19.0.0.0/GI1921 OSDBA=asmdba,OSOPER=oinstall,OSASM=asmadmin
Com formato OUI:
[oracle@lab02 ~]$ ./get_groups.sh -home all -oui Oracle Home: /u01/app/oracle/product/12.2.0.1/db_1 oracle.install.db.OSDBA_GROUP=dba oracle.install.db.OSOPER_GROUP=dba oracle.install.db.OSDGDBA_GROUP=dba oracle.install.db.OSKMDBA_GROUP=dba oracle.install.db.OSRACDBA_GROUP=dba oracle.install.db.OSBACKUPDBA_GROUP=dba Oracle Home: /u01/app/oracle/product/19.0.0.0/DB1921 oracle.install.db.OSDBA_GROUP=dba oracle.install.db.OSOPER_GROUP=dba oracle.install.db.OSDGDBA_GROUP=dba oracle.install.db.OSKMDBA_GROUP=dba oracle.install.db.OSRACDBA_GROUP=dba oracle.install.db.OSBACKUPDBA_GROUP=dba Oracle Home: /u01/app/product/19.0.0.0/GI1921 oracle.install.asm.OSDBA=asmdba oracle.install.asm.OSOPER=oinstall oracle.install.asm.OSASM=asmadmin
O formato de saída default do “FPP” é para ser usado no parâmetro “-groups” do comando “rhpctl add workingcopy”, enquanto o formato OUI é para ser usado em uma instalação manual nos scripts runInstaller (Database) ou gridSetup.sh (Grid Infrastructure).
Pingback: Out-Of-Place Patching is Easier in Oracle 26ai Using “-setupHomeAs” To Install new GI and DB homes – Blog do Dibiei