部署OceanBase-ce全过程
作者:ReadVersion
1. 部署ob-deploy
sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://mirrors.aliyun.com/oceanbase/OceanBase.repo sudo yum install -y ob-deploy
2. 复制配置文件并修改
github地址:
https://github.com/oceanbase/obdeploy/tree/master/example
根据部署计划选择相应的文件。
## Only need to configure when remote login is required user: # username: your username username: root # password: your password if need password: '123456' # key_file: your ssh-key file path if need # port: your ssh port, default 22 # timeout: ssh connection timeout (second), default 30 oceanbase-ce: servers: # Please don't use hostname, only IP can be supported - 192.168.32.131 global: # The working directory for OceanBase Database. OceanBase Database is started under this directory. This is a required field. home_path: /home/observer # The directory for data storage. The default value is $home_path/store. data_dir: /data # The directory for clog, ilog, and slog. The default value is the same as the data_dir value. redo_dir: /redo # Please set devname as the network adaptor's name whose ip is in the setting of severs. # if set severs as "127.0.0.1", please set devname as "lo" # if current ip is 192.168.1.10, and the ip's network adaptor's name is "eth0", please use "eth0" devname: ens33 mysql_port: 2881 # External port for OceanBase Database. The default value is 2881. DO NOT change this value after the cluster is started. rpc_port: 2882 # Internal port for OceanBase Database. The default value is 2882. DO NOT change this value after the cluster is started. zone: zone1 cluster_id: 1 # please set memory limit to a suitable value which is matching resource. memory_limit: 8G # The maximum running memory for an observer system_memory: 4G # The reserved system memory. system_memory is reserved for general tenants. The default value is 30G. stack_size: 512K cpu_count: 10 cache_wash_threshold: 1G __min_full_resource_pool_memory: 268435456 workers_per_cpu_quota: 10 schema_history_expire_time: 1d # The value of net_thread_count had better be same as cpu's core number. net_thread_count: 4 major_freeze_duty_time: Disable minor_freeze_times: 3 enable_separate_sys_clog: 0 enable_merge_by_turn: FALSE datafile_disk_percentage: 20 # The percentage of the data_dir space to the total disk space. This value takes effect only when datafile_size is 0. The default value is 90. syslog_level: INFO # System log level. The default value is INFO. enable_syslog_wf: false # Print system logs whose levels are higher than WARNING to a separate log file. The default value is true. enable_syslog_recycle: true # Enable auto system log recycling or not. The default value is false. max_syslog_file_count: 4 # The maximum number of reserved log files before enabling auto recycling. The default value is 0. # observer cluster name, consistent with obproxy's cluster_name appname: obcluster # root_password: # root user password, can be empty root_password: admin # proxyro_password: # proxyro user pasword, consistent with obproxy's observer_sys_password, can be empty obproxy: # Set dependent components for the component. # When the associated configurations are not done, OBD will automatically get the these configurations from the dependent components. depends: - oceanbase-ce servers: - 192.168.32.131 global: listen_port: 2883 # External port. The default value is 2883. prometheus_listen_port: 2884 # The Prometheus port. The default value is 2884. home_path: /root/obproxy # oceanbase root server list # format: ip:mysql_port;ip:mysql_port. When a depends exists, OBD gets this value from the oceanbase-ce of the depends. rs_list: 192.168.32.131:2881 enable_cluster_checkout: false # observer cluster name, consistent with oceanbase-ce's appname. When a depends exists, OBD gets this value from the oceanbase-ce of the depends. # cluster_name: obcluster skip_proxy_sys_private_check: true # obproxy_sys_password: # obproxy sys user password, can be empty. When a depends exists, OBD gets this value from the oceanbase-ce of the depends. # observer_sys_password: # proxyro user pasword, consistent with oceanbase-ce's proxyro_password, can be empty. When a depends exists, OBD gets this value from the oceanbase-ce of the depends.
3. 使用obd部署
echo "fs.aio-max-nr=1048576" >> /etc/sysctl.conf sysctl -p echo "* soft nofile 20480" >> /etc/security/limits.conf echo "* hard nofile 20480" >> /etc/security/limits.conf obd cluster deploy obcluster -c /etc/obdeploy.yaml obd cluster start obcluster
4. 连接OB
# 连接ob obclient -h127.0.0.1 -uroot@sys#obcluster -P2883 -p'your password' -Doceanbase -A # 连接obproxy obclient -h 127.0.0.1 -P2883 -uroot@proxysys
5. 创建unit和资源池、租户
create resource unit lcxunit max_cpu=2,max_memory='2G',max_iops=10000,max_disk_size='2G',max_session_num=2000; create resource pool lcxpool unit='lcxunit',unit_num=1; CREATE TENANT IF NOT EXISTS test_tenant charset='utf8mb4', replica_num=1, zone_list=('zone1'), primary_zone='zone1', resource_pool_list=('lcxpool') SET ob_tcp_invited_nodes='%'; DROP TENANT tenant_name [FORCE]
示例 1:
下述语句展示了创建名为 test_tenant 的一个 3 副本的 MySQL 租户(创建新租户默认是 MySQL 租户)。
obclient> CREATE TENANT IF NOT EXISTS test_tenant charset='utf8mb4', replica_num=3, zone_list=('zone1','zone2','zone3'), primary_zone='zone1;zone2,zone3', resource_pool_list=('pool1')
示例 2:
下述语句展示了创建租户后,直接通过修改变量 ob_tcp_innvited_nodes 的值为 % 以便允许任何客户端 IP 连接该租户。
如果不调整,默认租户的连接方式为只允许本机的 IP 连接数据库。
obclient> CREATE TENANT IF NOT EXISTS test_tenant charset='utf8mb4', replica_num=3, zone_list=('zone1','zone2','zone3'), primary_zone='zone1;zone2,zone3', resource_pool_list=('pool1') SET ob_tcp_invited_nodes='%'
示例说明如下:
- primary_zone 指该租户的表的分区 Leader 所在的 Zone ,例如,primary_ zone =’ zone1; zone2, zone3’ 表示该租户的表的分区 Leader 在 zone1 上, 这时通过分号来分隔。
- zone2 和 zone3 通过逗号分割,表示 zone2 和 zone3 是同一优先级,但是比 zone1 优先级低。
- primary_zone 设置时,其值可以为 RANDOM(必须大写),表示随机。
普通租户的内存最小规格必须大于等于 5 GB,否则创建租户失败。
如果希望建立租户进行非常简单的功能测试,可以修改参数 alter system __min_full_resource_pool_memory 的值为 1073741824 来允许以最小 1 GB 内存的规格创建租户。
6. 常用运维语句(来自官网)
查看服务器资源配置
可以通过以下 SQL 查看当前的服务器资源配置。
其中,__all_server 表记录了了各 OBServer 的状态,__all_virtual_server_stat 记录了各 OBServer 的 CPU、内存与磁盘使用量。
SELECT a.zone,concat(a.svr_ip,':',a.svr_port) observer, cpu_total, (cpu_total-cpu_assigned) cpu_free, round(mem_total/1024/1024/1024) mem_total_gb, round((mem_total-mem_assigned)/1024/1024/1024) mem_free_gb, usec_to_time(b.last_offline_time) last_offline_time, usec_to_time(b.start_service_time) start_service_time, b.status FROM __all_virtual_server_stat a JOIN __all_server b ON (a.svr_ip=b.svr_ip AND a.svr_port=b.svr_port) ORDER BY a.zone, a.svr_ip;
查看资源池配置
可以通过以下 SQL 查看当前的资源池配置。
其中,__all_resource_pool 表记录了资源池的信息,__all_unit_config 记录了资源单元的配置,__all_unit 记录了资源单元的列表。
SELECT t1.name resource_pool_name, t2.`name` unit_config_name, t2.max_cpu, t2.min_cpu, round(t2.max_memory/1024/1024/1024) max_mem_gb, round(t2.min_memory/1024/1024/1024) min_mem_gb, t3.unit_id, t3.zone, concat(t3.svr_ip,':',t3.`svr_port`) observer,t4.tenant_id, t4.tenant_name FROM __all_resource_pool t1 JOIN __all_unit_config t2 ON (t1.unit_config_id=t2.unit_config_id) JOIN __all_unit t3 on (t1.`resource_pool_id` = t3.`resource_pool_id`) LEFT JOIN __all_tenant t4 on (t1.tenant_id=t4.tenant_id) ORDER BY t1.`resource_pool_id`, t2.`unit_config_id`, t3.unit_id;
查看 RootService 执行的管理任务
可以通过以下 SQL 查看 RootService 最近执行的管理任务。
__all_rootservice_event_history 用于记录集群级的历史事件,如合并、Server 上下线、负载均衡任务执行等。配置项 ob_event_history_recycle_interval 控制该表中记录历史事件的保留时间,默认为 7 天。
有关 ob_event_history_recycle_interval 配置项的详细信息,请参见《OceanBase 数据库 参考指南》中的 系统配置项 章节。
SELECT DATE_FORMAT(gmt_create, '%b%d %H:%i:%s') gmt_create_ , module, event, name1, value1, name2, value2, rs_svr_ip FROM __all_rootservice_event_history WHERE 1 = 1 ORDER BY gmt_create DESC LIMIT 20;
如何查看用户表
可以通过以下 SQL 查看指定租户中所有用户表。
其中,gvtenant视图记录了租户信息 , gvtenant 视图记录了租户信息,gv tenant视图记录了租户信息,gvdatabase 记录了数据库信息,gvKaTeX parse error: Expected group after '_' at position 14: table 记录了表信息,_̲_all_virtual_me…tenant_id 表示租户 ID。
SELECT t1.tenant_id,t1.tenant_name,t2.database_name,t3.table_id,t3.table_Name,t3.tablegroup_id,t3.part_num,t4.partition_Id,t4.zone,t4.svr_ip,t4.role, round(t4.data_size/1024/1024) data_size_mb FROM `gv$tenant` t1 JOIN `gv$database` t2 ON (t1.tenant_id = t2.tenant_id) JOIN gv$table t3 ON (t2.tenant_id = t3.tenant_id AND t2.database_id = t3.database_id AND t3.index_type = 0) LEFT JOIN `__all_virtual_meta_table` t4 ON (t2.tenant_id = t4.tenant_id AND ( t3.table_id = t4.table_id OR t3.tablegroup_id = t4.table_id ) AND t4.role IN (1)) WHERE t1.tenant_id = $tenant_id ORDER BY t3.tablegroup_id, t4.partition_Id, t3.table_name ;
查看指定用户 SQL 命令执行情况
可以通过以下 SQL 查看指定用户执行的 SQL 命令的执行情况。
其中 TENANT_ID 表示租户 ID,USER_NAME 表示用户名,IP_ADDRESS 表示执行 SQL 的节点的 IP 地址。
obclient> SELECT /*+ read_consistency(weak) ob_querytimeout(100000000) */ substr(usec_to_time(request_time),1,19) request_time_, s.svr_ip, s.client_Ip, s.sid,s.tenant_id, s.tenant_name, s.user_name, s.db_name, s.query_sql, s.affected_rows, s.return_rows, s.ret_code, s.event, s.elapsed_time, s.queue_time, s.execute_time, round(s.request_memory_used/1024/1024,2) req_mem_mb, plan_type, is_executor_rpc, is_inner_sql FROM gv$sql_audit s WHERE s.tenant_id=<TENANT_ID> AND user_name='<USER_NAME>' AND svr_ip IN ('<IP_ADDRESS>') ORDER BY request_time DESC LIMIT 100;
查看物理机资源使用情况
可以通过以下 SQL 查看指定租户在物理机上的资源使用情况。
其中 gvmemstore 视图记录了租户的内存使用情况 , memstore 视图记录了租户的内存使用情况, memstore视图记录了租户的内存使用情况,tenant_id 表示租户 ID。
obclient> SELECT tenant_id, ip, round(active/1024/1024) active_mb, round(total/1024/1024) total_mb, round(freeze_trigger/1024/1024) freeze_trg_mb, round(mem_limit/1024/1024) mem_limit_mb , freeze_cnt , round((active/freeze_trigger),2) freeze_pct, round(total/mem_limit, 2) mem_usage FROM `gv$memstore` WHERE $tenant_id IN (1001) ORDER BY tenant_id, ip;
查看合并进度
可以通过以下 SQL 查看合并进度。
其中查询结果中的 merge_process 列表示当前合并进度的百分比。
SELECT ZONE,svr_ip,major_version,min_version,ss_store_count,merged_ss_store_count,modified_ss_store_count,merge_start_time,merge_finish_time,merge_process FROM __all_virtual_partition_sstable_image_info;
查看分区信息
可以通过以下 SQL 查询指定租户的分区信息。
其中 __all_virtual_partition_info 记录了分区信息,$tenant_id 表示租户 ID。
SELECT table_id, partition_idx, usec_to_time(min_log_service_ts), TIME_TO_SEC( now())-TIME_TO_SEC(usec_to_time(min_log_service_ts)) delta_time FROM __all_virtual_partition_info WHERE tenant_id=$tenant_id;
7. 小脚本(持续更新)
关于 shell 变量取值:
#!/bin/bash function start_cluster() { obd cluster start obcluster } function user_conn() { dbname=$2 echo ${dbname:-oceanbase} obclient -h127.0.0.1 -uroot@$1\#obcluster -P2883 -p'your password' -D${dbname:-oceanbase} -A } function stop_cluster() { obd cluster stop obcluster } case "$1" in 'start') start_cluster ;; '-u') user_conn $2 $3 ;; 'stop') stop_cluster ;; *) echo "ob-manager start|-u|stop ..." esac
总结
以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。