# Install API Server/Director Console

The **Director Console** lets you create and manage the configuration settings of the Fabric-enabled Logpoints divided into different pools. It allows you to search, configure, and monitor entities from a single user interface.

### ISO

Only one API Server is supported in one Logpoint Director setup.

<details>

<summary>Install API Server Using ISO</summary>

1. Boot your system with Logpoint Director ISO v1.0.0.
2. Select **API Server** in the **Director Server Type** panel and click **OK**.\
   ![Selecting LP Director Server Type](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FaH2JBSxTso1IJVstALsk%2Fimage.png?alt=media\&token=306c6a54-a882-4ec2-9f56-9320b4dcbbed)
3. The installer detects the number of hard disk drives present in the system and shows various options available for the Director installation. The available options for Director installation according to the number of HDD are:

   | Number of HDD(s) | Mode of Installation  |
   | ---------------- | --------------------- |
   | 1                | Single                |
   | 2                | Mirror/ Single        |
   | 3 or more        | RAIDZ/ Mirror/ Single |

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><ul><li>The ZFS (Zettabyte File System), used by the Logpoint Director, provides a software-defined solution for disk-based redundancy (Mirror, RAIDZ). Hence, it is not recommended to use hardware-based RAID. Doing so limits the ZFS to perform self-healing on checksum failures.</li><li>When selecting the RAIDZ mode, the first three disks is used for OS and Application installation. The remaining disks, if any, can be used to extend the disk space or used as L2ARC (Level 2 Adjustable Replacement Cache) or ZIL (ZFS Intent Log) for enhancing the read/write performance of ZFS. It can be done using ZFS commands.</li></ul></div>
4. Click **Back** to change the mode of installation or click **Continue** to proceed.\
   ![Start Installation or Return to Main Menu](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2F3ulIJGOztaaajgOGk21u%2Fimage.png?alt=media\&token=acfc35f5-8f9d-4dfc-a264-a1623c67d07f)

   The first reboot of the installer occurs.
5. The installer detects the list of Ethernet interfaces connected to the system. Choose the desired network interface to modify its configuration.\
   ![Select the Network Interface](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FWBmvJKHdzWh4eamxhgG0%2Fimage.png?alt=media\&token=9aa5f5b5-c5fe-45c3-9c8f-abc1769ed80b)

   Click **OK**.
6. The installer extracts the configuration of the selected Ethernet interface. Revise the configurations if necessary and click **Submit**.

   The full configuration details of the selected Ethernet interface is displayed if DHCP is enabled. If DHCP is not enabled, then only the fields “Hostname” and “DOMAIN” appear and you need to manually enter the “IP”, “Netmask”, and “Gateway” fields.\
   ![Enter the Network Configuration](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FxIdgNw8q95RoiVC5rkqt%2Fimage.png?alt=media\&token=de51efe6-7280-4ce2-82c5-59ac99941f69)
7. Click **Back** to revisit the configurations or click **Continue** to proceed.\
   ![Confirming the New Network Configuration](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FNGPYZMoPaaBoIgMIUJ25%2Fimage.png?alt=media\&token=7cde1661-1f10-479c-8baa-66690c192faa)
8. Enter the number of Fabric Servers that the API server (that is being configured) will connect to and click **OK**.\
   ![The Number of Fabric Server for API Server](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2Fsf9bUamJ636l3RyVFXDy%2Fimage.png?alt=media\&token=972ee69d-9825-4b8b-9c36-b047c210ef9f)
9. Specify the IP addresses and the respective tunnel IP addresses of the Fabric Servers and click **OK**.\
   ![Interface and Tunnel IP-Address of Fabric Servers](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FyenbMYE9hUwgK3PwUPLE%2Fimage.png?alt=media\&token=f3bb0965-b4d4-4a1b-8f9a-a5dce0942c91)
10. Click **Back** to revisit the configurations or click **Continue** to proceed.\
    ![Fabric Server Details](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FMSJ3KTJfIRSUxIFq8prz%2Fimage.png?alt=media\&token=2aa5a938-f879-4350-ac65-6a2ff721b6e8)
11. Click **OK**.\
    ![Successful API Server Installation](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FZmt9uNe3WHfChwJtrKT4%2Fimage.png?alt=media\&token=6e2e2fa7-db58-43d4-998f-873a00f1de12)
12. **Enter the IP address of Remote Syslog Server** where the Audit Logs should be sent to and click **OK**.

    If the Remote Syslog Server is not ready, you can leave the default settings as they are. You can later execute the **change-rsyslogip** command to change the IP address of the Remote Syslog Server, once you complete the installation process.\
    ![IP Address of Remote Syslog Server](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FGm1AjuW1vVjpIB2EFVMD%2Fimage.png?alt=media\&token=f8dec4fa-f555-4844-8078-7f0f0ce98299)\
    The system reboots to support the new configurations. The Director installation for the API server completes, and the login window appears.\
    ![API Login Window](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FlsSXxYdj5W89TRcMaHf3%2Fimage.png?alt=media\&token=cfc83509-64dd-4260-aea7-5bdda50a0c58)
