- 05 Jun 2024
- 8 minute read
- Print
- DarkLight
- PDF
Provision Clean Slate, Test, and Time Warp Environments
- Updated 05 Jun 2024
- 8 minute read
- Print
- DarkLight
- PDF
Overview
In addition to your Production environment, where operational data transactions occur, such as email campaigns, form building and completion, your database includes multiple test environments. The availability of these additional environments offers numerous benefits, including the ability to test new features, gain hands-on experience, and troubleshoot in a controlled setting before implementing them in the production environment.
Clean Slate: This database can be provisioned from several source options. Model database is a functional training database without any custom content. The Showcase database option includes examples of properly configured Slate functionality which you are free to test, copy or migrate to your database using Suitcase.
Test Environment: This database is a copy of the existing production environment.
Time Warp: This database is a copy of the production environment at a specific point in time from the last 90 days.
Clean Slate
A Clean Slate environment provisioned from the Model source option is a blank database built by Technolutions. While functional, it contains no person records, fields, decision codes, or other custom data. You can use it for training purposes, where new Slate users can practice without fear of impacting production data or accidentally sending communications that do not deliver in test environments (see our article on Test Environments for more of the differences between Test and Production).
🔔 Important!Consult with your Slate Administrators or other members of your Slate team before requesting a refresh for an active Clean Slate database.
Communication is key: if you request a refresh of your Clean Slate environment, it will refresh for everyone.
To access an existing Clean Slate environment or to provision a new one:
In the Production environment, click Database in the Slate navigation bar.
In the Auditing section, select Launch Clean Slate.
Take note of the Status of your institution's Clean Slate environment.
Active: A Clean Slate environment has already been provisioned for your institution and is in use.
Not Provisioned: Your institution has not provisioned a Clean Slate environment.
Expired: A Clean Slate environment was provisioned for your institution but has yet to be accessed in the past 30 days.
If your Clean Slate is Active:
Click Launch Clean Slate on the right.
If you've confirmed with your team that no one is using the Active Clean Slate, you can click the arrow, then Request Refresh, to generate a new Clean Slate.
If your Clean Slate is Not Provisioned or Expired, or if you've confirmed no one in your Slate team is using an Active Clean Slate:
In the pop-up:
From the Source list, select Slate Model, Slate Advancement Model, or Slate Admissions/Advancement Model.
Select at least one Slate user as Initial Administrator(s). Only administrators can provide new users with access to the Clean Slate.
Add a Memo if desired. The memo will be displayed to users prior to requesting a refresh of the environment and may be used to provide details of intended use.
Select Provision/Request Refresh. A confirmation pop-up appears.
Enter the required text into the confirmation pop-up and click OK.
📝 NoteProvisioning and refreshing a Clean Slate environment can take up to three hours to process.
To access your new Clean Slate environment:
Click the Endpoint URL, or
Click Launch Clean Slate
Note the pink indicators at the top and side of the Clean Slate environment. You may find it helpful to bookmark your Clean Slate environment's URL for easy access, especially if your team is involved in a Fundamentals course.
User Accounts
If new users are added to production after provisioning a Clean Slate environment, you'll need to add those accounts to Clean Slate to grant them access. There are three ways to add user accounts to Clean Slate:
Manually
Manually recreate accounts in the Clean Slate environment. This can be the quickest method for a small number of users. To manually recreate user accounts in Clean Slate:
Launch your Clean Slate environment.
From the main navigation, select Database. Under Users & Access, select User Permissions.
Click New User.
Configure the user's account as you did in the production environment.
With Upload Dataset
Using a query in your production environment and Upload Dataset in Clean Slate, you can move a large number of user accounts at once.
To move multiple accounts to Clean Slate at once with Upload Dataset:
Step One: Export New Users from Production
Launch your production environment.
From the main navigation, select Queries / Reports.
Click New Query or Quick Query. A pop-up appears.
In the pop-up, configure the following:
Type: Configurable Joins
Category: Related
Base: User
Click Save.
Click Export. A pop-up appears. Under User, Click Select All.
Note: The following items are required for user account creation:
User GUID
First Name
Last Name
Email Address
Click Continue.
Click Filter. A pop-up appears.
Under User, Select Created Date.
Click Continue.
Enter a Start Date, End Date, or both that narrows the results to time period following the provisioning of your Clean Slate environment and the creation of the new user accounts.
Click Save.
Once satisfied with the query, click Run Query.
Click Export.
Step Two: Import the New Users to Clean Slate
Launch Clean Slate.
From the main navigation, select Database. Under Import, select Sources / Upload Dataset.
Click Upload Dataset.
If desired, select a current Folder, or select Other to add a folder.
Add the file containing the new user information, then click Upload.
On the right, click Build Import.
From the list of Field Mappings, connect the source mappings to a destination mapping (including, at the least: User GUID, First Name, Last Name, and Email Address).
On the right, click Prompt Value Mappings.
Assign the user permissions as needed.
On the right, click Review & Run Import.
Click Run Import.
From the main navigation, select Database. Under Import, select Force Process Import. Click Back in your browser and return to Sources / Upload Dataset.
Select the user records from the list. A pop-up appears.
Click Create New.
From the main navigation, select Database. Under Users & Access, select User Permissions.
On the right, click Inactive Users.
Select the new user account or accounts from the list and click Edit User.
Select Enable account for access. Click Save.
Re-provision Clean Slate
This option will erase all in-progress work in your Clean Slate environment and start over with the selected source. Provisioning a new Clean Slate environment will also take about three hours. Use this option only if there is no active work in Clean Slate to be migrated to production. Once erased, there is no way to recover a previous version of Clean Slate.
Slate Showcase
Clean Slate a little too... clean? Slate Showcase environments are a great way to learn Slate best practices by example. Showcase environments, which come in Slate (default), Student Success, and Advancement flavors, are pre-loaded with sample data and common use cases. To provision a Showcase environment:
Following the steps to provision a Clean Slate, select the Showcase environment you'd like to provision from the Source list. Lifecycle-specific options include Slate Showcase (Admissions), Slate Student Success Showcase, and Slate Advancement Showcase.
Select at least one Slate user as Initial Administrator(s). Only administrators can provide new users with access to the Clean Slate.
Add a Memo if desired. The memo will be displayed to users before requesting a refresh of the environment and may be used to provide details of intended use.
Select Provision or Request Refresh. A confirmation pop-up appears.
Enter the required text into the confirmation pop-up and click OK.
Slate's Briefcase tool can be utilized to copy any data object from the Showcase environment into a production or test environment for further modification and customization.
Test Environment
Like a Clean Slate environment, a test environment is used to safely experiment with Slate processes without fear of impacting production data. Unlike Clean Slate, the Test Environment is an exact replica of your production environment from the time it was provisioned.
Provisioning a test environment is the same process as with a Clean Slate environment:
In the Production environment, click Database in the Slate navigation bar.
In the Auditing section, select Launch Test Environment.
Take note of the Status of your institution's test environment.
Click Provision, or refresh the test environment by clicking the arrow, then Request Refresh.
Add a Memo if desired. The memo will be displayed to users before requesting a refresh of the environment and may be used to provide details of intended use.
Click Provision/Refresh. A confirmation pop-up appears.
Enter the required text into the confirmation pop-up and click OK.
📝 NoteProvisioning and refreshing a test environment can take up to three hours to process.
To access your new test environment:
Click the Endpoint URL, or
Click Launch Test Environment
Time Warp
Time Warp environments, like Test Environments, create a copy of your production database; however, the copy can be made from any point in time within the past 90 days.
Provisioning a Time Warp environment is the same process as with a Clean Slate or test environment:
In the Production environment, click Database in the Slate navigation bar.
In the Auditing section, select Launch Time Warp.
Take note of the Status of your institution's Time Warp environment.
Click Provision, or refresh the test environment by clicking the arrow, then Request Refresh. A pop-up appears.
In the pop-up, configure the following:
Snapshot Date and Time: Enter a date and time (ET). The default value will be today.
Snapshot Type: Select Express to restore the latest weekly backup directly preceding the snapshot date. Otherwise, select Restore to exact moment in time.
Add a Memo if desired. The memo will be displayed to users before requesting a refresh of the environment and may be used to provide details of intended use.
Click Provision/Update Snapshot. A confirmation pop-up appears.
Enter the required text into the confirmation pop-up and click OK.
📝 NoteProvisioning and refreshing a Time Warp environment can take up to three hours to process.
To access your new Time Warp environment:
Click the Endpoint URL, or
Click Launch Time Warp
Learning Lab (Personal Environment)
As a registered user of Learning Lab, you have access to a comprehensive personal testing database to enhance your learning experience. With a full year of access, you are encouraged to make the most of this valuable resource and use it regularly as a supplement to your course activities. Using your test database to follow along with course activities will deepen your understanding and reinforce key concepts, leading to a more successful and fulfilling learning journey.
You can provision or launch your test database from the "Test and Other Environments" provisioning page (Databases from Database >Test & Other Environments> Learning Lab). When on this page, there are three possible views:
View for anyone NOT yet registered for Learning Lab courses
View for anyone registered for Learning Lab courses but has not yet provisioned their test database
View for anyone registered for Learning Lab courses and has provisioned their test database