Oracle-Based Deployment Guide for Cisco IoT FND, Release 5.x.x and Later

PDF

Set up Cisco IoT FND

Updated: March 2, 2026

Want to summarize with AI?

Log in

Overview

This topic explains how to set up Cisco IoT FND using the setupCgms.sh script, including configuration steps, important notes, and example command output.

To set up Cisco IoT FND, run the setupCgms.sh script.

Note
If deploying a Cisco IoT FND server cluster, the setupCgms.sh script must be run on every node in the cluster.
Caution

The Cisco IoT FND certificate encrypts data in the database. The setupCgms.sh script runs database migration, which requires access to the Coscp IoT FND certificate in the keystore. You must set up certificates before running setupCgms.sh. The script results in an error if it migrates the database and cannot access the certificate.

Caution

Ensure that the database password entered while running the setupCgms.sh script is valid. If you enter an invalid password multiple times, Oracle might lock your user account. You can unlock your account on the database server.

Note
For more information about unlocking your password, see Generating and installing certificates for Cisco IoT FND.

This example uses the setupCgms.sh script to set up a single-server Cisco IoT FND system that uses one database.


                # <uicontrol>cd /opt/cgms/bin</uicontrol>
                # <uicontrol>./setupCgms.sh</uicontrol>
                07-10-2023 17:10:00 IST: INFO: ========== IoT-FND  Setup Started - 2018-09-13-17-10-00 ==========
                07-10-2023 17:10:00 IST: INFO: Log file: /opt/cgms/bin/../server/cgms/log/cgms_setup.log
                Are you sure you want to setup CG-NMS (y/n)? <uicontrol>y</uicontrol>
                07-10-2023 17:10:02 IST: INFO: User response: y
                Do you want to change the database settings (y/n)? <uicontrol>y</uicontrol>
                07-10-2023 17:10:05 IST: INFO: User response: y
                Enter database server IP address [example.com]: <uicontrol>128.107.154.246</uicontrol>
                07-10-2023 17:11:02 IST: INFO: Database server IP: 128.107.154.246
                Enter database server port [1522]:
                07-10-2023 17:11:07 IST: INFO: Database server port: 1522
                Enter database SID [cgms]:
                07-10-2023 17:11:12 IST: INFO: Database SID: cgms
                Do you wish to configure another database server for this CG-NMS ? (y/n)? <uicontrol>n</uicontrol>
                07-10-2023 17:11:18 IST: INFO: User response: n
                07-10-2023 17:11:18 IST: INFO: Configuring database settings. This may take a while. Please wait ...
                07-10-2023 17:11:19 IST: INFO: Database settings configured.
                Do you want to change the database password (y/n)? <uicontrol>y</uicontrol>
                07-10-2023 17:15:07 IST: INFO: User response: y
                Enter database password:
                Re-enter database password:
                07-10-2023 17:15:31 IST: INFO: Configuring database password. This may take a while. Please wait ...
                07-10-2023 17:15:34 IST: INFO: Database password configured.
                Do you want to change the keystore password (y/n)? <uicontrol>n</uicontrol>
                07-10-2023 17:16:18 IST: INFO: User response: n
                Do you want to change the web application 'root' user password (y/n)? <uicontrol>n</uicontrol>
                07-10-2023 17:16:34 IST: INFO: User response: n
                Do you want to change IPAM and PSK Settings (y/n)?
                07-10-2023 17:16:34 IST: INFO: User response: <uicontrol>y</uicontrol>
                Do you want to use Internal IP Address Management (IPAM) for Loopback (y/n)?
                07-10-2023 17:16:34 IST: INFO: User response: <uicontrol>y</uicontrol>
                07-10-2023 17:16:45 IST: Configuring Preferences settings for IPAM. This may take a while. 
                Please wait…
                07-10-2023 17:16:45 IST: Preferences Settings for IPAM completed successfully
                Do you want to manage Tunnels using Unique Pre-Shared Keys (y/n)?
                07-10-2023 17:16:34 PDT: INFO: User response: <uicontrol>y</uicontrol>
                07-10-2023 17:16:45 IST: Configuring Preferences settings for Tunnel Mgmt. This may take a while. 
                Please wait…
                07-10-2023 17:16:45 IST: Preferences Settings for Tunnel Mgmt completed successfully
                Do you want to change the FTP settings (y/n)? <uicontrol>n</uicontrol>
                07-10-2023 17:16:45 IST: INFO: User response: n
                07-10-2023 17:16:45 IST: INFO: ========== IoT-FND Setup Completed Successfully ==========

The setupCgms.sh script lets you configure these settings:

  • Configuring Database Settings

  • Configuring Database HA

  • Configuring the IoT FND Database Password

  • Configuring the Keystore Password

  • Configuring the Web root User Password

  • Configuring FTPS Settings