Official Installation Documentation = Install VMware Cloud Director Object Storage Extension
1. Ensure to exclude the postgresql repos in /etc/yum.repos.d/CentOS-Base.repo
vim /etc/yum.repos.d/CentOS-Base.repo2. Find the [base] and [updates] sections, and insert the exclude=postgresql*
[base]
name=CentOS-$releasever - Base
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=os&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/os/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
exclude=postgresql*
#released updates
[updates]
name=CentOS-$releasever - Updates
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=updates&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/updates/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
exclude=postgresql*
#additional packages that may be useful
[extras]
name=CentOS-$releasever - Extras
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=extras&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/extras/$basearch/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
#additional packages that extend functionality of existing packages
[centosplus]
name=CentOS-$releasever - Plus
mirrorlist=http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=centosplus&infra=$infra
#baseurl=http://mirror.centos.org/centos/$releasever/centosplus/$basearch/
gpgcheck=1
enabled=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-73. Download latest postgresql RPM yum install
yum install https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm4. Install the postgresql13 Server:
yum install postgresql13-server postgresql13 -y5. Initialize the database:
/usr/pgsql-13/bin/postgresql-13-setup initdb6. Start and enable postegresql via systemctl
systemctl start postgresql-13 && systemctl enable postgresql-137. Change listen_addresses='localhost' to listen_addresses='*'
sed -i "s|#listen_addresses = 'localhost'|listen_addresses = '*'|g" /var/lib/pgsql/13/data/postgresql.conf8. Edit /var/lib/pgsql/13/data/pg_hba.conf + Add host all all 0.0.0.0/0 md5
vim /var/lib/pgsql/13/data/pg_hba.conf
# "local" is for Unix domain socket connections only
local all all peer
# IPv4 local connections:
host all all 0.0.0.0/0 md5
#host all all 127.0.0.1/32 scram-sha-256
# IPv6 local connections:
host all all ::1/128 scram-sha-256
# Allow replication connections from localhost, by a user with the
# replication privilege.
local replication all peer
host replication all 127.0.0.1/32 scram-sha-256
host replication all ::1/128 scram-sha-2569. Create OSE Database And User
su - postgres
-bash-4.2$ psql
postgres=# create user oseadmin with password 'PASSWORD';
CREATE ROLE
postgres=# create database osedb owner oseadmin;
CREATE DATABASE
postgres=# grant all privileges on database osedb to oseadmin;
GRANT
\quit10. Restart postgresql
systemctl restart postgresql-1311. Install Java OpenJRE 11
yum install java-11-openjdk -y12. Download the VMware Cloud Director Object Storage Extension (Current GA Version = 2.2.3)
yum install vmware-ose-2.2.3-22871129.el8.x86_64.rpm -y13. Accept the EULA by invoking ose from the CLI and input accept:
[root@vose]# ose
? Do you accept the EULA to continue configuring the software? (input 'accept'): accept
NAME:
ose - VMware Cloud Director Object Storage Extension
(OSE) middleware Command-line tool
USAGE:
ose <subcommand> [flags]
VERSION:
'2.2.3-22871129'
COMMANDS:
amazon Set and show amazon configuration
args Set / get / del / show current configuration
cert Import / gen / show OSE service SSL certificate
cloudian Set and show Cloudian configuration
config Validate / import / export OSE configuration
db Set and show database connection
director Set and show Cloud Director connection
ecs Set and show ECS configuration
endpoint Set OSE endpoint URL configuration
help Help about any command
jvmargs Set / del / show current java options argument configuration
migration Migrate data to version['2.2.3-22871129']
osis Set OSIS compliant platform endpoint
platforms Set and show storage platform
service Start / stop / restart / show OSE middleware
show Show all configurations in OSE
support Collect ose configuration and logs to help vmware ose team troubleshoot
ui Install / uninstall / show OSE UI plugin
OPTIONS:
-h, --help help for ose
--host="127.0.0.1" the host of OSE keeper service
--port=5198 the port of OSE keeper service
--version version for ose
14. Refer to Installing and Configuring VMware Cloud Director Object Storage Extension for any additional information.
15. Configure a self-signed certificate (Replace certificate-password)
ose cert gen --cn vose.philbendeck.com --secret certificate-password16. Configure the database connection (Replace 'PASSWORD'):
ose db set --url jdbc:postgresql://127.0.0.1:5432/osedb --user 'oseadmin' --secret 'PASSWORD'17. Configure the connection to VMware Cloud Director:
Prompt Method:
ose director setSyntax Method:
ose director set --url https://vcd.philbendeck.com --user administrator@system --secret 'PASSWORD'18. Install the VMware Cloud Director Object Storage Extension user interface plug-in.
Prompt Method
ose ui install Syntax Method
ose ui install --ose-url https://vose.philbendeck.com:44319. Refer to Configure VMware Cloud Director Object Storage Extension with Cloudian HyperStore
- Verify that you installed or upgraded your Cloudian HyperStore to version
7.4.(x)or7.5.(x)
- Verify that you increased the maximum length of Cloudian HyperStore user IDs from 64 bytes to 255 bytes.
- See Before you begin and Cloudian Deployment Requirements.
20. Start the VMware Cloud Director Object Storage Extension Keeper service.
systemctl start voss-keeper21. Configure the connection to the Cloudian HyperStore Admin Service HTTPS API endpoint:
To retrieve the Admin API password from the Cloudian HyperStore Cluster:
hsctl config get admin.auth.passwordPrompt Method
ose cloudian admin setSyntax Method
ose cloudian admin set --url https://s3-admin.philbendeck.com:19443 --user sysadmin --secret 'ADMIN-API PASSWORD'22. Configure the connection to the Cloudian HyperStore S3 Service:
Prompt Method
ose cloudian s3 setSyntax Method
ose cloudian s3 set https://s3-vcd.philbendeck.com23. Configure the connection to the Cloudian HyperStore IAM Service:
Prompt Method
ose cloudian iam setSyntax Method
ose cloudian iam set https://iam.philbendeck.com:1644324. Configure the connection to the Cloudian Management Console (CMC):
- In order for SSO support to the Cloudian Management Console, you must configure the
cmc_sso_enabled,true. - This configurable variable can be found in
/etc/cloudian-VER-puppet/manifests/extdata/common.csv - The SSO secret password can be set and found in =
cmc_sso_shared_key
Retrieve password via (Replace VER with the version of HyperStore):
grep cmc_sso_shared_key, /etc/cloudian-VER-puppet/manifests/extdata/common.csvPrompt Method
ose cloudian console setSyntax Method
ose cloudian console set --url https://cmc.philbendeck.com:8443 --user admin --secret SECRET force25. Enable the use of the Cloudian HyperStore platform.
ose platforms enable cloudian26. Ensure and verify that all the connectivity to each services is a Normal state:
ose config validate
+------------------------------------+-------------+---------------+-----------+
| Name | Required | Validation | Detail |
+====================================+=============+===============+===========+
| Region validation for vcd | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Database | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Certificate | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Cloud Director | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Platform - Cloudian | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Cloudian Administration Service | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Cloudian S3 Service | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+
| Cloudian IAM Service | Y | Valid | |
+------------------------------------+-------------+---------------+-----------+