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
/ *
2019-08-13 06:25:34 +02:00
* MinIO Cloud Storage , ( C ) 2015 - 2019 MinIO , Inc .
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
*
* 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 (
2018-04-06 00:04:40 +02:00
"context"
2019-11-14 02:38:05 +01:00
"errors"
2018-05-09 04:04:36 +02:00
"fmt"
2020-03-19 00:19:29 +01:00
"net"
2017-07-13 01:33:21 +02:00
"net/http"
2017-03-07 04:35:26 +01:00
"os"
2017-07-13 01:33:21 +02:00
"os/signal"
2018-05-19 02:51:03 +02:00
"strings"
2017-07-13 01:33:21 +02:00
"syscall"
2020-03-22 20:16:36 +01: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
"github.com/minio/cli"
2019-10-04 19:35:33 +02:00
"github.com/minio/minio/cmd/config"
2018-04-22 04:23:54 +02:00
xhttp "github.com/minio/minio/cmd/http"
2018-04-06 00:04:40 +02:00
"github.com/minio/minio/cmd/logger"
2019-10-23 07:59:13 +02:00
"github.com/minio/minio/pkg/auth"
2018-05-31 21:30:15 +02:00
"github.com/minio/minio/pkg/certs"
2019-10-04 19:35:33 +02:00
"github.com/minio/minio/pkg/color"
"github.com/minio/minio/pkg/env"
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
)
2019-06-10 16:57:42 +02:00
// ServerFlags - server command specific flags
var ServerFlags = [ ] cli . Flag {
2016-09-02 00:12:49 +02:00
cli . StringFlag {
Name : "address" ,
2018-12-19 01:08:11 +01:00
Value : ":" + globalMinioDefaultPort ,
2018-11-21 02:35:33 +01:00
Usage : "bind to a specific ADDRESS:PORT, ADDRESS can be an IP or hostname" ,
2016-09-02 00:12:49 +02:00
} ,
}
var serverCmd = cli . Command {
Name : "server" ,
2018-11-21 02:35:33 +01:00
Usage : "start object storage server" ,
2019-06-10 16:57:42 +02:00
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 :
2017-03-16 20:21:58 +01:00
{ { . HelpName } } - { { . Usage } }
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
USAGE :
2018-02-16 02:45:57 +01:00
{ { . HelpName } } { { if . VisibleFlags } } [ FLAGS ] { { end } } DIR1 [ DIR2 . . ]
{ { . HelpName } } { { if . VisibleFlags } } [ FLAGS ] { { end } } DIR { 1. . .64 }
2019-12-17 05:30:57 +01:00
{ { . HelpName } } { { if . VisibleFlags } } [ FLAGS ] { { end } } DIR { 1. . .64 } DIR { 65. . .128 }
2018-02-16 02:45:57 +01:00
DIR :
DIR points to a directory on a filesystem . When you want to combine
multiple drives into a single large system , pass one directory per
filesystem separated by space . You may also use a ' ... ' convention
to abbreviate the directory arguments . Remote directories in a
distributed setup are encoded as HTTP ( s ) URIs .
2017-02-16 02:45:08 +01:00
{ { if . VisibleFlags } }
2016-08-29 05:04:47 +02:00
FLAGS :
2017-02-15 11:25:38 +01:00
{ { range . VisibleFlags } } { { . } }
2017-02-16 02:45:08 +01:00
{ { end } } { { end } }
2018-02-03 03:18:52 +01: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
EXAMPLES :
2016-11-10 08:37:12 +01:00
1. Start minio server on "/home/shared" directory .
2019-05-15 10:32:44 +02:00
{ { . Prompt } } { { . HelpName } } / home / shared
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
2020-04-22 08:59:13 +02:00
2. Start single node server with 64 local drives "/mnt/data1" to "/mnt/data64" .
{ { . Prompt } } { { . HelpName } } / mnt / data { 1. . .64 }
3. Start distributed minio server on an 32 node setup with 32 drives each , run following command on all the nodes
2019-05-15 10:32:44 +02:00
{ { . Prompt } } { { . EnvVarSetCommand } } MINIO_ACCESS_KEY { { . AssignmentOperator } } minio
{ { . Prompt } } { { . EnvVarSetCommand } } MINIO_SECRET_KEY { { . AssignmentOperator } } miniostorage
2020-03-27 05:07:39 +01:00
{ { . Prompt } } { { . HelpName } } http : //node{1...32}.example.com/mnt/export{1...32}
2018-05-19 02:51:03 +02:00
2020-04-22 08:59:13 +02:00
4. Start distributed minio server in an expanded setup , run the following command on all the nodes
2019-12-17 05:30:57 +01:00
{ { . Prompt } } { { . EnvVarSetCommand } } MINIO_ACCESS_KEY { { . AssignmentOperator } } minio
{ { . Prompt } } { { . EnvVarSetCommand } } MINIO_SECRET_KEY { { . AssignmentOperator } } miniostorage
2020-03-27 05:07:39 +01:00
{ { . Prompt } } { { . HelpName } } http : //node{1...16}.example.com/mnt/export{1...32} \
http : //node{17...64}.example.com/mnt/export{1...64}
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
` ,
}
2018-05-19 02:51:03 +02:00
// Checks if endpoints are either available through environment
// or command line, returns false if both fails.
func endpointsPresent ( ctx * cli . Context ) bool {
2019-10-31 07:39:09 +01:00
endpoints := env . Get ( config . EnvEndpoints , strings . Join ( ctx . Args ( ) , config . ValueSeparator ) )
return len ( endpoints ) != 0
2018-05-19 02:51:03 +02:00
}
2017-03-30 20:21:19 +02:00
func serverHandleCmdArgs ( ctx * cli . Context ) {
2017-06-10 04:50:51 +02:00
// Handle common command args.
handleCommonCmdArgs ( ctx )
2017-03-29 17:55:33 +02:00
2018-12-19 01:08:11 +01:00
logger . FatalIf ( CheckLocalServerAddr ( globalCLIContext . Addr ) , "Unable to validate passed arguments" )
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
2017-04-12 00:44:27 +02:00
var setupType SetupType
2017-01-11 22:59:51 +01:00
var err error
2017-08-16 00:10:50 +02:00
2019-11-26 20:42:10 +01:00
globalMinioAddr = globalCLIContext . Addr
globalMinioHost , globalMinioPort = mustSplitHostPort ( globalMinioAddr )
2019-10-08 07:47:56 +02:00
endpoints := strings . Fields ( env . Get ( config . EnvEndpoints , "" ) )
2018-05-19 02:51:03 +02:00
if len ( endpoints ) > 0 {
2019-11-21 13:24:51 +01:00
globalEndpoints , globalXLSetDriveCount , setupType , err = createServerEndpoints ( globalCLIContext . Addr , endpoints ... )
2018-05-19 02:51:03 +02:00
} else {
2019-11-21 13:24:51 +01:00
globalEndpoints , globalXLSetDriveCount , setupType , err = createServerEndpoints ( globalCLIContext . Addr , ctx . Args ( ) ... )
2018-05-19 02:51:03 +02:00
}
2018-05-09 04:04:36 +02:00
logger . FatalIf ( err , "Invalid command line arguments" )
2018-02-16 02:45:57 +01:00
2018-05-09 04:04:36 +02:00
// On macOS, if a process already listens on LOCALIPADDR:PORT, net.Listen() falls back
// to IPv6 address ie minio will start listening on IPv6 address whereas another
// (non-)minio process is listening on IPv4 of given port.
2020-01-04 02:43:16 +01:00
// To avoid this error situation we check for port availability.
2019-06-25 00:02:40 +02:00
logger . FatalIf ( checkPortAvailability ( globalMinioHost , globalMinioPort ) , "Unable to start the server" )
2016-08-31 04:22:27 +02:00
2017-04-12 00:44:27 +02:00
globalIsXL = ( setupType == XLSetupType )
globalIsDistXL = ( setupType == DistXLSetupType )
if globalIsDistXL {
2017-01-23 09:32:55 +01:00
globalIsXL = true
}
2017-03-30 20:21:19 +02:00
}
func serverHandleEnvVars ( ) {
2017-06-10 04:50:51 +02:00
// Handle common environment variables.
handleCommonEnvVars ( )
2017-03-30 20:21:19 +02:00
}
2019-11-09 18:27:23 +01:00
func newAllSubsystems ( ) {
// Create new notification system and initialize notification targets
globalNotificationSys = NewNotificationSys ( globalEndpoints )
2019-10-31 07:39:09 +01:00
// Create a new config system.
globalConfigSys = NewConfigSys ( )
// Create new IAM system.
globalIAMSys = NewIAMSys ( )
2019-11-09 18:27:23 +01:00
// Create new policy system.
globalPolicySys = NewPolicySys ( )
// Create new lifecycle system.
globalLifecycleSys = NewLifecycleSys ( )
2020-02-05 10:42:34 +01:00
// Create new bucket encryption subsystem
globalBucketSSEConfigSys = NewBucketSSEConfigSys ( )
2020-05-04 18:42:58 +02:00
// Create new bucket quota subsystem
globalBucketQuotaSys = NewBucketQuotaSys ( )
2019-11-09 18:27:23 +01:00
}
2020-05-05 05:04:06 +02:00
func initSafeMode ( ) ( err error ) {
2019-11-20 02:42:27 +01:00
newObject := newObjectLayerWithoutSafeModeFn ( )
// Make sure to hold lock for entire migration to avoid
// such that only one server should migrate the entire config
// at a given time, this big transaction lock ensures this
// appropriately. This is also true for rotation of encrypted
// content.
2020-05-05 05:04:06 +02:00
txnLk := newObject . NewNSLock ( GlobalContext , minioMetaBucket , minioConfigPrefix + "/transaction.lock" )
defer func ( txnLk RWLocker ) {
txnLk . Unlock ( )
2019-11-20 02:42:27 +01:00
2019-11-09 18:27:23 +01:00
if err != nil {
2019-11-14 02:38:05 +01:00
var cerr config . Err
2020-05-05 05:04:06 +02:00
// For any config error, we don't need to drop into safe-mode
// instead its a user error and should be fixed by user.
2019-11-14 02:38:05 +01:00
if errors . As ( err , & cerr ) {
2019-11-11 21:01:21 +01:00
return
}
2019-12-05 00:32:37 +01:00
2019-11-09 18:27:23 +01:00
// Prints the formatted startup message in safe mode operation.
2020-05-05 05:04:06 +02:00
// Drops-into safe mode where users need to now manually recover
// the server.
2019-11-09 18:27:23 +01:00
printStartupSafeModeMessage ( getAPIEndpoints ( ) , err )
// Initialization returned error reaching safe mode and
// not proceeding waiting for admin action.
handleSignals ( )
}
2020-05-05 05:04:06 +02:00
} ( txnLk )
2019-10-31 07:39:09 +01:00
2019-11-09 18:27:23 +01:00
// **** WARNING ****
// Migrating to encrypted backend should happen before initialization of any
// sub-systems, make sure that we do not move the above codeblock elsewhere.
2020-05-05 05:04:06 +02:00
// Create cancel context to control 'newRetryTimer' go routine.
retryCtx , cancel := context . WithCancel ( GlobalContext )
2019-11-09 18:27:23 +01:00
2020-05-05 05:04:06 +02:00
// Indicate to our routine to exit cleanly upon return.
defer cancel ( )
2020-02-02 02:07:43 +01:00
// Initializing sub-systems needs a retry mechanism for
// the following reasons:
// - Read quorum is lost just after the initialization
// of the object layer.
// - Write quorum not met when upgrading configuration
// version is needed, migration is needed etc.
2020-05-05 05:04:06 +02:00
rquorum := InsufficientReadQuorum { }
wquorum := InsufficientWriteQuorum { }
2020-05-06 23:25:05 +02:00
for range newRetryTimerSimple ( retryCtx ) {
2020-05-05 05:04:06 +02:00
// let one of the server acquire the lock, if not let them timeout.
// which shall be retried again by this loop.
2020-05-06 23:25:05 +02:00
if err = txnLk . GetLock ( leaderLockTimeout ) ; err != nil {
logger . Info ( "Waiting for all MinIO sub-systems to be initialized.. trying to acquire lock" )
continue
}
2020-05-08 01:12:16 +02:00
// These messages only meant primarily for distributed setup, so only log during distributed setup.
if globalIsDistXL {
logger . Info ( "Waiting for all MinIO sub-systems to be initialized.. lock acquired" )
}
2020-05-06 23:25:05 +02:00
// Migrate all backend configs to encrypted backend configs, optionally
// handles rotating keys for encryption, if there is any retriable failure
// that shall be retried if there is an error.
if err = handleEncryptedConfigBackend ( newObject , true ) ; err == nil {
// Upon success migrating the config, initialize all sub-systems
// if all sub-systems initialized successfully return right away
if err = initAllSubsystems ( newObject ) ; err == nil {
// All successful return.
2020-05-08 01:12:16 +02:00
if globalIsDistXL {
// These messages only meant primarily for distributed setup, so only log during distributed setup.
logger . Info ( "All MinIO sub-systems initialized successfully" )
}
2020-05-06 23:25:05 +02:00
return nil
2020-02-02 02:07:43 +01:00
}
2020-05-05 05:04:06 +02:00
}
// One of these retriable errors shall be retried.
if errors . Is ( err , errDiskNotFound ) ||
errors . Is ( err , errConfigNotFound ) ||
errors . Is ( err , context . Canceled ) ||
errors . Is ( err , context . DeadlineExceeded ) ||
errors . As ( err , & rquorum ) ||
errors . As ( err , & wquorum ) ||
isErrBucketNotFound ( err ) {
2020-05-06 23:25:05 +02:00
logger . Info ( "Waiting for all MinIO sub-systems to be initialized.. possible cause (%v)" , err )
txnLk . Unlock ( ) // Unlock the transaction lock and allow other nodes to acquire the lock if possible.
2020-05-05 05:04:06 +02:00
continue
2020-02-02 02:07:43 +01:00
}
2020-05-05 05:04:06 +02:00
// Any other unhandled return right here.
return fmt . Errorf ( "Unable to initialize sub-systems: %w" , err )
}
// Return an error when retry is canceled or deadlined
if err = retryCtx . Err ( ) ; err != nil {
return fmt . Errorf ( "Unable to initialize sub-systems: %w" , err )
2019-10-31 07:39:09 +01:00
}
2020-05-05 05:04:06 +02:00
// Retry was canceled successfully.
return errors . New ( "Initializing sub-systems stopped gracefully" )
2019-11-09 18:27:23 +01:00
}
2020-05-05 05:04:06 +02:00
func initAllSubsystems ( newObject ObjectLayer ) ( err error ) {
2020-05-06 23:25:05 +02:00
// %w is used by all error returns here to make sure
// we wrap the underlying error, make sure when you
// are modifying this code that you do so, if and when
// you want to add extra context to your error. This
// ensures top level retry works accordingly.
var buckets [ ] BucketInfo
if globalIsDistXL || globalIsXL {
// List buckets to heal, and be re-used for loading configs.
buckets , err = newObject . ListBucketsHeal ( GlobalContext )
if err != nil {
return fmt . Errorf ( "Unable to list buckets to heal: %w" , err )
}
// Attempt a heal if possible and re-use the bucket names
// to reload their config.
wquorum := & InsufficientWriteQuorum { }
rquorum := & InsufficientReadQuorum { }
for _ , bucket := range buckets {
if err = newObject . MakeBucketWithLocation ( GlobalContext , bucket . Name , "" ) ; err != nil {
if errors . As ( err , & wquorum ) || errors . As ( err , & rquorum ) {
// Retrun the error upwards for the caller to retry.
return fmt . Errorf ( "Unable to heal bucket: %w" , err )
}
if _ , ok := err . ( BucketExists ) ; ! ok {
// ignore any other error and log for investigation.
logger . LogIf ( GlobalContext , err )
continue
}
// Bucket already exists, nothing that needs to be done.
}
}
} else {
buckets , err = newObject . ListBuckets ( GlobalContext )
if err != nil {
return fmt . Errorf ( "Unable to list buckets: %w" , err )
}
2020-05-05 05:04:06 +02:00
}
2019-11-09 18:27:23 +01:00
// Initialize config system.
if err = globalConfigSys . Init ( newObject ) ; err != nil {
2019-11-11 21:01:21 +01:00
return fmt . Errorf ( "Unable to initialize config system: %w" , err )
2019-11-09 18:27:23 +01:00
}
2020-05-05 05:04:06 +02:00
2019-11-12 12:16:25 +01:00
if globalEtcdClient != nil {
// **** WARNING ****
// Migrating to encrypted backend on etcd should happen before initialization of
// IAM sub-systems, make sure that we do not move the above codeblock elsewhere.
2020-04-07 23:26:39 +02:00
if err = migrateIAMConfigsEtcdToEncrypted ( GlobalContext , globalEtcdClient ) ; err != nil {
2019-12-02 18:28:01 +01:00
return fmt . Errorf ( "Unable to handle encrypted backend for iam and policies: %w" , err )
2019-11-12 12:16:25 +01:00
}
}
2020-04-07 23:26:39 +02:00
if err = globalIAMSys . Init ( GlobalContext , newObject ) ; err != nil {
2019-11-11 21:01:21 +01:00
return fmt . Errorf ( "Unable to initialize IAM system: %w" , err )
2019-10-31 07:39:09 +01:00
}
// Initialize notification system.
if err = globalNotificationSys . Init ( buckets , newObject ) ; err != nil {
2019-11-11 21:01:21 +01:00
return fmt . Errorf ( "Unable to initialize notification system: %w" , err )
2019-10-31 07:39:09 +01:00
}
// Initialize policy system.
if err = globalPolicySys . Init ( buckets , newObject ) ; err != nil {
2020-02-24 02:09:11 +01:00
return fmt . Errorf ( "Unable to initialize policy system: %w" , err )
}
// Initialize bucket object lock.
if err = initBucketObjectLockConfig ( buckets , newObject ) ; err != nil {
return fmt . Errorf ( "Unable to initialize object lock system: %w" , err )
2019-10-31 07:39:09 +01:00
}
// Initialize lifecycle system.
if err = globalLifecycleSys . Init ( buckets , newObject ) ; err != nil {
2019-12-02 18:28:01 +01:00
return fmt . Errorf ( "Unable to initialize lifecycle system: %w" , err )
2019-10-31 07:39:09 +01:00
}
2019-11-09 18:27:23 +01:00
2020-02-05 10:42:34 +01:00
// Initialize bucket encryption subsystem.
if err = globalBucketSSEConfigSys . Init ( buckets , newObject ) ; err != nil {
return fmt . Errorf ( "Unable to initialize bucket encryption subsystem: %w" , err )
}
2020-02-24 02:09:11 +01:00
2020-05-04 18:42:58 +02:00
// Initialize bucket quota system.
if err = globalBucketQuotaSys . Init ( buckets , newObject ) ; err != nil {
return fmt . Errorf ( "Unable to initialize bucket quota system: %w" , err )
}
2020-05-05 05:04:06 +02:00
// Populate existing buckets to the etcd backend
if globalDNSConfig != nil {
initFederatorBackend ( buckets , newObject )
}
2019-11-09 18:27:23 +01:00
return nil
2019-10-31 07:39:09 +01:00
}
2020-03-22 20:16:36 +01:00
func startBackgroundOps ( ctx context . Context , objAPI ObjectLayer ) {
// Make sure only 1 crawler is running on the cluster.
locker := objAPI . NewNSLock ( ctx , minioMetaBucket , "leader" )
for {
err := locker . GetLock ( leaderLockTimeout )
if err != nil {
time . Sleep ( leaderTick )
continue
}
break
// No unlock for "leader" lock.
}
if globalIsXL {
initGlobalHeal ( ctx , objAPI )
}
initDataUsageStats ( ctx , objAPI )
initDailyLifecycle ( ctx , objAPI )
2020-05-01 00:55:54 +02:00
initQuotaEnforcement ( ctx , objAPI )
2020-03-22 20:16:36 +01:00
}
2017-03-30 20:21:19 +02:00
// serverMain handler called for 'minio server' command.
func serverMain ( ctx * cli . Context ) {
2018-05-19 02:51:03 +02:00
if ctx . Args ( ) . First ( ) == "help" || ! endpointsPresent ( ctx ) {
2017-03-30 20:21:19 +02:00
cli . ShowCommandHelpAndExit ( ctx , "server" , 1 )
}
2020-01-22 00:49:25 +01:00
setDefaultProfilerRates ( )
2017-03-30 20:21:19 +02:00
2019-12-17 05:30:57 +01:00
// Initialize globalConsoleSys system
2020-04-09 18:30:02 +02:00
globalConsoleSys = NewConsoleLogger ( GlobalContext )
2019-12-17 05:30:57 +01:00
2019-04-19 19:26:44 +02:00
signal . Notify ( globalOSSignalCh , os . Interrupt , syscall . SIGTERM )
2018-11-02 19:53:45 +01:00
// Handle all server command args.
serverHandleCmdArgs ( ctx )
2019-11-04 18:30:59 +01:00
// Handle all server environment vars.
serverHandleEnvVars ( )
2019-12-17 05:30:57 +01:00
// Set node name, only set for distributed setup.
globalConsoleSys . SetNodeName ( globalEndpoints )
2019-12-05 00:32:37 +01:00
// Initialize all help
initHelp ( )
2018-10-28 02:51:00 +02:00
// Check and load TLS certificates.
2017-03-30 20:21:19 +02:00
var err error
2018-10-28 02:51:00 +02:00
globalPublicCerts , globalTLSCerts , globalIsSSL , err = getTLSConfig ( )
2018-05-09 04:04:36 +02:00
logger . FatalIf ( err , "Unable to load the TLS configuration" )
2017-03-30 20:21:19 +02:00
2018-10-28 02:51:00 +02:00
// Check and load Root CAs.
2019-10-08 07:47:56 +02:00
globalRootCAs , err = config . GetRootCAs ( globalCertsCADir . Get ( ) )
2018-10-28 02:51:00 +02:00
logger . FatalIf ( err , "Failed to read root CAs (%v)" , err )
2020-04-27 15:25:05 +02:00
globalMinioEndpoint = func ( ) string {
host := globalMinioHost
if host == "" {
host = sortIPs ( localIP4 . ToSlice ( ) ) [ 0 ]
}
return fmt . Sprintf ( "%s://%s" , getURLScheme ( globalIsSSL ) , net . JoinHostPort ( host , globalMinioPort ) )
} ( )
2017-12-04 07:47:12 +01:00
// Is distributed setup, error out if no certificates are found for HTTPS endpoints.
2018-04-10 04:10:23 +02:00
if globalIsDistXL {
2019-11-20 02:42:27 +01:00
if globalEndpoints . HTTPS ( ) && ! globalIsSSL {
2019-10-04 19:35:33 +02:00
logger . Fatal ( config . ErrNoCertsAndHTTPSEndpoints ( nil ) , "Unable to start the server" )
2018-04-10 04:10:23 +02:00
}
2019-11-20 02:42:27 +01:00
if ! globalEndpoints . HTTPS ( ) && globalIsSSL {
2019-10-04 19:35:33 +02:00
logger . Fatal ( config . ErrCertsAndHTTPEndpoints ( nil ) , "Unable to start the server" )
2018-04-10 04:10:23 +02:00
}
2017-12-04 07:47:12 +01:00
}
2018-12-19 01:08:11 +01:00
if ! globalCLIContext . Quiet {
2019-04-09 20:39:42 +02:00
// Check for new updates from dl.min.io.
2019-08-14 20:43:43 +02:00
checkUpdate ( getMinioMode ( ) )
2017-03-16 20:21:58 +01:00
}
2019-10-23 07:59:13 +02:00
if ! globalActiveCred . IsValid ( ) && globalIsDistXL {
logger . Fatal ( config . ErrEnvCredentialsMissingDistributed ( nil ) ,
"Unable to initialize the server in distributed mode" )
2018-08-15 06:41:47 +02:00
}
2017-03-30 20:21:19 +02:00
// Set system resources to maximum.
2019-12-05 00:32:37 +01:00
if err = setMaxResources ( ) ; err != nil {
logger . Info ( "Unable to set system resources to maximum %s" , err )
}
2017-03-30 20:21:19 +02:00
2019-06-09 07:14:07 +02:00
if globalIsXL {
// Init global heal state
globalAllHealState = initHealState ( )
2019-10-28 18:27:49 +01:00
globalBackgroundHealState = initHealState ( )
2019-06-09 07:14:07 +02:00
}
2018-01-22 23:54:55 +01:00
2017-03-30 20:21:19 +02:00
// Configure server.
2017-07-13 01:33:21 +02:00
var handler http . Handler
2020-05-01 00:55:54 +02:00
enableBucketQuotaOps := env . Get ( envDataUsageCrawlConf , config . EnableOn ) == config . EnableOn
handler , err = configureServerHandler ( globalEndpoints , enableBucketQuotaOps )
2018-05-09 04:04:36 +02:00
if err != nil {
2019-10-04 19:35:33 +02:00
logger . Fatal ( config . ErrUnexpectedError ( err ) , "Unable to configure one of server's RPC services" )
2018-05-09 04:04:36 +02:00
}
2017-01-17 02:05:00 +01:00
2018-05-31 21:30:15 +02:00
var getCert certs . GetCertificateFunc
if globalTLSCerts != nil {
getCert = globalTLSCerts . GetCertificate
}
2019-12-03 00:54:26 +01:00
httpServer := xhttp . NewServer ( [ ] string { globalMinioAddr } , criticalErrorHandler { handler } , getCert )
2020-03-19 00:19:29 +01:00
httpServer . BaseContext = func ( listener net . Listener ) context . Context {
return GlobalContext
}
2017-01-11 22:59:51 +01:00
go func ( ) {
2019-12-03 00:54:26 +01:00
globalHTTPServerErrorCh <- httpServer . Start ( )
2017-01-11 22:59:51 +01:00
} ( )
2016-09-14 10:11:03 +02:00
2019-12-03 00:54:26 +01:00
globalObjLayerMutex . Lock ( )
globalHTTPServer = httpServer
globalObjLayerMutex . Unlock ( )
2019-11-22 21:45:13 +01:00
if globalIsDistXL && globalEndpoints . FirstLocal ( ) {
2020-04-02 06:40:03 +02:00
for {
// Additionally in distributed setup, validate the setup and configuration.
err := verifyServerSystemConfig ( globalEndpoints )
if err == nil {
break
}
logger . LogIf ( GlobalContext , err , "Unable to initialize distributed setup" )
select {
case <- GlobalContext . Done ( ) :
return
case <- time . After ( 5 * time . Second ) :
}
2019-11-22 21:45:13 +01:00
}
}
2020-04-15 02:52:38 +02:00
newObject , err := newObjectLayer ( GlobalContext , globalEndpoints )
2019-07-01 21:22:01 +02:00
logger . SetDeploymentID ( globalDeploymentID )
2017-07-13 01:33:21 +02:00
if err != nil {
2018-05-31 21:30:15 +02:00
// Stop watching for any certificate changes.
globalTLSCerts . Stop ( )
2018-05-09 04:04:36 +02:00
globalHTTPServer . Shutdown ( )
2019-11-09 18:27:23 +01:00
logger . Fatal ( err , "Unable to initialize backend" )
2018-04-05 17:18:42 +02:00
}
2019-11-09 18:27:23 +01:00
// Once endpoints are finalized, initialize the new object api in safe mode.
globalObjLayerMutex . Lock ( )
globalSafeMode = true
globalObjectAPI = newObject
globalObjLayerMutex . Unlock ( )
2019-11-01 23:53:16 +01:00
2020-01-10 11:35:06 +01:00
newAllSubsystems ( )
// Enable healing to heal drives if possible
if globalIsXL {
2020-03-22 20:16:36 +01:00
initBackgroundHealing ( GlobalContext , newObject )
initLocalDisksAutoHeal ( GlobalContext , newObject )
2020-01-10 11:35:06 +01:00
}
2020-03-27 22:48:30 +01:00
go startBackgroundOps ( GlobalContext , newObject )
2020-05-05 05:04:06 +02:00
logger . FatalIf ( initSafeMode ( ) , "Unable to initialize server switching into safe-mode" )
2019-10-23 07:59:13 +02:00
2019-11-09 18:27:23 +01:00
if globalCacheConfig . Enabled {
2019-12-05 00:32:37 +01:00
// initialize the new disk cache objects.
var cacheAPI CacheObjectLayer
2020-03-22 20:16:36 +01:00
cacheAPI , err = newServerCacheObjects ( GlobalContext , globalCacheConfig )
2019-12-05 00:32:37 +01:00
logger . FatalIf ( err , "Unable to initialize disk caching" )
globalObjLayerMutex . Lock ( )
globalCacheObjectAPI = cacheAPI
globalObjLayerMutex . Unlock ( )
2019-10-23 07:59:13 +02:00
}
2019-11-09 18:27:23 +01:00
// Disable safe mode operation, after all initialization is over.
globalObjLayerMutex . Lock ( )
globalSafeMode = false
globalObjLayerMutex . Unlock ( )
2018-08-23 08:11:17 +02:00
2016-10-05 21:48:07 +02:00
// Prints the formatted startup message once object layer is initialized.
2018-12-14 08:37:46 +01:00
printStartupMessage ( getAPIEndpoints ( ) )
2016-10-05 21:48:07 +02:00
2019-10-23 07:59:13 +02:00
if globalActiveCred . Equal ( auth . DefaultCredentials ) {
msg := fmt . Sprintf ( "Detected default credentials '%s', please change the credentials immediately using 'MINIO_ACCESS_KEY' and 'MINIO_SECRET_KEY'" , globalActiveCred )
2019-11-09 18:27:23 +01:00
logger . StartupMessage ( color . RedBold ( msg ) )
2019-10-23 07:59:13 +02:00
}
2017-07-13 01:33:21 +02:00
handleSignals ( )
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
}
2017-01-17 02:05:00 +01:00
// Initialize object layer with the supplied disks, objectLayer is nil upon any error.
2020-04-15 02:52:38 +02:00
func newObjectLayer ( ctx context . Context , endpointZones EndpointZones ) ( newObject ObjectLayer , err error ) {
2017-01-17 02:05:00 +01:00
// For FS only, directly use the disk.
2020-03-24 20:43:40 +01:00
if endpointZones . NEndpoints ( ) == 1 {
2017-01-17 02:05:00 +01:00
// Initialize new FS object layer.
2019-11-20 02:42:27 +01:00
return NewFSObjectLayer ( endpointZones [ 0 ] . Endpoints [ 0 ] . Path )
2017-01-17 02:05:00 +01:00
}
2020-04-15 02:52:38 +02:00
return newXLZones ( ctx , endpointZones )
2017-01-17 02:05:00 +01:00
}