What is the Globus preview environment?

Globus provides a Preview environment for previewing upcoming changes to Globus services. This allows developers and users to test their applications with the changes before the changes are released for mainstream use. Most of the time, the services in the Preview environment are the same as the normal system. When significant changes are being readied for release, we deploy them in the Preview environment for testing and announce it on the developer-discuss email list.

The Preview environment is isolated and completely separate from the main Globus service. User accounts, groups, endpoint registrations, and application registrations are not shared between the normal system and the Preview system. You will need to create and maintain separate accounts, groups, endpoint registrations, and application registrations for the Preview environment.

The Preview environment is available at https://preview.globus.org. Other service information is listed below.

Web             https://preview.globus.org
Auth            auth.preview.globus.org
Transfer API    transfer.api.preview.globus.org
Globus ID       globusid.preview.globus.org
Developers      auth.preview.globus.org/developers

Cloning a Globus Connect Server endpoint

Use the following procedure to clone a Globus Connect Server endpoint in the main environment for testing in the Preview environment.

Note:Only Globus Connect Server endpoints can be cloned, not shares or Globus Connect Personal endpoints. The endpoint to be cloned must already exist and work correctly in the main Globus environment.
  1. Login to the Preview environment at the following URL: https://preview.globus.org

  2. Create a new endpoint definition in the Preview environment via the following link: https://preview.globus.org/app/endpoints/create

  3. We recommend using a "Display Name" that: (a) clearly identifies the endpoint from the main environment, and (b) indicates that this endpoint is a clone. E.g. "Geosciences preview clone."

  4. To fill in the "Identity Provider" section, look at the Manage Endpoints page in the main environment (not Preview), find the endpoint you are cloning, click the "Servers" tab, and copy exactly what you see in the "Identity Provider" section.

  5. To fill in the "Servers" section, look at the Manage Endpoints page in the main environment (not Preview), find the endpoint you are cloning, click the "Servers" tab, and copy exactly what you see in the "Servers" section.

Once you’ve created the endpoint clone, try using it to verify that it works.

Preview TCP ports

Since services will be connecting to your endpoint from the Preview environment, some additional ports must be open. (These are in addition to the normal Globus Connect Server firewall requirements.)

Port 2811 inbound from 107.20.144.193

  • Used for GridFTP control channel traffic.

Port 7512 inbound from 107.20.144.193

  • Used for MyProxy traffic.

  • This is only needed if your server is using a MyProxy service.

Using the Globus CLI

To use the Globus CLI with the Preview environment, set the GLOBUS_SDK_ENVIRONMENT environment variable to the value "preview". This tells the CLI to make API calls to the Preview environment’s services.

You will need to login again when you set this environment variable, but because the CLI manages tokens separately for each environment, you can unset the GLOBUS_SDK_ENVIRONMENT variable or use a separate terminal to go back to using the main environment without having to login again.

If you logout of one environment, it will not log you out of the other environment automatically, so be sure to logout of both environments when you are done.

For example, if you are using a bash shell, you can login to the preview environment with the following commands.

$ export GLOBUS_SDK_ENVIRONMENT=preview
$ globus login

You can logout of both environments using the following commands.

$ globus logout
$ unset GLOBUS_SDK_ENVIRONMENT
$ globus logout