SAPIEN Frequently Asked Questions

Questions we get asked... a lot. Click a specific question to view the answer.

Software Products

What are the prerequisites for different engine types?

When building executables in PrimalScript or PowerShell Studio there are various engine types to choose from, each of them with a prerequisite that must be installed on the machine that will be running your program. For example, if you build an executable in PowerShell Studio and select the SAPIEN PowerShell V2 Host (Command Line) Win32 engine then the .NET Framework 2.0 is required on the target machine.

Here is a table that shows the prerequisites for each engine type:

Engine

Prerequisite

SAPIEN PowerShell V2 Host (Command Line) Win32 .NET Framework 2.0
SAPIEN PowerShell V2 Host (Command Line) x64 .NET Framework 2.0
SAPIEN PowerShell V2 Host (Windows Forms) Win32 .NET Framework 2.0
SAPIEN PowerShell V2 Host (Windows Forms) x64 .NET Framework 2.0
SAPIEN PowerShell V2 Host (Windows) Win32 .NET Framework 2.0
SAPIEN PowerShell V2 Host (Windows) x64 .NET Framework 2.0
SAPIEN PowerShell V3 Host (Command Line) Win32 .NET 4.0 Client Profile
SAPIEN PowerShell V3 Host (Command Line) x64 .NET 4.0 Client Profile
SAPIEN PowerShell V3 Host (Windows Forms) Win32 .NET 4.0 Client Profile
SAPIEN PowerShell V3 Host (Windows Forms) x64 .NET 4.0 Client Profile
SAPIEN PowerShell V3 Host (Windows) Win32 .NET 4.0 Client Profile
SAPIEN PowerShell V3 Host (Windows) x64 .NET 4.0 Client Profile
SAPIEN PowerShell V5 Host (Command Line) Win32 .NET Framework 4.5
SAPIEN PowerShell V5 Host (Command Line) x64 .NET Framework 4.5
SAPIEN PowerShell V5 Host (Windows Forms) Win32 .NET Framework 4.5
SAPIEN PowerShell V5 Host (Windows Forms) x64 .NET Framework 4.5
SAPIEN PowerShell V5 Host (Windows) Win32 .NET Framework 4.5
SAPIEN PowerShell V5 Host (Windows) x64 .NET Framework 4.5
CMD Win32 Visual Studio 2012 Runtime
CMD x64 Visual Studio 2012 Runtime
CScript (Windows Script Host) Win32 Visual Studio 2012 Runtime
CScript (Windows Script Host) x64 Visual Studio 2012 Runtime
Microsoft Windows PowerShell (Command Line) Win32 Visual Studio 2012 Runtime
Microsoft Windows PowerShell (Command Line) x64 Visual Studio 2012 Runtime
MSHTA Win32 Visual Studio 2012 Runtime
MSHTA x64 Visual Studio 2012 Runtime
SAPIEN Script Host (Command Line) Win32 Visual Studio 2012 Runtime
SAPIEN Script Host (Command Line) x64 Visual Studio 2012 Runtime
SAPIEN Script Host (Windows) Win32 Visual Studio 2012 Runtime
SAPIEN Script Host (Windows) x64 Visual Studio 2012 Runtime
WScript (Windows Script Host) Win32 Visual Studio 2012 Runtime
WScript (Windows Script Host) x64 Visual Studio 2012 Runtime

 

What is the difference between PowerShell Studio and PrimalScript?

PowerShell Studio is a PowerShell Integrated Scripting and Toolmaking Environment. It is a full-featured PowerShell editor that allows you to visually create PowerShell GUI tools.  It's an essential part of your toolbox if you do a lot of PowerShell scripting. It is not designed to support any language other than PowerShell. For more information, visit our PowerShell Studio page.

PrimalScript is a universal scripting IDE that supports over 50 languages and file types. It is an essential part of your toolbox if you need to work with multiple technologies, languages and file formats at the same time. It does not support visual GUI creation. For more information, visit our PrimalScript page.

Watch this video by Jason Helmick, Which is Right for You? SAPIEN's PrimalScript or PowerShell Studio, to help determine which is the right application for you.

What languages are supported by PrimalScript?

