Skip to main content

NineData Usage Guide: AWS Marketplace Edition

Thank you for subscribing to NineData via AWS Marketplace. This AMI allows you to deploy NineData directly to an EC2 instance. Please follow the steps below to get started.

Step 1: Launch the Instance​

From the AWS Marketplace, subscribe to the NineData AMI and launch an EC2 instance using your preferred configuration:

  • Choose a region, instance type (recommended: t3.medium or above), VPC, and subnet.
  • Proceed to launch the instance.

We recommend deploying NineData in a private subnet, accessed through a bastion host or VPN, as it is designed for internal network use.

Step 2. Connect to the Instance​

Use SSH to connect to your EC2 instance.

ssh -i <your-key.pem> ec2-user@<EC2_Public_IP>

If your instance is in a private subnet, connect through a bastion host or VPN.

Step 3: Update Service Access IP​

After unpacking the pre-deployed services, you need to update the service access addresses based on your current host IP.

  1. Retrieve the local IP address. The first IP in the output is your local machine’s IP.

    hostname -I

  2. Edit the local hosts file. Run the following command:

    sudo vi /etc/hosts

    Locate the lines containing ninedata.registry.domain and ninedata.meta.domain, and replace their IP addresses with your local machine's IP.

  3. Edit the CoreDNS configuration. Run the command:

    kubectl edit cm coredns-custom -n kube-system

    Under the data field, find the mapping for ninedata.meta.domain and update the IP address to your local IP.

  4. Restart the CoreDNS service to apply the changes:

    kubectl rollout restart deploy coredns -n kube-system

  5. Restart the Console service:

    kubectl rollout restart deploy jzcloud-console -n jzcloud-console

Step 4. Access the Web Application​

NineData runs on port 30081 by default.

Once your EC2 instance is deployed and accessible from your private network:

  1. Open your browser and go to http://<EC2_Private_IP>:30081/

  2. Initial Credentials:

    • Username: admin

    • Password: Local IP

      tip

      How to get your local IP address:

      Use the command hostname -I in your terminal.

      The first IP in the output corresponds to your local machine.

Notes​

  • NineData is optimized for private network deployments. For public access, additional security configurations such as Nginx reverse proxy + firewall rules are required. This setup is not provided out-of-the-box.
  • Make sure port 30081 is open in the security group, or accessible via a bastion/VPN.
  • SSH access is available for advanced configuration or troubleshooting.