LaunchIT is an application that allows LC users to provision LC cloud resources for themselves automatically. The application -- LaunchIT -- can be accessed in the CZ, RZ and SCF (iSRD). To reach LaunchIT visit
- CZ: https://launchit.llnl.gov/ or https://lit.llnl.gov
- RZ: https://rzlaunchit.llnl.gov/
- SCF: https://launchit.llnl.gov/ from a browser on the iSRD network
After signing into LaunchIT with your LC username and appropriate pin+token, you can view available resources in the Catalog and your already-provisioned resources via your Dashboard.
After creating these resources, you will have access to the metadata of the resources you've created from LaunchIT, such as authentication credentials for databases you may have created. This metadata is available by going to your Dashboard -> your project -> your resource. For example, your project might be called cz-<username> and your resource might be a mongoDB instance.
LaunchIT now supports self-provisioning of object storage allocations. After creating an object storage allocation, users can view connection details like s3 keys and some basic information about their allocations, like storage usage and maximums.
For more info on LaunchIT, please see this announcement.
LaunchIT PDS Featuresπ
Creating a PDS Instanceπ
LaunchIT allows users to create a new PDS instance from several curated options. These options currently include MariaDB, MySQL, PostgreSQL, MongoDB, RabbitMQ, and Redis. The Fireworks + MongoDB option is also now available. To use this feature, go to the catalog page to select which option you would like to launch. Additionally, you can also launch a new instance using the dropdown from a workspace page.
Viewing PDS Instance Configurationπ
LaunchIT allows users to view and copy the connection configuration for a PDS instance. Individual fields are displayed directly on the instance dashboard. Additionally, there are some buttons representing pre-formatted configuration files just below the main table of values. Clicking on one of those buttons will display a text box containing the configuration file for users to copy. All instances offer the configuration format of JSON or YAML as a quick means of copying over all the contents. Some instance types, like MariaDB, offer additional configuration, like a ".my.cnf" type of configuration. These instance-specific configuration files often contain specific configuration for PDS and the LC environment. If there is a specific configuration format you would like to see on LaunchIT or if you have recommendations on elements to add to existing configuration formats, feel free to reach out via email at lit-help@llnl.gov.
Deleting a PDS Instanceπ
LaunchIT allows users to delete previously created PDS instances. To use this feature, go to the instance-specific page and select the "delete" button at the bottom of the page. This will delete all data stored by the instance and cannot be undone.
PDS Instance Password Resetπ
LaunchIT allows users to reset or change the password for their PDS instances. This is useful in cases where a password is accidentally exposed, for example, when uploading a configuration file to gitlab. It is also a security best practice to periodically update these passwords. To use this feature, select the "password reset" button near the bottom of an instance dashboard.
Creating a New Workspaceπ
LaunchIT allows users to create additional workspaces. These workspaces can be used for collaboration by adding users and adjusting permissions. Users can create a maximum of 5 workspaces, but there is no limit on how many workspaces a user can be added to. To use this feature, select the "create a new workspace" button at the top of the workspaces dashboard.
Deleting a Workspaceπ
LaunchIT allows users to delete a previously existing workspace. There must not be any instances in the workspace to use this feature, so users must first delete all instances in a workspace prior to using this feature. To use this feature, select the "delete workspace" button at the bottom of the specific workspace dashboard.
User Workspace Permissionsπ
LaunchIT allows users to add and remove permissions for other users for workspaces. This feature allows collaboration and group access to workspaces and instances. There are three permissions levels that can be granted: "View", "Edit", and "Admin".
-
View: The view permission allows a user to see the workspaces and view any instances within the workspace. A user with view access can see the status of the instance and any non-secret connection details like the hostname. A user with view permissions cannot see secret connection details like passwords or access workspaces permissions. Users with view permissions also cannot create or delete instances.
-
Edit: The edit permission gives all of the same access as the view permission. In addition, users with edit permission will also be able to create an instances but not delete it or view secrets. Users with edit permission will not be able to access the workspace permissions.
-
Admin: The admin permission gives all of the same access as the edit permission. In addition, users with admin permission will be able to access the workspace permissions to add and remove other users to the group workspace. Admin permissions allow the ability to delete instances and the workspace as well as view secret information like passwords.
To access workspace permissions, select the icon in the permissions column of the workspace you want to edit permissions for. Additionally, you can select the "permissions" button at the top of a specific workspace dashboard. Note that other users cannot be added to a personal workspace.
LaunchIT Object Storage Featuresπ
Creating an Object Storage Allocationπ
LaunchIT currently only supports creating a single personal allocation. Select Object Storage Allocations from the top navbar. If you don't already have an allocation, this page will give you the option to create one. After creating one, this page will load with a list of allocations that you have access to. This is currently limited to one, but we have plans to include group allocations in the future. Your allocation will be set to have the default quota of 4 TB.
Accessing an Object Storage Allocationπ
After selecting an allocation from the list on the object storage allocations page, you should see a page with a list of buckets and some configuration details below. The s3 access key ID and s3 secret access key are used as credentials when logging into your allocation. See the AWS CLI or python boto3 libraries for more information. The s3 endpoint URL is the URL where your s3 allocation can be reached.
S3 credentials expire after 30 days in accordance with our security policy. To generate new s3 keys at any time, select the reset s3 keys button below the connection configuration at any time.
Viewing Allocation Usage and Bucket Operationsπ
LaunchIT will list out all of the bucket names as well as the usage for each bucket. Below the bucket list and to the right of the connection configuration, you will see a storage usage graph. This contains information for the entire allocation, including how much is used and how much total is allocated.
Buckets can be created and deleted. Deleting a bucket will also forcefully delete all of its contents, with no means of recovering that data.
Exceptionsπ
So far, LaunchIT allows users to request persistent data services and object storage allocations along with a limited scope of operations and features for each. If you need any advanced support, such as requesting larger quotas, services that do not yet exist in our catalog, or help deploying a custom web server in our PDS environment, please feel free to reach out to lit-help@llnl.gov.
Advanced Support Template
I require an increased quota for my <object storage allocation> <cz-janeh> for my work with <SD>. Zone: <CZ> LC Username: <janeh> New Quota: <10 TB> Thank you! <Jane>