Installing CTERA Portal Instances
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Installing CTERA Portal Instances

  • Dark
    Light
  • PDF

Article summary

Use the following workflow to install CTERA Portal.

  1. Creating a Portal Instance. The image is obtainable from CTERA support.
  2. For the primary database server and secondary, replication, server Logging in to the Server to Create the Archive Pool.
  3. [Configuring Network Settings]/v1/docs/configuring-network-settings-6){target="_blank"}.
  4. Optionally, configure a default gateway.
  5. Additional Installation Instructions for Customers Without Internet Access.
  6. For the first server you install, follow the steps in Configuring the Primary Server.
  7. For any additional servers beside the primary server, install the server as described below and configure it as an additional server, as described in Installing and Configuring Additional CTERA Portal Servers.
  8. Make sure that you replicate the database, as described in Configuring the CTERA Portal Database for Backup.
  9. Backup the server as described in Backing Up the CTERA Portal Servers and Storage.
Note

You can use block-storage-level snapshots for backup, but snapshots are periodical in nature, configured to run every few hours. Therefore, you cannot recover the metadata to any point-in-time, and can lose a significant amount of data on failure. Also, many storage systems do not support block-level snapshots and replication, or do not do so efficiently.

Creating a Portal Instance

Note

For the primary database server and secondary, replication, server, the portal instance is created with a fixed size data pool. If you require a larger data pool, which should be approximately 1% of the expected global file system size, you can extend the data pool as described in Hyper-V Specific Management.

To create a CTERA Portal Server in Hyper-V:

  1. Open the Hyper-V Manager.
  2. Right-click the hypervisor and click Import Virtual Machine....
    image.png
    The Import Virtual Machine wizard opens, displaying the Locate Folder window.
    image.png
  3. Click Browse and browse to the CTERA Portal image folder.
  4. Click Next.
    The Select Virtual Machine window is displayed.
    image.png
  5. Click Next.
    The Choose Import Type window is displayed.
    image.png
  6. Select the Copy the virtual machine (create a new unique ID) option and click Next.
    The Choose Folders for Virtual Machine Files window is displayed.
    image.png
  7. Specify where to store the CTERA Portal virtual machine.
  8. Click Next.
    The Choose Folders to Store Virtual Hard Disks window is displayed.
    image.png
  9. Specify where to store the CTERA Portal data pool disk and click Next.
    The Completing Import Wizard window is displayed.
    image.png
  10. Click Finish.
  11. For the primary CTERA Portal database server and the secondary, replication, server, right-click the virtual machine and click Settings.
    image.png
    1. Click the IDE Controller and click Add for a new hard drive.
      image.png
    2. Click Add.
      image.png
    3. Click New.
      The New Virtual Hard Disk Wizard is displayed.
      image.png
    4. Click Next and make sure the VHDX disk format is selected.
    5. Click Next and make sure the Dynamically expanding disk type is selected.
    6. Click Next and specify the size for the new disk.
    7. Enter a size for the new hard disk.
      Note

      The minimum archive pool should be 200GB but it should be sized around 2% of the expected global file system size.

    8. Click Apply and the OK.
  12. Right-click the virtual machine and click Start.
  13. For the primary database server and the secondary, replication, servers, continue with Logging in to the Server to Create the Archive Pool.

Logging in to the Server to Create the Archive Pool

You need to create an archive pool on the primary database server, and when PostgreSQL streaming replication is required, also on the secondary, replication, serve. See Using PostgreSQL Streaming Replication for details about PostgreSQL streaming replication.

Logging in to the Server to Create the Archive Pool

You need to create an archive pool on the primary database server, and when PostgreSQL streaming replication is required, also on the secondary, replication, serve. See Using PostgreSQL Streaming Replication for details about PostgreSQL streaming replication.

To log in to the CTERA Portal server:

  • Right-click the virtual machine and click Connect to open the machine console.
    The default password is ctera321

You are prompted to change the password on your first login.

To create the archive pool:

  1. Connect to the virtual machine.
  2. Run fdisk -l to identify the disk to use for the archive pool.
  3. Run the following command to create the archive pool: portal-storage-util.sh create_db_archive_pool Device
    where Device is the Device name of the disk to use for the archive pool.
    For example: portal-storage-util.sh create_db_archive_pool sdc
  4. Start CTERA Portal services, by running the following command: portal-manage.sh start

Was this article helpful?