Manually Manage the Compute Environment

Although Graph Studio can automatically manage the attaching and detaching process of the compute environment in the background, you can also manually manage the environment.

The following lists a few situations which require manual intervention:
  • Increase or decrease the total available memory for Graph Studio. See the table that describes the memory allocation based on compute capacity in Inspect the Compute Environment for more information.
  • Increase (or decrease) the maximum amount of the graph server (PGX) memory available for analysis and optionally save the memory value as the default graph server (PGX) memory configuration.
  • Increase (or decrease) the maximum amount of memory available for notebook interpreters and optionally save the memory values as the default memory configurations for the interpreters.

    For instance, if the result of your PGQL (RDBMS) query contains thousands of long strings, you may have to increase the memory of the Database interpreter to avoid out of memory errors.

  • Code in a notebook accidentally caused the environment to enter a bad state.
  • The environment ran out of memory.
To manually manage the environment:
  1. Click on your username on the top right drop-down menu of Graph Studio and then select Compute Environment.

    The Compute Environment slider appears as shown:


    Description of manually_manage_env.png follows
    Description of the illustration manually_manage_env.png

  2. Click Restart or Attach or Detach as it may apply.

    The following table describes all the supported manual options to manage the compute environment:

    Manual Options Description
    Detach the compute environment

    If the compute environment is currently attached, you can detach it by clicking the Stop button. This will cause the compute environment to enter the Detaching state.

    Attach the compute environment

    If the compute environment is currently detached, you can optionally perform the following actions:

    1. Optionally, adjust the memory for the graph server and interpreters.

      When you modify the memory allocation for a component, Graph Studio automatically redistributes memory across the remaining components to ensure that the total allocation does not exceed the total available memory. However, the minimum memory requirement for each component is enforced and cannot be reduced. See the memory distrubution table in Inspect the Compute Environment for more information.

    2. Optionally, click Save preferences to save the adjusted values as the default memory settings.
    3. Click Create to attach to the compute environment.

      Note:

      The total amount of memory allocated to the compute environment is the sum of the memory given to the graph server and all the interpreters.
    Restart the compute environment You can detach and attach again in a single operation by clicking the Restart button. In this case, Graph Studio will attach to a compute environment with the same amount of memory as the current configuration for the graph server and the interpreters.
  3. Monitor the progress of any of the manual operations on the Jobs page.