Skip to content

Latest commit

 

History

History
121 lines (83 loc) · 2.21 KB

INSTALL.md

File metadata and controls

121 lines (83 loc) · 2.21 KB
Raw

Download and Build OpenSDS Source Code

  • Configure local environment
export GOPATH=$HOME/gopath
export PATH=$HOME/gopath/bin:$PATH
mkdir -p $HOME/gopath/src/github.com/opensds/
cd $HOME/gopath/src/github.com/opensds
  • Download OpenSDS source code
git clone https://github.com/opensds/opensds.git $HOME/gopath/src/github.com/opensds/
  • Import dependency packages
go get github.com/opensds/opensds/cmd/osdslet
go get github.com/opensds/opensds/cmd/osdsdock
  • Build OpenSDS source code to generate executable files
cd cmd/osdslet
go build

cd cmd/osdsdock
go build
  • Move these executable files to /usr/local/bin
cp cmd/osdslet/osdslet /usr/local/bin
cp cmd/osdsdock/osdsdock /usr/local/bin

Dependencies Installation

  • Install pip
curl https://bootstrap.pypa.io/get-pip.py | python
  • Install python dependencies
sudo apt-get install python-dev
  • Install os-brick
pip install git+https://github.com/leonwanghui/os-brick.git
  • Create configuration files
cp /usr/local/etc/os-brick/ /etc/ -r
  • Modify config file(/etc/os-brick/os-brick.conf) and change one line below:
[DEFAULT]
my_ip=your_host_ip

Configuration

  • Configure resource discovery in dock module
sudo cp examples/dock.json /etc/opensds
sudo cp examples/pool.json /etc/opensds
  • Create OpenSDS logging directory
sudo mkdir /var/log/opensds

Run OpenSDS Service

  • Start osdsdock with root access (for logging purpose)
sudo osdsdock //suppose the user has copied the compiled binary to /usr/local/bin
  • Start osdslet with root access (for logging purpose)
sudo osdslet //suppose the user has copied the compiled binary to /usr/local/bin
  • Run osdsctl for operations you want to perform.
sudo osdsctl --help //see what you can do with opensds

Currently osdsctl supports all the basic Cinder/Manila operations, for example if you want to create a 1GB volume from a Dell-EMC VMAX, which is connected to the OpenSDS underlay infra - OpenStack Cinder via its in-tree vmax cinder driver, using OpenSDS for an easy access:

sudo sdsctl volume create 1 -n cinder-vmax-volume

Viola !