ActionScript Flash JSAPI Rebol
Adobe Rex HTA Registry Files
ASP Pages HTML Resource Script
ASP.Net Pages IDM Rexx
AutoIt INI Files Ruby
AutoIt3 InstallScript SQL
AWK Java System Policy Editor
Bash Java Server pages Tcl
Batch Files JavaScript VBScript
C Kixtart Visual Basic.Net
C# LotusScript WinBatch
C++ Lua Windows PowerShell
CFML Pascal Windows Script Component
CH Perl Windows Script Host
CMD Files PHP XML
CSS PowerShell ASP Pages  
Flash Communication Server-Side ActionScript Python  

Licenses, Subscriptions and License Keys

Are your licenses per user or per server?

As per our EULA, all of our licenses are single-user licenses.

Can I use my licensed copy on multiple computers?

Each purchased license is allotted a maximum of two devices to be activated and operating at any given time for ones' personal use.  In order to switch and activate on a third device, one of the two activated devices must first be properly deactivated. See the "How do I deactivate a license?" FAQ for instructions on how to do so.

For more detailed information on your license, please read our EULA.

For more detailed information on activation and deactivation, please read our Quick Guide to SAPIEN Software Activation.

 

How do I register my license?

Has the software already been downloaded to your device?

Open the product and fill in the three boxes with the SAPIEN ID and password of the SAPIEN account you would like the license to be registered to. (If you have not created a SAPIEN account on www.sapien.com, you will need to do so first.) Click "Activate". This will not only activate the license on the device, it will also automatically register it to the SAPIEN account provided on the activation screen.


Is the software not yet downloaded to your device?

Please login to your SAPIEN Account and go to the My Account -> Registered Products page. (If you have not created an account on www.sapien.com, you will need to do so first.) On the left of the Registered Products Page, click the "Register a License" link.

Enter your License Number into the box provided, and click "Register". For multiple licenses, separate each with a comma.

If the product was successfully registered, the page will refresh, and the associated product will appear on the page with the download links, registered date, and expiration date.

How do I transfer a license?

First, you will need to properly decommission the current devices operating the license (see the How do I deactivate a license? FAQ).  Once you have accomplished this, log in to your SAPIEN Account and go to My Account -> Registered Products.  Find the subscription number that will be transferred, and click on the "Transfer License" button:

Carefully read over the terms of Transferring a Software License.  Once you have read the terms, click "I Agree" and enter a short comment as to why the license is being transferred.

Once this has been completed, you have the choice to remove the license or transfer the license automatically

If you remove the license, you will need to forward the license number on to the new end user. They will then need to complete the Registration (see the How do I register my subscription / license? FAQ) process to begin accessing the product.

 

If you choose to transfer the license automatically, you will need to enter the new user's SAPIEN account username. They will need to create an account first, if they do not already have one(www.sapien.com/auth).

Is there any way I can get an offline license?

Login to your SAPIEN Account and go to My Account -> Registered Products. In the menu on the left of the page, you will find a link that says "Request Offline Activation".

Request offline activation

Fill out the requested information. SAPIEN Sales will review the submitted information and you may be granted the ability to generate an offline activation file. Please take note that generally this option is reserved for long time customers, larger corporations and government agencies with a proven license management infrastructure in place. Only licenses under active maintenance are eligible for offline activations. If we determine that offline license files are used to install our software on more than the allowed two machines per license, your license may be revoked.

License, subscription, license key? What do they all mean?

When you purchase one of our products, you are purchasing a license allowing you to use the product. In order to activate/unlock the product, you will receive either a 16-digit license number. Please note, we are currently changing over our vergiage. Therefore, you may see "Subscription Number" places. This is being updated to License Number.

LICENSE NUMBER:
Beginning with the release of our 2014 versions, products are delivered with a license number. This license number comes with a free one-year maintenance subscription with the license purchase. After that, you can extend your maintenance subscription each year or not. Even if you don't renew, your software will continue to work. A license number will always be a 16-digit number beginning with the number 9. To activate/unlock your product, you will enter this 16-digit number in the box marked 'License no.' in the activation screen that appears when you first launch the software. License numbers require an internet connection for activation. (If your machine does not have an internet connection, see the FAQ "Is there any way I can get an offline key?" above.) For more information on our maintenance subscription model, please read our blog Starting with the 2014 versions all SAPIEN software sold with Subscription.

