Managing Access Points

You can manage Access Points from the Network > Access Points page, where you can create, delete, and update CIC Agent software for Access Points.

Viewing the list of Access Points

You can see Access Points on the Network > Access Points page.

Access Points with multiple Nodes for High Availability are marked by a special icon:

The Access Points page shows summary information for each Access Point in your CIC system, including:

Access Point List Summary Information

Name

The name of the Access Point. Used to identify the Access Point throughout your CIC system.
A special icon is displayed to indicate when an Access Point has multiple Nodes and is configured for High Availability.

Status

CIC tracks the status of each Access Point at a regular interval and displays the status for each in this column.

For Access Points with multiple Nodes, this column presents an aggregate status --an overall indication of Access Point health. Valid values for Access Point status are as follows:

Pending	The Access Point has been created, but the CIC Agent software is not yet active on the server where it was installed.
Active	At least one Agent (Node) is functioning normally.
Not Responding	None of the installed Agents (Nodes) are responding, but the Access Point is not yet considered down.
Down	All of the installed Agents (Nodes) have been non-responsive to status requests for an extended interval and the Access Point is considered to be offline.
Updating	The Access Point is neither Active nor Down and one or more Agents are in the process of updating.
Unhealthy	The Access Point has at least one Node that is experiencing connectivity issues and is considered unhealthy.

An additional, secondary status indicator is also displayed when not all of the Nodes associated with the Access Point are functioning normally. See Access Point Secondary Status.
In addition, you can hover over this column to see the status of individual Nodes. See Node Status for more information.

Nodes

The number of nodes installed for the Access Point. Having more than one node installed provides high-availability Access Point functionality. See High Availability CIC Agents.

Node version

For a single-Node Access Point, the version number of the CIC Agent software currently installed is displayed.

For a multiple-Node Access Point, no version number is displayed. You can hover over this column to see details about individual Nodes. See Secondary Status for Nodes for more information.

The Operating System on which the Access Point is running.

Endpoints

The number of Endpoints created on this Access Point.

Created by

The person who created the Access Point.

Modified

Last time the Access Point was modified.

Access Point Secondary Status

For Access Points set up for High Availability (with multiple Nodes), the Access Point Status column may show a badge indicating specific conditions.

Badge	Possible Conditions
No badge present	All Nodes are functioning normally.
	Some, but not all, of the Nodes are either not responding, down, unhealthy, or being updated. Nodes on Access Point are not on the same version.
	Some, but not all, Nodes are being updated.
	At least one node is running an old version and should be updated.

Node Status

When you hover over either of the Status or Node version columns, status information about individual Nodes for the given Access Point is displayed in a pop-up window.

Badges displayed indicate the following conditions:

Badge	Description	Appears in
	Node is not responding.	Status column
	Node is down.	Status column
	Node is active and functioning normally.	Status column
	Node is being updated.	Status column
	Node is experiencing connectivity issues - considered unhealthy.	Status column
	Node is running an old version and should be updated.	Node version column

Viewing Detailed Access Point Information

When you click an Access Point on the Access Point list, CIC displays detailed information about that Access Point.

Access Point Detail Information

Name

The name of the Access Point. Used to identify the Access Point throughout your CIC system.

Created By

The person who created the Node.

The Operating System on which the Node is running.

Nodes

For each node, the following information is displayed.

Status	The Node's current status. The status of each Node affects the overall status of the Access Point as displayed on the Access Points List page. Pending - CIC Agent software is installed, but not yet activated. Active - Node is functioning normally. Not responding - The Node is not responding, but is not yet considered down. Down - The Node has been non-responsive to status requests for an extended interval and is considered to be offline. Email notifications can be generated when this status changes. Updating - The CIC Agent software is in the process of being updated. Disabled - The Node has been made unavailable but can be re-enabled. Unhealthy - Indicates connectivity issues and can generate email notifications when this status changes. Note: Only Nodes running CIC Agent version 1.2.25 and later can display this status.
Name	The name identifying the Node.
Version	The version of the CIC Agent software currently installed on the Node.
Created By	The person who created this node.
Issue	If there is an issue, information about it is displayed.

Endpoints

A list of the Endpoints that use this Access Point. You can click an Endpoint name to display the Endpoint Details page for that Endpoint. See Managing Endpoints.

