Instructions


Prerequisites


In order to connect to your Bamboo Systems Chassis Management Controller (CMC) you will require a USB to Micro USB cable and physical access to the front panel of the B1000N Chassis.


1.1 Serial Console Connection

Connect a micro-USB cable (not provided) to the IOIO port on the front of the Bamboo B1000N chassis. Connect to a standard USB port on a laptop or server.  



Use your preferred serial console application to connect with settings 

    

        Baud rate: 115200

        Data bits - 8

        Parity - None

        Flow Control - None


Once connected authenticate with the default factory credentials of - 


Username: bambooadmin
Password: bamboo



examples:


Microsoft Windows / Putty - 






Linux / Minicom - 


$ sudo minicom -D /dev/ttyACM0 -b115200



1.2. SSH Connection

Connect a standard RJ45 cable (provided) to the RJ45 port on the front of the Bamboo B1000N chassis. Check the front panel LCD display for current IP configuration.


$ ssh bambooadmin@<Bamboo CMC IP Address>


Once connected authenticate with the default factory credentials of - 


Username: bambooadmin
Password: bamboo




2. CLI Commands - Bamboo Administration Chassis command tool (bac)


The Bamboo Systems Chassis command tool is designed to allow configuration and connectivity to all major components within your B1000N server. The below guide provides examples of all major functionality.   


    2.1 - IP Configuration

  

The Bamboo Systems B1000N Chassis Management Controller utilizes a pair of 1Gbe ports for connections to your external management network (eth0.3) and an internal management network (eth0.2). 


    Getniccfg - 

The getniccfg command to report back the configuration of your external management network port (eth0.3)


example - 

$ bac getniccfg

Output - 



    Setniccfg -

The setniccfg command allows you to reconfigure your external external management network port (eth0.3)


syntax - 


$ bac setniccfg -s <IP Address> <Subnet Mask> <Gateway>


Available arguments are - 

    -s      - This argument will set the IPv4 address for the management port 

    -s6    - This argument will set the IPv6 address for the management port  

    -d     - This argument will enable DHCP for the management port 

   -d6    - This argument will enable DHCP6 for the management port 

    -o     - enable or disable the external management NIC port    


example - 


$ bac setniccfg -s 172.16.10.50 255.255.255.0 172.16.10.1


output - 




    2.2 - Component connections 


Computer Node

    

    standard SSH


