Getting Started with KHIKA SaaS
Go to KHIKA SaaS from Google Chrome browser and click on “Sign Up”.
This will open the User Registration form.
Fill in all the required details.
- Note that the Customer Name is the brief name of your company and will be used when you login.
- Please make sure to give your official email address as a verification email will be sent on this email ID
- Also, mention a valid phone number as it will be used for recovering your account in future.
- Submit the form by clicking on the Register button.
On successful User Registration, a pop appears with success message:
Check your inbox for an email from khika.com.
- Note : If you do not see the email in your inbox, please check your junk folder.
- On opening the email, click on the “Verify Email” button to activate your account.
You should see a pop-up in your browser mentioning that your email has been verified and you can use your account.
You will receive confirmation email on your email ID. You can now login into KHIKA SaaS using the customer name, username and password, you had selected at the time of registration.
When you login for the first time, you do not see any data in Kibana dashboards which is expected. This is simply because we have not added any data yet.
Before adding any data to KHIKA SaaS, you must configure the KHIKA Data Aggregator. Click “Configure” from the side menu and go to “Node” tab. KHIKA SaaS has created an Aggregator Node for you and assigned a unique identity to this node.
Note: DO NOT share this identity with anyone as this is the secret identity you use to communicate with KHIKA. Copy-Paste this identity string into your favourite editor as we will need this when we configure our Data Aggregator VM.
Installing and configuring KHIKA Data Aggregator
KHIKA Data Aggregator is available as a virtual appliance. 1) If you are on AWS, you can directly use the ami-0f7d81781d1baee3e (AMI Name: KHIKADA1.0) for installing KHIKA Data Aggregator in your VPC.
Note: This AMI is available only in Mumbai region as of now
2) If you are not on AWS, you can download the OVA image of KHIKA Data Aggregator from our Google Drive . You will have to add a network interface to KHIKA Data Aggregator while provisioning your VM. Please refer to documentation of VMWare technology you are using.
Boot the VM and login as user=khika and password=khika123
- We highly recommend to change the password of user ‘khika’ using ‘sudo passwd’ command after this setup. Click here for detailed steps.
- When you login for the first time KHIKA Data Aggregator takes you through various steps to configure it. Step by step instructions are given below.
As you login for the first time, KHIKA Aggregator will identify that it is not configured and ask you to configure.
Press “Y” and proceed.
- This will start CentOS “nmtui” interface to configure the IP address for your KHIKA Aggregator. Select appropriate interface and provide an IP address.
- We highly recommend you to consult you network administrator for providing IP address and an internet gateway to your Data Aggregator. Here, we are sharing screenshots for your reference.
Your Data Aggregator must be able to communicate with KHIKA SaaS on internet to following host and TCP port
Host = KHIKA-DATA-GATEWAY-219b38e8fbe34670.elb.ap-south-1.amazonaws.com
Port = 9095
Please ensure your firewall allows this connection
After configuring the network parameters for you Aggregator, KHIKA will prompt you to provide details for your location
For example, if you are in India, enter number 5 after the hash sign prompted. This input is for Asia. This will prompt you for your country
Select your country (enter the appropriate number after the hash sign) and proceed This will prompt you for time. Verify the time and type 1 for Yes, if appropriate.
Further, it will prompt you to set the NTP server. We highly recommend to set a proper NTP server here. You can also enter an NTP server on internet
Type Y at this prompt.
System then asks you to enter the Server details. Enter the IP address of your NTP server.
It takes a few moments to connect to the mentioned NTP server and shows details including the synchronisation status. It further asks you to select the nearest KHIKA Data Gateway.
The nearest data gateway is pre-populated and you can just press “N” to select the default one.
In the above example, it is seen that the KHIKA Data Gateway is set in “ap-south-1” region.
The next step is crucial one where you set the identity of your KHIKA Data Aggregator.
This identity is visible in your “Node” tab on KHIKA We GUI. It was seen in this step. Copy paste this identity below
And finally,
This will configure all the required inputs for KHIKA Data Aggregator and start the services. Now go to KHIKA Web GUI and check aggregator status
You should see a message indicating your aggregator is successfully connected with KHIKA SaaS
If you do not see this message, click here to go to “trouble shooting connectivity of KHIKA Data Aggregator section”
If everything has worked so far, now you can :
The next section describes how to access the KHIKA GUI