NexStorage Quick Start Guide

This guide will help you quickly get up and running with NexStorage. In just a few minutes, you'll create your first bucket, upload files, and access your data using the S3-compatible API.

1. Creating Your NexStorage Account

Before you begin using NexStorage, you'll need to create an account:

1. Contact your NEXVECTA representative or sign up on our website
2. Complete the registration process and verify your email address
3. Log in to your new NexStorage account at https://console.nexstorage.nexvecta.com

2. Generating Access Keys

To interact with NexStorage programmatically, you'll need to create access keys:

1. In the NexStorage Console, navigate to the Security section
2. Click on Access Keys in the sidebar
3. Click the Create Access Key button
4. Enter a descriptive name for the key (e.g., "Development", "Production", etc.)
5. Select the appropriate permissions for the key
6. Click Create
7. Important: Copy both the Access Key ID and Secret Access Key to a secure location. The Secret Access Key will only be shown once.

Access Key ID: NEXSTORAGE1EXAMPLE2KEY3ID
Secret Access Key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

caution

Treat your Secret Access Key like a password. Never share it or store it in version control. If compromised, immediately rotate your keys.

3. Creating Your First Bucket

Buckets are the basic containers that hold your data in NexStorage:

Using the NexStorage Console

1. In the NexStorage Console, navigate to the Buckets section
2. Click Create Bucket
3. Enter a globally unique bucket name (e.g., my-company-data)
4. Select the appropriate region for your bucket
5. Choose default encryption settings (AES-256 is recommended)
6. Set the access level (Private is recommended)
7. Click Create Bucket

Using the AWS CLI

If you prefer using the command line, you can use the AWS CLI:

1. Install the AWS CLI if you haven't already:

   # For macOS
   brew install awscli
   
   # For Ubuntu/Debian
   apt-get install awscli
   
   # For Windows (using PowerShell)
   choco install awscli

2. Configure the AWS CLI with your NexStorage credentials:

   aws configure --profile nexstorage

   Enter your Access Key ID and Secret Access Key when prompted. For region, enter your preferred NexStorage region (e.g., us-east-1). For output format, you can use json.

3. Create a bucket using the AWS CLI:

   aws s3api create-bucket \
     --bucket my-company-data \
     --profile nexstorage \
     --endpoint-url https://s3.nexstorage.nexvecta.com

4. Uploading and Downloading Files

Uploading Files

Using the NexStorage Console

1. Navigate to your bucket in the NexStorage Console
2. Click the Upload button
3. Select files from your computer or drag and drop them onto the upload area
4. Click Upload to begin the upload process

Using the AWS CLI

# Upload a single file
aws s3 cp example.txt \
  s3://my-company-data/ \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

# Upload a folder recursively
aws s3 cp my-local-folder/ \
  s3://my-company-data/my-folder/ \
  --recursive \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

Downloading Files

Using the NexStorage Console

1. Navigate to your bucket in the NexStorage Console
2. Select the file you want to download
3. Click the Download button

Using the AWS CLI

# Download a single file
aws s3 cp \
  s3://my-company-data/example.txt \
  ./example.txt \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

# Download a folder recursively
aws s3 cp \
  s3://my-company-data/my-folder/ \
  ./my-local-folder/ \
  --recursive \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

5. Testing with Simple CLI Commands

Here are some useful AWS CLI commands for working with NexStorage:

List All Buckets

aws s3 ls \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

List Objects in a Bucket

aws s3 ls s3://my-company-data/ \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

Get Object Information

aws s3api head-object \
  --bucket my-company-data \
  --key example.txt \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

Delete an Object

aws s3 rm s3://my-company-data/example.txt \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

Sync Local Directory with Bucket

aws s3 sync ./my-local-folder/ \
  s3://my-company-data/my-folder/ \
  --profile nexstorage \
  --endpoint-url https://s3.nexstorage.nexvecta.com

Next Steps

Now that you've created your first bucket and learned the basics of using NexStorage, you may want to explore these advanced topics:

• Security Best Practices - Learn how to secure your data
• Integration Guides - Connect NexStorage to your applications
• Monitoring and Analytics - Set up monitoring for your storage

Troubleshooting

If you encounter any issues, check these common solutions:

Issue	Solution
"Access Denied" errors	Check your access key permissions and bucket policies
Connection timeouts	Verify your network connectivity and endpoint URL
Slow uploads	Try using multipart uploads for large files
Region errors	Ensure you're specifying the correct region for your bucket

Still need help? Contact our support team at support@nexvecta.com or check our FAQ for more information.