diff --git a/content/en/lib/images/nm-device-wired-symbolic.svg b/content/en/lib/images/nm-device-wired-symbolic.svg new file mode 100644 index 00000000..a9f519c8 --- /dev/null +++ b/content/en/lib/images/nm-device-wired-symbolic.svg @@ -0,0 +1,74 @@ + + + + + + image/svg+xml + + + + + + + + + + + + + + diff --git a/content/en/lib/images/nm-signal-100-symbolic.svg b/content/en/lib/images/nm-signal-100-symbolic.svg new file mode 100644 index 00000000..33158eee --- /dev/null +++ b/content/en/lib/images/nm-signal-100-symbolic.svg @@ -0,0 +1,79 @@ + + + + + + image/svg+xml + + + + + + + + + + + + + + diff --git a/content/en/lib/images/settings-symbolic.svg b/content/en/lib/images/settings-symbolic.svg new file mode 100644 index 00000000..2ecf57b1 --- /dev/null +++ b/content/en/lib/images/settings-symbolic.svg @@ -0,0 +1,106 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/content/en/lib/images/super-key.svg b/content/en/lib/images/super-key.svg new file mode 100644 index 00000000..5e860cda --- /dev/null +++ b/content/en/lib/images/super-key.svg @@ -0,0 +1,43 @@ + + + + + + + + + + + + + SHIFT + + + + + + + Z + + + + + + + CTRL + + + + + + + ⊞​ + + + + + + + ALT + + \ No newline at end of file diff --git a/content/en/workstations/Vector_quickstart_guide.pdf b/content/en/workstations/Vector_quickstart_guide.pdf new file mode 100644 index 00000000..df0aaf5c Binary files /dev/null and b/content/en/workstations/Vector_quickstart_guide.pdf differ diff --git a/content/en/workstations/quickstart-guide/_index.md b/content/en/workstations/quickstart-guide/_index.md new file mode 100644 index 00000000..e858f9be --- /dev/null +++ b/content/en/workstations/quickstart-guide/_index.md @@ -0,0 +1,4 @@ +--- +title: "How do I get started using my Lambda Vector?" +type: docs +--- diff --git a/content/en/workstations/quickstart-guide/booting-ubuntu-first-time/index.md b/content/en/workstations/quickstart-guide/booting-ubuntu-first-time/index.md new file mode 100644 index 00000000..0fb8d693 --- /dev/null +++ b/content/en/workstations/quickstart-guide/booting-ubuntu-first-time/index.md @@ -0,0 +1,44 @@ +--- +title: "Booting Ubuntu for the first time" +type: docs +tags: +- Ubuntu +weight: 20 +--- + +The first time you turn on your Vector, you'll need to complete a series of +steps to set up Ubuntu. + +1. You'll be prompted to select a language for your system. Choose + **English**, then click **Continue**. + +1. When prompted to select a keyboard layout, select **English (US)** and + **English (US)** again. Then, click **Continue**. + +1. You'll be asked **Where are you?** to set your time zone. Begin to type in + the city you're located in. When you see your city, or the time zone your + city is in, select your city or the time zone, then click **Continue**. + +1. In the **Who are you?** dialog, you'll be asked to complete several fields: + + - For **Your name**, enter your "real name" or the name you use to identify + yourself. + + - For **Your computer's name**, enter a name for your Vector. This name is + used for different purposes, for example, to identify your Vector on + [your network]({{< relref "connecting-to-your-network" >}}) and in log + files. + + - For **User name**, enter a name to use to log into the system. This name + will also be the name of your home directory, for example, + `/home/username`. + + - In the **Choose your password** field, enter the password you want to use + to log into your system. In the following **Confirm your password** + field, reenter your password. + + - For security, choose **Require my password to log in**. + + Click **Continue** to finish setting up Ubuntu. + +1. Once the set up of Ubuntu finishes, you'll be able to log into your system. diff --git a/content/en/workstations/quickstart-guide/connecting-to-your-network/index.md b/content/en/workstations/quickstart-guide/connecting-to-your-network/index.md new file mode 100644 index 00000000..d5f2b90e --- /dev/null +++ b/content/en/workstations/quickstart-guide/connecting-to-your-network/index.md @@ -0,0 +1,110 @@ +--- +title: "Connecting to your network" +type: docs +tags: +- hardware +- network +weight: 30 +--- + +You can connect to your network using either +[Ethernet]({{< relref "#connecting-using-ethernet" >}}) or +[Wi-Fi]({{< relref "#connecting-using-wi-fi" >}}) (if you purchased your +Vector with a Wi-Fi adapter). + +{{% alert title="Tip" color="success" %}} +It's recommended to connect to your network using Ethernet rather than Wi-Fi. +Ethernet is more reliable and provides better performance than Wi-Fi. +{{% /alert %}} + +## Connecting using Ethernet + +If you +[connect to your network using Ethernet]({{< relref "unboxing-and-setting-up-vector#connecting-your-wired-network" >}}), +your network settings will likely automatically be configured using DHCP. + +You should see at the +top-right of your screen, which indicates you're connected to your network. + +## Connecting using Wi-Fi + +If you purchased your Vector with a +[Wi-Fi adapter]({{< relref "unboxing-and-setting-up-vector#connecting-your-wi-fi-antenna-if-included" >}}), +you can use the **Wi-Fi** panel in GNOME Settings to connect to your Wi-Fi +network. + +To open the **Wi-Fi** panel in GNOME Settings: + + +1. Press the + + + key on your keyboard to open the **Activities** overview. Then, type `wifi`. + + {{% alert title="Tip" color="success" %}} + The + + + key on your keyboard is located between the **Ctrl** and **Alt** keys. + + + {{% /alert %}} + +1. Click **Wi-Fi** to open the **Wi-Fi** panel in GNOME Settings. + +Your network settings will likely automatically be configured using DHCP once +you successfully connect to your Wi-Fi network. + +You'll see at the +top-right of your screen once you're connected to your Wi-Fi network. + +{{% alert title="Note" color="info" %}} +Some networks require you to log in before you can access the network. If +you're asked to log into your network, you need to contact your network +administrator for the required credentials. +{{% /alert %}} + +## Configuring a static IP address + +DHCP, or _Dynamic Host Configuration Protocol_, assigns an IP address that +might change from time to time. If your IP address changes, it might be +difficult to remotely access your Vector. + +If you plan to remotely access your Vector, you should ask your network +administrator to configure a static DHCP lease so that your IP address doesn't +change. + +As an alternative to configuring a static DHCP lease, your network +administrator might provide you with settings that you can use to manually +configure a static IP address. + +To manually configure a static IP address: + +1. Press the + + + key on your keyboard to open the **Activities** overview. Then, type `network`. + +1. Click **Network** to open the **Network** panel in GNOME Settings. + +1. If you're connected to your network using Ethernet, click the + next to your wired connection. + + If you're connected to your network using Wi-Fi, click the + next to your Wi-Fi connection. + +1. Click **IPv4**. For **IPv4 Method**, choose **Manual**. + + Fill in the fields with the network settings provided to you by your + network administrator. + + Next to **DNS**, switch off **Automatic**. In the field, enter the DNS + server IP addresses provided by your network administrator, separated by a + `,`. + + Next to **Routes**, switch off **Automatic**. + + Fill in the fields with the network settings provided to you by your + network administrator. + +1. Click **Apply** to enable your changes. diff --git a/content/en/workstations/quickstart-guide/creating-additional-user-accounts/index.md b/content/en/workstations/quickstart-guide/creating-additional-user-accounts/index.md new file mode 100644 index 00000000..87352b9e --- /dev/null +++ b/content/en/workstations/quickstart-guide/creating-additional-user-accounts/index.md @@ -0,0 +1,66 @@ +--- +title: "Creating additional user accounts" +type: docs +tags: +- Ubuntu +weight: 40 +--- + +By having their own accounts, users can manage their own files, data sets, +and programs, as well as manage their own +[Python virtual environments]({{< relref "/linux/create-python-virtual-environment" >}}), +[conda virtual environments]({{< relref "/linux/create-conda-virtual-environment" >}}), +and [Docker containers]({{< relref "/linux/install-docker-run-container" >}}). + +Also, by having additional accounts, you can assign system administrator +privileges to other users. + +You can add user accounts from the **Users** panel in **GNOME Settings**: + +1. Press the + + + key on your keyboard to open the **Activities** overview. Then, type `users`. + + {{% alert title="Tip" color="success" %}} + The + + + key on your keyboard is located between the **Ctrl** and **Alt** keys. + + + {{% /alert %}} + +1. Click **Users** to open the **Users** panel in **GNOME Settings**. + +1. Click **Unlock** at the top of the panel, then click **Add User**. + +1. For **Account Type**, choose either **Standard** or **Administrator**. + + - **Standard** account users can create, modify, and delete only their own + files, not system files or other users' files. Standard account users + also can change their own settings only, not system settings or other + users' settings. + + - **Administrator** account users have the same privileges as standard + account users. However, administrator account users can also create, + modify, and delete system files and other users' files. Administrator + account users can also change their system settings and other users' + settings. + +1. For **Full Name**, enter the user's full name, that is, their "real" name + or name they use to identify themselves. + +1. For **Username**, enter the name the user will use to log into the system. + This name will also be the name of the user's home directory, for example, + `/home/username`. + +1. Under **Password**, choose either **Allow user to set a password when they + next login**, or **Set a password now**. + + If you choose to set a password now, in the **Password** field, enter a + custom password, or click the + to automatically + generate a password. + +1. Click **Add** at the top of the dialog to add the user. diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/authentication-required.png b/content/en/workstations/quickstart-guide/formatting-storage-drives/authentication-required.png new file mode 100644 index 00000000..91ca4f99 Binary files /dev/null and b/content/en/workstations/quickstart-guide/formatting-storage-drives/authentication-required.png differ diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/file-browser-other-locations.png b/content/en/workstations/quickstart-guide/formatting-storage-drives/file-browser-other-locations.png new file mode 100644 index 00000000..3a99697a Binary files /dev/null and b/content/en/workstations/quickstart-guide/formatting-storage-drives/file-browser-other-locations.png differ diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/format-volume.png b/content/en/workstations/quickstart-guide/formatting-storage-drives/format-volume.png new file mode 100644 index 00000000..4453dd8f Binary files /dev/null and b/content/en/workstations/quickstart-guide/formatting-storage-drives/format-volume.png differ diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/formatted-partition.png b/content/en/workstations/quickstart-guide/formatting-storage-drives/formatted-partition.png new file mode 100644 index 00000000..7fa2ce31 Binary files /dev/null and b/content/en/workstations/quickstart-guide/formatting-storage-drives/formatted-partition.png differ diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/index.md b/content/en/workstations/quickstart-guide/formatting-storage-drives/index.md new file mode 100644 index 00000000..75b5fa30 --- /dev/null +++ b/content/en/workstations/quickstart-guide/formatting-storage-drives/index.md @@ -0,0 +1,86 @@ +--- +title: "Formatting your storage drives" +type: docs +tags: +- hardware +- storage +weight: 60 +--- + +If you purchased storage drives with your Vector, that is, drives in addition +to your boot drive, you need to format them before you can use them. + +To format your storage drives: + +1. Press the + + + key on your keyboard to open the **Activities** overview. Then, type `disks`. + + {{% alert title="Tip" color="success" %}} + The + + + key on your keyboard is located between the **Ctrl** and **Alt** keys. + + + {{% /alert %}} + +1. Click **Disks** to open GNOME Disks. + +1. In the left sidebar, click your storage drive. + + Information about the drive, including a graph showing how the drive is + currently partitioned and formatted, will show in the right pane. + + Since the drive hasn't yet been partitioned and formatted, only a single + unformatted partition will show as **Unknown**. + + {{< imgproc unformatted-partition Resize "700x">}}{{< /imgproc >}} + +1. In the graph, click the unformatted partition, then click + . Choose **Format + Partition**. + +1. In the **Format Volume** dialog that opens: + + - In the **Volume Name** field, enter a name to identify your storage + drive. + + - Leave **Erase** toggled off. + + - For **Type**, choose **Internal disk for use with Linux systems only + (Ext4)**. + + (Optional) Select **Password protect volume (LUKS)** to encrypt your + storage drive with a password. + + {{< imgproc format-volume Resize "600x">}}{{< /imgproc >}} + +1. Click **Next** in the dialog title bar. You'll be warned that all data on + the drive will be erased. + + {{< imgproc warning-all-data-will-be-lost Resize "600x">}}{{< /imgproc >}} + + Click **Format** in the title bar. When prompted, enter your user password, + then click **Authenticate**. + + {{< imgproc authentication-required Resize "400x">}}{{< /imgproc >}} + +Your storage drive is now formatted and ready for use. + +{{< imgproc formatted-partition Resize "700x">}}{{< /imgproc >}} + +To mount and access your storage drive using the file browser: + +1. Press the + + + key on your keyboard to open the **Activities** overview. Then, type `files`. + +1. Click **Files** to open the file browser. + +1. In the left sidebar, click **Other Locations**. Then, click your storage + drive. + + {{< imgproc file-browser-other-locations Resize "700x">}}{{< /imgproc >}} diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/unformatted-partition.png b/content/en/workstations/quickstart-guide/formatting-storage-drives/unformatted-partition.png new file mode 100644 index 00000000..e8ddde7c Binary files /dev/null and b/content/en/workstations/quickstart-guide/formatting-storage-drives/unformatted-partition.png differ diff --git a/content/en/workstations/quickstart-guide/formatting-storage-drives/warning-all-data-will-be-lost.png b/content/en/workstations/quickstart-guide/formatting-storage-drives/warning-all-data-will-be-lost.png new file mode 100644 index 00000000..cfba8f81 Binary files /dev/null and b/content/en/workstations/quickstart-guide/formatting-storage-drives/warning-all-data-will-be-lost.png differ diff --git a/content/en/workstations/quickstart-guide/remotely-accessing-vector-ssh/index.md b/content/en/workstations/quickstart-guide/remotely-accessing-vector-ssh/index.md new file mode 100644 index 00000000..f9e4c6f2 --- /dev/null +++ b/content/en/workstations/quickstart-guide/remotely-accessing-vector-ssh/index.md @@ -0,0 +1,67 @@ +--- +title: "Remotely accessing your Vector using SSH" +type: docs +tags: +- network +- SSH +- Ubuntu +weight: 50 +--- + +You can install OpenSSH Server on your Vector to allow secure remote access +via SSH. + +To install OpenSSH Server: + +1. Press **Ctrl** + **Alt** + **T** on your keyboard to open a terminal. + +1. In the terminal, type: + + ```bash + sudo apt -yqq update && sudo apt -yqq install openssh-server + ``` + + Then, press **Enter** on your keyboard to run the command. + + The command will install and configure OpenSSH Server. + +Once OpenSSH Server is installed on your Vector, you can SSH into your Vector +from other computers. + +For example, to SSH into your Vector from another computer running Ubuntu: + +1. Press **Ctrl** + **Alt** + **T** on the other computer's keyboard to open a + terminal. + +1. In the terminal, type in the following command: + + ```bash + ssh USERNAME@HOST + ``` + + Replace **USERNAME** with your username on your Vector. Replace **HOST** + with your [Vector's IP address]({{< relref "connecting-to-your-network" >}}). + + Then, press **Enter** on the keyboard to run the command. + +1. The first time you SSH into your Vector, you'll see a warning similar to + the following: + + ``` + The authenticity of host '192.168.122.181 (192.168.122.181)' can't be established. + ED25519 key fingerprint is SHA256:atnhDBdkhdxpVgBhRXAnkrOBrQqshA65O/1toxafdTU. + This key is not known by any other names + Are you sure you want to continue connecting (yes/no/[fingerprint])? + ``` + + Type `yes`, then press **Enter**. + + You'll be prompted to enter your password. Type in your password, then + press **Enter**. + + {{% alert title="Note" color="info" %}} + You won't see masking characters such as `*` or `•` as you type in your + password. + {{% /alert %}} + + You're now remotely logged into your Vector. diff --git a/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/glass-film.jpg b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/glass-film.jpg new file mode 100644 index 00000000..1e344c1e Binary files /dev/null and b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/glass-film.jpg differ diff --git a/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/index.md b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/index.md new file mode 100644 index 00000000..6430ad79 --- /dev/null +++ b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/index.md @@ -0,0 +1,134 @@ +--- +title: "Unboxing and setting up your Vector" +type: docs +tags: +- hardware +- network +weight: 10 +--- + + + +To set up your Vector, you need to connect your monitor, keyboard & mouse, +wired network, Wi-Fi antenna (if included), and power cable. + +You also need to remove the glass panel films and Instapak foam used to +protect your Vector during shipment. + +{{< imgproc rear-io-and-gpus Resize "600x" >}}{{< /imgproc >}} + + + + + + + +
RedTopmost GPU
LimeUSB ports
BlueEthernet ports
YellowWi-Fi antenna connectors
FuchsiaPower connector
+ +{{% alert title="Note" color="info" %}} +The ports on your Vector might be arranged differently than in the above +picture, depending on your Vector's configuration. +{{% /alert %}} + +## Removing the Instapak foam and glass panel films + +To remove the Instapak foam from inside your Vector and the films that protect +your Vector's glass panels, you need to first remove the glass panels. + +To remove your Vector's glass panels: + +{{< imgproc rear-thumbscrews-latch Resize "600x" >}}{{< /imgproc >}} + +1. Unscrew the 2 thumbscrews at the rear, top center of your Vector (boxed in + red in the above picture). + +1. Slide down the black latch at the top rear of your Vector, on the side + closest to the glass side panel (boxed in + blue in the above picture). + + At the same time, pull the top panel back and lift the panel off. + +1. Lift your Vector's glass side and front panels up and out. + +{{% alert title="Warning" color="warning" %}} +**Use care when handling the glass panels!** +{{% /alert %}} + +With your Vector's glass panels removed, remove the Instapak foam from inside +your Vector. + +{{< imgproc instapak Resize "600x" >}}{{< /imgproc >}} + +Peel the protective films from _both sides_ of your Vector's glass panels. + +{{< imgproc glass-film Resize "600x" >}}{{< /imgproc >}} + +Once you've removed the Instapak foam from inside your Vector and have peeled +the protective films from your Vector's glass panels, replace the glass panels +by following the above instructions in reverse. + +## Connecting your monitor + +{{% alert title="Note" color="info" %}} +You **must** connect your monitor to a port on your Vector's topmost GPU. +Otherwise, your Vector won't boot. +{{% /alert %}} + +- If your GPU and monitor both have HDMI ports, use an HDMI cable to connect + your monitor to the GPU. + +- If your GPU and monitor both have DisplayPorts, use a DisplayPort cable to + connect your monitor to the GPU. + +- If your GPU has DisplayPorts and your monitor has only HDMI ports, use a + DisplayPort-to-HDMI adapter and an HDMI cable to connect your monitor to the + GPU. + +- If your GPU has HDMI ports and your monitor has only DisplayPorts, use an + HDMI-to-DisplayPort adapter and a DisplayPort cable to connect your monitor + to the GPU. + +{{% alert title="Note" color="info" %}} +DisplayPort-to-HDMI and HDMI-to-DisplayPort adapters are unidirectional. This +means a DisplayPort-to-HDMI adapter can only be used with the DisplayPorts on +GPUs. Similarly, HDMI-to-DisplayPort adapters can only be used with the HDMI +ports on GPUs. + +Lambda doesn't support or recommend any particular adapters. +{{% /alert %}} + +## Connecting your keyboard & mouse + +Connect your keyboard and mouse to any available USB port on your Vector, +including the front USB ports. + +## Connecting your wired network + +Connect to your wired network by plugging one end of an Ethernet cable into +your router, switch, or jack designated by your network administrator. Plug +the other end of the Ethernet cable into an Ethernet port on the back of your +Vector. + +{{% alert title="Note" color="info" %}} +Each Ethernet port on your Vector has its own settings. This means, for +example, if your network administrator +[assigns a static IP address to your Vector]({{< relref "connecting-to-your-network#configuring-a-static-ip-address" >}}) +using a DHCP static lease, you need to make sure you always connect to your +wired network using the same Ethernet port. +{{% /alert %}} + +## Connecting your Wi-Fi antenna (if included) + +If you purchased your Vector with on-board Wi-Fi, connect the included antenna +to the 2 marked ports on the rear of your Vector. + +## Connecting your power cable + +Connect your Vector's power supply unit (PSU) _directly_ to a power outlet +using the included cord. Ideally, the power outlet will be on a dedicated +circuit. + +**Do not use a power strip, surge suppressor, or uninterruptible power supply +(UPS or battery backup).** + +Also, make sure your PSU is switched to the **|** (on) position. diff --git a/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/instapak.jpg b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/instapak.jpg new file mode 100644 index 00000000..0827ee17 Binary files /dev/null and b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/instapak.jpg differ diff --git a/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/rear-io-and-gpus.jpg b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/rear-io-and-gpus.jpg new file mode 100644 index 00000000..1b3c66be Binary files /dev/null and b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/rear-io-and-gpus.jpg differ diff --git a/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/rear-thumbscrews-latch.jpg b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/rear-thumbscrews-latch.jpg new file mode 100644 index 00000000..3306bd19 Binary files /dev/null and b/content/en/workstations/quickstart-guide/unboxing-and-setting-up-vector/rear-thumbscrews-latch.jpg differ