Creating an Access Point

Creating an Access Point entails running a script to download and install the CIC Agent software on a private server.

Log in to CIC.
In the CIC Cockpit, go to Network > Access Points and click the Add Access Point button.
Enter a Name and choose an OS from the following:
- CentOS
- Red Hat
- Ubuntu
- SUSE Linux Enterprise Server
- Windows
The system displays the Nodes window. Click the Add button (in the upper right corner of the Node window) or the Add Node link.
Note: You can add more than one Node to create a High Availability Agent implementation. See High Availability CIC Agents.
CIC displays the code required to install the CIC Agent. Follow the instructions displayed to install the CIC Agent software on the Access Point server.

For more detailed information about working with CIC Agent software, see Installing, Updating, and Uninstalling CIC Agents.
Optional - Add more nodes to your Access Point. Adding more nodes provides high-availability functionality. Click the Add button.

Adding Nodes to an Existing Access Point

New HA Agents can be added to an Access Point regardless of the version of any pre-existing Agents in the Access Point. Upon activation of subsequent Agents, the Access Point will indicate that multiple agents have been activated. As you add Agents, they are given default names like "Node_1", "Node_2". You can edit these names to suit your needs.

Select an Access Point from the Access Point list.
Click the Add Node button.
CIC displays the code required to install the CIC Agent. Follow the instructions displayed to install the CIC Agent software on the Access Point server.
For more detailed information about working with CIC Agent software, see Installing, Updating, and Uninstalling CIC Agents.

Working with Nodes

Once a Node has been added to an Access Point, you can restart, disable, rename, or delete it.

Restarting Nodes

In a situation where issues with a Node might be resolved by a restart, click the Restart button for that Node.

A confirmation dialog box displays.

You can click Restart with no further intervention for a regular restart (waiting for all in-progress jobs to complete) or select the Force Restart check box to restart the Node immediately, potentially losing in-progress jobs.

Disabling Nodes

Click the Disable button for the Node you want to disable.

When a Node is disabled, its leadership is relinquished on the next heartbeat request, ensuring that a disabled Node cannot become a Leader Node.

Note: You cannot disable a Node if it is the only one running in an Access Point.

Renaming Nodes

Click the Rename button and then enter a new name for the Node.

Deleting Nodes

Click the Delete button to remove a Node from the Access Point.

Note: You cannot delete a Leader Node or the last Node in an Access Point. To delete a Leader Node, disable it first.

Removing an Access Point

Removing an access point is a two-step process, where you first remove the Access Point from the CIC UI and then use the appropriate OS-based process for removing an application to uninstall the CIC Agent.

Go to Network > Access Points.
Select the check box for the access point you want to remove.
Click the Trash Can icon in the upper right part of the page and then click Delete to confirm that you want to remove the access point.
Uninstall the CIC Agent software. You can uninstall from using the tools provided by your OS or the command line.
If you are uninstalling a legacy version of CIC Agent (1.0.16 or earlier), you must use the package uninstaller.

For Windows, use the Add or Remove Programs utility.

For Linux, do one of the following:
- For RPM-based distributions:
```
sudo rpm -e cleo-agent
sudo rm -rf /opt/cleo /var/log/cleo
```
- For Debian-based distributions:
```
sudo apt purge cleo-agent
sudo rm -rf /var/log/cleo
```
If you are uninstalling a newer version (1.0.17 or later), you can use either the package uninstaller (see above for more information) or the command line (see Installing, Updating, and Uninstalling CIC Agents.)

Note: When you uninstall a newer version of CIC Agent (1.0.17 or later) and you have multiple CIC Agents installed, make sure you are uninstalling the intended instance of the Agent software.

Updating CIC Agent Software

From time to time, it is necessary to update the CIC Agent software installed on each of your Access Point servers.

To see what version of the Agent you have installed, go to the Network > Access Points page.

Select the Access Point for which you want to update the CIC Agent software and click the update button in the upper right. Note that if you have Admin permissions, you might be able to update the agent software for all Access Points available on the Network > Access page.
Confirm that you want to update the agent. This might take a few minutes as your system needs to download the software and then install it.

Note: When performing updates to an Access Point with more than one Node, only one Agent is in an "update" state at a time.