首页 > 代码库 > trove manual installation 翻译
trove manual installation 翻译
目标
此文件提供了一步一步的指导手动安装trove在一个现有OpenStack的环境为了开发。
该文件将不包括:
OpenStack的设置
trove服务配置
要求
正在运行的OpenStack的环境是必需的,包括以下组件:
计算 (Nova)
镜像服务 (Glance)
身份认证 (Keystone)
一个网络组件 (either Neutron or Nova-Network)
如果你想在块存储卷提供数据存储,还需要块存储(Cinder)
如果你想要做的备份/恢复和复制,你也需要对象存储(Swift)
在刚安装了Ubuntu14.04 LTS的环境中运行trove服务。这将被称为“本地环境”
AMQP服务(RabbitMQ的或QPID)
MySQL(SQLite,PostgreSQL)数据库用来满足trove的内部需求,从当地的环境访问。
某些OpenStack的服务必须是从虚拟机可以访问的:
Swift
虚拟机必须从本地环境访问,用来开发/调试
openstack服务必须直接从本地环境访问,例如:
Nova
Cinder
Swift
Heat
安装
收集信息
以下信息对现有环境要求:
Keystone的主机和端口(S)
OpenStack的管理员的用户名,租户名称和密码
Nova的URL
Cinder的URL
Swift的URL
Heat的URL
AMQP连接凭证(服务器URL,用户密码)
trove的控制器端连接字符串(MySQL的和SQLite的,PostgreSQL的)
安装依赖
对于Trove¶必需的程序包
要安装的软件包列表:
$ sudo apt-get install build-essential libxslt1-dev qemu-utils mysql-client \
git python-dev python-pexpect python-pymysql libmysqlclient-dev
Python的设置
要找出哪个版本setuptools的最新的,请检查setuptools的repo。
要找出哪个pip版本是最新的,请访问pip的repo。
在Ubuntu软件仓库中有些软件包已经过时。请务必更新从适当来源的最新版本。
使用最新的setuptools:
$ cd ~
$ wget https://pypi.python.org/packages/source/s/setuptools/setuptools-{{latest}}.tar.gz
$ tar xfvz setuptools-{{latest}}.tar.gz
$ cd setuptools-{{latest}}
$ python setup.py install --user
使用最新的pip:
$ wget https://pypi.python.org/packages/source/p/pip/pip-{{latest}}.tar.gz
$ tar xfvz pip-{{latest}}.tar.gz
$ cd pip-{{latest}}
$ python setup.py install --user
注意上面的‘-user‘ - 我们在用户的home目录安装的软件包,在$HOME/.local/bin中,所以我们需要将它添加到环境变量:
$ echo PATH="$HOME/.local/bin:$PATH" >> ~/.profile
$ . ~/.profile
安装virtualenv,创建环境,并激活它:
$ pip install virtualenv --user
$ virtualenv --system-site-packages env
$ source env/bin/activate
获取trove
获得OpenStack的资料库中trove源组件:
$ cd ~
$ git clone https://git.openstack.org/openstack/trove.git
$ git clone https://git.openstack.org/openstack/python-troveclient.git
安装Trove¶
首先,安装要求:
$ cd ~/trove
$ pip install -r requirements.txt -r test-requirements.txt
然后安装trove
$ sudo python setup.py develop
最后安装trove client
$ cd ~/python-troveclient
$ sudo python setup.py develop
$ cd ~
其他所需的OpenStack的客户端(python-novaclient,python-keystoneclient等)应该已经被作为trove的一部分安装了。
为OpenStack准备trove:
你首先需要创建一个名为“trove_for_trove_usage‘租户。接下来,创建用户名为“regular_trove_user‘和‘admin_trove_user” - 使用“宝库”作为密码。这些都是用来提供trove服务所使用的帐户。此外,您将需要注册trove作为OpenStack的服务及其端点:
$ keystone --os-username <OpenStackAdminUsername> --os-password <OpenStackAdminPassword> --os-tenant-name <OpenStackAdminTenant> --os-auth-url http://<KeystoneIP>:<KeystonePort>/v2.0 tenant-create --user trove_for_trove_usage
$ keystone --os-username <OpenStackAdminUsername> --os-password <OpenStackAdminPassword> --os-tenant-name <OpenStackAdminTenant> --os-auth-url http://<KeystoneIP>:<KeystonePort>/v2.0 user-create --user regular_trove_user --pass trove --tenant trove_for_trove_usage
$ keystone --os-username <OpenStackAdminUsername> --os-password <OpenStackAdminPassword> --os-tenant-name <OpenStackAdminTenant> --os-auth-url http://<KeystoneIP>:<KeystonePort>/v2.0 user-create --user admin_trove_user --pass trove --tenant trove_for_trove_usage
$ keystone --os-username <OpenStackAdminUsername> --os-password <OpenStackAdminPassword> --os-tenant-name <OpenStackAdminTenant> --os-auth-url http://<KeystoneIP>:<KeystonePort>/v2.0 user-role-add --user admin_trove_user --tenant trove_for_trove_usage --role admin
$ keystone --os-username <OpenStackAdminUsername> --os-password <OpenStackAdminPassword> --os-tenant-name <OpenStackAdminTenant> --os-auth-url http://<KeystoneIP>:<KeystonePort>/v2.0 service-create --user trove --type database
$ keystone --os-username <OpenStackAdminUsername> --os-password <OpenStackAdminPassword> --os-tenant-name <OpenStackAdminTenant> --os-auth-url http://<KeystoneIP>:<KeystonePort>/v2.0 endpoint-create --service trove --region RegionOne --publicurl ‘http://<EnvironmentPublicIP>:<EnvironmentPort>/v1.0/$(tenant_id)s‘ --adminurl ‘http://<EnvironmentPublicIP>:<EnvironmentPort>/v1.0/$(tenant_id)s‘ --internalurl ‘http://<EnvironmentPublicIP>:<EnvironmentPort>/v1.0/$(tenant_id)s‘
其中,<EnvironmentPublicIP>和<EnvironmentPort>是指安装了Trove的服务器的IP地址和端口。该IP应该可以访问任何要与trove交流的主机。
准备trove配置文件¶
有几个trove的配置文件:
api-paste.ini and trove.conf - trove-API服务
trove-taskmanager.conf - trove - taskmanager服务
trove-guestagent.conf - trove-guestagent服务
trove - conductor.conf - trove-conductor服务
<datastore_manager>.cloudinit -虚拟机调配期间的用户数据
Cloud-init scripts是用户数据被用于不同的数据存储类型,如MySQL/ Percona的,cassandra,MongoDB的,Redis的,couchbase同时提供新计算实例。
上述例子在:~/trove/etc/trove/ as *.conf.sample files.
如果干净的Ubuntu镜像被用作用于trove实例源镜像,Cloud-init scripts必须安装和在实例中运行guestagent。
作为替代方案,你可以考虑创建一个自定义镜像与预安装和预配置的trove。
源镜像
至于trove实例源图像,我们将使用trove兼容Ubuntu的镜像:
$ export DATASTORE_TYPE="mysql"
$ wget http://tarballs.openstack.org/trove/images/ubuntu/${DATASTORE_TYPE}.qcow2
$ glance --os-username admin_trove_user --os-password trove --os-tenant-name trove_for_trove_usage --os-auth-url http://<KeystoneIP>:<KeystoneAdminPort>/v2.0 image-create --name trove-image --is-public True --container-format ovf --disk-format qcow2 --owner ${DATASTORE_TYPE}.qcow2
注:http://tarballs.openstack.org/trove/images包括MySQL和Percona的,MongoDB的trove兼容的镜像。
在这一步,请记住镜像ID或存储在一个环境变量(IMAGEID)。
$ glance --os-username trove --os-password trove --os-tenant-name trove --os-auth-url http://<KeystoneIP>:<KeystoneAdminPort>/v2.0
image-create --name trove-image --is-public true --container-format ovf --disk-format qcow2 --owner trove < precise.qcow2
$ export IMAGEID=<glance_image_id>
Cloud-init scripts
Cloud-init location
默认情况下,trove-taskmanager将着眼于为/etc/trove/cloudinit for <datastore_manager>.cloudinit.
Cloud-init content
对于trove兼容镜像的每个cloud-init script应包含:
Trove的安装
与trove代码在内的自定义镜像
等待被加入
准备数据库
创建trove数据库模式:
连接到存储后端(MySQL,PostgreSQL)
创建数据库,名字为trove(这个数据库将被用于存储trove的ORM)
撰写的连接字符串。例如:MYSQL + pymysql://<用户>:<密码>@ <backend_host>:<backend_port>/<数据库>
初始化数据库
一旦创建了trove数据库,其结构需要填充。
$ trove-manage db_sync
设置trove数据存储
数据存储
数据存储是一种数据结构,描述一组数据存储版本,其中包含的:
- ID -- simple auto-generated UUID
- Name -- user-defined attribute, actual name of a datastore
- Datastore Versions
例如:
- mysql, cassandra, redis, etc.
数据存储版本
数据存储版本是一个数据结构,它描述了一个版本,固定到数据存储特定的数据库,其中包括的:
- ID — Simple auto-generated UUID
- Datastore ID — Reference to Datastore
- Name — User-defined attribute, actual name of a database version
- Datastore manager — trove-guestagent manager that is used for datastore management
- Image ID — Reference to a specific Glance image ID
- Packages — Operating system specific packages that would be deployed onto datastore VM
- Active — Boolean flag that defines if version can be used for instance deployment or not
例如:
- ID - edb1d22a-b66d-4e86-be60-756240439272
- Datastore ID - 9c3d890b-a2f2-4ba5-91b2-2997d0791502
- Name - mysql-5.6
- Datastore manager - mysql
- Image ID - d73a402-3953-4721-8c99-86fc72e1cb51
- Packages - mysql-server=5.5, percona-xtrabackup=2.1
- Active - True
数据存储和数据存储版本注册
要注册的数据存储,你必须执行
$ export DATASTORE_TYPE="mysql" # available options: mysql, mongodb, postgresql, redis, cassandra, couchbase, couchdb, db2, vertica, etc.
$ export DATASTORE_VERSION="5.6" # available options: for cassandra 2.0.x, for mysql: 5.x, for mongodb: 2.x.x, etc.
$ export PACKAGES="mysql-server-5.6" # available options: cassandra=2.0.9, mongodb=2.0.4, etc
$ export IMAGEID="9910350b-77e3-4790-86be-b971d0cf9175" # Glance image ID of the relevant Datastore version (see Source images section)
$ trove-manage datastore_update ${DATASTORE_TYPE} ""
$ trove-manage datastore_version_update ${DATASTORE_TYPE} ${DATASTORE_VERSION} ${DATASTORE_TYPE} ${IMAGEID} ${PACKAGES} 1
$ trove-manage datastore_update ${DATASTORE_TYPE} ${DATASTORE_VERSION}
运行trove
trove服务配置和tuning¶
等待被加入
开始trove服务
运行trove的API:
$ trove-api --config-file=${TROVE_CONF_DIR}/trove-api.conf &
运行 trove-taskmanager:
$ trove-taskmanager --config-file=${TROVE_CONF_DIR}/trove-taskamanger.conf &
运行 trove-conductor:
$ trove-conductor --config-file=${TROVE_CONF_DIR}/trove-conductor.conf &
trove互动
Keystonerc
你需要构建一个kenstonerc文件,包含数据用来简化在使用客户端的时候的认证过程:
export OS_TENANT_NAME=trove
export OS_USERNAME=regular_trove_user
export OS_PASSWORD=trove
export OS_AUTH_URL="http://<KeystoneIP>:<KeystonePort>/v2.0/"
export OS_AUTH_STRATEGY=keystone
trove部署验证
首先,你需要执行:
$ . keystonerc
要查看某个特定命令的帮助:
$ trove help <command>
创建一个用例:
$ trove create <name> <flavor_id>
[--size <size>]
[--databases <databases> [<databases> ...]]
[--users <users> [<users> ...]] [--backup <backup>]
[--availability_zone <availability_zone>]
[--datastore <datastore>]
[--datastore_version <datastore_version>]
[--nic <net-id=net-uuid,v4-fixed-ip=ip-addr,port-id=port-uuid>]
[--configuration <configuration>]
[--replica_of <source_id>]
故障排除
在‘trove show <instance_id>’命令输出中没有实例的Ips
如果trove实例创建成功,则显示活动状态和工作,但没有IP地址的显示,在命令‘trove show <instance_id>‘的输出中,然后确认确认以下行添加到了trove.conf
network_label_regex = ^NETWORK_NAME$
NETWORK_NAME应该替换为真实姓名的实例连接到网络。
决定你要哪个网络附加一个trove实例,运行以下命令:
$ nova net-list
或者
$ neutron net-list
一种可能的方法来查找网络名称是执行“nova list”命令。输出将为租户列出所有OpenStack的实例,包括网络信息。
比如:
NETWORK_NAME=IP_ADDRESS
更多信息:http://www.cnblogs.com/S-tec-songjian/
trove manual installation 翻译