Performing Initial Configuration (CLI)

Language:

Use this procedure, which is a step-by-step utility, to complete initial configuration of network interfaces, the Domain Name Service (DNS), time settings, name services, directory services, storage, and remote support on the appliance using the command line interface (CLI).

Note - If installing clustered controllers, it is strongly recommended that you use the BUI for initial configuration, as described in Performing Initial Configuration (BUI).

Each step begins by printing its help, which can be reprinted by typing help. Use the done command to complete each step. In the examples, the existing settings (obtained from the DHCP server) are checked and accepted by typing done. To customize them, enter each context (datalinks, devices and interfaces) and type help to see available actions for that context.

Before You Begin

Ensure you have configured the system as described in Configuring the System.
This procedure assumes you have just completed configuration of the network interface and are using the same administrative client to access the CLI.

Log in using the administrative password that you created during system configuration.

hostname console login: root
Password: 
To setup your system, you will be taken through a series of steps; as the setup
process advances to each step, the help message for that step will be
displayed.
          
Press any key to begin initial configuration ...

Configure the appliance network interfaces.

For detailed information, see the following topics:

Note - You can create a management interface now, or at another time using a task in Configuring Management Interfaces in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

aksh: starting configuration with "net" ... 
          
Configure Networking. Configure the appliance network interfaces. The first
network interface has been configured for you, using the settings you provided
at the serial console. 
          
Subcommands that are valid in this context:

   datalinks            => Manage datalinks
          
   devices              => Manage devices
          
   interfaces           => Manage interfaces
          
   help [topic]         => Get context-sensitive help. If [topic] is specified,
                           it must be one of "builtins", "commands", "general",
                           "help" or "script".

   show                 => Show information pertinent to the current context

   abort                => Abort this task (potentially resulting in a
                           misconfigured system)

   done                 => Finish operating on "net"

hostname:maintenance system setup net> devices show
Devices:

     DEVICE UP       MAC                      SPEED          
       igb0 true     0:14:4f:8d:59:aa         1000 Mbit/s    
       igb1 false    0:14:4f:8d:59:ab         0 Mbit/s       
       igb2 false    0:14:4f:8d:59:ac         0 Mbit/s       
       igb3 false    0:14:4f:8d:59:ad         0 Mbit/s       

hostname:maintenance system setup net> datalinks show
Datalinks:

   DATALINK CLASS          LINKS       LABEL
       igb0 device         igb0        Untitled Datalink

hostname:maintenance system setup net> interfaces show
Interfaces:

INTERFACE    STATE    CLASS    LINKS       ADDRS                  LABEL
igb0         up       ip       igb0        192.168.2.80/22        Untitled Interface

hostname:maintenance system setup net> done

To create a management interface now, use the following steps as an example:

Go to maintenance system setup net, and then enter interfaces.
```
hostname:maintenance system setup net> interfaces
```

Enter show to view the interface. Enter cd .. to return to the context for the next step.

hostname:maintenance system setup net interfaces> show
Interfaces:

INTERFACE    STATE      CLASS      LINKS      ADDRS                   LABEL
igb0         up         ip         igb0       192.0.2.11/24           Untitled Interface
hostname:maintenance system setup net interfaces> cd ..

Configure routing for the interface labeled Untitled Interface. Enter cd .. to return to the correct context for the next step.

For detailed information, see Configuring Network Routing in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

hostname:maintenance system setup net> routing
hostname:maintenance system setup net routing> create
hostname:maintenance system setup net route (uncommitted)> set destination=0.0.0.0
                        destination = 0.0.0.0 (uncommitted)
hostname:maintenance system setup net route (uncommitted)> set mask=0
                               mask = 0 (uncommitted)
hostname:maintenance system setup net route (uncommitted)> set interface=igb0
                          interface = igb0 (uncommited)
hostname:maintenance system setup net route (uncommitted)> set gateway=192.0.2.1
                            gateway = 192.168.56.101 (uncommitted)
