Appearance
Get started
CloudSmart works on the AWS accounts you connect. A tenant admin adds each account in Accounts & Setup with a four-step wizard: Details, Deploy, Connect, Data feeds. Members can use connected accounts but cannot add or remove them.
If you close the wizard part way, choose Resume setup in the accounts list.
1. Details
In Accounts & Setup, choose + Add AWS account and enter:
- Account name: how the account shows in the account switcher.
- AWS account ID: the 12-digit account you sell from on AWS Marketplace.
2. Deploy
CloudSmart never asks for AWS keys. You deploy a CloudFormation stack that creates a role CloudSmart uses, plus the storage that receives your AWS Marketplace data feeds.
- Choose a deployment mode:
- Feenix + CloudSmart (recommended): one stack for both.
- CloudSmart only (standalone): CloudSmart only.
- Choose Open AWS Console. The CloudFormation console opens in us-east-1 with the values filled in.
- Leave Timestamp as it is.
- Feenix mode only: paste the ExternalID from your Feenix portal. See Where do I find the Feenix External ID?
- Create the stack, then choose I've launched it, continue.
3. Connect
CloudSmart checks for your stack and connects when it is ready. You can also choose Verify now once the stack shows CREATE_COMPLETE.
The result shows whether the role answered and which features the account enables. Missing permissions are listed. Features turn on as their permissions are found. If some are missing, update the stack (see Keeping accounts current).
The first data run starts as soon as the account is verified, so the dashboard appears soon after.
4. Data feeds
Tell AWS Marketplace where to deliver your data feeds. The wizard shows the values with copy buttons:
- Amazon S3 bucket ARN and SNS topic ARN.
- KMS key ARN: copy
DFKMSKeyArnfrom the stack's Outputs tab. CloudSmart keeps it for next time.
Choose Open customer data storage. In the AWS Marketplace Management Portal, paste the three values and choose Submit.
If the wizard has no ARNs, read DFS3BucketArn, DFSnsTopicArn and DFKMSKeyArn from the stack's Outputs tab in us-east-1.
Optional: verify a sender in Amazon SES to send emails. See Email sending.
5. Preceptor (optional)
Preceptor is the cost dashboard. It reads billing data from your payer (management) account and covers the whole workspace. Set it up in Accounts & Setup → Preceptor. See Installing Preceptor.
Default account
Each account stands on its own. The default account only sets where you land after sign-in. Switch accounts at any time in the account switcher.
Keeping accounts current
The accounts list shows a badge on an account that needs attention. Its button opens a Stack maintenance & migration checklist. Everything keeps working while you follow it.
Update available
For Update available or Update recommended, choose Update stack. In CloudFormation, select your stack (cloudsmart-feenix, or cloudsmart-datafeeds in CloudSmart-only mode) and choose Update, Replace current template, Amazon S3 URL. Paste the URL from the dialog and keep every parameter, including Timestamp. After UPDATE_COMPLETE, choose Re-verify.
Consolidate access
The account still connects through older per-feature roles. Deploy the unified stack once from the dialog, then choose Re-verify after CREATE_COMPLETE.
Migration needed
Choose Migrate onboarding. The account still uses the old Customer Onboarding stack. Follow these steps in order:
- Deploy the new stack.
- Wait for Verified.
- In the AWS Marketplace portal, register data storage again with the new ARNs from the account's Data feeds action.
- Check that your dashboard still receives data after the next delivery.
- Only then delete the old stack (its Resources tab lists
CrossSyncLambda). Deleting it earlier stops your data feeds.
Older stacks
Once the account uses the CloudSmartAccess role, you can delete the older per-feature stacks (from POTemplate.yaml, CRMTemplate.yaml and WATemplate.yaml). Role names on those stacks start with TenantPrivateOffers, TenantCRMConnect and TenantCustomLens. Keep the stack that created the CustomerSaas role if you use the Storefront.
Removing an account
Removing an account only removes it from CloudSmart. Nothing in your AWS account is changed.
Guided tour
The first time you sign in, a short tour walks you through the app. Choose Next and Back to move, or Skip tour to stop. Most steps link to the matching guide.
Open the menu under your initials at any time:
- Show me around tours the page you are on.
- Restart tour plays the whole tour again.
Both are also in search (Ctrl K, or ⌘K on a Mac).
Next
Setup errors are covered in the FAQ.