LICENSE KEY:
Product versions prior to 2014 were delivered with a license key. A license key will always be a 47-character string, beginning with the version year followed by the product code. (For example, a license to PowerShell Studio 2012 would begin with 12-SPS.) To activate/unlock your product, you will enter this 47-character string in the box marked 'License no.' in the activation screen that appears when you first launch the software. License keys do not require an internet connection for activation.”

Why doesn't the trial key I generated work?

Nine times out of ten, the answer to this question is "You don't need a trial key." Trial keys for our products are needed for virtual machines only. All other machines will run the trial with no key at all.  If you ARE on a virtual machine and your trial key doesn't work, please post in our Trial Software Questions forum.

Activations & Deactivations

How do I deactivate a license?

In every products' home screen resides a Gold Button resembling a certificate, in the upper right-hand corner. This is where all of your license information can be accessed.

Proceed to the home screen of the product you will be removing the license from. Click on the gold certificate button.

A familiar screen will appear (the same screen that appears for the initial activation); click "Deactivate License".

 

You can also reset an activation directly from the Registered Products page of the registered SAPIEN Account, by clicking on “Activations” if you are under active maintenance.  

Please note that uninstalling the product DOES NOT remove the license from the device. Proper decommission of the license must be followed in order to free up activations. Also, removing the license from your Account Page does not remove any license data from your computer.

 

What if I need more than 2 activations?

In certain circumstances, our users may require more than two activations. For those users, we offer the Lab Pack. With this Lab Pack, you are able to install the software on up to 18 ADDITIONAL devices (20 total), for your personal use.  You may still only have two devices per license running at any given time, but it will offer more flexibility for those users who can't deactivate their devices right away due to frequent maintenance/rebuilds.  Also with this lab pack, activations are reset at a more rapid pace, so if you do happen to have to rebuild devices or you have a device crash (without being able to properly decommission your device beforehand), activations will reset more frequently (every 30 days, rather than the normal 180 days).

This Lab Pack operates in the same way as a Subscription; it will need to be renewed yearly, to continue receiving the additional 18 activations.  Take note that if you decide that you no longer wish to utilize the Lab Pack, there are no repercussions.  Just do not renew it when your year is up, and we will remove it from your account.  Also, if you choose not to renew your Subscription Maintenance, you still have the option of renewing your Lab Pack.  We will not take that away from you.  The first initial purchase of the Lab Pack will run through the remainder of your current Subscription life. For more information or to purchase a Lab Pack, please contact us at sales@sapien.com.

Why do I get a 'certificate authority is invalid or incorrect' error when I try to activate my software. How do I activate my software?

Some systems require a root certificate to be installed before accessing SSL protected scripts via the internet. If these systems do not have the proper root certificate installed, users will receive an error when trying to activate our software.

The certificate authority is invalid or incorrect

Our SSL certificate is issued Amazon's ACM. For information on installing a root certificate on your machine, please refer to this article, How to Prepare for AWS’s Move to Its Own Certificate Authority.

You may also need to add https://www.sapien.com to the trusted sites in Internet Explorer / Edge. (See https://www.computerhope.com/issues/ch001952.htm.)

Why do I get a 'The underlying connection was closed...' error when I try to activate my software. How do I activate my software?

This is usually indicative of a SSL/TLS trust issue. You will need to install a root certificate on your system.

Our SSL certificate is issued Amazon's ACM. For information on installing a root certificate on your machine, please refer to this article, How to Prepare for AWS’s Move to Its Own Certificate Authority.

You may also need to add https://www.sapien.com to the trusted sites in Internet Explorer. (See https://www.computerhope.com/issues/ch001952.htm.)

Why do I get a 'Your subscription information could not be verified' followed by 'This build is not covered by your subscription' after updating my software?

This series of messages occurs when you have inadvertently updated to a version of our software that is not covered by your expired maintenance subscription. When you have updated to a build you cannot activate, you will see this message:

 

If you attempt to unlock it after receiving the first message, you will be presented with the following:

 