By default all components in your B1000N system are accessible via SSH from the Chassis Management Controller. Unlike bac connect (detailed below) the standard SSH connection will not perform any component checks on connection nor will it attempt the default credentials and as such authentication for every connection will be required. Default Bamboo Systems credentials are provided here - (https://bamboosystems.freshdesk.com/a/solutions/articles/69000253259)

A list of all component internal 1Gbe IP Addresses are provided here - (https://bamboosystems.freshdesk.com/a/solutions/articles/69000334955)

Note: this can be restricted or even disabled if required


Syntax - 

$ ssh <username>@<IP address of component>


example server/compute node connection -

$ ssh bamboouser@169.254.68.3


output - 



example Internal Switch connection -

$ ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -oKexAlgorithms=+diffie-hellman-group14-sha1 admin@169.254.68.39


output - 




    bac connect


The bac connect command is easier to use for initial 'out of box' configuration. Whilst using the same SSH protocol bac connect also performance several checks during the connection process to ensure the component is up and functional as well as checking the components mode of operation (standard mode or recovery mode). bac connect also parses the factory default credentials for speed of initial deployment.


Syntax -


$ bac connect -e <Component to connect to>

Available component connection options are -

    Blade1_Switch, Blade1_Server1, Blade1_Server2, Blade1_Server3, Blade1_Server4

    Blade2_Switch, Blade2_Server1, Blade2_Server2, Blade2_Server3, Blade2_Server4


Available arguments are - 

   -t    - this will force the connection protocol to Telnet rather than SSH (NOTE: this optional argument is only available when             connecting to Blade1_Switch or Blade2_Switch


example - 

$ bac connect -e Blade1_Server1

output - 



    bac proxy


The bac proxy option allows for the configuration of an automatic connection relay to a B1000N internal component. 


    bac proxy list


example -


$ bac proxy list


output - 



    bac proxy enable


Syntax - 


$ bac proxy <action> -e <end point component> -p <port>

Available arguments are - 

   -p    - Specify access port. Port number range 0 - 65535

   -e    - Specify endpoint component. Available endpoints Blade1_Switch, Blade2_Switch


example -


$ bac proxy enable -e Blade1_Switch -p 543


output -  



    bac proxy disable


Syntax - 


$ bac proxy <action> -e <end point component>

Available arguments are - 

   -p    - Specify access port. Port number range 0 - 65535

   -e    - Specify endpoint component. Available endpoints Blade1_Switch, Blade2_Switch


example -


$ bac proxy disable -e Blade1_Switch


output -  



    2.3 - User management


     -usermngmt    


     -usermngmt listusers


This command can be executed to report a list of all current users account on the Bamboo Systems B1000N Chassis Management Controller


example - 

$ bac usermngmt listusers


output (factory defaults) -  



     -usermngmt adduser


This command can be executed to add new users to access the Bamboo B1000N Chassis Management Controller.


syntax - 

$ bac usermngmt useradd <username> -p <password>


Available arguments are - 

    -p     - Set the corresponding user password  

    -H    - Do not create a user home directory   

    -h     - Specify user home directory (directory must already exist)

    -u     - Assign a specific UUID to the user. Valid UUID range 1000...59999

    -g     - Assign user to specific user group    


Example - 


$ bac usermngmt adduser bamboouser123 -p Password123!



output -  



    -usermngmt rmuser


This command can be executed to remove a user from access the Bamboo B1000N Chassis Management Controller.


syntax - 

$ bac usermngmt rmuser <username>


Available arguments are - 

    -r     - Remove user home directory  


Example - 


$ bac usermngmt rmuser bamboouser123 -r


output -  




     -sshpkauth    


This command provides the ability to upload a public ssh key for authentication to the B1000N Chassis Management Controller.y to ecuted to report a list of all current users account on the Bamboo Systems B1000N Chassis Management Controller


     -sshpkauth upload


example - 

$ bac sspkauth upload 


output (factory defaults) -  



     -sshpkauth list


example -

$ bac sshpkauth list


output -  


     -sshpkauth delete


example -

$ bac sshpkauth delete ID


output -  




    2.4 - Redfish API management


    redfish


This command is reserved for future use


    2.5 - Software management and update


This command is reserved for future use


    2.6 - Hardware management


    hwinventory -


Gathering a comprehensive list of all B1000N hardware components is possible with this command.


Note: This will gather hardware details from all components so can take several minutes to complete


example - 

$ bac hwinventory


output -  



 

   2.7 - Support and Log Gathering 


    techsupreport -


Gathering a set of technical logs for the Bamboo Systems support team is simple with the techsupreport command. These logs tarballed and automatically be stored in /mnt/data/system/reports


example - 

$ bac techsupreport collect


output -  



In disconnected/dark datacentres B1000N logs may also be exported to USB storage (not supplied)


syntax - 

$ bac techsupreport export <USB Mount Point>


example -


$ bac techsupreport export /media/LOGS
 


    2.8 - Miscellaneous 


    Enable/Disable SSH -


You may wish to disable/enable SSH to the Bamboo B1000N CMC. This is controlled through the bac ssh command. Executing an ssh enable or disable command will ensure the ssh service starts/stops on every boot cycle as well as enabling or disabling the service immediately 


syntax - 


$ bac ssh <enable or disable> port <port number to use>



example - 

$ bac enable ssh port <specify port number>


output -  



    getversion -


This command can be executed to understand all software versions (CMC, Kernel and BAC utility) running on your Bamboo Systems B1000N Chassis Management Controller.


example - 

$ bac getversion


output -  




    usbstorage -


In disconnected datacentre environments which do not have any access to the wider internet it is possible to use USB storage devices to gather logs and update software on your B1000N system. The usbstorage command allows you to manage attached USB storage devices


Syntax - 


enable/disable USB storage

$ bac usbstorage <enable/disable>

List currently attached USB storage file systems

$ bac usbstorage list


output - 




    sslcert -


This command is reserved for future use



    help -


And finally, a full help section is also available within the Bamboo bac utility.


example - 

$ bac -h


output -