hostname:maintenance system setup net route (uncommited)> set family=IPv4
                             family = IPv4 (uncommitted)
hostname:maintenance system setup net route (uncommitted)> commit
hostname:maintenance system setup net routing> cd ..

Enter interfaces, select the interface labeled Untitled Interface, and then enter show to view its properties.

hostname:maintenance system setup net> interfaces
hostname:maintenance system setup net interfaces> select igb0
hostname:maintenance system setup net interfaces igb0> show
Properties:

                                     state = up
                                  curaddrs = 192.0.2.11/24
                                     class = ip
                                     label = Untitled Interface
                                    enable = true
                                     admin = true
                                     links = igb0
                                   v4addrs = 
                                    v4dhcp = true
                                   v6addrs = 
                                    v6dhcp = false

Set an IPv4 address, change the protocol from DHCP to static, and set a new label to indicate that it is a management interface. Enter cd ../.. to return to the correct context for the next step.

hostname:maintenance system setup net interfaces igb0> set v4addrs=192.0.2.11/24
                              v4addrs = 192.168.1.101/24 (uncommitted)
hostname:maintenance system setup net interfaces igb0> set v4dhcp=false
                               v4dhcp = false (uncommitted)
hostname:maintenance system setup net interfaces igb0(uncommitted)> set label=management-controller
                              label = management-controller (uncommitted)
hostname:maintenance system setup net interfaces igb0 (uncommitted)> commit
hostname:maintenance system setup net interfaces igb0> cd ../..

Configure the Domain Name Service (DNS).

For detailed information, see DNS Configuration in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

Configure DNS. Configure the Domain Name Service.

Subcommands that are valid in this context:

   help [topic]         => Get context-sensitive help. If [topic] is specified,
                           it must be one of "builtins", "commands", "general",
                           "help", "script" or "properties".

   show                 => Show information pertinent to the current context

   commit               => Commit current state, including any changes

   abort                => Abort this task (potentially resulting in a
                           misconfigured system)

   done                 => Finish operating on "dns"

   get [prop]           => Get value for property [prop]. ("help properties"
                           for valid properties.) If [prop] is not specified,
                           returns values for all properties.

   set [prop]           => Set property [prop] to [value]. ("help properties"
                           for valid properties.) For properties taking list
                           values, [value] should be a comma-separated list of
                           values.

hostname:maintenance system setup dns> show
Properties:
                      <status> = online
                        domain = sun.com
                       servers = 198.51.100.1

hostname:maintenance system setup dns> set domain=sf.fishworks.com
                        domain = sf.fishworks.com (uncommitted)
hostname:maintenance system setup dns> set servers=198.51.100.2
                       servers = 198.51.100.2 (uncommitted)
hostname:maintenance system setup dns> commit
hostname:maintenance system setup dns> done
aksh: done with "dns", advancing configuration to "ntp" ...

Configure the Network Time Protocol (NTP) to synchronize the appliance clock.

Note - If you share filesystems using SMB and Active Directory, the client clocks must be synchronized to within five minutes of the appliance clock to avoid user authentication errors. One way to ensure clock synchronization is to configure the appliance and the SMB clients to use the same NTP server.

For detailed information, see NTP Configuration in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

Configure Time. Configure the Network Time Protocol.

Subcommands that are valid in this context:

   help [topic]         => Get context-sensitive help. If [topic] is specified,
                           it must be one of "builtins", "commands", "general",
                           "help", "script" or "properties".

   show                 => Show information pertinent to the current context

   commit               => Commit current state, including any changes

   abort                => Abort this task (potentially resulting in a
                           misconfigured system)

   done                 => Finish operating on "ntp"

   enable               => Enable the ntp service

   disable              => Disable the ntp service

   get [prop]           => Get value for property [prop]. ("help properties"
                           for valid properties.) If [prop] is not specified,
                            returns values for all properties.

   set [prop]           => Set property [prop] to [value]. ("help properties"
                           for valid properties.) For properties taking list
                           values, [value] should be a comma-separated list of
                           values.