13. Log in using the following credentials:

    ```
    username: cmdr-admin
    password: changeme
    ```

    It is recommended to change the password immediately using the `passwd` command.

    <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>It is mandatory to synchronize the time between all the Director components (Fabric-enabled Logpoint, Logpoint Master, Fabric Server(s), and API Server. Execute the <code>config-ntp</code> command to configure and manage NTP server details.</p></div>
14. Execute the `install-dc` command as cmdr-admin to install the Director Console.\
    ![Configuring SFTP](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FUzh8bxlyagPV4i0lqkZp%2Fimage.png?alt=media\&token=68dd18b6-4cbb-4f13-85ee-f57b60ad878b)
15. Click **Yes** to configure SFTP or **No** to proceed without configuring SFTP.
16. To configure **SFTP**, enter the **SFTP server IP address**, **User Name**, **Password** and **Data retention Period** and click **Submit**.\
    Configuring SFTP:\
    ![](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FwA0OkKeN8alqGll9YhCA%2Fimage.png?alt=media\&token=a0baa7e2-eed8-4dde-baa8-4a09413488fe)

    Successful SFTP Configuration:\
    ![](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FBk6TvsDPrzoYIFnLGjOh%2Fimage.png?alt=media\&token=2dff8369-de37-47b3-b57a-98c78f195fe1)

Go to the [Configuring SFTP in Director Console](https://docs.logpoint.com/director/director-console/backup-and-restore/director-console-backup#configure-sftp-in-director-console-ui) for more details.

The installation of the API Server is now complete.

We recommended you to change the password of Fabric Proxy ACL (Access Control List) using the `change-fabric-proxyacl` command exposed to the API Server, before connecting a Logpoint to the Director setup. The default credentials of the Fabric Proxy ACL are:

```
username: zkacl
password: Welcome@123
```

We recommended you to change the password of Fabric Authenticator using the `change-fabric-authpwd` command exposed to the API Server, before connecting a Logpoint to the Director setup. The default credentials of the Fabric Authenticator are:

```
username: user: hdfs/admin
password: Welcome@123
```

The next step is to upload a license. In the Director setup, only the Director users have the authority to upload a license. See the [Uploading a Director License](https://docs.logpoint.com/director/deploy-and-configure/configure-director/manage-director-license) section for details.

</details>

### AMI/OVA/VHD

You must deploy the API Server AMI/OVA/VHD before installing the API Server. To learn how, go to the [Deploying the Director AMIs](https://docs.logpoint.com/director/deploy-and-configure/deploy-director/install-director-components/broken-reference), the [Deploying the Director OVAs](https://docs.logpoint.com/director/deploy-and-configure/deploy-director/install-director-components/broken-reference) and [Deploying the Director Azure VHDs](https://docs.logpoint.com/director/deploy-and-configure/deploy-director/install-director-components/broken-reference).

Only one API Server is supported in one Logpoint Director setup.

<details>

<summary>Install API Server Using AMI/OVA/VHD</summary>

1. Access the API Server instance. The installer detects the list of ethernet interfaces connected to the system. Select the appropriate network interface to modify its configuration and click **OK**.\
   ![Select the Network Interface](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FM4kxpngxyZq03uvJOJTt%2Fimage.png?alt=media\&token=7e4f1abc-a50b-4b27-b902-fa0360735c3e)
2. The installer extracts the configuration of the selected ethernet interface. Revise the configurations if necessary.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>For API Server AMI</strong>: Do not change the <strong>IP Address</strong>, <strong>Netmask</strong>, and <strong>Gateway</strong>. AWS environment does not allow these changes after launching the instances.</p></div>

   ![Enter the Network Configuration](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2F1rvFDLpCkylhd8lt974k%2Fimage.png?alt=media\&token=5b69b41e-a99c-4c07-a9a9-a03c6151136e)
3. Click **Submit**.\
   ![Confirming the New Network Configuration](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2F2QCPwjknp1LJIae7ZSIZ%2Fimage.png?alt=media\&token=b93770c9-ffa6-4780-aeaa-c5685ff6a021)
4. Click **Continue**. You can click **Back** to revisit the configurations.
5. Enter the number of Fabric Server instances for the API Server to connect.\
   ![The Number of Fabric Server for API Server](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2FgKsOS7PvQJwvK26alZiU%2Fimage.png?alt=media\&token=bcf574d1-41b0-4fc9-85a8-67321c842261)
6. Click **OK**.
7. Specify the IP addresses and the respective tunnel IP addresses of the Fabric Server instances. The tunnel IP is the internal IP address through which the Logpoint Director components communicate with each other.\
   ![Interface and Tunnel IP-Address of Fabric Servers](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2F54FyZknASwF2LLFbMCPK%2Fimage.png?alt=media\&token=053d029c-7d8b-422f-9ebd-c310bd8941b6)
8. Click **OK**.\
   ![Fabric Server Details](https://3198401301-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhzE0kPDYI002AO7fHbFv%2Fuploads%2F3buns0gy1hBNCZVeO2an%2Fimage.png?alt=media\&token=7a522c39-991c-4ab8-b825-cbb42c0f0e54)
9. Click **Continue**. Click **Back** to revisit the configurations. The system reboots to support the new configurations.
10. Enter the API Server’s default credentials:

    ```
    username: cmdr-admin
    password: changeme
    ```

    We recommend you to change the password immediately using the *passwd* command.
11. Execute the *config-ntp* command to configure and manage the NTP server.

    <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>It is mandatory to synchronize the time between all the Director components (Fabric-enabled Logpoint instances, Logpoint Search Master, the Fabric Server, and the API Server).</p></div>

We recommend you to change the password of Fabric Proxy ACL (Access Control List) using the *change-fabric-proxyacl* command exposed to the API Server, before connecting a Logpoint to the Director setup. The default credentials of the Fabric Proxy ACL are:

```
username: zkacl
password: Welcome@123
```

We also recommend you to change the password of Fabric Authenticator using the *change-fabric-authpwd* command exposed to the API Server, before connecting a Logpoint to the Director setup. The default credentials of the Fabric Authenticator are:

```
username: hdfs/admin
password: Welcome@123
```

To learn how to access Director Console, go to the [Accessing Director Console](https://docs.logpoint.com/director/deploy-and-configure/deploy-director/install-director-components/broken-reference) section.

</details>
