Osdag/C2/Installation-of-Osdag-in-Ubuntu/English

Title of the script: Installation of Osdag in Ubuntu

Author: Zahran Sajid

Keywords: Osdag, Installation, Ubuntu Linux, Terminal, Miniconda, sample design, Fin Plate, CAD model, conda, text editor, video tutorial.

Visual Cue	Narration
Slide: Title Slide	Welcome to the spoken tutorial on ‘Installation of Osdag in Ubuntu’.
Slide: Learning Objectives	In this tutorial, we will learn to: Download and install Osdag in Ubuntu Linux operating system Open Osdag through Terminal Verify the installation
Slide: System Requirements	To record this tutorial, I am using: Ubuntu Linux 20.04 Osdag version 2021(v2021.02.a.a12f) gedit text editor, and A working internet connection
Slide: Pre-requisites https://spoken-tutorial.org	To follow this tutorial, the user should be familiar with, Basic Linux commands A text editor in Linux, and Basics of structural steel design For prerequisite Linux and gedit Text Editor tutorials please visit this website.
Slide: Hardware Requirements	For a successful installation, we will need, 64-bit Ubuntu Linux 18.04 or later version Minimum of 4 GB RAM. Minimum of 4 GB hard disk space.
Slide: Code Files	The files used in this tutorial are available in the Code Files link. Please download and extract them. Make a copy and then use them while practising.
Show commands.txt using gedit	I have opened the commands.txt file in the gedit text editor on my system. You may use any other editor of your choice.
Only Narration Press Ctrl, Shift, and V keys to paste in the Terminal.	I will use the same file to copy the commands during the demonstration. Commands on the terminal can be pasted by pressing the Ctrl, Shift, and V keys together.
Only Narration	Let us first download the installer file from the Osdag website. Open any web browser of your choice.
Open Mozilla Firefox	I have opened the Mozilla Firefox web browser.
Type ‘osdag.fossee.in’ and press Enter	In the address bar type the URL ‘osdag.fossee.in’ and press Enter.
Cursor on the homepage of Osdag.	We see the homepage of the Osdag website.
Mozilla Firefox: Click on “Downloads” tab.	In the top menu bar, click on the Downloads tab.
Point toward the Downloads page	We will be redirected to the Downloads page. The Osdag installers for Ubuntu Linux and Windows operating system are listed here.
Scroll and point towards the release dates.	The installers are listed according to their release date.
Point towards 1. Installer [Release: 2021-02-15]	The topmost installer is for the latest version of Osdag.
Scroll the page to show the older versions.	Older versions of Osdag are listed below.
Mozilla Firefox: Click on Installer-Linux	Click on the Installer-Linux link.
Cursor in the Osdag page.	We will be redirected to the Osdag User Information Form page.
Mozilla Firefox: Show filled Osdag User Information Form	To download the Osdag Installer, the required details must be filled in. I have already filled the form.
Cursor in the form.	The details will be used for internal quality assessment purposes only. So, please do not hesitate to submit the details.
Click on Submit.	Click on Submit at the end of the form to start downloading the Osdag installer.
Point toward the Osdag_ubuntu_installer_v2021.02.a.a12f.tar.gz file in the Downloads directory	Osdag installer is now downloaded and saved to the Downloads directory on my system.
Only Narration	Let us proceed with the installation process.
Show terminal and gedit text editor opened side-by-side Press Ctrl + Alt + T keys to open the Terminal.	I have opened the terminal and gedit text editor. I will switch between them as required.
Only Narration	I will now go to the Downloads directory where I have saved the installer file. Users need to choose the directory where the installer file is saved.
Terminal: Type cd (space) Downloads and press Enter	In the terminal, I will type cd (space) Downloads and press Enter.
Cursor in the Terminal window.	Here on wards, please remember to press the Enter key after typing each command.
Terminal: Type ls and press Enter	Type ls to check whether the installer file is listed in the current directory.
Terminal: Point towards Osdag_ubuntu_installer_v2021.02.a.a12f.tar.gz file	The list shows the installer file.
gedit text editor: Copy tar -xvf Osdag_ubuntu_installer_v2021.02.a.a12f.tar.gz	To extract the installer file, copy the first command from the Code file.
Terminal: Paste in the Terminal and press Enter	Paste it in the terminal and press Enter.
Only Narration	Now we have to navigate into the extracted Osdag installer folder.
gedit text editor: Copy cd Osdag_ubuntu_installer_v2021.02.a.a12f	Copy the next command from the Code file.
Terminal: Paste in the Terminal and press Enter.	Paste it in the terminal and press Enter.
Slide: Installation Steps	Installing Osdag is a two-step process First step is to install Miniconda Second step is to install Osdag
Slide: What is Miniconda?	Conda is a cross-platform package manager. Miniconda is a minimal installer for conda. Conda installs, runs and updates the packages and their dependencies.
Show terminal and gedit text editor opened side-by-side.	Now, let us proceed with the installation.
gedit text editor: Copy bash 1-install-Miniconda3-latest-Linux-x86_64.sh.	For installing Miniconda, copy the third command from the Code file.
Terminal: Paste it in the Terminal and press Enter.	Paste it in the terminal and press Enter.
Terminal: Press Enter several times. Point to More on the terminal.	Press Enter several times to scroll through the Miniconda License page.
Terminal: Type yes and press Enter.	Type yes to approve the license terms and continue.
Cursor at the prompt. Only Narration.	Miniconda will prompt you for the location where it needs to be installed. By default, it will be installed in the user’s home directory. We can optionally specify another location of our choice. I will go ahead with the default location.
Terminal: Press Enter	Press Enter to confirm and proceed further.
Terminal: Type yes and press Enter	Type yes and press Enter to initialise Miniconda3 by running conda in it.
Point to the message.	We can see a message notifying the successful installation of Miniconda.
Close and reopen the Terminal by pressing the Ctrl, Alt and T keys together	I will close the terminal and then reopen it by pressing the Ctrl, Alt and T keys together.
Only narration	This step is necessary for the miniconda installation to take effect.
Only narration	Now we have to again navigate into the extracted Osdag installer folder.
Terminal: Type cd (space) Downloads and press Enter	In the terminal, I will type cd space Downloads and press Enter.
gedit text editor: Copy cd Osdag_ubuntu_installer_v2021.02.a.a12f	Copy the second command from the Code file.
Terminal: Paste in the Terminal and press Enter.	Paste it in the terminal and press Enter.
Only narration	Now let us proceed with the installation of Osdag.
gedit text editor: Copy bash 2-install-osdag.sh	For installing Osdag, copy the fourth command from the Code file.
Terminal: Paste in the Terminal and press Enter	Paste it in the terminal and press Enter.
Terminal: Point to the success message	Once the installation is complete, a success message is displayed. This means we have successfully installed Osdag in our system.
Only narration	By default, Osdag will be installed in the home directory. We can confirm this by checking our specified installation directory.
cd command.	Let us go to the home directory using the cd command.
Terminal: Type cd $HOME	Type cd $HOME
Only narration	Now we are in the home directory.
Terminal: Type ls and press Enter.	Type ls and press Enter.
Terminal: Point towards miniconda3 and Osdag directories.	We see ‘miniconda3’ and ‘Osdag’ directories listed under the home directory.
Cursor in the terminal.	We can also change the location of Osdag. To do so, simply move the Osdag directory to the preferred location.
Cursor in the terminal.	Let us now launch Osdag through the Terminal.
Terminal: Type cd Osdag.	To enter the Osdag directory, type cd space Osdag.
gedit text editor: Copy python osdagMainPage.py	To start Osdag, copy the last command from the Code file.
Terminal: Paste and press Enter	Paste the command in the terminal and press Enter.
Only Narration	It may take some time to open Osdag for the very first time.
Point towards the Osdag Interface	Now we can see the Osdag interface on the screen.
Only narration	Let us validate the installation by running a sample design example.
Osdag: Click on the Connection module	Click on the Connection module present at the top left side.
Click on Fin Plate image	Click on the Fin Plate image to select the module.
Click on Start	Click on the Start button below to launch the module.
Only narration	The module might take some time to launch.
Fin Plate Connection GUI: Click on File Load input	Go to the File menu present at the top left corner, and select Load input.
Open Design Window: Browse to the Code file directory	I will browse to the Code file directory.
Open Design Window: Select the FinPlate_sample_design.osi file and click on Open	Select FinPlate_sample_design.osi, and Click on the Open button.
Point toward the Input Dock fields	We see the input values are populated for our sample design example.
Cursor in the window.	We are now ready to perform the design.
Fin Plate Connection GUI: Click on the Design button	Click on the Design button at bottom to start.
Osdag: Point towards the CAD window and the Log messages window.	Osdag will display the CAD model and print log messages.
Point to the design.	This means that the design is complete. This indicates that the installation of Osdag is successful.
Only narration	This brings us to the end of this tutorial. Let us summarise.
Slide: Summary	In this tutorial, we have: Downloaded and installed Osdag on Ubuntu Linux operating system Opened Osdag through Terminal Verified the installation
Slide: About Spoken Tutorial Project	The video at the following link summarises the Spoken Tutorial Project. Please download and watch it.
Slide: Spoken Tutorial Workshops	The Spoken Tutorial Project team conducts workshops and gives certificates. For more details, please write to us.
Slide: Answers for THIS Spoken Tutorial	Do you have questions in THIS Spoken Tutorial? Please visit this website. Choose the minute and second where you have the question. Explain your question briefly. The Spoken Tutorial project will ensure an answer. You will have to register to ask questions.
Slide: FOSSEE Forum	For any general or technical questions on Osdag, visit the FOSSEE forum and post your question
Slide: Acknowledgements	The Spoken Tutorial project is funded by the Ministry of Education, Government of India
Slide: Thank you	This is Zahran Sajid, a FOSSEE summer fellow 2022, IIT Bombay signing off Thanks for joining.

Contributors and Content Editors

Anandajitht, Danish, Madhurig