# How To Use Persistent Volumes
The purpose of this guide is to help you understand storage provisioning by creating a WordPress blog and MySQL database.
In this example, both the blog and database require persistent storage.
This guide assumes knowledge of OpenShift fundamentals and that you have a cluster up and running. Please review steps 1 - 10 in the
[sample-app](https://github.com/openshift/origin/blob/master/examples/sample-app/README.md) to run an OpenShift cluster.
## Root access
The Wordpress Dockerhub image binds Apache to port 80 in the container, which requires root access. We can allow that
in this example, but those wishing to run a more secure cluster will want to ensure their images don't require root access (e.g, bind to high number ports, don't chown or chmod dirs, etc)
Allow Wordpress to bind to port 80 by editing the restricted security context restraint. Change "runAsUser" from ```MustRunAsRange``` to ```RunAsAny```.
```
$ oc edit scc restricted
apiVersion: v1
groups:
- system:authenticated
kind: SecurityContextConstraints
metadata:
creationTimestamp: 2015-06-26T14:01:03Z
name: restricted
resourceVersion: "59"
selfLink: /api/v1/securitycontextconstraints/restricted
uid: c827a79d-1c0b-11e5-9166-d4bed9b39058
runAsUser:
type: MustRunAsRange <-- change to RunAsAny
seLinuxContext:
type: MustRunAs
```
Changing the restricted security context as shown above allows the Wordpress container to bind to port 80.
## Storage Provisioning
OpenShift expects that storage volumes are provisioned by system administrator outside of OpenShift. As subsequent step, the system admin then tells OpenShift about these volumes by creating Persistent Volumes objects. Wearing your "system admin" hat, follow these guides to create Persistent Volumes named `pv001` and `pv002`.
* [NFS](nfs/README.md)
* [OpenStack Cinder](cinder/README.md)
- [Fibre Channel](fc/README.md)
## Persistent Volumes Claims
Now that the "system admin" guy has deployed some Persistent Volumes, you can continue as an application developer and actually use these volumes to store some MySQL and Wordpress data. From now on, the guide does not depend on the underlying storage technology!
```
# Create claims for storage.
# The claims in this example carefully match the volumes created above.
$ oc create -f examples/wordpress/pvc-wp.yaml
$ oc create -f examples/wordpress/pvc-mysql.yaml
$ oc get pvc
NAME LABELS STATUS VOLUME
claim-mysql map[] Bound pv0002
claim-wp map[] Bound pv0001
```
## MySQL
Launch the MySQL pod.
```
oc create -f examples/wordpress/pod-mysql.yaml
```
After a few moments, MySQL will be running and accessible via the pod's IP address. We don't know what the IP address
will be and we wouldn't want to hard-code that value in any pod that wants access to MySQL.
Create a service in front of MySQL that allows other pods to connect to it by name.
```
# This allows the pod to access MySQL via a service name instead of hard-coded host address
oc create -f examples/wordpress/service-mysql.yaml
```
## WordPress
We use the MySQL service defined above in our Wordpress pod. The variable WORDPRESS_DB_HOST is set to the name
of our MySQL service.
Because the Wordpress pod and MySQL service are running in the same namespace, we can reference the service by name. We
can also access a service in another namespace by using the name and namespace: ```mysql.another_namespace```. The fully qualified
name of the service would also work: ```mysql.<namespace>.svc.cluster.local```
```
- name: WORDPRESS_DB_HOST
# this is the name of the mysql service fronting the mysql pod in the same namespace
# expands to mysql.<namespace>.svc.cluster.local - where <namespace> is the current namespace
value: mysql
```
Launch the Wordpress pod and its corresponding service.
```
oc create -f examples/wordpress/pod-wordpress.yaml
oc create -f examples/wordpress/service-wp.yaml
oc get svc
NAME LABELS SELECTOR IP(S) PORT(S)
mysql name=mysql name=mysql 172.30.115.137 3306/TCP
wpfrontend name=wpfrontend name=wordpress 172.30.170.55 5055/TCP
```
## Start Blogging
In your browser, visit 172.30.170.55:5055 (your IP address will vary). The Wordpress install process will lead you through setting up the blog.