WIP: feat(quickstarts): initial migration of quickstarts content

docusaurus.config.js

@@ -36,13 +36,14 @@ const config = {
       attributes: {
         'http-equiv': 'Content-Security-Policy',
         content:
-          "default-src 'self' 'unsafe-inline' 'unsafe-eval' data: https://avatars.githubusercontent.com https://github.com https://kit.fontawesome.com/ https://ka-f.fontawesome.com/ https://fonts.googleapis.com/ https://fonts.gstatic.com/ https://www.google-analytics.com/ https://www.googletagmanager.com/ https://*.algolia.net/;",
+          "default-src 'self' 'unsafe-inline' 'unsafe-eval' data: https://avatars.githubusercontent.com https://github.com https://kit.fontawesome.com/ https://ka-f.fontawesome.com/ https://fonts.googleapis.com/ https://fonts.gstatic.com/ https://www.youtube.com/ https://www.google-analytics.com/ https://www.googletagmanager.com/ https://*.algolia.net/;",
       },
     },
     {
       // Load font awesome icons
       tagName: 'script',
       attributes: {
+        defer: 'true',
         src: 'https://kit.fontawesome.com/17a35e44e3.js',
         crossorigin: 'anonymous',
       },
@@ -88,6 +89,15 @@ const config = {
         path: './releases',
       },
     ],
