Skip to main content

​
Actian VectorAI DB – AWS Marketplace Usage Instructions

​
Release notes

This version of Actian VectorAI DB is its initial release on AWS Marketplace. Version updates will be posted here.

​
Usage instructions

​
1. Launch the product

  1. Subscribe to Actian VectorAI DB on AWS Marketplace and accept the listing’s contract subscription. See AWS Marketplace subscription overview if you’re new to AWS Marketplace.
  2. Launch an EC2 instance from the listing (1-Click or standard EC2 launch), selecting an instance type sized for your expected vector volume. The gRPC API becomes available at port 6574.
  3. Attach an IAM role granting AWS License Manager access to the instance — see Required IAM permissions below. Attaching a role is required for anything above the Free tier. For list of tiers, see Licensing tiers.
  4. Wait for the instance to reach the running state and pass both EC2 status checks before proceeding. See Verify the instance is healthy below.

​
2. Required IAM permissions

VectorAI DB checks out your subscription’s entitlement from AWS License Manager automatically at startup. For this to succeed, the EC2 instance must run under an IAM role (instance profile) that allows, at minimum, the following AWS License Manager actions:
  • CheckoutLicense
  • ExtendLicenseConsumption
  • CheckInLicense
  • ListReceivedLicenses
  • GetLicenseUsage
Example IAM policy to attach to the instance role:
"Resource": "*" is required. License Manager consumption actions do not support resource-level restrictions. Attach this policy to a role, then attach that role as the IAM instance profile. Do this either at launch under Advanced details > IAM instance profile or afterward under Actions > Security > Modify IAM role in the EC2 console. If you modify the IAM role, then you must restart the instance for the IAM to take effect. Without this role, the instance cannot use a Starter or Growth entitlement and will run only at the Free tier limit.

​
3. Licensing tiers

Your AWS Marketplace subscription tier determines your vector capacity: No manual license key or activation step is required. Once the IAM role above is attached, VectorAI DB automatically uses the entitlement for your subscription. For general product concepts such as collections, vectors, search, see the core concepts overview and quickstart page in the VectorAI DB documentation.

​
4. Check your current allotment

Query the instance directly:
This returns your current vector-count ceiling and usage.

​
5. Verify the instance is healthy

  1. Open the Amazon EC2 console, select your instance, and check the Status checks tab. Both system and instance status checks should show passed.
  2. Confirm that the REST API is responding:
    A successful response, even an empty list, confirms that the service is running.
  3. Confirm that the reported vector count ceiling (step 4 above) matches your subscribed tier. If it shows the Free-tier limit instead, verify that the IAM role from step 2 is attached correctly.

​
6. Start using VectorAI DB

Once you have confirmed a healthy instance, create a collection and run your first search using the REST API or one of the following SDKs and agent frameworks:

​
Support