Cisco Fog Director Reference Guide, Release 1.9
Bias-Free Language
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
- Updated:
- August 15, 2019
Chapter: Cisco Fog Director General Operations
Cisco Fog Director General Operations
This chapter describes general operations that you perform with Cisco Fog Director.
Browser Guidelines
The following browser guidelines apply to Cisco Fog Director:
- You can access the Cisco Fog Director user interface by using Mozilla Firefox release 44 and above or Google Chrome release 48 and above
- For increased system security, a Cisco Fog Director browser session times out after a 30 minute period of no use
- To ensure that a Cisco Fog Director page shows the most current information, use your browser Refresh feature to periodically update the page that you are viewing
Accessing Cisco Fog Director
After you install Cisco Fog Director, you can access it from any supported computer that has IP connectivity to the Cisco Fog Director server.
To access Cisco Fog Director, follow these steps:
Step 1
Start a supported browser, and in the Address field, enter the fully-qualified hostname or the IP address of the server on which Cisco Fog Director is running.
If you are logging in for the first time, the End User License Agreement (EULA) dialog box displays. Otherwise, the Log In page displays.
Step 2 If the End User License Agreement dialog box displays, review the EULA and click the Accept button to continue.
Step 3 Enter your Cisco Fog Director ID in the LOGIN ID field, and enter your Cisco Fog Director Password in the PASSWORD field.
IDs and passwords are case-sensitive, so make sure to enter them exactly as they are configured.
The default Fog Director ID is admin and the default password is admin.
If you entered the default password (admin), the system prompts you to change your password. Otherwise, the Cisco Fog Director Apps page displays.
Step 5 If the system prompts you to change your password, take these actions:
a. Enter your new password in the NEW PASSWORD and CONFIRM PASSWORD fields.
The password is case-sensitive and can include any number of alphanumeric and special characters, but no spaces.
c. Enter your new password in the PASSWORD field.
Viewing Notifications
A notification is a system message that Cisco Fog Director provides. For example, the system provides a notification when a new version of Cisco Fog Director is available.
When notifications have been provided and not addressed, the Notification icon 
in the Cisco Fog Director menu bar displays the number of notifications. For example, this icon indicates that you have one notification: 
.
To see a summary of notifications, hover your mouse pointer over the Notification icon. If you hover your mouse pointer over the icon when there are no notifications, the system displays the message “You’re all caught up!”
To see detailed information about notifications, click the Notification icon and then click the desired notification summary box.
Exiting Cisco Fog Director
To exit Cisco Fog Director, click the Logout button 
from any Cisco Fog Director page.
Changing Your Cisco Fog Director Password
To change your Cisco Fog Director password, follow these steps:
Step 1 Take either of these actions:
.
Step 2 Enter your Cisco Fog Director ID in the LOGIN ID field, and enter your Cisco Fog Director Password in the PASSWORD field.
IDs and passwords are case-sensitive, so make sure to enter them exactly as they are configured.
Step 3 Enter your new password in the NEW PASSWORD and in the CONFIRM NEW PASSWORD fields.
The password is case-sensitive and can include any number of alphanumeric and special characters, but no spaces.
To cancel a password change operation, click Login instead of CHANGE PASSWORD.
Understanding Managed and Unmanaged States for Apps
Cisco Fog Director considers a Cisco IOx app to be in managed state when you can manage the app on a device by using Cisco Fog Director. Cisco Fog Director considers an app to be in unmanaged state when the app has been added to device by a method other than using Cisco Fog Director.
In general, a Cisco IOx app is in managed state when it has been installed on a device through Cisco Fog Director. However, in some scenarios in which an app already is installed on a device using a method other than Cisco Fog Director, the app does not go to managed state when device is then added to Cisco Fog Director.
This section provides an overview of the general steps to take in these scenarios to ensure that an app is in managed state.
If an app is in unmanaged state on a device, follow these steps to change it to managed state:
|
|
|
|
|---|---|---|
To uninstall the app, see the “Uninstalling an App” section, your Cisco IOx Client documentation, or your Cisco IOx Local Manager documentation To delete the device, see the “Deleting Devices” section. |
||
If you uninstalled the app from the device, remove the app from the Installed App area on the Cisco Fog Director App View page by clicking the Remove button in this area for the app. |
||
See the “Adding Devices” section or the “Importing Devices” section. |
||
See the “Importing an App” section. |
||
See the “Installing an App” section. |
If you have a device on which an app is installed using a method other than Cisco Fog Director, follow these steps to ensure that the app does not go to unmanaged state with you add the device to Cisco Fog Director:
|
|
|
|
|---|---|---|
To uninstall the app, see the “Uninstalling an App” section, your Cisco IOx Client documentation, or your Cisco IOx Local Manager documentation To delete the device, see the “Deleting Devices” section. |
||
See the “Importing an App” section. |
||
See the “Adding Devices” section or the “Importing Devices” section. |
||
See the “Installing an App” section. |
An app goes to unmanaged state if the following occurs:
1. You add a device to Cisco Fog Director.
2. You install the app on the device by using Cisco Fog Director.
3. You delete the device from Cisco Fog Director (with the app still installed on the device).
4. You delete the app from Cisco Fog Director.
5. You add the device again to Cisco Fog Director.
To prevent the app from going to unmanaged state, follow these steps before you add the device again to Cisco Fog Director:
|
|
|
|
|---|---|---|
See the “Importing an App” section. |
||
See the “Adding Devices” section or the “Importing Devices” section. |
Troubleshooting
The following sections provide information that can be useful for troubleshooting Cisco Fog Director. In addition, the Cisco Fog Director apps pages and device pages provide information and features that you can use to monitor and troubleshoot apps.
Cisco Fog Director Logs
Cisco Fog Director provides several options for viewing or obtaining logs for apps, devices, and the system. You can use these logs to monitor operations or troubleshoot issues that occur.
Logs are stored in the /opt/cisco/fogdirector/logs folder on the server on which Cisco Fog Director is running.
Table 3-1 describes the logs and provides references to sections that provide more detailed information.
|
|
|
|
|---|---|---|
See the description of the View App Log button in the “Viewing Detailed Monitoring Information” section. Also see the description of the App Log tab and View all App Logs in the “Apps Area” section |
||
See the description of Collect Debug Logs, the VIEW DEVICE LOGS button, and the DOWNLOAD TECH SUPPORT LOGS button in the “Device Details Area” section. Also see the “Obtaining Device Logs” section |
||
Information about actions performed by users, and errors or exceptions generated by a device or persistent store. |
Cisco Fog Director Processes
To operate properly, Cisco Fog Director requires that its processes be running on the server on which it is installed. If you experience problems with Cisco Fog Director, such as its web-based user interface becoming unresponsive, you can check the status of the processes and stop and restart them if needed.
To manage Cisco Fog Director processes, use an SSH client to access the server on which Cisco Fog Director is installed, log in using your Cisco Fog Director user name and password, and then use the commands that Table 3-2 describes.
Feedback