You will need to uninstall the version you have on your machine and download and install the latest build covered by your license.  To gain access to the latest build to which you are entitled, navigate to your Registered Products page (https://www.sapien.com/account/products.)

If you have a license number for a single product, you will see the download links for the software to the right of the version (or build) number.

 

If you have a license to the SAPIEN DevOps Suite, you will see the download links to the right of the version (or build) number.

 

Click on the download link appropriate for your system and reinstall the software.

Why do I get the message 'This subscription is not for this product' when I try to activate my software?

If you are trying to activate PowerShell Studio or PrimalSQL and keep getting this message:

This subscription is not for this product

Please check your username and password for forward-slashes /, asterisks *, open and close parentheses (), open and close square brackets [] or apostrophes ' at your account info page. These characters are not encoded correctly by the language used to create these products and thus break the activation process. While we are working on a fix for this, please remove any of the offending characters from your username and / or password.

If you are not using any of those characters ( /, *, (, ), `, ` or ' ) and still receive this error, please contact us at sales@sapien.com.

General Questions

How do I get support?

For general help with your account, trial software, feedback and to submit your wish list, please go to our Customer Service Forums at https://www.sapien.com/forums/viewforum.php?f=4

If you have a product question and you have a registered license with an active maintenance subscription, please post in our Product Support Forums for Registered Customers at https://www.sapien.com/forums/viewforum.php?f=5

If you have a general scripting question and need help from your fellow scripters, visit our ScriptingAnswers forum at https://www.sapien.com/forums/viewforum.php?f=6

Do you have a Feature request? You can place that in Feature Requests.

Can’t remember any of these weird forum links? Go to www.sapien.com and click on "Support", it’s all there.

What if you have information or a request you don’t want the public to see? Email to support@sapien.com

Problems with the web site or with using any of the forums above? Send an email to websupport@sapien.com

What if it is extremely urgent? If you have premium support, we have a ticket system that will get you faster responses: http://www.sapien.com/support/premiumsupport (If you do not have premium support associated with your account then this won't work, unless you add it to your subscription by clicking here.)

How do I subscribe / unsubscribe from a specific forum and / or forum topic?

To subscribe to a specific forum, click the "Subscribe forum" link near the bottom of the page upon entering the forum.

To unsubscribe, click the "Unsubscribe forum" link near the bottom of the page upon entering the forum.

To subscribe to a topic, reply to the topic with the "Notify me when a reply is posted" checkbox checked.

Alternately, you can subscribe to a topic by clicking the Topic Tools icon next to the Post Reply button,

then clicking the "Subscribe topic" link in the drop-down menu.

To unsubscribe, click the Topic Tools icon, and select "Unsubscribe topic" from the drop-down menu.

How do I subscribe to SAPIEN's mailing lists?

You can go directly to our MailChimp Signup form by clicking here.

Or, log in to your SAPIEN Account and go to My Account -> Registered Products. In the menu on the left, click "SAPIEN Mailing Lists".

Subscribe to SAPIEN Mailing Lists

Then click on the "join our mailing list" in the resulting screen and follow the instructions for sign up.

In either case, you will receive an email with a link to confirm your subscription. You will not be subscribed to any list until you click the confirmation link in the email.

How do I unsubscribe from or update my mailing list subscription?

You can change preferences or unsubscribe using the "update subscription preferences" or "unsubscribe from all lists" links at the bottom of any email you receive via your mailing list subscription.

Use this link Unsubscribe from all lists to unsubscribe now.

Unsubscribing from our mailing list will NOT prevent you from receiving maintenance subscription expiration reminders.

 

Classes, Training and Special Groups

Do you offer any On-Site Training?

Yes, we do!  You supply the classroom space and computers, and we will supply the trainer.  We find that the ideal class is no larger than 20 students. Our instructor is continually engaged with students, so while it is best if all students are in the classroom, we can also accommodate remote students. The training fee includes a copy of the textbook used to teach the class and complimentary trial versions of SAPIEN development tools.  Contact us for availability and costs (sales@sapien.com).

Please visit https://www.sapien.com/books_training/On-Site-Training for more information regarding the On-Site-Training Course.

Do you provide a discount for Microsoft MVPs?

No, we do not.

SAPIEN Store

How long does it take to receive an order?

All of our orders are fulfilled electronically.  If you purchase directly from our On-Line Store, a packing slip will be sent to you almost immediately.  If you do not receive the e-mail, please make sure to check your SPAM folder.  If you submit a purchase order, please allow up to 24 business hours for fulfillment.  Please take note that weekends are not included.  If a purchase order is submitted Friday, it may not get fulfilled until Monday.  We do try our best to prevent this from occurring, but it is a possibility.