+    [
+      '@docusaurus/plugin-content-docs',
+      {
+        id: 'quickstarts',
+        path: 'quickstarts',
+        routeBasePath: 'quickstarts',
+        sidebarPath: './sidebars.js',
+      },
+    ],
   ],
 
   presets: [
@@ -160,7 +170,7 @@ const config = {
         title: 'Developers',
         navItems: [
           {
-            href: 'https://quickstarts.teradata.com/',
+            href: `${baseUrl}/quickstarts/business-intelligence/create-stunning-visualizations-in-power-bi-using-data-from-teradata-vantage/`,
             label: 'Getting started',
           },
           {

quickstarts/_partials/_clone-repo.mdx

@@ -0,0 +1,11 @@
+
+
+The `deployments` folder in the [AI Unlimited GitHub repository](https://github.com/Teradata/ai-unlimited) that Teradata provides contains template, parameter, and policy files for installing AI Unlimited.
+
+	Open a terminal window, and clone the repository.
+
+    ``` bash
+    git clone https://github.com/Teradata/ai-unlimited
+	```
+
+

quickstarts/_partials/community_link.mdx

@@ -0,0 +1,3 @@
+:::note
+If you have any questions or need further assistance, please visit our [community forum](https://support.teradata.com/community) where you can get support and interact with other community members.
+:::

quickstarts/_partials/getting-started-intro.mdx

@@ -0,0 +1,9 @@
+import UseCase from './use-csae.mdx';
+
+<UseCase />
+## Overview
+This how-to shows how to gain access to a Teradata database by running it on your local machine. Once you finish the steps you will have a working Teradata Vantage Express database on your computer.
+
+:::note
+Starting with version 17.20, Vantage Express includes the following analytics packages: [Vantage Analytics Library](https://docs.teradata.com/r/Vantage-Analytics-Library-User-Guide/January-2022), [Bring Your Own Model (BYOM)](https://docs.teradata.com/r/Teradata-VantageTM-Bring-Your-Own-Model-User-Guide/May-2022), [API Integration with AWS SageMaker](https://docs.teradata.com/r/Teradata-VantageTM-API-Integration-Guide-for-Cloud-Machine-Learning/April-2022).
+:::

quickstarts/_partials/getting-started-queries.mdx

@@ -0,0 +1,54 @@
+```sql
+CREATE DATABASE HR
+AS PERMANENT = 60e6, -- 60MB
+    SPOOL = 120e6; -- 120MB
+```
+
+5. Let’s create a sample table and insert some data and query it. We will first create a table to hold employee information:
+
+```sql
+CREATE SET TABLE HR.Employees (
+   GlobalID INTEGER,
+   FirstName VARCHAR(30),
+   LastName VARCHAR(30),
+   DateOfBirth DATE FORMAT 'YYYY-MM-DD',
+   JoinedDate DATE FORMAT 'YYYY-MM-DD',
+   DepartmentCode BYTEINT
+)
+UNIQUE PRIMARY INDEX ( GlobalID );
+```
+
+6. Now, let's insert a record:
+
+```sql
+INSERT INTO HR.Employees (
+   GlobalID,
+   FirstName,
+   LastName,
+   DateOfBirth,
+   JoinedDate,
+   DepartmentCode
+)
+VALUES (
+   101,
+   'Adam',
+   'Tworkowski',
+   '1980-01-05',
+   '2004-08-01',
+   01
+);
+```
+
+7. Finally, let's see if we can retrieve the data:
+
+```sql
+SELECT * FROM HR.Employees;
+```
+
+You should get the following results:
+
+```sql
+GlobalID  FirstName  LastName   DateOfBirth  JoinedDate  DepartmentCode
+--------  ---------  ---------- -----------  ----------  --------------
+     101  Adam       Tworkowski  1980-01-05  2004-08-01               1
+```

quickstarts/_partials/getting-started-summary.mdx

@@ -0,0 +1,3 @@
+## Summary
+
+In this guide we have covered how to quickly create a working Teradata environment. We used Teradata Vantage Express in a VM running on VMware. In the same VM, we ran Teradata Studio Express to issue queries. We installed all software locally and didn't have to pay for cloud resources.

quickstarts/_partials/install-ve-in-public.mdx

@@ -0,0 +1,112 @@
+import GettingStartedQueries from './getting-started-queries.mdx';
+
+run. Install VirtualBox and 7zip:
+```bash
+apt update && apt-get install p7zip-full p7zip-rar virtualbox -y
+```
+5. Retrieve the curl command to download Vantage Express.
+* Go to [Vantage Expess download page](https://downloads.teradata.com/download/database/teradata-express-for-vmware-player) (registration required).
+* Click on the latest download link, e.g. "Vantage Express 17.20". You will see a license agreement popup. Don't accept the license yet.
+* Open the network view in your browser. For example, in Chrome press kbd:[F12] and navigate to `Network` tab:
+
+![Browser Network Tab](../images/browser.network.png)
+
+* Accept the license by clicking on `I Agree` button and cancel the download.
+* In the network view, find the last request that starts with `VantageExpress`. Right click on it and select `Copy -> Copy as cURL`:
+
+![Browser Copy culr](../images/browser.copy.curl.png)
+* Head back to the ssh session and download Vantage Express by pasting the curl command. Add `-o ve.7z` to the command to save the download to file named `ve.7z`. You can remove all the HTTP headers, e.g.:
+
+```bash
+curl -o ve.7z 'http://d289lrf5tw1zls.cloudfront.net/database/teradata-express/VantageExpress17.20_Sles12_202108300444.7z?Expires=1638719978&Signature=GKBkNvery_long_signature__&Key-Pair-Id=********************'
+```
+
+* Unzip the downloaded file. It will take several minutes:
+
+```bash
+7z x ve.7z
+```
+* Start the VM in VirtualBox. The command will return immediately but the VM init process will take several minutes:
+
+```bash
+export VM_IMAGE_DIR="/opt/downloads/VantageExpress17.20_Sles12"
+DEFAULT_VM_NAME="vantage-express"
+VM_NAME="${VM_NAME:-$DEFAULT_VM_NAME}"
+vboxmanage createvm --name "$VM_NAME" --register --ostype openSUSE_64
+vboxmanage modifyvm "$VM_NAME" --ioapic on --memory 6000 --vram 128 --nic1 nat --cpus 4
+vboxmanage storagectl "$VM_NAME" --name "SATA Controller" --add sata --controller IntelAhci
+vboxmanage storageattach "$VM_NAME" --storagectl "SATA Controller" --port 0 --device 0 --type hdd --medium  "$(find $VM_IMAGE_DIR -name '*disk1*')"
+vboxmanage storageattach "$VM_NAME" --storagectl "SATA Controller" --port 1 --device 0 --type hdd --medium  "$(find $VM_IMAGE_DIR -name '*disk2*')"
+vboxmanage storageattach "$VM_NAME" --storagectl "SATA Controller" --port 2 --device 0 --type hdd --medium  "$(find $VM_IMAGE_DIR -name '*disk3*')"
+vboxmanage modifyvm "$VM_NAME" --natpf1 "tdssh,tcp,,4422,,22"
+vboxmanage modifyvm "$VM_NAME" --natpf1 "tddb,tcp,,1025,,1025"
+vboxmanage startvm "$VM_NAME" --type headless
+vboxmanage controlvm "$VM_NAME" keyboardputscancode 1c 1c
+```
+* ssh to Vantage Express VM. Use `root` as password:
+
+```bash
+ssh -p 4422 root@localhost
+```
+* Validate that the DB is up:
+```bash
+pdestate -a
+```
+
+If the command returns `PDE state is RUN/STARTED. DBS state is 5: Logons are enabled - The system is quiescent`, it means that Vantage Express has started.
+If the status is different, repeat `pdestate -a` till you get the correct status.
+
+* Once Vantage Express is up and running, start `bteq` client command line client. BTEQ (pronounced “bee-teek”) is a general-purpose, command-based client tool used to submit SQL queries to a Teradata Database.
+
+```bash
+bteq
+```
+* Once in bteq, connect to your Vantage Express instance. When asked for the password, enter `dbc`:
+
+```bash
+.logon localhost/dbc
+```
+
+## Run sample queries
+
+* Using `dbc` user, we will create a new database called `HR`. Copy/paste this query and run press kbd:[Enter]:
+
+<GettingStartedQueries />
+
+## Optional setup
+
+* If you intend to stop and start the VM, you may want to add Vantage Express to autostart. ssh to your VM and run the following commands:
+
+```bash
+sudo -i
+
+cat <<EOF >> /etc/default/virtualbox
+VBOXAUTOSTART_DB=/etc/vbox
+VBOXAUTOSTART_CONFIG=/etc/vbox/autostart.cfg
+EOF
+
+cat <<EOF > /etc/systemd/system/vantage-express.service
+[Unit]
+Description=vm1
+After=network.target virtualbox.service
+Before=runlevel2.target shutdown.target
+[Service]
+User=root
+Group=root
+Type=forking
+Restart=no
+TimeoutSec=5min
+IgnoreSIGPIPE=no
+KillMode=process
+GuessMainPID=no
+RemainAfterExit=yes
+ExecStart=/usr/bin/VBoxManage startvm vantage-express --type headless
+ExecStop=/usr/bin/VBoxManage controlvm vantage-express savestate
+[Install]
+WantedBy=multi-user.target
+EOF
+
+systemctl daemon-reload
+systemctl enable vantage-express
+systemctl start vantage-express
+```

quickstarts/_partials/jupyter_notebook_clearscape_analytics_note.mdx

@@ -0,0 +1,3 @@
+:::note
+This how-to shows you how to add Teradata Extensions to a Jupyter Notebooks environment. A hosted version of Jupyter Notebooks integrated with Teradata Extensions and analytics tools is available for functional testing for free at https://clearscape.teradata.com.
+:::