Configuring the Primary Server
  • 3 Minutes to read
  • Dark
  • PDF

Configuring the Primary Server

  • Dark
  • PDF

Article summary

Configuring the primary server is a one-time operation, the first time you access the portal.


All CTERA Portal servers must not run other services. By default, CTERA portal servers are application servers.

If you are installing an additional server, proceed directly with Installing and Configuring Additional CTERA Portal Servers.

Performing Initial CTERA Portal Setup

This procedure is performed only once, on the primary server.

To perform initial CTERA Portal setup of the primary server:

  1. Using a Web browser, browse to the CTERA Portal, via the IP address using HTTPS. For example,
    The Setup wizard opens, displaying the Select Server operation mode window.

  2. Choose This is the Master Server.

  3. Click Next.
    The License Agreement window is displayed.

  4. Read the agreement and then click I Accept and then click Next.
    The database is initialized and then the Welcome to CTERA Portal window is displayed.

  5. Complete the fields as follows:
    Username – The name for your CTERA Portal administrator account.
    First Name – The first name of the administrator.
    Last Name – The last name of the administrator.
    Email Address – The email address of the administrator for notifications.
    Password – The password administrator will use to access the CTERA Portal.
    Retype Password – The password.

  6. Click Next.
    The Email Settings window is displayed.

  7. Complete the fields as follows:
    SMTP Server – The outgoing mail server address for sending email messages from CTERA Portal to users.
    SMTP Port – The port number for sending email messages from CTERA Portal to users. This port is usually TCP 25.
    Sender – The email address that should appear in the From field of notifications. For example: CTERA Customer Service
    Enable TLS – Select this option to use Transport Layer Security (TLS) encryption for sending email messages from CTERA Portal to users.
    Server requires authentication – Select this option if the SMTP server requires authentication.

    • User Name – Type the user name that CTERA Portal should use when authenticating to the SMTP server.
    • Password – Type the password that CTERA Portal should use when authenticating to the SMTP server.

    The username and password you specified for the portal administrator are sent to the email address using the information specified here. If the address is incorrect, the email will not arrive and if you have not recorded the administrator username and password details and they are forgotten, you will not be able to access the portal.

  8. Click Next.
    The DNS Domain window is displayed.

  9. In the DNS Suffix field, type the DNS suffix to append to each virtual portal's name, in order to create the virtual portal's DNS name.
    For example, if a virtual portal's name is myportal, and the DNS suffix is, then the virtual portal's DNS name is


    You can change the DNS domain in the CTERA Portal user interface, in Settings > Global Settings.

  10. Click Next.
    The Wizard Completed window is displayed.

  11. Click Finish.
    The data is saved and a success message is displayed.

  12. Click OK.
    CTERA Portal opens, displaying the Administrator Login page.

  13. Enter the user name and password you specified in the Welcome to CTERA Portal window, above, and click SIGN IN.
    The portal opens, displaying the Main > Dashboard page. By default, CTERA Portal creates a team portal called portal. For information about how to rename, view and edit this portal, or create additional team portals, see Team Administrator Guide.


The initial setup includes initializing the PostgreSQL database used by the CTERA Portal. The database must be backed up. Backing up the database is described in Backing Up the Database.

Enabling Internal Tools

To make the installation faster, features that take a long time to initialize are not started automatically. These tools are required for the following:

  • CTERA Messaging Service
  • CTERA Edge Filer Syslog Service
  • Using an S3 Browser
  • Setting the Local Quota

To initialize the features:

  1. Log in as root over SSH to the CTERA Portal.
  2. Run the following command:
    set /settings/platformServicesSetting/enabled true

Your features will be initialized.


Because these features take a long time to initialize, CTERA recommends that you finish installing all the production servers. You then initialize the features by running the CLI in the primary database server and it will initialize the features on every server.

After initializes the features, if you add more servers, the features are automatically initialized on these servers.

Was this article helpful?