First-Time Setup

Install Licentra Bundle

This guide walks you through installing the Licentra SuiteApp bundle in your NetSuite environment. The bundle contains all necessary components for Licentra integration.

See More: Licentra Wiki – Modules

---

What You'll Install

The Licentra SuiteApp bundle includes:

• Custom Records - For storing configuration and license data
• Scripts - For API communication and license validation
• Pages - License Viewer and management interfaces
• Permissions - Role-based access controls

---

Before You Begin

Ensure you have completed the Prerequisites checklist:

• ✅ NetSuite Administrator permissions
• ✅ Access to SuiteBundler
• ✅ Scheduled installation window (if needed)

---

Installation Steps

Step 1: Access SuiteBundler

1. Log into your NetSuite account
2. Navigate to: Customization > SuiteBundler > Search and Install Bundles
3. Wait for the page to load completely

Step 2: Search for Licentra Bundle

1. Locate the search bar on the "Search & Install Bundles" page
2. Enter search term: Licentra
3. Look for the bundle with these details:
   • Bundle Name: Licentra
   • Bundle ID: 571165
   • Publisher: BringIT (Products) Production
   • Status: Available for installation

Step 3: Review Bundle Details

1. Click on the Licentra bundle link
2. Review the bundle information:
   • Bundle description and features
   • Version information
   • Dependencies (if any)
   • Installation requirements

Step 4: Initiate Installation

1. Click the "Install" button
2. Review the installation confirmation dialog
3. Click "OK" to proceed with installation

Step 5: Monitor Installation Progress

1. Stay on the installation page or check your email
2. Look for installation status updates
3. Wait for completion confirmation

---

Installation Verification

Check Installation Status

After installation completes:

1. Go to: Customization > SuiteBundler > Search and Install Bundles
2. Search for "Licentra" again
3. Verify status shows: "Installed" or "Active"

Verify Bundle Components

Check that the following are now available:

• Setup > Company > Licentra Config - Configuration records
• Setup > Company > Licentra License Viewer - License management page
• Setup > Company > API Secrets - API secret management (if not already available)

---

Post-Installation Setup

Once the bundle is installed:

1. Configure Licentra Settings - Set up the connection
2. Create API Secret - Store your license credentials
3. Validate Configuration - Test the integration

---

Troubleshooting Installation Issues

Bundle Not Found

Possible Causes:

• Incorrect search terms
• Bundle not available for your NetSuite version
• Network connectivity issues

Solutions:

• Try searching for "BringIT" or "571165"
• Contact your Licentra administrator
• Check with NetSuite support

Installation Fails

Possible Causes:

• Insufficient permissions
• NetSuite version incompatibility
• System maintenance in progress

Solutions:

• Verify Administrator role permissions
• Check NetSuite version compatibility
• Try installation during off-peak hours

Installation Stuck

Possible Causes:

• Large bundle size
• Network connectivity issues
• System resources

Solutions:

• Wait 15-20 minutes for completion
• Check email for status updates
• Contact NetSuite support if stuck for more than 30 minutes

---

Getting Help

If you encounter issues during installation:

1. Check the troubleshooting guides for common solutions
2. Review NetSuite system status for any ongoing issues
3. Contact your Licentra administrator for bundle-specific issues
4. Reach out to NetSuite support for platform-related problems

---

Next Steps

After successful bundle installation:

1. Configure Licentra Settings - Set up the connection between NetSuite and Licentra
2. Test the Integration - Verify everything is working correctly
3. Review Configuration Reference - Understand all available settings

---