Skip to content
This repository has been archived by the owner on Jan 17, 2018. It is now read-only.

Improved documentation for Ubuntu15+ installations #39

Merged
merged 9 commits into from
Jun 23, 2016
Merged

Improved documentation for Ubuntu15+ installations #39

Changes from 8 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
916e285
Padding out with more detail
stephlocke Jun 22, 2016
9bd0e2c
Correcting some mistakes
stephlocke Jun 23, 2016
cfdfa4e
More revisions to tidy up
stephlocke Jun 23, 2016
e4dcae7
Removed remnant wording re: binary
stephlocke Jun 23, 2016
7810179
Agreed deletions
stephlocke Jun 23, 2016
129e7c5
Removed references to release directories
stephlocke Jun 23, 2016
1a61271
Making ubuntu version specific
stephlocke Jun 23, 2016
39d1d30
Improved wording
stephlocke Jun 23, 2016
bf1ba71
Shorter mkdir cmd
stephlocke Jun 23, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 15 additions & 4 deletions contrib/init/systemd/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,20 +3,31 @@
> NOTE: These instructions are valid for Ubuntu versions using `systemd` init
> system.

Run the following commands:
## TL;DR
1. Get the latest [release](https://github.com/Azure/azurefile-dockervolumedriver/releases)
2. Put the binary into `/usr/bin/azurefile-dockervolumedriver`
3. Get the .default and .service files and deploy them
4. Reload systemd

## In-depth walkthrough

0. `sudo -s`
0. Download the binary from “Releases” tab of the repo to `/opt/bin/`: `wget -qO/usr/bin/azurefile-dockervolumedriver [url]`
0. Make it executable: `chmod +x /usr/bin/azurefile-dockervolumedriver`
0. Use wget to get the `azurefile-dockervolumedriver.default` and `azurefile-dockervolumedriver.service` files from GitHub. These are in the `../contrib/init/systemd` directory.
0. Download the binary from the "Releases" tab of the repo to `/usr/bin/azurefile-dockervolumedriver`
+ Use wget to download to dir: `wget -qO/usr/bin/azurefile-dockervolumedriver https://github.com/Azure/azurefile-dockervolumedriver/releases/download/[VERSION]/azurefile-dockervolumedriver`
+ Make it executable `chmod +x /opt/bin/azurefile-dockervolumedriver`
0. Save the `.default` file to `/etc/default/azurefile-dockervolumedriver`
+ Copy the file: `cp azurefile-dockervolumedriver.default /etc/default/azurefile-dockervolumedriver`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

well, they don't have it on their disk at this point. so maybe we should point them to the file with something like:

- download [azurefile-dockervolumedriver.default](../path/to/azurefile-dockervolumedriver.default) file first

0. Edit `/etc/default/azurefile-dockervolumedriver` with your Azure Storage Account credentials.
0. Save the `.service` file to `/etc/systemd/system/azurefile-dockervolumedriver.service`
+ [Ubuntu 15.x only] Make the requisite directories if they don't exist: `mkdir /etc/systemd && mkdir /etc/systemd/system`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these can be briefly done as mkdir -p /etc/systemd/system

+ Copy the relevant file: `cp azurefile-dockervolumedriver.service /etc/systemd/system/`
0. Run `systemctl daemon-reload`
0. Run `systemctl enable azurefile-dockervolumedriver`
0. Run `systemctl start azurefile-dockervolumedriver`
0. Check status via `systemctl status azurefile-dockervolumedriver`

Try by creating a volume and running a container with it:
To test, try to create a volume and running a container with it:

docker volume create -d azurefile --name myvol -o share=myvol
docker run -i -t -v myvol:/data busybox
Expand Down