FAQ

Below are some commonly asked questions by ActiveState users. If you have questions please check the online community forums. They are regularly maintained by ActiveState staff and are contributed to by other members of the ActiveState community. For questions related to your account, reach out to contact us.

Working with ActiveState

Working with runtimes

The State Tool


Working with ActiveState

Will my project use my proprietary code?

Your ActiveState project will not use any first-party or proprietary code produced by you or anyone else with whom you have shared the project. All user-generated code does not become part of the shared properties of your project, nor does it belong to ActiveState.

How do I share my project?

Details on how to share your project can be found here.

Why would I share my project?

The benefits of sharing your ActiveState project include

  • Saving fellow developers time and effort setting up a stable development environment.
  • Accelerate employee onboarding by immediately making the correct, specific dependencies needed for the project available.
  • Educators can standardize student environments and restrict unneeded artifacts to simplify the learning experience.
  • Organizations can better control which tools developers are using and account for what is being used in the event of patches, updates, or security risks.

Can I pass my invitation to collaborate on a project to someone else in my organization?

No, the invite email is specific to your email address and your organization. If you would like to provide access to other people in your organization you can either sign up for the Platform yourself and invite them, or contact us with the email addresses of the users to invite, and we will send them individual invites (this is only available for paid tiers).

How long should it take for my project to build?

The time needed to build your project can vary depending on

  • package size- certain packages are larger than others and will require more time to build.
  • package build complexity- some packages just need their code wrapped up in a compressed file. While others need to pull in and compile numerous C libraries, and other potential build steps. An example of a complex package would be Tensorflow in the Python ecosystem.
  • The number of packages included- fewer packages can result in a shortened build time.
  • The number of dependencies needed for each package.

A small build with fewer packages and dependencies may only take seconds or minutes to build successfully. Larger, more complex projects can take several minutes or even hours to build successfully.

What should I do if my build is taking longer than expected?

In cases where a build process appears stuck, try resetting the build by making a minor change to your configuration. For example, changing the version of an existing package, adding a new package, changing the version of the language, etc.

What is a CVE?

A Common Vulnerability and Exposures (CVE) identification is the unique identifier that is given to a specific vulnerability by the National Institute of Standards and Technology (NIST) National Vulnerability Database (NVD). Each CVE has been reviewed by a governing body (the CVE Numbering Authority) and found to present a credible threat to the security of a system. Check here to find out more about CVEs and how the ActiveState Platform and the State Tool deal with them.

What is an organization?

Organizations are the way you group ActiveState Platform projects for a company, department, or team. Members of the organization will have access to each project in the organization, with the ability to invite others to join, remove users, and create or modify runtimes (depending on the role of the user).

You can create paid organizations that support both private and public projects, or free organizations that only support public projects.

What happened to Komodo IDE and Komodo Edit?

Komodo IDE and Komodo Edit have been opensourced. Check out our blog article to find out more.

Where can I find a copy of the end-user license agreement?

All current license agreements can be found here, and agreements for older versions or legacy products can be found here.

Where can I find documentation for deprecated products and legacy language versions?

Information on deprecated products and languages can be found on the ActiveState documentation homepage. These docs are for archival use only and are not updated.

How can I delete my ActiveState Account?

Details on how to delete your account can be found here. Note that deleting your account will not automatically uninstall the State Tool from your machine.


The ActiveState runtime

What are the benefits of installing a runtime? Why should I do it?

Each runtime is created and executed in a virtual environment that will avoid conflicts between other projects, production environments, and the developer environments of other developers (if the runtime has been shared). Using the ActiveState Platform, each runtime can be easily updated to include the most current and secure versions of all dependencies/packages/binaries/etc.

Why don’t I get a download? What do I get instead?

Instead of offering a pre-packaged downloadable installer, the State Tool creates a virtual environment on your system allowing you to run concurrent and disparate development environments that contain all (and only) the packages you need for your projects, without conflicts or interfering with the preexisting language versions on your system.

Installers are available for Enterprise tier users. Click here to find out more

Where does my runtime go when I run state activate?

Each ActiveState project (and the associated runtime) is installed in its own virtual directory to prevent dependency conflicts. When you activate a runtime you’re setting up a virtual environment to work from. This keeps your dependencies separate from those outside of the virtual environment’s parameters. This is important because

  • It’s good for developers because their work won’t conflict with production.
  • It won’t conflict with work done by other developers.
  • it won’t conflict with your other work, as each runtime is contained in its own virtual environment.

After exiting your runtime, files are cached on your local system until deletion. This helps keep reloading time fast. Regularly using the state pull command will keep your project, and its virtual environment, up to date on your local installation.

How do I end my runtime session? How do I stop my runtime?

You can end your activated state by typing exit into the command prompt or terminal window. Closing the command prompt or terminal window will also deactivate your project.

How do I install a project to a specific location on my system?

You can find instructions for location-specific installations in the checkout documentation here.

Can I use my runtime in my IDE?

ActiveState currently has integrations with several popular IDE’s including Visual Studio Code, Pycharm, and Eclipse. More information about integrations can be found here.

Can I request a package (or package version) I need for my project?

For organizations with Service Level Agreements (SLA), use the contact information included in your SLA to request specific packages. When requesting a new package, include the name of your organization and project, as well as the package and, when possible, the package version.

Users without an SLA can post a request on the community forums. Feel free to include as much information as you feel comfortable disclosing, including your organization or project name, and package version. These requests will be processed according to their availability and user demand.

What do I do if my project has a build error?

Organizations with SLAs are encouraged to use the contact information provided in their agreement to receive assistance from ActiveState. Users without an active SLA can try to review and edit any CVEs that may be causing the build to fail, or ask for help on the community forums.