hostname:maintenance system setup ntp> set servers=0.pool.ntp.org
                       servers = 0.pool.ntp.org (uncommitted)
hostname:maintenance system setup ntp> commit
hostname:maintenance system setup ntp> done
aksh: done with "ntp", advancing configuration to "directory" ...

Configure name services.

For detailed information, see Configuring Services in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

Note - Active Directory has two modes: domain and workgroup mode, which dictate how SMB users are authenticated. In domain mode, SMB clients are authenticated through the Active Directory domain controller, and you must ensure that the times on the appliance and the domain controller match within five minutes.

NIS is an older directory protocol that is not very secure, and largely replaced by LDAP. It is not recommended to run NIS and LDAP at the same time because they use the same domain name setting.

Configure Name Services. Configure directory services for users and groups. You
can configure and enable each directory service independently, and you can
configure more than one directory service.

Subcommands that are valid in this context:

   nis                  => Configure NIS

   ldap                 => Configure LDAP

   ad                   => Configure Active Directory

   help [topic]         => Get context-sensitive help. If [topic] is specified,
                           it must be one of "builtins", "commands", "general",
                           "help" or "script".

   show                 => Show information pertinent to the current context

   abort                => Abort this task (potentially resulting in a
                           misconfigured system)

   done                 => Finish operating on "directory"

hostname:maintenance system setup directory> nis
hostname:maintenance system setup directory nis> show
Properties:
                      <status> = online
                        domain = sun.com
                     broadcast = true
                     ypservers = 

hostname:maintenance system setup directory nis> set domain=fishworks
                        domain = fishworks (uncommitted)
hostname:maintenance system setup directory nis> commit
hostname:maintenance system setup directory nis> done
hostname:maintenance system setup directory> done
aksh: done with "directory", advancing configuration to "support" ...

Configure storage pools.

For detailed information, see Configuring Storage in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

Configure Storage.

Subcommands that are valid in this context:

    help [topic]         => Get context-sensitive help. If [topic] is specified,
                          it must be one of "builtins", "commands", "general",
                          "help", "script" or "properties".

    show                 => Show information pertinent to the current context

    commit               => Commit current state, including any changes

    done                 => Finish operating on "storage"

    config <pool>        => Configure the storage pool

    unconfig             => Unconfigure the storage pool

    add                  => Add additional storage to the storage pool

    import               => Search for existing or destroyed pools to import

    scrub <start|stop>   => Start or stop a scrub

    get [prop]           => Get value for property [prop]. ("help properties"
                          for valid properties.) If [prop] is not specified,
                          returns values for all properties.

    set pool=[pool]      => Change current pool

hostname:maintenance system setup storage> show
Properties:
                          pool = pool-0
                        status = online
                       profile = mirror
                   log_profile = -
                 cache_profile = -
hostname:maintenance system setup storage> done
aksh: done with "storage", advancing configuration to "support" ...

Configure remote support.

Note - You can configure remote support now, or at another time. If you do not have an Oracle support account, enter done without configuring remote support and complete it later. For more information about configuring remote support later or obtaining an Oracle support account, see Phone Home Configuration in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.

Remote Support. Register your appliance and configure remote monitoring.

Subcommands that are valid in this context:

   tags                 => Configure service tags

   scrk                 => Configure phone home

   help [topic]         => Get context-sensitive help. If [topic] is specified,
                           it must be one of "builtins", "commands", "general",
                           "help" or "script".

   show                 => Show information pertinent to the current context

   abort                => Abort this task (potentially resulting in a
                           misconfigured system)

   done                 => Finish operating on "support"

 hostname:maintenance system setup support> done
 aksh: initial configuration complete!

Next Steps

If you did not configure the management interface yet, see the tasks in Configuring Management Interfaces in Oracle ZFS Storage Appliance Administration Guide, Release OS8.7.0.
See Upgrading the Software in Oracle ZFS Storage Appliance Customer Service Manual.

Performing Initial Configuration (CLI)

Next Steps

Related Topics