Reference: Appliance Array menu
Use the Appliance Array menu to create an array, add appliances to the array, assign Tanium roles to the appliances, and then install the roles on all appliances from a single menu. If you need to add an additional appliance later on, you can add the appliance to the array, and then assign and install a role to use with your existing installation.
About Appliance Arrays
In TanOS 1.6.0 and later, you can group appliances into an Appliance Array to make it easier to set up and manage the appliances that contain the components of a Tanium cluster.
A Tanium cluster is an active-active cluster of two Tanium Servers that ensures continuous availability in the event of an outage or scheduled maintenance. In a Tanium cluster, the Tanium Server application is active-active, and the database component is active-passive.
A typical Appliance Array contains the following appliances:
- A primary Tanium Server appliance with an active database
- A secondary Tanium Server appliance with a passive database
- A Tanium Module Server appliance
- One or more Tanium Zone Server appliances
You can also add a secondary (standby) Tanium Module Server appliance to an Appliance Array. For more information, see Deploying a standby Module Server.
When you create an array on an appliance, the appliance becomes a controlling member of the array.
- A controlling member can add members, remove members, and refresh the array.
- When you install a Tanium Server role on an appliance in the array, the corresponding appliance becomes a controlling member of the array. Any other appliances without a Tanium Server role become non-controlling members; this could include the appliance where the array was created (a refresh may be needed on the affected appliances to see the change).
Create an Appliance Array
For a new installation, set up the Appliance Array before you install the components of a Tanium cluster. For more information, see Installing an Appliance Array.
Perform the following steps on the appliance that you want to be the controlling member of the array; in most installations, this is the appliance that you want to be the primary Tanium Server.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen ------------------------------------------------------
>>> Installation -> Appliance Array <<<
INFO: This appliance is not currently a member of an array
C: Create Appliance Array
R: Return to previous menu
------------------------------------------------------
- Enter C and follow the prompts to create an array.
View screen>>> Installation -> Appliance Array -> Create Array <<<
This activity creates a new array, with the current appliance being the
initial controlling member. Other appliances can then be added to this
array, provided that either:
A. The added member has no role (i.e. is not yet a TS, TMS, etc.); or
B. The controlling member has a TS (All-in-One or TaniumServer)
Please enter the name of the array: Tanium Appliance Array
Select the address other members would use to contact this appliance
1: 10.10.10.60
Please select: 1
Successfully created the Appliance Array
Press enter to continue
The Appliance Array menu refreshes with the new array.
TanOS designates the new (pending) role for the appliance as a Tanium Server.
View screen
------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 1
Hostname Current Role Platform New Role
1: ts1 None None Tanium Server
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
Add an appliance to an Appliance Array
From a controlling member of an array, you can add additional appliances to the array.
To add an appliance to a existing array where the appliances are already assigned a role, add the appliance to the array, assign a role to the appliance, install the pending role, and then perform any additional required configuration for the Tanium role. For more information, see Installing an Appliance Array.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 1
Hostname Current Role Platform New Role
1: ts1 None None Tanium Server
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
- Enter A and follow the prompts to add an appliance to the array.
View screen >>> Installation -> Appliance Array -> Add Member <<<
This activity adds a remote TanOS appliance to the array. Doing so requires
logging into the remote appliance to gather information and provide that
appliance with information about the array. You may be asked to enter the
password for tanadmin on the remote appliance.
Only TanOS 1.6 and later can be added to an Appliance Array.
Initial config must have been run on the remote appliance.
Please enter the remote appliance address: 10.10.10.61
If prompted, please enter the password for [email protected]
Password:
Successfully added host 10.10.10.61 to the Appliance Array
Press enter to continue
The Appliance Array menu refreshes with the new member.
View screen
------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 2
Hostname Current Role Platform New Role
1: ts1 None None Tanium Server
2: ts2 None None No Change
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
Remove an appliance from an Appliance Array
From a controlling member of an array, you can remove other appliances from the array, including other controlling members.
An appliance cannot remove itself from an array. To remove an appliance, you must sign into another controlling member of the array to perform the steps. To remove the last member of an array, reset the array.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 2
Hostname Current Role Platform New Role
1: ts1 None None Tanium Server
2: ts2 None None No Change
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
- Enter the line number of the appliance that you want to remove from the array.
View screen>>> Appliance Configuration -> Appliance Array -> Manage Member <<<
Report from remote appliance 'appliance-162-2' at '10.10.10.65'
Serial Number: be04e9e1-c5e7-46e5-975e-93320a8c8792
Name: appliance-162-2
TanOS Version: 1.6.3.0073
Role: Tanium Server
TaniumServer: 7.4.4.1250
D: Delete Member
R: Return to previous menu
------------------------------------------------------
- Enter D and follow the prompts to remove the appliance from the array.
View screen>>> Appliance Configuration -> Appliance Array -> Delete Member <<<
Report from remote appliance 'appliance-162-2' at '10.10.10.65'
Serial Number: be04e9e1-c5e7-46e5-975e-93320a8c8792
Name: appliance-162-2
TanOS Version: 1.6.3.0073
Role: Tanium Server
TaniumServer: 7.4.4.1250
This operation will remove a member from the array.
1. The member will be asked to leave
2. The controlling appliance will forget about the member
3. All remaining members will be informed of the removal
As a result all appliances associated with the array will be updated and
will no longer recognize the appliance as part of the array.
Are you sure you want to remove appliance-160-2 from the array? [Yes|No]:
Assign roles
Use the Appliance Array menu to assign roles to appliances without an existing role. You can then install the roles on the appliances in a single action.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 4
Hostname Current Role New Role
1: ts1 None No Change
2: ts2 None No Change
3: tms1 None No Change
4: tzs1 None No Change
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
- Enter the line number for an appliance without a pending New Role.
The Manage Member menu appears.
View screen
>>> Appliance Configuration -> Appliance Array -> Manage Member <<<
Serial Number: VMware-564d7441f288a8d6-a4da1a1bac78aaa5
Name: ts2
FQDN: ts2.tam.local
TanOS Version: 1.6.3.0073
Role: None
Pending Role: No Change
T: Assign Role: TaniumServer
M: Assign Role: TaniumModuleServer
Z: Assign Role: TaniumZoneServer
U: Cancel Pending Role Change
D: Delete Member
R: Return to previous menu
------------------------------------------------------
- Enter T, M, or Z to assign the corresponding role to the appliance.
The Appliance Array menu refreshes with the new pending role.
View screen
------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 4
Hostname Current Role New Role
1: ts1 None No Change
2: ts2 None Tanium Server
3: tms1 None No Change
4: tzs1 None No Change
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
When you close the Appliance Array menu, any pending roles are reset.
Install roles
From a controlling member of an array, you can install pending roles to the appliances in the array.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 4
Hostname Current Role Platform New Role
1: ts1 None None Tanium Server
2: ts2 None None Tanium Server
3: tms1 None None Tanium Module Server
4: tzs1 None None Tanium Zone Server
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
If no appliances have pending roles, assign new roles.
- Enter I and follow the prompts to install any pending roles.
What to do next
After the installation completes, perform any necessary configuration. For more information, see Installing an Appliance Array.
Refresh an Appliance Array
From a controlling member of an array, you can refresh the array to retrieve current membership from the other appliances in the array. This information is refreshed on all appliances in the array.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 4
1: ts1 Tanium Server
2: ts2 Tanium Server
3: tms1 Tanium Module Server
4: tzs1 Tanium Zone Server
A: Add Member
F: Refresh Appliance Array
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
- Enter F and follow the prompts to refresh the array.
View screen>>> Appliance Configuration -> Appliance Array -> Refresh Array <<<
This action will communicate with each member of the array, retrieve current
information, and re-distrubute that information to all array members.
Do you want to continue? [Yes|No]: yes
Getting update from ts2 (10.10.10.61)
Getting update from tms1 (10.10.10.62)
Getting update from tzs1 (10.10.10.63)
Sending update to ts2 (10.10.10.61)
Sending update to tms1 (10.10.10.62)
Sending update to tzs1 (10.10.10.63)
Press enter to continue
Reset an Appliance Array
Reset an Appliance Array to remove the appliance from the array. If the appliance is the only member of the array, reset the array to delete the array.
To delete an array, sign into a controlling member of the array, remove all other members of the array, and then reset the array.
- Sign into the TanOS console as a user with the tanadmin role.
- Enter 1 to go to the Tanium Installation menu.
View screen------------------------------------------------------
>>> Tanium Installation <<<
Currently installed Role: Tanium Role not installed
Currently installed Add-On: No add-ons installed
------------------------------------------------------
M: Manage Appliance Array
1: Install Tanium Server (All-in-one)
2: Install Tanium Server Service
3: Install Tanium Module Server Service
4: Install Tanium Zone Server Service
H: Help
R: Return to previous menu
------------------------------------------------------
- Enter M to go to the Appliance Array menu.
View screen------------------------------------------------------
>>> Installation -> Appliance Array <<<
Array Name: Tanium Appliance Array
Array UUID: 0f6c41f1-409c-4515-9b8a-f4e5b6798695
Number of Array Members: 1
Hostname Current Role Platform New Role
1: ts1 None None Tanium Server
A: Add Member
F: Refresh Appliance Array
I: Install Pending Role Changes
X: Reset Appliance Array
R: Return to previous menu
------------------------------------------------------
- Enter X and follow the prompts to reset the array.
View screen>>> Appliance Configuration -> Appliance Array -> Reset Array <<<
This appliance is the sole member of an existing array. Since it is the sole
member, resetting the array will not affect other appliances.
Do you want to drop this appliance from the array? [Yes|No]: yes
Press enter to continue