I made changes to my project on the Platform, but the changes do not show up in the State Tool?

After making changes to your project using the Platform, open the project using the State Tool by starting a shell or activating the project. Then run state pull. This will update your project with the changes made on the Platform.

Why can’t I install my runtime?

If you experience trouble installing your runtime, make sure that the OS version on your local machine meets the minimum standards.

  • Windows 10 or later
  • macOS 10.10 or later
  • Minimum standards for Linux will depend on the details of your project. Distros and versions can be selected when creating your project and changed from the Configuration tab on the project page.

How do I download the files or source code from my project?

Instructions on how to download the files from your project can be found here.

The recommended version of each language is based on Platform build success rates and the availability of new open source package versions. ActiveState continuously updates these recommended versions as more recent versions of the language ecosystem become stable and vetted by the open source community.


The State Tool

How to install the latest version of the State Tool?

Open your command prompt or terminal and type state update

How do I download a project to my machine?

To check out a project on your local machine enter state checkout <orgname>/<projectname> <path to folder> For example state checkout JohnSmith/Project1 C:\project

How do I download the bits from a project to a specific location on my machine?

To check out a project’s bits to your local machine enter state checkout <orgname>/<projectname> --runtime-path <path to folder> For example state checkout JohnSmith/Project1 --runtime-path C:\project

How do I show which projects are on my local machine?

To display all existing projects, their location on your system, and the location of their executable files enter state projects.

How do I update my project on my local machine?

Working from your project directory (the folder containing your activestate.yaml file) enter the command state pull.

How do I use the State Tool to check my project for vulnerabilities?

You can use the State Tool to check your current project for any potential vulnerabilities by activating the project and running state cve to view the vulnerabilities associated with that project.

For a more detailed explanation of the vulnerabilities associated with your project, enter state cve report. This will include an ID for each listed vulnerability so you can look them up to see how they may impact the security or performance of your project. To address the vulnerabilities found in your project see here.

How do I switch from one project to another?

  • While working from an activated project, enter state projects in your terminal to view a list of the projects that are installed locally on your machine.
  • After finding the project you want from the list, exit your currently activated project by typing exit into the command line. This will deactivate your project.
  • Type state activate <orgname/projectname> to activate the project you want to switch to.

How to stop state activate? How do I end my State Tool session?

You can end your activated state by typing exit into the command prompt or terminal window. Closing the command prompt or terminal window will also deactivate your project.

How do I compare projects using the State Tool?

Comparing different versions of the same project is a great way to make sure changes have been logged and to track the progress of your projects. To compare two separate projects:

  • Begin by activating your first project by typing state activate <organization1/project1> into your command prompt.
  • Run the script by entering state run <script1>.
  • When the script has completed, type exit to deactivate the project.
  • Activate the second project by entering state activate <organization1/project2> into the command prompt.
  • Run the project2 script by entering state run <script2> and wait for the script to stop.
  • Now, by scrolling down you can view a side-by-side comparison of the projects.

How do I uninstall the State Tool and all cached data?

There are two separate commands to uninstall your activated project, each with unique characteristics.

  • state clean cache will remove all copies of cached versions of everything and reset the State Tool cache. This command will not uninstall the State Tool. This needs to be done from the main project directory, although it may work from other directories with newer language versions.
  • state clean uninstall gets rid of cached files, uninstalls the State Tool, installed language runtimes, and all configured information. It’s important to note that after confirming your choice to run this command, you will need to restore everything from the Platform. To find out more see here.

What can I do if my State tool update is taking longer than usual (more than a few minutes)?

If you are updating from a much older version it may have problems with runaway services that may be preventing the update. The State Tool Troubleshooting section has instructions on identifying and shutting down runaway services for Windows, macOS, and Linux. After running the script to stop ongoing processes, enter state update to resume your update.

What does “The State Tool could not figure out what path to use” mean?

Generally, the “could not figure out what path to use” means that the State Tool can’t find a suitable folder for your runtime. Unsuitable folders include program folders, system folders, or folders where restrictive permissions have been set. Your personal folders are more likely to be writable and are a better choice for your project. Follow the steps here to check out a project to a specific location on your system.

What does “State Tool could not install dependencies and/or the build failed” mean?

If you receive this error, you can try resolving the error in the Platform. The Platform provides more feedback and can see if (and when) the rebuild succeeds. That will show when the State Tool can find a working build of the module to download from your project.

The Platform will also allow you to specify the package version and see immediately if there are any vulnerabilities associated with it. Check here for more information about adding packages using the Platform and here for information about vulnerabilities.

Why does The State Tool show an error when trying to download my Tcl project?

The State Tool cannot download Tcl projects, you must go to the Platform and download the .msi or .tar file directly from the project page to install your Tcl project on your local machine.

How can I install the State Tool on a server?

To install the State Tool on a server you will need to checkout the project to a specific location on the server. To do so enter state checkout <orgname>/<projectname> <location>. This will place a project folder containing your project’s activestate.yaml file into the specific location. To checkout all of the bits associated with your project enter state check out <orgname>/<projectname> --runtime-path <location>. More information on state checkout can be found here.

What does “could not activate runtime environment” or “failure encountered in active subshell” mean?

This error may indicate that your current working directory is incompatible with the State Tool (for example a System32 or similar directory), or you are trying to state activate as an Admin on your local system. After activating, your runtime will be installed into a personal (or user) AppData folder. Only users can access the runtime. Try exiting as an Admin, logging in as a user, and re-activating the runtime.

Why did I receive a “could not retrieve install package information” error?

This error may result from trying to install a package while being behind a proxy server. Click here for more details and potential solutions