config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
/*
|
|
|
|
* Minio Cloud Storage, (C) 2015, 2016 Minio, Inc.
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
2016-08-19 01:23:42 +02:00
|
|
|
package cmd
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"net"
|
|
|
|
"net/http"
|
2016-10-27 12:30:52 +02:00
|
|
|
"net/url"
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
"os"
|
|
|
|
"strconv"
|
|
|
|
"strings"
|
2016-05-31 20:53:21 +02:00
|
|
|
"time"
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
2016-10-28 17:45:32 +02:00
|
|
|
"regexp"
|
|
|
|
"runtime"
|
|
|
|
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
"github.com/minio/cli"
|
|
|
|
)
|
|
|
|
|
2016-09-02 00:12:49 +02:00
|
|
|
var serverFlags = []cli.Flag{
|
|
|
|
cli.StringFlag{
|
|
|
|
Name: "address",
|
|
|
|
Value: ":9000",
|
|
|
|
Usage: "Specify custom server \"ADDRESS:PORT\", defaults to \":9000\".",
|
|
|
|
},
|
|
|
|
cli.StringFlag{
|
|
|
|
Name: "ignore-disks",
|
|
|
|
Usage: "Specify comma separated list of disks that are offline.",
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
},
|
2016-09-02 00:12:49 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
var serverCmd = cli.Command{
|
|
|
|
Name: "server",
|
|
|
|
Usage: "Start object storage server.",
|
|
|
|
Flags: append(serverFlags, globalFlags...),
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
Action: serverMain,
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
CustomHelpTemplate: `NAME:
|
|
|
|
minio {{.Name}} - {{.Usage}}
|
|
|
|
|
|
|
|
USAGE:
|
2016-08-29 05:04:47 +02:00
|
|
|
minio {{.Name}} [FLAGS] PATH [PATH...]
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
2016-08-29 05:04:47 +02:00
|
|
|
FLAGS:
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
{{range .Flags}}{{.}}
|
|
|
|
{{end}}
|
|
|
|
ENVIRONMENT VARIABLES:
|
2016-07-10 23:38:15 +02:00
|
|
|
ACCESS:
|
|
|
|
MINIO_ACCESS_KEY: Access key string of 5 to 20 characters in length.
|
|
|
|
MINIO_SECRET_KEY: Secret key string of 8 to 40 characters in length.
|
|
|
|
|
|
|
|
CACHING:
|
|
|
|
MINIO_CACHE_SIZE: Set total cache size in NN[GB|MB|KB]. Defaults to 8GB.
|
|
|
|
MINIO_CACHE_EXPIRY: Set cache expiration duration in NN[h|m|s]. Defaults to 72 hours.
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
2016-10-05 21:48:07 +02:00
|
|
|
SECURITY:
|
|
|
|
MINIO_SECURE_CONSOLE: Set secure console to '0' to disable printing secret key. Defaults to '1'.
|
|
|
|
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
EXAMPLES:
|
|
|
|
1. Start minio server.
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
$ minio {{.Name}} /home/shared
|
|
|
|
|
|
|
|
2. Start minio server bound to a specific IP:PORT, when you have multiple network interfaces.
|
|
|
|
$ minio {{.Name}} --address 192.168.1.101:9000 /home/shared
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
3. Start minio server on Windows.
|
|
|
|
$ minio {{.Name}} C:\MyShare
|
2016-03-28 06:52:38 +02:00
|
|
|
|
2016-07-10 23:38:15 +02:00
|
|
|
4. Start minio server on 12 disks to enable erasure coded layer with 6 data and 6 parity.
|
2016-09-01 22:29:26 +02:00
|
|
|
$ minio {{.Name}} /mnt/export1/ /mnt/export2/ /mnt/export3/ /mnt/export4/ \
|
|
|
|
/mnt/export5/ /mnt/export6/ /mnt/export7/ /mnt/export8/ /mnt/export9/ \
|
|
|
|
/mnt/export10/ /mnt/export11/ /mnt/export12/
|
2016-07-10 23:38:15 +02:00
|
|
|
|
|
|
|
5. Start minio server on 12 disks while ignoring two disks for initialization.
|
2016-09-01 22:29:26 +02:00
|
|
|
$ minio {{.Name}} --ignore-disks=/mnt/export1/ /mnt/export1/ /mnt/export2/ \
|
2016-09-22 04:58:50 +02:00
|
|
|
/mnt/export3/ /mnt/export4/ /mnt/export5/ /mnt/export6/ /mnt/export7/ \
|
2016-09-01 22:29:26 +02:00
|
|
|
/mnt/export8/ /mnt/export9/ /mnt/export10/ /mnt/export11/ /mnt/export12/
|
2016-08-18 23:29:23 +02:00
|
|
|
|
2016-10-27 12:30:52 +02:00
|
|
|
6. Start minio server for a 4 node distributed setup. Type the following command on all the 4 nodes exactly.
|
2016-08-18 23:29:23 +02:00
|
|
|
$ export MINIO_ACCESS_KEY=minio
|
|
|
|
$ export MINIO_SECRET_KEY=miniostorage
|
2016-10-27 12:30:52 +02:00
|
|
|
$ minio {{.Name}} http://192.168.1.11/mnt/export/ http://192.168.1.12/mnt/export/ \
|
|
|
|
http://192.168.1.13/mnt/export/ http://192.168.1.14/mnt/export/
|
|
|
|
|
|
|
|
7. Start minio server on a 4 node distributed setup. Type the following command on all the 4 nodes exactly.
|
|
|
|
$ minio {{.Name}} http://minio:miniostorage@192.168.1.11/mnt/export/ \
|
|
|
|
http://minio:miniostorage@192.168.1.12/mnt/export/ \
|
|
|
|
http://minio:miniostorage@192.168.1.13/mnt/export/ \
|
|
|
|
http://minio:miniostorage@192.168.1.14/mnt/export/
|
2016-09-01 22:29:26 +02:00
|
|
|
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
`,
|
|
|
|
}
|
|
|
|
|
2016-04-12 21:45:15 +02:00
|
|
|
type serverCmdConfig struct {
|
2016-10-18 21:49:24 +02:00
|
|
|
serverAddr string
|
2016-10-27 12:30:52 +02:00
|
|
|
endpoints []*url.URL
|
|
|
|
ignoredEndpoints []*url.URL
|
2016-10-18 21:49:24 +02:00
|
|
|
isDistXL bool // True only if its distributed XL.
|
|
|
|
storageDisks []StorageAPI
|
|
|
|
}
|
|
|
|
|
2016-10-27 12:30:52 +02:00
|
|
|
// Parse an array of end-points (from the command line)
|
|
|
|
func parseStorageEndpoints(eps []string) (endpoints []*url.URL, err error) {
|
2016-10-18 21:49:24 +02:00
|
|
|
for _, ep := range eps {
|
|
|
|
if ep == "" {
|
2016-10-27 12:30:52 +02:00
|
|
|
return nil, errInvalidArgument
|
2016-10-18 21:49:24 +02:00
|
|
|
}
|
2016-10-27 12:30:52 +02:00
|
|
|
var u *url.URL
|
|
|
|
u, err = url.Parse(ep)
|
2016-10-18 21:49:24 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
2016-10-27 12:30:52 +02:00
|
|
|
if u.Host != "" && globalMinioHost == "" {
|
|
|
|
u.Host = net.JoinHostPort(u.Host, globalMinioPort)
|
|
|
|
}
|
|
|
|
endpoints = append(endpoints, u)
|
2016-10-18 21:49:24 +02:00
|
|
|
}
|
|
|
|
return endpoints, nil
|
2016-04-12 21:45:15 +02:00
|
|
|
}
|
|
|
|
|
2016-05-07 06:18:29 +02:00
|
|
|
// getListenIPs - gets all the ips to listen on.
|
2016-10-24 08:55:12 +02:00
|
|
|
func getListenIPs(httpServerConf *http.Server) (hosts []string, port string, err error) {
|
|
|
|
var host string
|
|
|
|
host, port, err = net.SplitHostPort(httpServerConf.Addr)
|
|
|
|
if err != nil {
|
|
|
|
return nil, port, fmt.Errorf("Unable to parse host address %s", err)
|
2016-07-13 08:21:18 +02:00
|
|
|
}
|
2016-10-24 08:55:12 +02:00
|
|
|
if host == "" {
|
2016-10-24 11:43:16 +02:00
|
|
|
var ipv4s []net.IP
|
|
|
|
ipv4s, err = getInterfaceIPv4s()
|
2016-10-24 08:55:12 +02:00
|
|
|
if err != nil {
|
|
|
|
return nil, port, fmt.Errorf("Unable reverse sorted ips from hosts %s", err)
|
|
|
|
}
|
2016-10-24 11:43:16 +02:00
|
|
|
for _, ip := range ipv4s {
|
|
|
|
hosts = append(hosts, ip.String())
|
|
|
|
}
|
2016-10-24 08:55:12 +02:00
|
|
|
return hosts, port, nil
|
|
|
|
} // if host != "" {
|
|
|
|
// Proceed to append itself, since user requested a specific endpoint.
|
|
|
|
hosts = append(hosts, host)
|
|
|
|
return hosts, port, nil
|
2016-05-07 06:18:29 +02:00
|
|
|
}
|
|
|
|
|
2016-07-13 08:21:18 +02:00
|
|
|
// Finalizes the endpoints based on the host list and port.
|
|
|
|
func finalizeEndpoints(tls bool, apiServer *http.Server) (endPoints []string) {
|
|
|
|
// Verify current scheme.
|
|
|
|
scheme := "http"
|
|
|
|
if tls {
|
|
|
|
scheme = "https"
|
|
|
|
}
|
|
|
|
|
2016-10-24 08:55:12 +02:00
|
|
|
// Get list of listen ips and port.
|
|
|
|
hosts, port, err := getListenIPs(apiServer)
|
|
|
|
fatalIf(err, "Unable to get list of ips to listen on")
|
2016-07-13 15:34:59 +02:00
|
|
|
|
2016-07-13 08:21:18 +02:00
|
|
|
// Construct proper endpoints.
|
2016-10-24 08:55:12 +02:00
|
|
|
for _, host := range hosts {
|
|
|
|
endPoints = append(endPoints, fmt.Sprintf("%s://%s:%s", scheme, host, port))
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
}
|
2016-07-13 08:21:18 +02:00
|
|
|
|
|
|
|
// Success.
|
|
|
|
return endPoints
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
}
|
|
|
|
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
// initServerConfig initialize server config.
|
|
|
|
func initServerConfig(c *cli.Context) {
|
2016-07-30 23:55:20 +02:00
|
|
|
// Create certs path.
|
|
|
|
err := createCertsPath()
|
|
|
|
fatalIf(err, "Unable to create \"certs\" directory.")
|
|
|
|
|
2016-06-26 12:18:07 +02:00
|
|
|
// Fetch max conn limit from environment variable.
|
|
|
|
if maxConnStr := os.Getenv("MINIO_MAXCONN"); maxConnStr != "" {
|
|
|
|
// We need to parse to its integer value.
|
|
|
|
globalMaxConn, err = strconv.Atoi(maxConnStr)
|
|
|
|
fatalIf(err, "Unable to convert MINIO_MAXCONN=%s environment variable into its integer value.", maxConnStr)
|
|
|
|
}
|
|
|
|
|
2016-07-04 01:58:21 +02:00
|
|
|
// Fetch max cache size from environment variable.
|
|
|
|
if maxCacheSizeStr := os.Getenv("MINIO_CACHE_SIZE"); maxCacheSizeStr != "" {
|
|
|
|
// We need to parse cache size to its integer value.
|
|
|
|
globalMaxCacheSize, err = strconvBytes(maxCacheSizeStr)
|
|
|
|
fatalIf(err, "Unable to convert MINIO_CACHE_SIZE=%s environment variable into its integer value.", maxCacheSizeStr)
|
|
|
|
}
|
|
|
|
|
2016-07-09 05:34:27 +02:00
|
|
|
// Fetch cache expiry from environment variable.
|
|
|
|
if cacheExpiryStr := os.Getenv("MINIO_CACHE_EXPIRY"); cacheExpiryStr != "" {
|
|
|
|
// We need to parse cache expiry to its time.Duration value.
|
|
|
|
globalCacheExpiry, err = time.ParseDuration(cacheExpiryStr)
|
|
|
|
fatalIf(err, "Unable to convert MINIO_CACHE_EXPIRY=%s environment variable into its time.Duration value.", cacheExpiryStr)
|
|
|
|
}
|
|
|
|
|
2016-10-18 08:14:41 +02:00
|
|
|
// When credentials inherited from the env, server cmd has to save them in the disk
|
|
|
|
if os.Getenv("MINIO_ACCESS_KEY") != "" && os.Getenv("MINIO_SECRET_KEY") != "" {
|
|
|
|
// Env credentials are already loaded in serverConfig, just save in the disk
|
2016-08-03 01:48:21 +02:00
|
|
|
err = serverConfig.Save()
|
2016-10-18 08:14:41 +02:00
|
|
|
fatalIf(err, "Unable to save credentials in the disk.")
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
}
|
2016-04-19 07:05:32 +02:00
|
|
|
|
|
|
|
// Set maxOpenFiles, This is necessary since default operating
|
|
|
|
// system limits of 1024, 2048 are not enough for Minio server.
|
|
|
|
setMaxOpenFiles()
|
2016-10-06 22:35:56 +02:00
|
|
|
|
2016-07-30 17:50:49 +02:00
|
|
|
// Set maxMemory, This is necessary since default operating
|
|
|
|
// system limits might be changed and we need to make sure we
|
|
|
|
// do not crash the server so the set the maxCacheSize appropriately.
|
|
|
|
setMaxMemory()
|
|
|
|
|
2016-04-19 07:05:32 +02:00
|
|
|
// Do not fail if this is not allowed, lower limits are fine as well.
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
}
|
|
|
|
|
2016-08-26 09:11:53 +02:00
|
|
|
// Validate if input disks are sufficient for initializing XL.
|
2016-10-27 12:30:52 +02:00
|
|
|
func checkSufficientDisks(eps []*url.URL) error {
|
2016-08-26 09:11:53 +02:00
|
|
|
// Verify total number of disks.
|
2016-10-18 21:49:24 +02:00
|
|
|
total := len(eps)
|
|
|
|
if total > maxErasureBlocks {
|
2016-08-26 09:11:53 +02:00
|
|
|
return errXLMaxDisks
|
|
|
|
}
|
2016-10-18 21:49:24 +02:00
|
|
|
if total < minErasureBlocks {
|
2016-08-26 09:11:53 +02:00
|
|
|
return errXLMinDisks
|
|
|
|
}
|
|
|
|
|
|
|
|
// isEven function to verify if a given number if even.
|
|
|
|
isEven := func(number int) bool {
|
|
|
|
return number%2 == 0
|
|
|
|
}
|
|
|
|
|
|
|
|
// Verify if we have even number of disks.
|
|
|
|
// only combination of 4, 6, 8, 10, 12, 14, 16 are supported.
|
2016-10-18 21:49:24 +02:00
|
|
|
if !isEven(total) {
|
2016-08-26 09:11:53 +02:00
|
|
|
return errXLNumDisks
|
|
|
|
}
|
|
|
|
|
|
|
|
// Success.
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
2016-08-24 04:19:24 +02:00
|
|
|
// Returns if slice of disks is a distributed setup.
|
2016-10-27 12:30:52 +02:00
|
|
|
func isDistributedSetup(eps []*url.URL) (isDist bool) {
|
|
|
|
// Validate if one the disks is not local.
|
2016-10-18 21:49:24 +02:00
|
|
|
for _, ep := range eps {
|
|
|
|
if !isLocalStorage(ep) {
|
2016-08-24 04:19:24 +02:00
|
|
|
// One or more disks supplied as arguments are not
|
|
|
|
// attached to the local node.
|
|
|
|
isDist = true
|
2016-10-27 12:30:52 +02:00
|
|
|
break
|
2016-08-24 04:19:24 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
return isDist
|
|
|
|
}
|
|
|
|
|
2016-10-28 17:45:32 +02:00
|
|
|
// We just exit for invalid endpoints.
|
|
|
|
func checkEndpointsSyntax(eps []*url.URL, disks []string) {
|
|
|
|
for i, u := range eps {
|
|
|
|
switch u.Scheme {
|
|
|
|
case "", "http", "https":
|
|
|
|
// Scheme is "" for FS and singlenode-XL, hence pass.
|
|
|
|
default:
|
|
|
|
if runtime.GOOS == "windows" {
|
|
|
|
// On windows for "C:\export" scheme will be "C"
|
|
|
|
matched, err := regexp.MatchString("^[a-zA-Z]$", u.Scheme)
|
|
|
|
fatalIf(err, "Parsing scheme : %s (%s)", u.Scheme, disks[i])
|
|
|
|
if matched {
|
|
|
|
break
|
|
|
|
}
|
|
|
|
}
|
|
|
|
fatalIf(errInvalidArgument, "Invalid scheme : %s (%s)", u.Scheme, disks[i])
|
|
|
|
}
|
|
|
|
if runtime.GOOS == "windows" {
|
|
|
|
if u.Scheme == "http" || u.Scheme == "https" {
|
|
|
|
// "http://server1/" is not allowed
|
|
|
|
if u.Path == "" || u.Path == "/" || u.Path == "\\" {
|
|
|
|
fatalIf(errInvalidArgument, "Empty path for %s", disks[i])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
if u.Scheme == "http" || u.Scheme == "https" {
|
|
|
|
// "http://server1/" is not allowed.
|
|
|
|
if u.Path == "" || u.Path == "/" {
|
|
|
|
fatalIf(errInvalidArgument, "Empty path for %s", disks[i])
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
// "/" is not allowed.
|
|
|
|
if u.Path == "" || u.Path == "/" {
|
|
|
|
fatalIf(errInvalidArgument, "Empty path for %s", disks[i])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if err := checkDuplicateEndpoints(eps); err != nil {
|
|
|
|
fatalIf(errInvalidArgument, "Duplicate entries in %s", strings.Join(disks, " "))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// Make sure all the command line parameters are OK and exit in case of invalid parameters.
|
|
|
|
func checkServerSyntax(c *cli.Context) {
|
|
|
|
serverAddr := c.String("address")
|
|
|
|
|
|
|
|
host, portStr, err := net.SplitHostPort(serverAddr)
|
|
|
|
fatalIf(err, "Unable to parse %s.", serverAddr)
|
|
|
|
|
|
|
|
// Verify syntax for all the XL disks.
|
|
|
|
disks := c.Args()
|
|
|
|
endpoints, err := parseStorageEndpoints(disks)
|
|
|
|
fatalIf(err, "Unable to parse storage endpoints %s", disks)
|
|
|
|
checkEndpointsSyntax(endpoints, disks)
|
|
|
|
|
|
|
|
if len(endpoints) > 1 {
|
|
|
|
// For XL setup.
|
|
|
|
err = checkSufficientDisks(endpoints)
|
|
|
|
fatalIf(err, "Storage endpoint error.")
|
|
|
|
}
|
|
|
|
|
|
|
|
// Verify syntax for all the ignored disks.
|
|
|
|
var ignoredEndpoints []*url.URL
|
|
|
|
ignoredDisksStr := c.String("ignore-disks")
|
|
|
|
if ignoredDisksStr != "" {
|
|
|
|
ignoredDisks := strings.Split(ignoredDisksStr, ",")
|
|
|
|
if len(endpoints) == 1 {
|
|
|
|
fatalIf(errInvalidArgument, "--ignore-disks is valid only for XL setup.")
|
|
|
|
}
|
|
|
|
ignoredEndpoints, err = parseStorageEndpoints(ignoredDisks)
|
|
|
|
fatalIf(err, "Unable to parse ignored storage endpoints %s", ignoredDisks)
|
|
|
|
checkEndpointsSyntax(ignoredEndpoints, ignoredDisks)
|
|
|
|
|
|
|
|
for i, ep := range ignoredEndpoints {
|
|
|
|
// An ignored disk should be present in the XL disks list.
|
|
|
|
if !containsEndpoint(endpoints, ep) {
|
|
|
|
fatalIf(errInvalidArgument, "Ignored storage %s not available in the list of erasure storages list.", disks[i])
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if !isDistributedSetup(endpoints) {
|
|
|
|
// for FS and singlenode-XL validation is done, return.
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
// Rest of the checks applies only to distributed XL setup.
|
|
|
|
if host != "" {
|
|
|
|
// We are here implies --address host:port is passed, hence the user is trying
|
|
|
|
// to run one minio process per export disk.
|
|
|
|
if portStr == "" {
|
|
|
|
fatalIf(errInvalidArgument, "Port missing, Host:Port should be specified for --address")
|
|
|
|
}
|
|
|
|
foundCnt := 0
|
|
|
|
for _, ep := range endpoints {
|
|
|
|
if ep.Host == serverAddr {
|
|
|
|
foundCnt++
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if foundCnt == 0 {
|
|
|
|
// --address host:port should be available in the XL disk list.
|
|
|
|
fatalIf(errInvalidArgument, "%s is not available in %s", serverAddr, strings.Join(disks, " "))
|
|
|
|
}
|
|
|
|
if foundCnt > 1 {
|
|
|
|
// --address host:port should match exactly one entry in the XL disk list.
|
|
|
|
fatalIf(errInvalidArgument, "%s matches % entries in %s", serverAddr, foundCnt, strings.Join(disks, " "))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
tls := isSSL()
|
|
|
|
for _, ep := range endpoints {
|
|
|
|
if ep.Scheme == "https" && !tls {
|
|
|
|
// Certificates should be provided for https configuration.
|
|
|
|
fatalIf(errInvalidArgument, "Certificates not provided for https")
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2016-07-13 08:21:18 +02:00
|
|
|
// serverMain handler called for 'minio server' command.
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
func serverMain(c *cli.Context) {
|
2016-10-05 21:48:07 +02:00
|
|
|
if !c.Args().Present() || c.Args().First() == "help" {
|
|
|
|
cli.ShowCommandHelpAndExit(c, "server", 1)
|
|
|
|
}
|
2016-07-01 23:32:53 +02:00
|
|
|
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
// Server address.
|
2016-10-10 08:03:10 +02:00
|
|
|
serverAddr := c.String("address")
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
|
2016-04-12 21:45:15 +02:00
|
|
|
// Check if requested port is available.
|
2016-10-18 21:49:24 +02:00
|
|
|
host, portStr, err := net.SplitHostPort(serverAddr)
|
|
|
|
fatalIf(err, "Unable to parse %s.", serverAddr)
|
|
|
|
globalMinioHost = host
|
config: Migrate to the new version. Remove backend details.
Migrate to new config format v4.
```
{
"version": "4",
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"console": {
"enable": true,
"level": "fatal"
},
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
}
}
}
```
This patch also updates [minio cli spec](./minio.md)
2016-04-02 04:19:44 +02:00
|
|
|
|
2016-10-27 12:30:52 +02:00
|
|
|
// Check if requested port is available.
|
|
|
|
fatalIf(checkPortAvailability(portStr), "Port unavailable %s", portStr)
|
|
|
|
globalMinioPort = portStr
|
|
|
|
|
2016-10-28 17:45:32 +02:00
|
|
|
// Check server syntax and exit in case of errors.
|
|
|
|
// Done after globalMinioHost and globalMinioPort is set as parseStorageEndpoints()
|
|
|
|
// depends on it.
|
|
|
|
checkServerSyntax(c)
|
|
|
|
|
2016-07-10 23:38:15 +02:00
|
|
|
// Disks to be ignored in server init, to skip format healing.
|
2016-10-27 12:30:52 +02:00
|
|
|
var ignoredEndpoints []*url.URL
|
|
|
|
if len(c.String("ignore-disks")) > 0 {
|
|
|
|
ignoredEndpoints, err = parseStorageEndpoints(strings.Split(c.String("ignore-disks"), ","))
|
|
|
|
fatalIf(err, "Unable to parse storage endpoints %s", strings.Split(c.String("ignore-disks"), ","))
|
|
|
|
}
|
2016-07-10 23:38:15 +02:00
|
|
|
|
|
|
|
// Disks to be used in server init.
|
2016-10-27 12:30:52 +02:00
|
|
|
endpoints, err := parseStorageEndpoints(c.Args())
|
2016-10-18 21:49:24 +02:00
|
|
|
fatalIf(err, "Unable to parse storage endpoints %s", c.Args())
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
2016-10-28 17:45:32 +02:00
|
|
|
storageDisks, err := initStorageDisks(endpoints, ignoredEndpoints)
|
|
|
|
fatalIf(err, "Unable to initialize storage disks.")
|
2016-10-06 22:35:56 +02:00
|
|
|
|
2016-10-20 04:59:48 +02:00
|
|
|
// Cleanup objects that weren't successfully written into the namespace.
|
|
|
|
fatalIf(houseKeeping(storageDisks), "Unable to purge temporary files.")
|
|
|
|
|
2016-10-27 12:30:52 +02:00
|
|
|
// Initialize server config.
|
|
|
|
initServerConfig(c)
|
|
|
|
|
2016-10-05 21:48:07 +02:00
|
|
|
// First disk argument check if it is local.
|
2016-10-27 12:30:52 +02:00
|
|
|
firstDisk := isLocalStorage(endpoints[0])
|
2016-10-05 21:48:07 +02:00
|
|
|
|
2016-10-28 17:45:32 +02:00
|
|
|
// Check if endpoints are part of distributed setup.
|
|
|
|
isDistXL := isDistributedSetup(endpoints)
|
|
|
|
|
fs: Break fs package to top-level and introduce ObjectAPI interface.
ObjectAPI interface brings in changes needed for XL ObjectAPI layer.
The new interface for any ObjectAPI layer is as below
```
// ObjectAPI interface.
type ObjectAPI interface {
// Bucket resource API.
DeleteBucket(bucket string) *probe.Error
ListBuckets() ([]BucketInfo, *probe.Error)
MakeBucket(bucket string) *probe.Error
GetBucketInfo(bucket string) (BucketInfo, *probe.Error)
// Bucket query API.
ListObjects(bucket, prefix, marker, delimiter string, maxKeys int) (ListObjectsResult, *probe.Error)
ListMultipartUploads(bucket string, resources BucketMultipartResourcesMetadata) (BucketMultipartResourcesMetadata, *probe.Error)
// Object resource API.
GetObject(bucket, object string, startOffset int64) (io.ReadCloser, *probe.Error)
GetObjectInfo(bucket, object string) (ObjectInfo, *probe.Error)
PutObject(bucket string, object string, size int64, data io.Reader, metadata map[string]string) (ObjectInfo, *probe.Error)
DeleteObject(bucket, object string) *probe.Error
// Object query API.
NewMultipartUpload(bucket, object string) (string, *probe.Error)
PutObjectPart(bucket, object, uploadID string, partID int, size int64, data io.Reader, md5Hex string) (string, *probe.Error)
ListObjectParts(bucket, object string, resources ObjectResourcesMetadata) (ObjectResourcesMetadata, *probe.Error)
CompleteMultipartUpload(bucket string, object string, uploadID string, parts []CompletePart) (ObjectInfo, *probe.Error)
AbortMultipartUpload(bucket, object, uploadID string) *probe.Error
}
```
2016-03-31 01:15:28 +02:00
|
|
|
// Configure server.
|
2016-10-05 21:48:07 +02:00
|
|
|
srvConfig := serverCmdConfig{
|
2016-10-18 21:49:24 +02:00
|
|
|
serverAddr: serverAddr,
|
2016-10-27 12:30:52 +02:00
|
|
|
endpoints: endpoints,
|
|
|
|
ignoredEndpoints: ignoredEndpoints,
|
2016-10-18 21:49:24 +02:00
|
|
|
storageDisks: storageDisks,
|
2016-10-27 12:30:52 +02:00
|
|
|
isDistXL: isDistXL,
|
2016-07-31 23:11:14 +02:00
|
|
|
}
|
2016-08-31 04:22:27 +02:00
|
|
|
|
2016-07-31 23:11:14 +02:00
|
|
|
// Configure server.
|
2016-10-13 08:13:24 +02:00
|
|
|
handler, err := configureServerHandler(srvConfig)
|
|
|
|
fatalIf(err, "Unable to configure one of server's RPC services.")
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
2016-10-05 21:48:07 +02:00
|
|
|
// Set nodes for dsync for distributed setup.
|
2016-10-27 12:30:52 +02:00
|
|
|
if isDistXL {
|
|
|
|
fatalIf(initDsyncNodes(endpoints), "Unable to initialize distributed locking")
|
2016-10-05 21:48:07 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Initialize name space lock.
|
2016-10-27 12:30:52 +02:00
|
|
|
initNSLock(isDistXL)
|
2016-10-05 21:48:07 +02:00
|
|
|
|
|
|
|
// Initialize a new HTTP server.
|
2016-10-10 08:03:10 +02:00
|
|
|
apiServer := NewServerMux(serverAddr, handler)
|
2016-08-12 06:33:55 +02:00
|
|
|
|
2016-10-28 17:45:32 +02:00
|
|
|
// If https.
|
|
|
|
tls := isSSL()
|
|
|
|
|
2016-07-13 08:21:18 +02:00
|
|
|
// Fetch endpoints which we are going to serve from.
|
2016-07-24 21:30:57 +02:00
|
|
|
endPoints := finalizeEndpoints(tls, &apiServer.Server)
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
|
2016-10-18 01:38:29 +02:00
|
|
|
// Initialize local server address
|
|
|
|
globalMinioAddr = getLocalAddress(srvConfig)
|
|
|
|
|
|
|
|
// Initialize S3 Peers inter-node communication
|
2016-10-27 12:30:52 +02:00
|
|
|
initGlobalS3Peers(endpoints)
|
2016-10-18 01:38:29 +02:00
|
|
|
|
2016-10-10 08:03:10 +02:00
|
|
|
// Start server, automatically configures TLS if certs are available.
|
|
|
|
go func(tls bool) {
|
|
|
|
var lerr error
|
|
|
|
if tls {
|
|
|
|
lerr = apiServer.ListenAndServeTLS(mustGetCertFile(), mustGetKeyFile())
|
|
|
|
} else {
|
|
|
|
// Fallback to http.
|
|
|
|
lerr = apiServer.ListenAndServe()
|
|
|
|
}
|
|
|
|
fatalIf(lerr, "Failed to start minio server.")
|
|
|
|
}(tls)
|
2016-09-14 10:11:03 +02:00
|
|
|
|
|
|
|
// Wait for formatting of disks.
|
2016-10-27 12:30:52 +02:00
|
|
|
err = waitForFormatDisks(firstDisk, endpoints[0], storageDisks)
|
2016-10-05 21:48:07 +02:00
|
|
|
fatalIf(err, "formatting storage disks failed")
|
2016-09-14 10:11:03 +02:00
|
|
|
|
|
|
|
// Once formatted, initialize object layer.
|
2016-10-05 21:48:07 +02:00
|
|
|
newObject, err := newObjectLayer(storageDisks)
|
|
|
|
fatalIf(err, "intializing object layer failed")
|
2016-09-13 20:00:40 +02:00
|
|
|
|
2016-10-10 08:03:10 +02:00
|
|
|
globalObjLayerMutex.Lock()
|
2016-08-31 04:22:27 +02:00
|
|
|
globalObjectAPI = newObject
|
2016-10-10 08:03:10 +02:00
|
|
|
globalObjLayerMutex.Unlock()
|
2016-08-05 22:48:31 +02:00
|
|
|
|
2016-10-05 21:48:07 +02:00
|
|
|
// Prints the formatted startup message once object layer is initialized.
|
|
|
|
printStartupMessage(endPoints)
|
|
|
|
|
2016-09-14 10:11:03 +02:00
|
|
|
// Waits on the server.
|
2016-10-10 08:03:10 +02:00
|
|
|
<-globalServiceDoneCh
|
config/main: Re-write config files - add to new config v3
- New config format.
```
{
"version": "3",
"address": ":9000",
"backend": {
"type": "fs",
"disk": "/path"
},
"credential": {
"accessKey": "WLGDGYAQYIGI833EV05A",
"secretKey": "BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF"
},
"region": "us-east-1",
"logger": {
"file": {
"enable": false,
"fileName": "",
"level": "error"
},
"syslog": {
"enable": false,
"address": "",
"level": "debug"
},
"console": {
"enable": true,
"level": "fatal"
}
}
}
```
New command lines in lieu of supporting XL.
Minio initialize filesystem backend.
~~~
$ minio init fs <path>
~~~
Minio initialize XL backend.
~~~
$ minio init xl <url1>...<url16>
~~~
For 'fs' backend it starts the server.
~~~
$ minio server
~~~
For 'xl' backend it waits for servers to join.
~~~
$ minio server
... [PROGRESS BAR] of servers connecting
~~~
Now on other servers execute 'join' and they connect.
~~~
....
minio join <url1> -- from <url2> && minio server
minio join <url1> -- from <url3> && minio server
...
...
minio join <url1> -- from <url16> && minio server
~~~
2016-02-13 00:27:10 +01:00
|
|
|
}
|