. Docs  . Admin Guide  . Installation Guide

Installation Guide

This is the installation guide for setting up Kora for your enterprise.

In this section we will see the steps for Enterprise Admin to:

  • install Kora,
  • set up access control,
  • assign login options (SSO) and
  • enroll users.

Server Installation

Kora comes in two versions – Cloud or On-prem.

Cloud Version

There are five steps to setting up and using Kora from the Cloud version:

Step 1 – Register Enterprise Admin:
In order to set-up Kora for your organization on the cloud version, the Kora needs the email id of a user from your enterprise who will act as the Enterprise Admin (EA). This email id will be registered with the Kora cloud setup.

Step 2 – Register Domain Name:
Provide a primary domain name to Kora to get it white-labeled with Kora. This is to enable users from your enterprise to access the Kora cloud version. Enterprise Admin can add subdomains later to suit your enterprise needs for example segregation of HR and finance domains under your organization.

Step 4 – OAuth Setup:
If you want to enable Single SignOn using Google or Office 365 for your users, the Kora team can enable it for you at the time of your enterprise account creation. If not provided, users will be directed to the email-based login screen, wherein they have to register their email ids with Kora in order to log in.

Step 5 – Admin Login:
Once Enterprise Admin is registered, he/she will be provided access to the Kora administration page at kora.kore.ai/admin. The Enterprise Admin can log in to the Kora admin page and set up your enterprise Kora.

Virtual Private Cloud

If needed Kora team can provide a private cloud setup for your organization. This would be an instance similar to the Kora cloud setup hosted on your private cloud setup or managed by Kora. The steps in installation and setup would be the same as that mentioned in the earlier section for the Cloud installation.

On-Prem

This section includes the hardware, and software requirements for the on-prem installation.  The step-by-step Kora installation instructions will be shared with you by the Kora team.

OS / Hardware / Network requirements

  • Enterprise Linux (RHEL/CentOS 7.x)
  • 10-gigabit Ethernet bandwidth
  • SSL certificate for the subdomains*
  • SMTP Account(new or existing) credentials. This will be configured in the server to send user signup and activation mail for bots platform

NOTE: TLS for inter-process communication is not enabled by default. This can be configured as needed.
* This is required only in case of a clustered environment. For a Standalone (single) server environment, this is not required.

Standalone (single) server environment

  • Target Application server: Bots platform will be deployed on this server.
    • 16 CPU cores at 2Ghz or greater speed per core
    • 32 GB RAM
    • 100 GB Operating System storage – root partition Make sure if there is separate /var/ partition: with minimum 30 GB storage
    • 100 GB SSD Hard disk – /data
    • 250 GB – 500GB Hard disk – /data – On MongoDB ServerNote: If the servers are on VMware platform, CPU and Memory should be reserved (CPU should not be overcommit) for the specified capacity. The recommended CPU speed is 3 GHz.
  • Operating System
    • Enterprise 64-bit (RHEL/CentOS 7.3,7.4,7.5) Linux
  • 2 DNS name to be assigned to the application server.
    • DNS name for Kora Application access (e.g: kora.yourcompany.com)
    • DNS name for bots Application access (e.g: bots.yourcompany.com)
  • SMTP account for outbound emails
    • Used for sending out the registration emails in the bots platform.
      Bots platform uses a basic auth account to send out emails.
  • Ethernet bandwidth
    • Recommended: 10 Gigabit
  • Network configuration
    • Target application server needs to have access to internet connection [ports 80, 443].
    • VPN Access to Kora team: If the Kora team is provided with VPN access to the customer environment, all the ports of application Server should be accessible over VPN.
  • Access to Kore download server (https://korebuilds.kore.com)
  • Functional identities
  • Sudo access
    • The installation will require sudo access to server during installation
      The functional identity (kore) will be used to start/stop Kore platform specific services including nginx.

Clustured environment

TBD

Enterprise configurations

This section outlines various configurations that you as an Enterprise Admin can set up from the Admin Console.

Roles & permissions

As the Enterprise Admin, before you onboard users to Kora, you need to set roles and give permissions to users for accessing Kora features. See here for more details.

Setting up Authorization

Types of Supported Authorizations

Kora allows you to integrate the following login options:

  • Google,
  • O365,
  • SAML,
  • Exchange, and
  • Email-based login.

Based on your choice these will be enabled by the Kora team for you when setting up the account. Refer here for more on the OAuth setting. To be elaborated post-implementation.

Testing OAuth setup
It is advisable to test the setup once before onboarding users. For this, you can invite yourself to Kora. On the receipt of the invitation email, accept the invitation. You should be taken to the SSO login page that you set up. Login to Kora.

User Enrollment

Enterprise Admin can invite users in any of the following ways:

  1. Invite users individually: Go to Enrollment -> Invite (maximum of 5 invites can be sent at a time).
  2. Bulk invite a large set of users by uploading a file with user details: Go to Enrollment -> Bulk Invite.

See here for more on Enrollment.