Open topic with navigation
Before you can begin issuing and activating licenses, you must define and configure the products and product options in SOLO Server which will be used to issue your application's licenses. This topic is designed to guide you through adding your first product option, and assumes you have already defined your licensing requirements. Additionally, the SOLO Server manual can be viewed by clicking the menu Help / Manual or Help / Help for this Page in the very top right of the administrative web interface.
Before you distribute production copies of your application, it is imperative that you update your application with encryption key data from your activated SOLO Server account.
In SOLO Server, a product is defined to describe your application as a whole, and may contain one or many product options. For each type of license your application will support and require activation to use, at least one product option needs to be defined. In this guide, we will use an example product named "XYZ Product" with the following example licensing requirements:
This screen in the "Add Product Wizard" allows you to create a new Product, or add an Option to an existing Product.
When adding a new Product, you also have the option to copy all settings from an existing Product; however this does not copy the existing Product's Options, Upsells, or Updates.
Note that all steps after this one in the the "Add Product Wizard", a new panel will show at the top titled "Summary of current selections..." until you reach the end of the wizard (at which point this is all that is displayed). This panel provides a helpful summary of the selections you made as you progressed through the wizard, and is also very helpful in summarizing combinations of certain settings.
This panel allows you to create a new Option from a blank template, or create a new Option that has all settings copied from an Existing option. When you choose to copy all settings from an existing Option, this will not copy Extended Pricing, Priority Codes, Shipping, Upsells, and Rules. If you need to make a copy of an existing Option that also copies these additional settings, use the Duplicate Product Option page instead.
The selection you make in "Type of Product" field should describe the nature of the item that is being sold. Always select "Licensed Software/Application" if you are selling a license that may be activated with SOLO Server via a supported licensing client (configured on the next screen). You may still configure download and shipping settings after selecting "Licensed Software/Application."
You may be asked to select the licensing client you use.
Choose Protection PLUS 5 SDK as your licensing client.
This screen allows you to configure a file that may be downloaded via SOLO Server's ESD features, or a download page hosted on your company/product web site, which can be provided to the user from SOLO Server's Customer License Portal and invoices.
In this screen, you may configure basic settings for SOLO Server's e-commerce, such as the price and unit of measure.
Setting the price to zero allows anyone to use the shopping cart to process an order without entering a credit card, even if you are not using the e-commerce engine of SOLO Server. It is strongly recommended that you set the price to a value greater than zero unless you specifically want to allow this or have configured a shopping cart rule to verify eligibility for a free upgrade.
This screen allows you to configure miscellaneous settings, such as whether the new Product and Option are hidden and enabled.
This screen provides a final summary of your settings and selections, and allows you to save your new Product and Option.
When configuring your product options, Protection PLUS 5 SDK requires the Issue Installation ID option to be checked!
The product option configuration offers a plethora of configuration options not covered in this guide. Each of these options are documented in the SOLO Server manual, which you can see by clicking the Help link at the top of the page.
It is possible to simply create additional product options the same way the first was created. However, it is generally a good practice to copy existing product options to create your additional product options. This is especially true when using Protection PLUS 4 SDK compatible activation codes, and when using the SOLO Server shopping cart. Consequently, it is strongly recommend to follow the steps below to create your additional product options:
With everything configured as described in our example and steps above, the new Option will be added in your Product list/catalog as shown below.
When your application submits activation requests to SOLO Server, it can include the Product ID (397336 in the example screen shot above) in the request. By doing so, SOLO Server will ensure that the License ID the user entered for activation is for the appropriate Product ID specified in the request. Since each Product ID is generally unique for each of your applications, this validation prevents licenses issued for one product or application (i.e. "XYZ Product") from being used to activate an entirely different product or application. If no Product ID (or a zero) is sent to SOLO Server, then SOLO Server will not perform this validation for you, and you will need to make sure you evaluate the Product ID and Product Option ID in the activated license to ensure the license is for the appropriate application.
Furthermore, the Product Option ID may also be included in an activation request, just like the Product ID. Though this is typically not necessary or appropriate, it does allow you to create special builds of your application that will only activate with a certain Product Option ID. Using the "XYZ Product" example here, this kind of validation can be useful if the "Standard Edition" and "Express Edition" are released and distributed as entirely separate builds/installers. Otherwise, if both editions are made available in a single build/installer, then it is best to rely on Product ID validation alone.
SOLO Server's Payment Plans allow you to offer subscription licenses, maintenance and support subscriptions, payment over multiple installments, and more. Learn more about how to configure SOLO Server for Payment Plans.