Open Source Ecology - User contributions [en]

Create ZIM from OSE Wiki

2021-04-24T19:52:10Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using zimmer, as this seems to be the easiest option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do). 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A mysql server 
apache 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/Zimmer==
Zimmer can be found at [https://github.com/vadp/zimmer github], to install we need nodejs. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install nodejs

We also need zimwriterfs installed. There are binaries for Linux [https://download.openzim.org/release/zimwriterfs here], so downloading can look about like that:

wget "https://download.openzim.org/release/zimwriterfs/zimwriterfs_linux-x86_64-1.3.5.tar.gz"
tar -xzf zimwriterfs_linux-x86_64-1.3.5.tar.gz
mv zimwriterfs_linux-x86_64-1.3.5/zimwriterfs .
sudo chmod +x ./zimwriterfs

Now we can install zimmer:

npm i -g git+https://github.com/vadp/zimmer

The Zimmer is basically a scraper, scanning the wiki for all pages and downloading them in a way that zimwriterfs can work with them. The command for the scraping to start is:

wikizimmer http://127.0.0.1/wiki/Main_Page

This may take, depending on the system, a long time, so run it with nohup, screen or similar. When its done, first get a favicon and save it as favicon.png in the newly created directory. Now you can use zimwriterfs to create the actual zim file.

./zimwriterfs --welcome=A/Main_Page.html --favicon=favicon.png --language=eng --title="OSEWiki" --description="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, sustainable, post-scarcity economy." --creator="Marcin Jakubowski" --publisher="ENTERYOURNAME" ./127.0.0.1 osewiki_en_all_YEAR-MONTH.zim

The naming is important, for the android app will only successfully interact with the zim if the naming format is provided like this. 
The command should take a bit, after it's done, there is a new zimfile, congratulations!

==Test of the scraped material==
For testing how many pages were scraped, the following steps are advised: 
Get number of scraped pages (when inside the directory created by the scraper, no redirects included):

find A -type f | wc -l

Get number of scraped images:

find I -type f | wc -l

For the amount of pages (redirects included) and the amount of uploaded files (not only images) on the wiki, visit http://127.0.0.1/wiki/Special:Statistics?action=raw 

==Download==

===2019-08===
The first archive of our wiki (from 08-18-2019) is available on archive.org: https://archive.org/details/osewiki_en_all_2019-08

It can be downloaded [https://archive.org/download/osewiki_en_all_2019-08/osewiki_en_all_2019-08.zim here]

===2021-04===
The linked file is not working for unknown reasons, until this is fixed you can get it from my personal cloud:
[https://nextcloud.philobyte.com/s/8Q6PyNrMkmfj2Jb here]

Create ZIM from OSE Wiki

2019-08-21T10:03:24Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using zimmer, as this seems to be the easiest option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do). 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A mysql server 
apache 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/Zimmer==
Zimmer can be found at [https://github.com/vadp/zimmer github], to install we need nodejs. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install nodejs

We also need zimwriterfs installed. There are binaries for Linux [https://download.openzim.org/release/zimwriterfs here], so downloading can look about like that:

wget "https://download.openzim.org/release/zimwriterfs/zimwriterfs_linux-x86_64-1.3.5.tar.gz"
tar -xzf zimwriterfs_linux-x86_64-1.3.5.tar.gz
mv zimwriterfs_linux-x86_64-1.3.5/zimwriterfs .
sudo chmod +x ./zimwriterfs

Now we can install zimmer:

npm i -g git+https://github.com/vadp/zimmer

The Zimmer is basically a scraper, scanning the wiki for all pages and downloading them in a way that zimwriterfs can work with them. The command for the scraping to start is:

wikizimmer http://127.0.0.1/wiki/Main_Page

This may take, depending on the system, a long time, so run it with nohup, screen or similar. When its done, first get a favicon and save it as favicon.png in the newly created directory. Now you can use zimwriterfs to create the actual zim file.

./zimwriterfs --welcome=A/Main_Page.html --favicon=favicon.png --language=eng --title="OSEWiki" --description="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, sustainable, post-scarcity economy." --creator="Marcin Jakubowski" --publisher="ENTERYOURNAME" ./127.0.0.1 osewiki_en_all_YEAR-MONTH.zim

The naming is important, for the android app will only successfully interact with the zim if the naming format is provided like this. 
The command should take a bit, after it's done, there is a new zimfile, congratulations!

==Test of the scraped material==
For testing how many pages were scraped, the following steps are advised: 
Get number of scraped pages (when inside the directory created by the scraper, no redirects included):

find A -type f | wc -l

Get number of scraped images:

find I -type f | wc -l

For the amount of pages (redirects included) and the amount of uploaded files (not only images) on the wiki, visit http://127.0.0.1/wiki/Special:Statistics?action=raw 

==Download==

The current version (from 08-18-2019) is now on archive.org, it can be downloaded [https://archive.org/download/osewiki_en_all_2019-08/osewiki_en_all_2019-08.zim here]

Create ZIM from OSE Wiki

2019-08-20T12:32:14Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using zimmer, as this seems to be the easiest option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do). 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A redis server 
A mysql server 
apache 
parsoid (running on port 8000) 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/Zimmer==
Zimmer can be found at [https://github.com/vadp/zimmer github], to install we need nodejs. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install nodejs

We also need zimwriterfs installed. There are binaries for Linux [https://download.openzim.org/release/zimwriterfs here], so downloading can look about like that:

wget "https://download.openzim.org/release/zimwriterfs/zimwriterfs_linux-x86_64-1.3.5.tar.gz"
tar -xzf zimwriterfs_linux-x86_64-1.3.5.tar.gz
mv zimwriterfs_linux-x86_64-1.3.5/zimwriterfs .
sudo chmod +x ./zimwriterfs

Now we can install zimmer:

npm i -g git+https://github.com/vadp/zimmer

The Zimmer is basically a scraper, scanning the wiki for all pages and downloading them in a way that zimwriterfs can work with them. The command for the scraping to start is:

wikizimmer http://127.0.0.1/wiki/Main_Page

This may take, depending on the system, a long time, so run it with nohup, screen or similar. When its done, first get a favicon and save it as favicon.png in the newly created directory. Now you can use zimwriterfs to create the actual zim file.

./zimwriterfs --welcome=A/Main_Page.html --favicon=favicon.png --language=eng --title="OSEWiki" --description="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, sustainable, post-scarcity economy." --creator="Marcin Jakubowski" --publisher="ENTERYOURNAME" ./127.0.0.1 osewiki_en_all_YEAR-MONTH.zim

The naming is important, for the android app will only successfully interact with the zim if the naming format is provided like this. 
The command should take a bit, after it's done, there is a new zimfile, congratulations!

==Test of the scraped material==
For testing how many pages were scraped, the following steps are advised: 
Get number of scraped pages (when inside the directory created by the scraper, no redirects included):

find A -type f | wc -l

Get number of scraped images:

find I -type f | wc -l

For the amount of pages (redirects included) and the amount of uploaded files (not only images) on the wiki, visit http://127.0.0.1/wiki/Special:Statistics?action=raw 

==Download==

The current version (from 08-18-2019) is now on archive.org, it can be downloaded [https://archive.org/download/osewiki_en_all_2019-08/osewiki_en_all_2019-08.zim here]

Create ZIM from OSE Wiki

2019-08-20T11:46:58Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using zimmer, as this seems to be the easiest option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A redis server 
A mysql server 
apache 
parsoid (running on port 8000) 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/Zimmer==
Zimmer can be found at [https://github.com/vadp/zimmer github], to install we need nodejs. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install nodejs

We also need zimwriterfs installed. There are binaries for Linux [https://download.openzim.org/release/zimwriterfs here], so downloading can look about like that:

wget "https://download.openzim.org/release/zimwriterfs/zimwriterfs_linux-x86_64-1.3.5.tar.gz"
tar -xzf zimwriterfs_linux-x86_64-1.3.5.tar.gz
mv zimwriterfs_linux-x86_64-1.3.5/zimwriterfs .
sudo chmod +x ./zimwriterfs

Now we can install zimmer:

npm i -g git+https://github.com/vadp/zimmer

The Zimmer is basically a scraper, scanning the wiki for all pages and downloading them in a way that zimwriterfs can work with them. The command for the scraping to start is:

wikizimmer http://127.0.0.1/wiki/Main_Page

This may take, depending on the system, a long time, so run it with nohup, screen or similar. When its done, first get a favicon and save it as favicon.png in the newly created directory. Now you can use zimwriterfs to create the actual zim file.

./zimwriterfs --welcome=A/Main_Page.html --favicon=favicon.png --language=eng --title="OSEWiki" --description="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, sustainable, post-scarcity economy." --creator="Marcin Jakubowski" --publisher="ENTERYOURNAME" ./127.0.0.1 osewiki_en_all_YEAR-MONTH.zim

The naming is important, for the android app will only successfully interact with the zim if the naming format is provided like this. 
The command should take a bit, after it's done, there is a new zimfile, congratulations!

==Test of the scraped material==
For testing how many pages were scraped, the following steps are advised: 
Get number of scraped pages (when inside the directory created by the scraper, no redirects included):

find A -type f | wc -l

Get number of scraped images:

find I -type f | wc -l

For the amount of pages (redirects included) and the amount of uploaded files (not only images) on the wiki, visit http://127.0.0.1/wiki/Special:Statistics?action=raw 

==Download==

The current version (from 08-18-2019) is now on archive.org, it can be downloaded [https://archive.org/download/osewiki_en_all_2019-08/osewiki_en_all_2019-08.zim here]

Christian Rupp Log

2019-08-20T01:55:33Z

Christian:

{{Status|... Printer Cluster |Post bio on Developers page, Jitsi, Wordpress(?), ISO |...}}
{{RightTOC}}

[[D3D Log]]. [[Development Team Log]]. [[Marcin Log]].
[https://hangouts.google.com/hangouts/_/event/cfvdskolaipjgki95aoufjf3l50?hl=en&authuser=0 OSE Hangout] [https://meet.jit.si/SelfishStarsConjureHeroically Jitsi Meetup].

<html><iframe width="700" height="600" src="https://osedev.org/wiki/Christian"></iframe></html>

=Mon Aug 20, 2019=
Successful creation of an offline version of the wiki in the zim format. Documented the process [https://wiki.opensourceecology.org/wiki/Create_ZIM_from_OSE_Wiki here]. Also contacted Kiwix so they may add this to their repository, as this would make public distribution of the wiki easier.

=Thu Oct 26, 2017=
Documented my Setup, uploaded everything and wrote a HowTo for booting up from USB with all eventualities (2h)

=Wed Oct 25, 2017=
Made the next Iteration for OSELinux, now with working exploded part diagrams, all requested software, working arduino and cura (its now possible to write the code to the arduino/print with cura). Lastly, the Wallpaper seems to work fine now. This version also uses the us version ISO as a basis, for fixing some minor issues in the default settings.
As this seems to fix everything requested, I've called this iteration 1.0. I will now pause the project until further features are requested.
The new version can be found here:
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]
(5h)

=Tue Sep 12, 2017=
Wrote down how the ISO can be created and customized
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]

=Sun Sep 3, 2017=
Breakthrough with the ISO creation. The software used fixes the errors encountered with the current version. Furthermore, due to the possibility of better testing I could prove my concept of the jitsi plugin, its functional. Additionally, I could test the /etc/skel directory, and its working, further customized settings can now be integrated. I did nearly everything wished from the list (including the new debsum package, which is a reasonable add), including the vocoscreen settings and the freecad macro, and added all up to a new, tested version of the ISO which will go online tomorrow.

There are however (little) flaws left:

For some reason, arduino wont work properly unless started as root, this may however be system specific and basically fixable by running

sudo adduser $USER dialout

maybe I'm able to integrate that in the basic startup process, this may however be complicated. I could also write a little script that starts the program but requires root rights so the user is prompted to provide it.

Additionally there are settings to do regarding cura and blender, however I'm completely unfamiliar with those, this looks like something an expert provides for me (if anyone says he/she knows the perfect setup, contact me!)

Additionally I worked on the OSE server (or, more like it, setup a client on my side). (6h)

=Thu Aug 31, 2017=
Workstation at home is now functional, found a software perfect for our needs, however it still has some flaws to be corrected, I had to comment out some bad source code, its working, documentation follows. the used software is

https://github.com/kamilion/customizer

And its taking out all hazzle with setting up the ISO, and rounds all up with a neat GUI, however lacks of a simple changer of Desktop Enviroments (however, this is kind of luxury, we can just work with xubuntu, lubuntu etc) (5h)

=Sat Aug 26, 2017=
Setup a new workstation here, however didnt work, several errors here, may take some time... (2h)

=Thu Aug 24, 2017=
Unfortunately, I have some hardware problems, but the first version of the ISO is available [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here].

Due to my problems the features explained yesterday are NOT included, but giving out the ISO to find out what default settings suits us best should help getting out a better version.

=Wed Aug 23, 2017=
Did some research with very encouraging results, two processes in particular:

The [https://wiki.ubuntuusers.de/Ubuntu_Customization_Kit/ Ubuntu Customization Kit] lets you create an ISO with a gui and further very easy options in contrast to the very confusing commands to otherwise setup a chroot.

The customization of the 'default user': from that Page, I also derived information on how to customize the users that get created (on starting the live version for instance). This makes a custom desktop possible as well as custom settings for any program imaginable. (1,5h)

=Tue Aug 22, 2017=
Finished the update, got many things to work, got to test the result yet with virtualbox, I'll do that tonight.
Those things were not (yet) possible:

Setting other defaults for vokoscreen (consists only of one binary, personal settings are created for specific user)

Adding the printer to Cura (Although it is probably possible, it basically has the same problem as the above, I'll document further info)

Adding the Macro to freecad (Is also saved into the users folder per default, as there are no macro examples, I couldnt slip it in somewhere)

This means that I placed those files in the /opt folders for further access. (2,5 h) Download link follows after the testing was done.

=Mon Aug 21, 2017=
Updated the iso with some new information, optimized a few steps and tested that (1,5h)

=Thu Aug 17, 2017=
Created a new ISO for OSE Linux, including new software and updating existing. Added new software and some special settings, however not all wishes could be fulfilled, documentation follows (I've shortened the installation process). (4h)

=Wed Aug 16, 2017=
Piwik seems to be highly insecure, so some research had to be done. Probably we'll be switching to Open Web Analytics.

Setup of wordpress for Jose, unfortunately the URL has to be adjusted yet (3h)

=Tue Aug 15, 2017=
Unfortunately, there were serveral issues on the way, primarily coming from the security side... Had to research further and talk with michael about further steps

=Sat Aug 12, 2017=
Got to work on piwik, some problems occured, about half way (hopefully) through. (4h)

=Tue Aug 8, 2017=
Talked with Marcin and Michael about server security. (2h)

=Sat Jul 27, 2017=
Researched my docs about the https encryption, looked through the basic system of piwik and the usual safety-measures. Prepared everything on server for setup (root access still required). (4h)

=Thu Jul 27, 2017=
Took a while to figure out the errors, there were two; rc.local had the wrong permissions, I added the necessary steps to the instructional, and a classic mistake in the Scanner (intendation error...), not quite sure where that came from.

Additionaly I figured out how to make the image for distribution only as small as the files contained, other than the size of my SD card (which would make the use of a 4 GB SD card impossible). All is now uploaded, corrected, tested and well. (5h)

=Wed Jul 26, 2017=
Started the documentation of the testing and created a main article on the printer cluster, including all the used ressources, install instructions, testing results and all the information I collected while I was setting up and configuring the image.
All of this is now collected here: [[3d_Printer_Cluster]]

However, I was confronted with problems on the image I was uploading to my drive, I'll have to redo some things there... (4h)

=Tue Jul 25, 2017=
Got the testing scenario right, tested on and finished.

Did refurbish the code a bit and uploaded the new version.

The Image is now collected and done, it lays in my drive right here [https://drive.google.com/file/d/0ByUmXv7QXHeQLXdEbG55MlM2eXM/view?usp=sharing Printer Cluster] for installation, just follow these Instructions [[How_to:Write_Image_to_SD_Card]]. More detailed Documentation tomorrow. (7h)

=Mon Jul 24, 2017=
Started testing, couldn't however communicate with the Marlin; possible solutions:

1. Marlin wasn't setup properly: check by sending GCode via USB from a 3d print software.

2. Pins aren't setup properly: May need its power from the USB to UART, not only ground... (till now, I power comes from USB)

3. Contact protocol is wrong: Check the Bitrate (with step 1) and the /dev folder on whats appearing on plugging in

=Sat Jul 22, 2017=
Took part of the sprint for the CEB Press, I did insert new rods

Also stayed for the filament extruder. As there was nothing to do for me, I setup my freshly arrived Ardurinos
. All thats missing now for testing is the USB to UART converter, I can and will pick it up on monday (5h)

=Fri Jul 21, 2017=
Preparated the software for testing, adding slicing profile to script, configured Marlin, ready for the ardurinos to arrive(3,5h)

=Thu Jul 20, 2017=
Talked with Michael on how I can help administering the server (1h)

=Wed Jul 19, 2017=
I was given the task of making the wiki more accessible, so I asked myself

How can we organize the current information on the wiki?

The sites have to be hierarchical, so there are main sites, that redirect to more specific undercategories. Crossreferences are no problem of course, this is only about quickly aquiring information. This means also that those hierarchical links should be displayed prominently. For organising the information in that way, we have to map the wiki first, so we can manually decide how the every site should be reachable from the main page.

The following tools will therefore be of use:

[https://www.mediawiki.org/wiki/Extension:VIKI Visualization of the Links]

[https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki_Graph Simpler Variant, maybe interesting if we have to modify the script]

[https://www.mediawiki.org/wiki/Manual:GenerateSitemap.php This way we not only can see every site, we can also make it easier for google users to spot specific site of the wiki]

Additionaly, I ordered the more parts necessary for setting up a printer cluster on my own (at least the software-site). Documentation will follow when I start the setup (2h)

=Friday Jul 14, 2017=
Setup the Pi with marcin, gave me SSH access cia DynDNS (4,5h)

=Wednesday Jul 12, 2017=
Learned about AT code, about how to connect with the RC12 module and some other details for setting up the transceiver (2h)

=Tuesday Jul 11, 2017=
Tried to setup the SD card with Marcin, failed because of different errors (2h)

=Sun Jul 9, 2017=
Written a definite manual on how to setup software and hardware in its entirety. The instructions are in the google spreadsheet seen below (Jun 27). (0,5h)

=Sat Jul 8, 2017=
Had some thinking about security, user internal permission restrictions. Would be a pain to explain it all, however, solved it by running scanner on systemstart (there it is always run as root) and trigger the running by a variable settable by the website (clicking on the button).

Additional, reboot works now (and it should now be easy to implement further commands if necessary).

Lastly, some little code optimization (looks far more convenient now), renaming of the host to replab (this is now also what you type into search bar for accessing the website) and I licensed the files under the GPLv3. (6h)

That means the user interface is done and ready for testing. Changes will now only impact the Scanner and Maybe some design wishes (I'm open for requests) for the website.

=Fri Jul 7, 2017=
Took longer than expected, but the uploader contains now a drag and drop and accepts mutliple uploads at once and mirrors the design of the website. (5h)

=Thu Jul 6, 2017=
Integrated the script into the Web Interface, the current model allows an upload via the 3dPrinter website. The upload then automatically converts the file into stl. Currently, the upload allows fcstd and stl files. The Upload blocks the website for the uploader until the upload is complete, after that, the file is already accessible in the Octoprint interface.

The upload is should take about a second per 20 kb of fcstd converting. This means, a 60 kb file takes 3 seconds of 'uploading'. (4h)

Drag and drop and a neater upload interface will be the next goal.

=Wed Jul 5, 2017=
Designed a script to convert fcstd to stl. It's tested and working, however it seems not to work perfectly with all Parts.
I think this is not fault of the script but of freecad. It seems to impact only very complex forms, so I hope it won't impact our work. The script will be added to the zip as soon as it is implemented into the website. (3h)

=Tue Jul 4, 2017=
Wiped the Testpi end redeployed it in the simplest way possible and wrote the instructions down here [[How_to:_Create_Printer_Cluster_Image]] (1h)

=Mon Jul 3, 2017=
Added Lazyload to the iframes for a maximum of performance, added buttons for server management (reboot etc.), merged all data to a zip file with a how to, taking [https://octopi.octoprint.org/ octopi] as a basis. Package will be tested by me tomorrow. (3h)
[[File:PrinterClusterData.zip]]

=Sun Jul 2, 2017=

Wrote a webtemplate for managing multiple instances of octoprint,

additionaly step by step instructions to make the OSE Printer Cluster image out of the octopi (8 h)

=Sat Jul 1, 2017=

Worked on Scanscript, ready for testing (6h)

=Fri Jun 30, 2017=

Got a SD card setup with octopi and written a documentation about how to do it right here

[[How_to:Write_Image_to_SD_Card]]

The Image itself btw can be found here

[https://octopi.octoprint.org/ Octopi]

The hardware setup is displayed in the presentation already, so there is nothing holding us back from testing the software upon a printer.
Additionaly, I've figured out some of the missing pieces and began writing a python script for autorecognition of the 3d printers.
(5h)

=Thu Jun 29, 2017=

Got a step-by step plan about what should be done, learned about the G-Code and found those of interest for me from Marlin.
(M115 gives me unique Data about the printer, M20 to M30 are used to read, write to the sd card and start the printing process from there)
Found out how to reformat fcstd to stl with command line only (for automatic conversion on upload).
(1,5h)

=Tue Jun 27, 2017=

<html><iframe src="https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/embed?start=false&loop=false&delayms=3000" frameborder="0" width="480" height="299" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe></html>

[https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/edit#slide=id.g1e7b20ee3a_0_10 edit]

Researched Methods for cluster management, communication between printer and computer etc.
Most Promising:
[https://github.com/foosel/OctoPrint Octoprint]

This can be run for [http://blog.patshead.com/2016/02/control-multiple-3d-printers-using-a-single-raspberry-pi-with-octoprint.html several printers]

Hardware is defined and set, list and setup in the presentation.
Very rough price estimate: 45 $ + 20$/printer(5h)

=Sun Jun 25, 2017=
Finished FreeCAD test, Video is uploaded to youtube.
https://www.youtube.com/watch?v=nkDFKByIPfE (about 7h)

Create ZIM from OSE Wiki

2019-08-20T01:52:17Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using zimmer, as this seems to be the easiest option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A redis server 
A mysql server 
apache 
parsoid (running on port 8000) 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/Zimmer==
Zimmer can be found at [https://github.com/vadp/zimmer github], to install we need nodejs. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install nodejs

We also need zimwriterfs installed. There are binaries for Linux [https://download.openzim.org/release/zimwriterfs here], so downloading can look about like that:

wget "https://download.openzim.org/release/zimwriterfs/zimwriterfs_linux-x86_64-1.3.5.tar.gz"
tar -xzf zimwriterfs_linux-x86_64-1.3.5.tar.gz
mv zimwriterfs_linux-x86_64-1.3.5/zimwriterfs .
sudo chmod +x ./zimwriterfs

Now we can install zimmer:

npm i -g git+https://github.com/vadp/zimmer

The Zimmer is basically a scraper, scanning the wiki for all pages and downloading them in a way that zimwriterfs can work with them. The command for the scraping to start is:

wikizimmer http://127.0.0.1/wiki/Main_Page

This may take, depending on the system, a long time, so run it with nohup, screen or similar. When its done, first get a favicon and save it as favicon.png in the newly created directory. Now you can use zimwriterfs to create the actual zim file.

./zimwriterfs --welcome=A/Main_Page.html --favicon=favicon.png --language=eng --title="OSEWiki" --description="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, sustainable, post-scarcity economy." --creator="Marcin Jakubowski" --publisher="ENTERYOURNAME" ./127.0.0.1 osewiki_en_all_YEAR-MONTH.zim

The naming is important, for the android app will only successfully interact with the zim if the naming format is provided like this. 
The command should take a bit, after it's done, there is a new zimfile, congratulations!

OSE Linux - 2.0 version from 2020

2018-07-21T13:54:43Z

Christian: Maintainer has chosen to delete the Google Drive Account. Still served via Archive. If problems occur, further mirrors can be added.

{{Hint|OSE Linux is an Ubuntu 16.04 distribution with all of OSE's software, FreeCAD macros, Cura settings, and Marlin configured for the OSE 3D printer. Releases occur quarterly with updates. [[OSE_Linux#Requests_and_Notes]] shows required updates.}}
=What is It?=

[[Image:oselinux.jpg|thumb|OSE software stack.]]

'''OSE Linux''' is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

==OSE Linux at Workshops==
For reasons of software uniformity, we like to use OSE Linux. Our experience with prior workshops at OSE which involve software training was that always there was someone who could not run some software properly, or there would be some differences in the software on different platforms. This typically obstructed smooth progress of everyone following along during software training. For this reason, we like to use OSE Linux live, so that everyone has the exact same copy. All that people need to do is to boot from our USB. Once booted, uniform results are pretty much guaranteed. Thus, we begun using OSE Linux in 2017 as a regular practice during OSE workshops - where participants are instructed to either make their own USB at home - or we provide the USB at the OSE site.

==Software List==
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=Download and Install OSE Linux Live ISO=

==v2017-10==

Download the [https://en.wikipedia.org/wiki/ISO_image .ISO Image] file below. This will then be installed onto a USB flash drive to create a [https://en.wikipedia.org/wiki/Live_USB Live USB].

* [https://archive.org/details/OSELinux1.0 Internet Archive]
* [https://archive.org/details/OSELinux1.0 Torrent]
* [magnet:?xt=urn:btih:1b86fa4bdccea4308a115f7f0dbe9eeb93f37fe2&dn=OSELinux1.0&tr=http%3a%2f%2fbt1.archive.org%3a6969%2fannounce&tr=http%3a%2f%2fbt2.archive.org%3a6969%2fannounce&ws=http%3a%2f%2fia601504.us.archive.org%2f24%2fitems%2f&ws=http%3a%2f%2fia801504.us.archive.org%2f24%2fitems%2f&ws=https%3a%2f%2fia801504.us.archive.org%2f24%2fitems%2f Magnet Link]

==How To Create an OSE Linux USB using Ubunutu==

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
For Setting up the USB stick, follow the instructions [[How_to:Write_Image_to_SD_Card]], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

3. Boot your computer with the USB. See [[OSE Linux#Getting Started]]

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version''' 
<html><video height="400" controls>
<source src="https://wiki.opensourceecology.org/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

==How To Create an OSE Linux USB using Windows==

[https://rufus.akeo.ie/#download Download Rufus]

<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==How To Create an OSE Linux USB using Mac==

'''[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785 How To Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X - github]'''

'''Download'''

Download the latest OSE Linux ISO disk image [[OSE_Linux#Download_and_Install_OSE_Linux_Live_ISO]]. Please note there may be two disk images to choose from: a **standard disk image** and a **hybrid disk image** [https://docs.google.com/document/d/1SnCg3IMGULNH21Vm6h-RDRC7yRf362HrahrUEOb7CcY/edit source]. The hybrid disk image is preferred.

'''Insert your USB Stick and determine its device identifier'''

# Insert USB stick
# Open a Terminal window
# Determine USB stick device ID: `diskutil list`

<nowiki>

$ diskutil list
...
/dev/disk3 (external, physical):
#: TYPE NAME SIZE IDENTIFIER
0: *16.0 GB disk3
</nowiki>

'''Create a bootable USB Stick from a hybrid disk image'''

Using a hybrid ISO disk image is by far the simpler approach as you just overwrite the entire USB stick.

# Unmount all partitions on device: `diskutil unmountDisk [Device ID]`
# Copy ISO: `sudo dd if=[Path to ISO] of=[Device ID] bs=1048576`
#* Press CTRL+T to send a SIGINFO signal to `dd` to track progress [http://osxdaily.com/2015/06/05/copy-iso-to-usb-drive-mac-os-x-command/#comment-1718523 source]

<nowiki>

$ diskutil unmountDisk /dev/disk3
Unmount of all volumes on disk3 was successful
$ sudo dd if=~/Downloads/ose0.3isohybrid.iso of=/dev/disk3 bs=1048576
2142+0 records in
2142+0 records out
2246049792 bytes transferred in 1841.710284 secs (1219546 bytes/sec)
</nowiki>

The partition is automatically marked as as bootable.

Eject USB Stick: `diskutil eject [Device ID]`

<nowiki>

$ diskutil eject /dev/disk3
Disk /dev/disk3 ejected
</nowiki>

And you're good to go.

=Getting Started=
'''Instructions for using OSE Linux for the first time'''

==Booting Up and BIOS Settings==

After powering on your computer, but before your normal operating system starts, you can access your boot settings.

'''Boot target computer from USB Stick'''

First, configure the BIOS to prioritize booting from a USB drive. In my case, I'm installing on an HP Spectre x360 laptop [http://h30434.www3.hp.com/t5/Notebook-Operating-System-and-Recovery/How-to-boot-from-USB-flash-drive-HP-Spectre-x360/td-p/5032935].

# Power up HP Spectre x360
# Press `F10` to enter the BIOS
# Navigate to System Configuration
# Select Boot Options
## Disable Secure Boot
## Enable Legacy Boot
## In UEFI Boot Order move USB Diskette to top of list
## In Legacy Boot Order move USB Diskette to top of list
# Press `F10` to save changes and exit BIOS

Your system will restart, recognize the USB Stick, and boot its contents.

_For existing Linux systems with a boot manager installed, you may still need to intervene to select an alternative boot option. Press `F9` to enter Boot Options and choose the USB Disk._

 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

==Software Tutorials==

*[[FreeCAD 101]]
**[[Old FreeCAD Tests]]
*[https://en.wikibooks.org/wiki/OpenSCAD_User_Manual OpenSCAD wikibook]

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

=Troubleshooting=
*[[How to Troubleshoot Wireless on OSE Linux]]

=OSE Linux Development=
'''This section is used by developers making OSE Linux'''

==How To Create the ISO File Using Ubuntu==
We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==TODO==

This section will enumerate items for OSE Devs to work on for upcoming versions of OSE Linux.

===Requests and Notes===
*7/18 - Sweet Home 5.7 update
*7/18 - [[FlatCAM]] - used to generate toolpaths for D3D CNC Circuit Mill
*7/18 -[[QT]]- used to create Copper Carve
*7/18 -Copper Carve - [http://opencircuitinstitute.org/content/oci-copper-carve]. Used to control D3D CNC Circuit Mill. Ask Shane Oberloier
*7/18 -Processing addition (oscilloscope)
*6/18 -Piping library addition to FreeCAD
*6/18 -FEA addition to FreeCAD
*6/21/18 - '''[[u8glib]] addition to D3D Marlin
*6/5/18 - Webm output of Kdenlive does not play without downloading extra packages. Make it play by downloading the appropriate software
** try installing vlc
*6/5/18 - Note that screen sharing in Jitsi Meet does not work in Chromium. Proper extensions need to be added.
*4/25/18 - Pronterface should be added to OSE Linux. This may help troubleshooting of printing.
*4/25/18 - Chromium allows only 3 or so tabs to be open before tabs no longer open, and a new Chromium window needs to be opened.
*4/23/18 - bug report. Downloaded http://opensourceecology.org/w/images/9/9b/OSE_Marlin.zip - and this could not be extracted on my desktop - "An error occurred while loading the archive". Extraction worked on another computer.
*4/23/18 - When trying to use Marlin from another USB - Could not open OSE Marlin (from another USB drive). Archive type not supported.
*Improve video - add which navigation style to use, and how to select a rotation plane. Next, use OSE Linux for the video, to remove any possibility of version difference. We should be able to teach someone Cube Readiness in 2 hours, and 3 more hours for video etc.
*2/1/18 - [[PVC Pipe and Fittings Library]] - verified that pipe, cross, elbow, alpha elbow, tee, and couplings now work in OSE Linux 1.0. These, combined with their 5 supporting CSV files, can now be added to OSE Linux.
*3/16/18 - SweetHome3D icon does not appear in applications menu, only in search box. Can we put it in the menu?

===Requirements===
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

===Persistence===

We need to build in a simple way to persist data between reboots.

Marcin would like to be able to use OSE Linux full-time, but he would need to have his ssh key, keepass, etc all persisted between reboots. This, in general, is a necessary feature for anything more than "trying out" a distro. Because this data can be sensitive in nature (ie: ssh keys for logging into hetzner2), all persistent volumes should necessarily be encrypted.

The best experience I've had with Persistence in live distros was TAILS. There's no `dd` on the user side. They just go to "Applications -> System Tools -> Configure persistent volume", and set it up with the GUI.

TAILS is based on debian, as is OSE Linux, so I think this is a good place to start looking for how we can enable persistence in OSE Linux:

# https://tails.boum.org/contribute/design/persistence/#index3h2
# https://git-tails.immerda.ch/persistence-setup

For more info on this implementation, see [[OSE Linux Persistence]]

===Hashes & Signatures===

For every release of OSE Linux, there should be at least the following files in addition to the iso (arch specific) images:
# MD5SUMS
# MD5SUMS.gpg
# SHA1SUMS
# SHA1SUMS.gpg
# SHA256SUMS
# SHA256SUMS.gpg

This follows the standards as used by debian/ubuntu. For example, see the set of release files for ubuntu 18.04 here:

* https://mirrors.ocf.berkeley.edu/ubuntu-releases/18.04/

By following this procedure, we would provide a means for our users (after--say--spending many, many hours downloading the iso over a high-packet-loss sattelite internet connection) to validate that there was no corruption before they burn the image to a drive (a simple & fast step that can save days of debugging). Moreover, by releasing a cryptographic signature of these checksum files, we provide a means of authentication.

Note that, following best operational security practices, the cryptographic signature should be made from a subkey that is signed by an OSE primary key. The primary key should be in cold storage and only used on an air-gapped machine to sign subkeys. Those subkeys (which can be rotated) are the keys that are actually used to sign our releases' checksum files. For more information on this, see this [https://tails.boum.org/doc/about/openpgp_keys/index.en.html TAILS OpenPGP keys doc]

===OSE Linux Assists in Providing Technical Support===
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Version Change Log=
'''Oct 25 2017 - Version 1.0 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQUkdrdXpHLUgtckk here], [magnet:?xt=urn:btih:1b86fa4bdccea4308a115f7f0dbe9eeb93f37fe2&dn=OSELinux1.0&tr=http%3a%2f%2fbt1.archive.org%3a6969%2fannounce&tr=http%3a%2f%2fbt2.archive.org%3a6969%2fannounce&ws=http%3a%2f%2fia601504.us.archive.org%2f24%2fitems%2f&ws=http%3a%2f%2fia801504.us.archive.org%2f24%2fitems%2f&ws=https%3a%2f%2fia801504.us.archive.org%2f24%2fitems%2f magnet]

'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here]

'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
OSE Live iso is named 4-28-17ose0.42.iso '''
The Download Link is [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing here]

'''February v0.3 release 
The Download Link is [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b here] 
Readme and Install Notes by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit Google Doc Link]

=Links=
* [[OSE Linux Persistence]]
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]
*https://en.wikipedia.org/wiki/List_of_tools_to_create_Live_USB_systems

=Maintainers=
*[[Christian Rupp]] - 2017-present
*[[Jai Kumar]] - 2017 intial version

OSE Linux Persistence

2018-07-14T19:01:31Z

Christian:

On this page, the functioning and creation of the Linux Live Distribution Persistence Script (LLD-Persistence for short) will be documented. It is written for the OSE Linux system, however its very general in its dependencies. In fact, probably any Linux Distribution supporting a Live Version will probably able to integrate this script without much hazzle. It is loosely based on Tails persistence implementation and written entirely in bash. It is hosted on Github right [https://github.com/WisdomCode/LLD-Persistence here].
For the usage, an USB Stick with '''at least 8 GB''' is needed.

==Purpose==
The purpose of this script is to create a persistent storage on a Live USB Stick. Without it, everything done on the Live OS will be deleted (or, to be more precise: never saved) from the USB and one starts with a fresh version. Although this can have advantages, it can be difficult for a normal workflow, as some personal files and settings may be necessary. This is where this Script comes in. It saves parts of the OS, which can then be recalled on the next start of the device. Because of the risky situation of having personal data on an easily loosable item like a Stick, the Data is securely encrypted.

==Usage==
The script has three modes, which are given as parameter on Start: 
0: A new persistent storage gets created. Only works when none is created already. 
1: The persistent storage is applied. This means all chosen files from now on are saved to persistence (more on that later). Only works if there is one. 
2: The persistent storage gets destroyed (shredded, no recovery possible!). 
 
All of those require root rights. This is however normally no problem on a live OS. .desktop files will follow to call those options from the normal menu.
It works with an easy to follow GUI. In Option 0 the user will be asked for a password for the creation. After that, one can choose what shall be made persistent. The script is highly modular in that regard and can be extended without much bash knowledge, at the moment the following Options exist:
Home Directory: This will make the entire home folder of the user persistent. This includes basically all personal settings and directories and things like the desktop. This is recommended.
Persistent Folder: A more minimalist approach. A new Folder gets created in the Home directory that will from now on be persistent. Useless together with Home Directory.
Network: Saves Network Settings. If used together with the Home Directory Option, this means saving also encrypted WIFI access (which will immediately be used after applying persistent storage).
Printer: Printer Settings are saved and applied. 
'''Note:''' Porting Network and Printer to another Distribution can cause problems, as these rely on the network-manager and cups. If those aren't used in the other distribution, this has to be modified.

After choosing, the persistent storage gets created and after a reboot, it can now be applied with option 1.
In Option 1, you will be asked for the password previously set. After that, its done!
Option 2 will ask you twice if your sure and, if you are, start the permanent deletion of the persistent storage. After that, it can be recreated with Option 0.

==Technique==
The script is based in bash, with the use of cryptsetup, parted, rsync and zenity. Bash needs to be 4.2 or higher, with very basic Tools available (sed, tail, grep, cut, shred). Most of those tools are available in every Linux distribution out of the box. If not, they can be found in the repository with near to absolute certainty. For Example, Ubuntu needs the cryptsetup installed via
sudo apt-get install cryptsetup
The Encryption done with LUKS. In Option 0, on the remaining disk space of the USB, a partition is created and enrypted. In there, a folder is created for each of the different persistence options. The folders are filled with the content of the original Folder with rsync. In Option 1, the device is mounted and every folder is mounted over there chosen counterpart. Therefore, each interaction with those folders is now saved onto the encrypted drive. In Option 2, shred is used to clean the partition. Lastly, the partition itself is removed.

==Todo==
The script is not entirely tested, its more like a beta, there may be very rough errors. It is not yet applicable for a normal use case!
Missing are the aforementioned desktop files, so the script can be called from the menu. After that, the applying of the persistence should be asked after login (or maybe even before?).
An install script should be written copying the script and the desktop files to their places and making them executable.

OSE Linux Persistence

2018-07-14T19:00:58Z

Christian:

On this page, the functioning and creation of the Linux Live Distribution Persistence Script (LLD-Persistence for short) will be documented. It is written for the OSE Linux system, however its very general in its dependencies. In fact, probably any Linux Distribution supporting a Live Version will probably able to integrate this script without much hazzle. It is loosely based on Tails persistence implementation and written entirely in bash. It is hosted on Github right [ here https://github.com/WisdomCode/LLD-Persistence ].
For the usage, an USB Stick with '''at least 8 GB''' is needed.

==Purpose==
The purpose of this script is to create a persistent storage on a Live USB Stick. Without it, everything done on the Live OS will be deleted (or, to be more precise: never saved) from the USB and one starts with a fresh version. Although this can have advantages, it can be difficult for a normal workflow, as some personal files and settings may be necessary. This is where this Script comes in. It saves parts of the OS, which can then be recalled on the next start of the device. Because of the risky situation of having personal data on an easily loosable item like a Stick, the Data is securely encrypted.

==Usage==
The script has three modes, which are given as parameter on Start: 
0: A new persistent storage gets created. Only works when none is created already. 
1: The persistent storage is applied. This means all chosen files from now on are saved to persistence (more on that later). Only works if there is one. 
2: The persistent storage gets destroyed (shredded, no recovery possible!). 
 
All of those require root rights. This is however normally no problem on a live OS. .desktop files will follow to call those options from the normal menu.
It works with an easy to follow GUI. In Option 0 the user will be asked for a password for the creation. After that, one can choose what shall be made persistent. The script is highly modular in that regard and can be extended without much bash knowledge, at the moment the following Options exist:
Home Directory: This will make the entire home folder of the user persistent. This includes basically all personal settings and directories and things like the desktop. This is recommended.
Persistent Folder: A more minimalist approach. A new Folder gets created in the Home directory that will from now on be persistent. Useless together with Home Directory.
Network: Saves Network Settings. If used together with the Home Directory Option, this means saving also encrypted WIFI access (which will immediately be used after applying persistent storage).
Printer: Printer Settings are saved and applied. 
'''Note:''' Porting Network and Printer to another Distribution can cause problems, as these rely on the network-manager and cups. If those aren't used in the other distribution, this has to be modified.

After choosing, the persistent storage gets created and after a reboot, it can now be applied with option 1.
In Option 1, you will be asked for the password previously set. After that, its done!
Option 2 will ask you twice if your sure and, if you are, start the permanent deletion of the persistent storage. After that, it can be recreated with Option 0.

==Technique==
The script is based in bash, with the use of cryptsetup, parted, rsync and zenity. Bash needs to be 4.2 or higher, with very basic Tools available (sed, tail, grep, cut, shred). Most of those tools are available in every Linux distribution out of the box. If not, they can be found in the repository with near to absolute certainty. For Example, Ubuntu needs the cryptsetup installed via
sudo apt-get install cryptsetup
The Encryption done with LUKS. In Option 0, on the remaining disk space of the USB, a partition is created and enrypted. In there, a folder is created for each of the different persistence options. The folders are filled with the content of the original Folder with rsync. In Option 1, the device is mounted and every folder is mounted over there chosen counterpart. Therefore, each interaction with those folders is now saved onto the encrypted drive. In Option 2, shred is used to clean the partition. Lastly, the partition itself is removed.

==Todo==
The script is not entirely tested, its more like a beta, there may be very rough errors. It is not yet applicable for a normal use case!
Missing are the aforementioned desktop files, so the script can be called from the menu. After that, the applying of the persistence should be asked after login (or maybe even before?).
An install script should be written copying the script and the desktop files to their places and making them executable.

OSE Linux Persistence

2018-07-14T18:59:50Z

Christian: Created page with "On this page, the functioning and creation of the Linux Live Distribution Persistence Script (LLD-Persistence for short) will be documented. It is written for the OSE Linux sy..."

On this page, the functioning and creation of the Linux Live Distribution Persistence Script (LLD-Persistence for short) will be documented. It is written for the OSE Linux system, however its very general in its dependencies. In fact, probably any Linux Distribution supporting a Live Version will probably able to integrate this script without much hazzle. It is loosely based on Tails persistence implementation and written entirely in bash. It is hosted on Github right [here https://github.com/WisdomCode/LLD-Persistence].
For the usage, an USB Stick with '''at least 8 GB''' is needed.

==Purpose==
The purpose of this script is to create a persistent storage on a Live USB Stick. Without it, everything done on the Live OS will be deleted (or, to be more precise: never saved) from the USB and one starts with a fresh version. Although this can have advantages, it can be difficult for a normal workflow, as some personal files and settings may be necessary. This is where this Script comes in. It saves parts of the OS, which can then be recalled on the next start of the device. Because of the risky situation of having personal data on an easily loosable item like a Stick, the Data is securely encrypted.

==Usage==
The script has three modes, which are given as parameter on Start:
0: A new persistent storage gets created. Only works when none is created already.
1: The persistent storage is applied. This means all chosen files from now on are saved to persistence (more on that later). Only works if there is one.
2: The persistent storage gets destroyed (shredded, no recovery possible!).

All of those require root rights. This is however normally no problem on a live OS. .desktop files will follow to call those options from the normal menu.
It works with an easy to follow GUI. In Option 0 the user will be asked for a password for the creation. After that, one can choose what shall be made persistent. The script is highly modular in that regard and can be extended without much bash knowledge, at the moment the following Options exist:
Home Directory: This will make the entire home folder of the user persistent. This includes basically all personal settings and directories and things like the desktop. This is recommended.
Persistent Folder: A more minimalist approach. A new Folder gets created in the Home directory that will from now on be persistent. Useless together with Home Directory.
Network: Saves Network Settings. If used together with the Home Directory Option, this means saving also encrypted WIFI access (which will immediately be used after applying persistent storage).
Printer: Printer Settings are saved and applied.
'''Note:''' Porting Network and Printer to another Distribution can cause problems, as these rely on the network-manager and cups. If those aren't used in the other distribution, this has to be modified.

After choosing, the persistent storage gets created and after a reboot, it can now be applied with option 1.
In Option 1, you will be asked for the password previously set. After that, its done!
Option 2 will ask you twice if your sure and, if you are, start the permanent deletion of the persistent storage. After that, it can be recreated with Option 0.

==Technique==
The script is based in bash, with the use of cryptsetup, parted, rsync and zenity. Bash needs to be 4.2 or higher, with very basic Tools available (sed, tail, grep, cut, shred). Most of those tools are available in every Linux distribution out of the box. If not, they can be found in the repository with near to absolute certainty. For Example, Ubuntu needs the cryptsetup installed via
sudo apt-get install cryptsetup
The Encryption done with LUKS. In Option 0, on the remaining disk space of the USB, a partition is created and enrypted. In there, a folder is created for each of the different persistence options. The folders are filled with the content of the original Folder with rsync. In Option 1, the device is mounted and every folder is mounted over there chosen counterpart. Therefore, each interaction with those folders is now saved onto the encrypted drive. In Option 2, shred is used to clean the partition. Lastly, the partition itself is removed.

==Todo==
The script is not entirely tested, its more like a beta, there may be very rough errors. It is not yet applicable for a normal use case!
Missing are the aforementioned desktop files, so the script can be called from the menu. After that, the applying of the persistence should be asked after login (or maybe even before?).
An install script should be written copying the script and the desktop files to their places and making them executable.

Create ZIM from OSE Wiki

2018-05-29T22:12:03Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A redis server 
A mysql server 
apache 
parsoid (running on port 8000) 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
sudo pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=<nowiki>http://127.0.0.1</nowiki> --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true parsoidUrl=http://localhost:8000 --verbose

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-28T09:22:32Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Securing the Server==
If the server is accessible from the internet in any way (like a virtual Host or similar), it's absolutely mandatory to protect it against external threats to assure the security of the private data from OSE and it's members. To do that, all externall access should be closed, beside the ssh access used for the further setup. Also make sure to protect this access, some ideas for that are found [https://devops.profitbricks.com/tutorials/secure-the-ssh-server-on-ubuntu/ here]. Default ssh ports are targets of 100s of attacks per day if open to the web, so use countermeasures. 
For securing the further access, the easies way to do that is to use iptables to block all other access:
sudo apt-get install iptables
iptables -P INPUT DROP
iptables -A INPUT -i eth0 -p tcp --dport 22 -j ACCEPT
Depending on your setup, you may have to change the 22 to the port your ssh is running on, and change -eth0 to the network device your system is using (ifconfig should give you that information). Better check this BEFORE your setting that up. 
If you'd like to setup the security differently, the following vulnerabilities have to be covered by your setup: 
A redis server 
A mysql server 
apache 
parsoid (running on port 8000) 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
sudo pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=<nowiki>http://127.0.0.1</nowiki> --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-27T18:57:34Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a safe place, keep it only as long as you need it! Make sure that the web server running this snapshot can only be access from your local network; it should not be exposed to the public internet.''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost 127.0.0.1:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
'''Double-check that this apache vhost is not accessible to the public internet''' 

After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
sudo pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=<nowiki>http://127.0.0.1</nowiki> --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-27T17:56:03Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a save place, keep it only as long as you need it!''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost *:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
sudo pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=<nowiki>http://127.0.0.1</nowiki> --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-27T17:51:19Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a save place, keep it only as long as you need it!''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost *:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=<nowiki>http://127.0.0.1</nowiki> --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-27T17:50:47Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a save place, keep it only as long as you need it!''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost *:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=http://127.0.0.1 --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-27T17:49:39Z

Christian:

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a save place, keep it only as long as you need it!''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost *:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "<nowiki>https://wiki.opensourceecology.org/images/ose-logo.png</nowiki>"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=http://127.0.0.1 --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

Create ZIM from OSE Wiki

2018-05-27T17:45:51Z

Christian: This Page describes how the OSE Wiki can be backed up into a ZIM file for offline usage

'''Warning: This page is a page dedicated to the administration of this wiki. You may use this information for the understanding of the tools used, however, for the creation of a .zim file from this wiki, you need the approval and collaboration of the Server Admin.''' 
 
The ZIM Format is an open source format to store webpages in its entirety, with a focus on wikipedia and mediawiki pages. For more info, look [https://en.wikipedia.org/wiki/ZIM_(file_format) here]. 
To create a ZIM File yourself, you need to scrape the webpage and download all necessary dependencies. For that purpose, there are a handfull of [http://www.openzim.org/wiki/Build_your_ZIM_file programs] capable of doing that. We will be using mwoffliner, as it seems to be the most advanced option. 
But before we go into scraping, it should be told that the OSE wiki is not written for scraping, as you can see in the robots.txt, the limited ressources of this project lead to a firm security regarding scraping or DOS attacks. There is (unfortunately) no scrape tool for zim files out there that can be regulated to fit those needs, so we need a workaround here. 
This is why this process has actually 2 steps: Setting up and Starting the scraper, and create a copy of the OSEWiki in a safe enviroment, which then can be scraped at any pace. We will start by creating the copy. 
We will assume a debian enviroment (any derivative will do), as some of the programs have to be compiled from scratch, partly with bad documentation, it is probably possible, but not advisable to use other distributions. 

==Setup OSEWiki from a Backup==
For this step you need a backup of the entire OSE wiki. This backup will contain of a sqldump, and the document root. 
'''Warning! Such a Backup contains sensitive information! Store it in a save place, keep it only as long as you need it!''' 
On your Server, you will need a default [https://en.wikipedia.org/wiki/LAMP_(software_bundle) LAMP] setup, so install mysql, apache and php, like this: 
sudo apt-get install php php-mysql mysql-server apache2 libapache2-mod-php php-xml php-mbstring
The Backup of the document root can be placed now, in it you can find the ''LocalSettings.php''. In this file, the setup of the database is described; as we need to recreate it, search for ''DATABASE SETTINGS''. There, you'll find the name of the database, the username and the password. You'll need them to restore the dump. 
Now, restore the dump in the following fashion: 
sudo su
mysql -u root
create database [database_name];
grant all privileges on [database_name].* to [database_user]@localhost identified by [database_user_password];
exit;
mysql -u [database_user] -p [database_name] < [path_to_sqldump_file]
if the sql file is compressed, extract it first. 
Now database and document root are finished, we need to work on apache next. The Webservers conf file can be setup with just 4 lines basically, being: 
<VirtualHost *:80>
DocumentRoot [path_to_the_htdocs_in_the_Document_Root]
Alias /wiki [path_to_the_htdocs_in_the_Document_Root]/index.php
</VirtualHost>
'''Don't forget the Alias''' 
After that reload apache, and you should be able to reach the OSE wiki now through the ip of your server! 

==Setup Scraper/MWOffliner==
MWOffliner can be found at [https://github.com/openzim/mwoffliner github], to install we need a redis-server, nodejs and some minor components. They can be installed like this: 

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo apt-get install jpegoptim advancecomp gifsicle pngquant imagemagick nscd
sudo apt-get install redis-server

Additionally, the redis server needs a specific setup, make sure the following options are set in /etc/redis/redis.conf: 
unixsocket /dev/shm/redis.sock
unixsocketperm 777
save ""
appendfsync no

Lastly, we also need the zimwriterfs installed, which is a bit inconvenient, as the [https://github.com/openzim/zimwriterfs github] pages instructions on building it are just plain wrong (as in May 2018). However, they provide a docker written for ubuntu, so following those instructions should work:
sudo apt-get install git pkg-config libtool automake autoconf make g++ liblzma-dev coreutils wget zlib1g-dev libicu-dev python3-pip libgumbo-dev libmagic-dev
pip3 install meson
wget https://oligarchy.co.uk/xapian/1.4.3/xapian-core-1.4.3.tar.xz
tar xvf xapian-core-1.4.3.tar.xz
cd xapian-core-1.4.3 && ./configure
sudo make all install
cd .. && rm -rf xapian
ln -s /usr/bin/python3 /usr/bin/python
git clone https://github.com/openzim/libzim.git
cd libzim && git checkout 3.0.0
git clone git://github.com/ninja-build/ninja.git
cd ninja && git checkout release
./configure.py --bootstrap
sudo cp ./ninja /usr/local/bin/
cd .. && meson . build
cd build && ninja
sudo ninja install
cd ../.. && rm -rf libzim
git clone https://github.com/openzim/zimwriterfs.git
cd zimwriterfs && meson . build
cd build && sudo ninja install
cd ../.. && rm -rf zimwriterfs
sudo ldconfig
These commands are extracted and from [https://github.com/openzim/zimwriterfs/blob/master/docker/Dockerfile here], written so that they can be run on a normal system. After all of that compiling, last thing we need is the actual mwoffliner, so lets get that one: 
sudo npm -g install mwoffliner
All the dependencies will be built by itself, after its done, you can start using it. Just type ''mwoffliner'' into command line and you get the possible parameter.
For the creation of a build from the OSE Wiki, the following command is used:

wget -O /tmp/favicon.png "https://wiki.opensourceecology.org/images/ose-logo.png"
mwoffliner --outputDirectory=[Directory_Of_Zim_File] --mwUrl=http://127.0.0.1 --adminEmail=[your_mail] --customZimTitle=OSEWiki --customZimDescription="The Open Source Ecology (OSE) project tries to create open source blueprints of all industrial machines definining modern society for a decentralized, post-scarcity economy." --cacheDirectory=[Directory_of_Cached_Data(Optional)] --customZimFavicon=/tmp/favicon.png --mwApiPath="api.php" --localParsoid=true

This may take, depending on the system, a long time, so run it with nohup, screen or similar. After that, at the Directory stated by you, the completed ZIM should appear. Congratulations!

OSE Linux - 2.0 version from 2020

2017-11-03T14:11:31Z

Christian:

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQUkdrdXpHLUgtckk here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
For Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version''' 
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-28T12:47:32Z

Christian:

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcldZTUVTUGIzRlk here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
For Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version''' 
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

Christian Rupp Log

2017-10-26T11:35:09Z

Christian:

{{Status|... Printer Cluster |Post bio on Developers page, Jitsi, Wordpress(?), ISO |...}}
{{RightTOC}}

[[D3D Log]]. [[Development Team Log]]. [[Marcin Log]].
[https://hangouts.google.com/hangouts/_/event/cfvdskolaipjgki95aoufjf3l50?hl=en&authuser=0 OSE Hangout] [https://meet.jit.si/SelfishStarsConjureHeroically Jitsi Meetup].

<html><iframe width="700" height="600" src="https://osedev.org/wiki/Christian"></iframe></html>

=Thu Oct 26, 2017=
Documented my Setup, uploaded everything and wrote a HowTo for booting up from USB with all eventualities (2h)

=Wed Oct 25, 2017=
Made the next Iteration for OSELinux, now with working exploded part diagrams, all requested software, working arduino and cura (its now possible to write the code to the arduino/print with cura). Lastly, the Wallpaper seems to work fine now. This version also uses the us version ISO as a basis, for fixing some minor issues in the default settings.
As this seems to fix everything requested, I've called this iteration 1.0. I will now pause the project until further features are requested.
The new version can be found here:
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]
(5h)

=Tue Sep 12, 2017=
Wrote down how the ISO can be created and customized
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]

=Sun Sep 3, 2017=
Breakthrough with the ISO creation. The software used fixes the errors encountered with the current version. Furthermore, due to the possibility of better testing I could prove my concept of the jitsi plugin, its functional. Additionally, I could test the /etc/skel directory, and its working, further customized settings can now be integrated. I did nearly everything wished from the list (including the new debsum package, which is a reasonable add), including the vocoscreen settings and the freecad macro, and added all up to a new, tested version of the ISO which will go online tomorrow.

There are however (little) flaws left:

For some reason, arduino wont work properly unless started as root, this may however be system specific and basically fixable by running

sudo adduser $USER dialout

maybe I'm able to integrate that in the basic startup process, this may however be complicated. I could also write a little script that starts the program but requires root rights so the user is prompted to provide it.

Additionally there are settings to do regarding cura and blender, however I'm completely unfamiliar with those, this looks like something an expert provides for me (if anyone says he/she knows the perfect setup, contact me!)

Additionally I worked on the OSE server (or, more like it, setup a client on my side). (6h)

=Thu Aug 31, 2017=
Workstation at home is now functional, found a software perfect for our needs, however it still has some flaws to be corrected, I had to comment out some bad source code, its working, documentation follows. the used software is

https://github.com/kamilion/customizer

And its taking out all hazzle with setting up the ISO, and rounds all up with a neat GUI, however lacks of a simple changer of Desktop Enviroments (however, this is kind of luxury, we can just work with xubuntu, lubuntu etc) (5h)

=Sat Aug 26, 2017=
Setup a new workstation here, however didnt work, several errors here, may take some time... (2h)

=Thu Aug 24, 2017=
Unfortunately, I have some hardware problems, but the first version of the ISO is available [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here].

Due to my problems the features explained yesterday are NOT included, but giving out the ISO to find out what default settings suits us best should help getting out a better version.

=Wed Aug 23, 2017=
Did some research with very encouraging results, two processes in particular:

The [https://wiki.ubuntuusers.de/Ubuntu_Customization_Kit/ Ubuntu Customization Kit] lets you create an ISO with a gui and further very easy options in contrast to the very confusing commands to otherwise setup a chroot.

The customization of the 'default user': from that Page, I also derived information on how to customize the users that get created (on starting the live version for instance). This makes a custom desktop possible as well as custom settings for any program imaginable. (1,5h)

=Tue Aug 22, 2017=
Finished the update, got many things to work, got to test the result yet with virtualbox, I'll do that tonight.
Those things were not (yet) possible:

Setting other defaults for vokoscreen (consists only of one binary, personal settings are created for specific user)

Adding the printer to Cura (Although it is probably possible, it basically has the same problem as the above, I'll document further info)

Adding the Macro to freecad (Is also saved into the users folder per default, as there are no macro examples, I couldnt slip it in somewhere)

This means that I placed those files in the /opt folders for further access. (2,5 h) Download link follows after the testing was done.

=Mon Aug 21, 2017=
Updated the iso with some new information, optimized a few steps and tested that (1,5h)

=Thu Aug 17, 2017=
Created a new ISO for OSE Linux, including new software and updating existing. Added new software and some special settings, however not all wishes could be fulfilled, documentation follows (I've shortened the installation process). (4h)

=Wed Aug 16, 2017=
Piwik seems to be highly insecure, so some research had to be done. Probably we'll be switching to Open Web Analytics.

Setup of wordpress for Jose, unfortunately the URL has to be adjusted yet (3h)

=Tue Aug 15, 2017=
Unfortunately, there were serveral issues on the way, primarily coming from the security side... Had to research further and talk with michael about further steps

=Sat Aug 12, 2017=
Got to work on piwik, some problems occured, about half way (hopefully) through. (4h)

=Tue Aug 8, 2017=
Talked with Marcin and Michael about server security. (2h)

=Sat Jul 27, 2017=
Researched my docs about the https encryption, looked through the basic system of piwik and the usual safety-measures. Prepared everything on server for setup (root access still required). (4h)

=Thu Jul 27, 2017=
Took a while to figure out the errors, there were two; rc.local had the wrong permissions, I added the necessary steps to the instructional, and a classic mistake in the Scanner (intendation error...), not quite sure where that came from.

Additionaly I figured out how to make the image for distribution only as small as the files contained, other than the size of my SD card (which would make the use of a 4 GB SD card impossible). All is now uploaded, corrected, tested and well. (5h)

=Wed Jul 26, 2017=
Started the documentation of the testing and created a main article on the printer cluster, including all the used ressources, install instructions, testing results and all the information I collected while I was setting up and configuring the image.
All of this is now collected here: [[3d_Printer_Cluster]]

However, I was confronted with problems on the image I was uploading to my drive, I'll have to redo some things there... (4h)

=Tue Jul 25, 2017=
Got the testing scenario right, tested on and finished.

Did refurbish the code a bit and uploaded the new version.

The Image is now collected and done, it lays in my drive right here [https://drive.google.com/file/d/0ByUmXv7QXHeQLXdEbG55MlM2eXM/view?usp=sharing Printer Cluster] for installation, just follow these Instructions [[How_to:Write_Image_to_SD_Card]]. More detailed Documentation tomorrow. (7h)

=Mon Jul 24, 2017=
Started testing, couldn't however communicate with the Marlin; possible solutions:

1. Marlin wasn't setup properly: check by sending GCode via USB from a 3d print software.

2. Pins aren't setup properly: May need its power from the USB to UART, not only ground... (till now, I power comes from USB)

3. Contact protocol is wrong: Check the Bitrate (with step 1) and the /dev folder on whats appearing on plugging in

=Sat Jul 22, 2017=
Took part of the sprint for the CEB Press, I did insert new rods

Also stayed for the filament extruder. As there was nothing to do for me, I setup my freshly arrived Ardurinos
. All thats missing now for testing is the USB to UART converter, I can and will pick it up on monday (5h)

=Fri Jul 21, 2017=
Preparated the software for testing, adding slicing profile to script, configured Marlin, ready for the ardurinos to arrive(3,5h)

=Thu Jul 20, 2017=
Talked with Michael on how I can help administering the server (1h)

=Wed Jul 19, 2017=
I was given the task of making the wiki more accessible, so I asked myself

How can we organize the current information on the wiki?

The sites have to be hierarchical, so there are main sites, that redirect to more specific undercategories. Crossreferences are no problem of course, this is only about quickly aquiring information. This means also that those hierarchical links should be displayed prominently. For organising the information in that way, we have to map the wiki first, so we can manually decide how the every site should be reachable from the main page.

The following tools will therefore be of use:

[https://www.mediawiki.org/wiki/Extension:VIKI Visualization of the Links]

[https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki_Graph Simpler Variant, maybe interesting if we have to modify the script]

[https://www.mediawiki.org/wiki/Manual:GenerateSitemap.php This way we not only can see every site, we can also make it easier for google users to spot specific site of the wiki]

Additionaly, I ordered the more parts necessary for setting up a printer cluster on my own (at least the software-site). Documentation will follow when I start the setup (2h)

=Friday Jul 14, 2017=
Setup the Pi with marcin, gave me SSH access cia DynDNS (4,5h)

=Wednesday Jul 12, 2017=
Learned about AT code, about how to connect with the RC12 module and some other details for setting up the transceiver (2h)

=Tuesday Jul 11, 2017=
Tried to setup the SD card with Marcin, failed because of different errors (2h)

=Sun Jul 9, 2017=
Written a definite manual on how to setup software and hardware in its entirety. The instructions are in the google spreadsheet seen below (Jun 27). (0,5h)

=Sat Jul 8, 2017=
Had some thinking about security, user internal permission restrictions. Would be a pain to explain it all, however, solved it by running scanner on systemstart (there it is always run as root) and trigger the running by a variable settable by the website (clicking on the button).

Additional, reboot works now (and it should now be easy to implement further commands if necessary).

Lastly, some little code optimization (looks far more convenient now), renaming of the host to replab (this is now also what you type into search bar for accessing the website) and I licensed the files under the GPLv3. (6h)

That means the user interface is done and ready for testing. Changes will now only impact the Scanner and Maybe some design wishes (I'm open for requests) for the website.

=Fri Jul 7, 2017=
Took longer than expected, but the uploader contains now a drag and drop and accepts mutliple uploads at once and mirrors the design of the website. (5h)

=Thu Jul 6, 2017=
Integrated the script into the Web Interface, the current model allows an upload via the 3dPrinter website. The upload then automatically converts the file into stl. Currently, the upload allows fcstd and stl files. The Upload blocks the website for the uploader until the upload is complete, after that, the file is already accessible in the Octoprint interface.

The upload is should take about a second per 20 kb of fcstd converting. This means, a 60 kb file takes 3 seconds of 'uploading'. (4h)

Drag and drop and a neater upload interface will be the next goal.

=Wed Jul 5, 2017=
Designed a script to convert fcstd to stl. It's tested and working, however it seems not to work perfectly with all Parts.
I think this is not fault of the script but of freecad. It seems to impact only very complex forms, so I hope it won't impact our work. The script will be added to the zip as soon as it is implemented into the website. (3h)

=Tue Jul 4, 2017=
Wiped the Testpi end redeployed it in the simplest way possible and wrote the instructions down here [[How_to:_Create_Printer_Cluster_Image]] (1h)

=Mon Jul 3, 2017=
Added Lazyload to the iframes for a maximum of performance, added buttons for server management (reboot etc.), merged all data to a zip file with a how to, taking [https://octopi.octoprint.org/ octopi] as a basis. Package will be tested by me tomorrow. (3h)
[[File:PrinterClusterData.zip]]

=Sun Jul 2, 2017=

Wrote a webtemplate for managing multiple instances of octoprint,

additionaly step by step instructions to make the OSE Printer Cluster image out of the octopi (8 h)

=Sat Jul 1, 2017=

Worked on Scanscript, ready for testing (6h)

=Fri Jun 30, 2017=

Got a SD card setup with octopi and written a documentation about how to do it right here

[[How_to:Write_Image_to_SD_Card]]

The Image itself btw can be found here

[https://octopi.octoprint.org/ Octopi]

The hardware setup is displayed in the presentation already, so there is nothing holding us back from testing the software upon a printer.
Additionaly, I've figured out some of the missing pieces and began writing a python script for autorecognition of the 3d printers.
(5h)

=Thu Jun 29, 2017=

Got a step-by step plan about what should be done, learned about the G-Code and found those of interest for me from Marlin.
(M115 gives me unique Data about the printer, M20 to M30 are used to read, write to the sd card and start the printing process from there)
Found out how to reformat fcstd to stl with command line only (for automatic conversion on upload).
(1,5h)

=Tue Jun 27, 2017=

<html><iframe src="https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/embed?start=false&loop=false&delayms=3000" frameborder="0" width="480" height="299" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe></html>

[https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/edit#slide=id.g1e7b20ee3a_0_10 edit]

Researched Methods for cluster management, communication between printer and computer etc.
Most Promising:
[https://github.com/foosel/OctoPrint Octoprint]

This can be run for [http://blog.patshead.com/2016/02/control-multiple-3d-printers-using-a-single-raspberry-pi-with-octoprint.html several printers]

Hardware is defined and set, list and setup in the presentation.
Very rough price estimate: 45 $ + 20$/printer(5h)

=Sun Jun 25, 2017=
Finished FreeCAD test, Video is uploaded to youtube.
https://www.youtube.com/watch?v=nkDFKByIPfE (about 7h)

OSE Linux - 2.0 version from 2020

2017-10-26T11:33:12Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
For Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version''' 
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:32:52Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
For Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:32:19Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:31:37Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 

Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:31:07Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

Setting up the USB stick, follow the instructions [http://opensourceecology.org/wiki/How_to:Write_Image_to_SD_Card here], 
simply swap the word SD for USB. There are no customizations to be made as they are suggested at the bottom, all is working out of the box.

 
<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:25:13Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true" height=400 width=80%></iframe></html>
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:22:44Z

Christian: /* HowTo Document for Linux Users */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/e/2PACX-1vT2NluspmIZSXErMIL2Rt-SxzJtq8NlhLLP2rMe5Cez0NZEfg9ncnO9g1RKC-3WALotbo2IpdQL4tKY/pub?embedded=true"></iframe></html>
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-26T11:19:46Z

Christian:

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB, please refer to the document for further information: 
<html><iframe src="https://docs.google.com/document/d/1TbP-AiRBrH3HnvLQheHSx-glbvMVIBRWvcI-uuYnBoU/pub?embedded=true" height=400 width=80%></iframe></html>
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-25T21:08:09Z

Christian: /* Current */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-25T20:53:42Z

Christian: /* Download the Current ISO Link (For OSE Linux Live End Users) */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (NOT For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-25T20:49:56Z

Christian: /* Current */

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

OSE Linux - 2.0 version from 2020

2017-10-25T20:47:54Z

Christian:

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
''''Oct 25 release 
Added exploded part diagrams,vlc and obs 
Working arduino and cura (its now possible to write the code to the arduino/print with cura) 
Custom Wallpaper seems to work fine now. 
This version fixed all known issues (except the time zone, which is in the nature of Ubuntu). Therefore, this is version 1.0,
and this project will be seen as done until further changes are needed. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here] 

==Old==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/open?id=0ByUmXv7QXHeQQk9YYXNWYkdCcDQ here] 
 
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

Christian Rupp Log

2017-10-25T20:11:09Z

Christian:

{{Status|... Printer Cluster |Post bio on Developers page, Jitsi, Wordpress(?), ISO |...}}
{{RightTOC}}

[[D3D Log]]. [[Development Team Log]]. [[Marcin Log]].
[https://hangouts.google.com/hangouts/_/event/cfvdskolaipjgki95aoufjf3l50?hl=en&authuser=0 OSE Hangout] [https://meet.jit.si/SelfishStarsConjureHeroically Jitsi Meetup].

<html><iframe width="700" height="600" src="https://osedev.org/wiki/Christian"></iframe></html>

=Wed Oct 25, 2017=
Made the next Iteration for OSELinux, now with working exploded part diagrams, all requested software, working arduino and cura (its now possible to write the code to the arduino/print with cura). Lastly, the Wallpaper seems to work fine now. This version also uses the us version ISO as a basis, for fixing some minor issues in the default settings.
As this seems to fix everything requested, I've called this iteration 1.0. I will now pause the project until further features are requested.
The new version can be found here:
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]
(5h)

=Tue Sep 12, 2017=
Wrote down how the ISO can be created and customized
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]

=Sun Sep 3, 2017=
Breakthrough with the ISO creation. The software used fixes the errors encountered with the current version. Furthermore, due to the possibility of better testing I could prove my concept of the jitsi plugin, its functional. Additionally, I could test the /etc/skel directory, and its working, further customized settings can now be integrated. I did nearly everything wished from the list (including the new debsum package, which is a reasonable add), including the vocoscreen settings and the freecad macro, and added all up to a new, tested version of the ISO which will go online tomorrow.

There are however (little) flaws left:

For some reason, arduino wont work properly unless started as root, this may however be system specific and basically fixable by running

sudo adduser $USER dialout

maybe I'm able to integrate that in the basic startup process, this may however be complicated. I could also write a little script that starts the program but requires root rights so the user is prompted to provide it.

Additionally there are settings to do regarding cura and blender, however I'm completely unfamiliar with those, this looks like something an expert provides for me (if anyone says he/she knows the perfect setup, contact me!)

Additionally I worked on the OSE server (or, more like it, setup a client on my side). (6h)

=Thu Aug 31, 2017=
Workstation at home is now functional, found a software perfect for our needs, however it still has some flaws to be corrected, I had to comment out some bad source code, its working, documentation follows. the used software is

https://github.com/kamilion/customizer

And its taking out all hazzle with setting up the ISO, and rounds all up with a neat GUI, however lacks of a simple changer of Desktop Enviroments (however, this is kind of luxury, we can just work with xubuntu, lubuntu etc) (5h)

=Sat Aug 26, 2017=
Setup a new workstation here, however didnt work, several errors here, may take some time... (2h)

=Thu Aug 24, 2017=
Unfortunately, I have some hardware problems, but the first version of the ISO is available [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here].

Due to my problems the features explained yesterday are NOT included, but giving out the ISO to find out what default settings suits us best should help getting out a better version.

=Wed Aug 23, 2017=
Did some research with very encouraging results, two processes in particular:

The [https://wiki.ubuntuusers.de/Ubuntu_Customization_Kit/ Ubuntu Customization Kit] lets you create an ISO with a gui and further very easy options in contrast to the very confusing commands to otherwise setup a chroot.

The customization of the 'default user': from that Page, I also derived information on how to customize the users that get created (on starting the live version for instance). This makes a custom desktop possible as well as custom settings for any program imaginable. (1,5h)

=Tue Aug 22, 2017=
Finished the update, got many things to work, got to test the result yet with virtualbox, I'll do that tonight.
Those things were not (yet) possible:

Setting other defaults for vokoscreen (consists only of one binary, personal settings are created for specific user)

Adding the printer to Cura (Although it is probably possible, it basically has the same problem as the above, I'll document further info)

Adding the Macro to freecad (Is also saved into the users folder per default, as there are no macro examples, I couldnt slip it in somewhere)

This means that I placed those files in the /opt folders for further access. (2,5 h) Download link follows after the testing was done.

=Mon Aug 21, 2017=
Updated the iso with some new information, optimized a few steps and tested that (1,5h)

=Thu Aug 17, 2017=
Created a new ISO for OSE Linux, including new software and updating existing. Added new software and some special settings, however not all wishes could be fulfilled, documentation follows (I've shortened the installation process). (4h)

=Wed Aug 16, 2017=
Piwik seems to be highly insecure, so some research had to be done. Probably we'll be switching to Open Web Analytics.

Setup of wordpress for Jose, unfortunately the URL has to be adjusted yet (3h)

=Tue Aug 15, 2017=
Unfortunately, there were serveral issues on the way, primarily coming from the security side... Had to research further and talk with michael about further steps

=Sat Aug 12, 2017=
Got to work on piwik, some problems occured, about half way (hopefully) through. (4h)

=Tue Aug 8, 2017=
Talked with Marcin and Michael about server security. (2h)

=Sat Jul 27, 2017=
Researched my docs about the https encryption, looked through the basic system of piwik and the usual safety-measures. Prepared everything on server for setup (root access still required). (4h)

=Thu Jul 27, 2017=
Took a while to figure out the errors, there were two; rc.local had the wrong permissions, I added the necessary steps to the instructional, and a classic mistake in the Scanner (intendation error...), not quite sure where that came from.

Additionaly I figured out how to make the image for distribution only as small as the files contained, other than the size of my SD card (which would make the use of a 4 GB SD card impossible). All is now uploaded, corrected, tested and well. (5h)

=Wed Jul 26, 2017=
Started the documentation of the testing and created a main article on the printer cluster, including all the used ressources, install instructions, testing results and all the information I collected while I was setting up and configuring the image.
All of this is now collected here: [[3d_Printer_Cluster]]

However, I was confronted with problems on the image I was uploading to my drive, I'll have to redo some things there... (4h)

=Tue Jul 25, 2017=
Got the testing scenario right, tested on and finished.

Did refurbish the code a bit and uploaded the new version.

The Image is now collected and done, it lays in my drive right here [https://drive.google.com/file/d/0ByUmXv7QXHeQLXdEbG55MlM2eXM/view?usp=sharing Printer Cluster] for installation, just follow these Instructions [[How_to:Write_Image_to_SD_Card]]. More detailed Documentation tomorrow. (7h)

=Mon Jul 24, 2017=
Started testing, couldn't however communicate with the Marlin; possible solutions:

1. Marlin wasn't setup properly: check by sending GCode via USB from a 3d print software.

2. Pins aren't setup properly: May need its power from the USB to UART, not only ground... (till now, I power comes from USB)

3. Contact protocol is wrong: Check the Bitrate (with step 1) and the /dev folder on whats appearing on plugging in

=Sat Jul 22, 2017=
Took part of the sprint for the CEB Press, I did insert new rods

Also stayed for the filament extruder. As there was nothing to do for me, I setup my freshly arrived Ardurinos
. All thats missing now for testing is the USB to UART converter, I can and will pick it up on monday (5h)

=Fri Jul 21, 2017=
Preparated the software for testing, adding slicing profile to script, configured Marlin, ready for the ardurinos to arrive(3,5h)

=Thu Jul 20, 2017=
Talked with Michael on how I can help administering the server (1h)

=Wed Jul 19, 2017=
I was given the task of making the wiki more accessible, so I asked myself

How can we organize the current information on the wiki?

The sites have to be hierarchical, so there are main sites, that redirect to more specific undercategories. Crossreferences are no problem of course, this is only about quickly aquiring information. This means also that those hierarchical links should be displayed prominently. For organising the information in that way, we have to map the wiki first, so we can manually decide how the every site should be reachable from the main page.

The following tools will therefore be of use:

[https://www.mediawiki.org/wiki/Extension:VIKI Visualization of the Links]

[https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki_Graph Simpler Variant, maybe interesting if we have to modify the script]

[https://www.mediawiki.org/wiki/Manual:GenerateSitemap.php This way we not only can see every site, we can also make it easier for google users to spot specific site of the wiki]

Additionaly, I ordered the more parts necessary for setting up a printer cluster on my own (at least the software-site). Documentation will follow when I start the setup (2h)

=Friday Jul 14, 2017=
Setup the Pi with marcin, gave me SSH access cia DynDNS (4,5h)

=Wednesday Jul 12, 2017=
Learned about AT code, about how to connect with the RC12 module and some other details for setting up the transceiver (2h)

=Tuesday Jul 11, 2017=
Tried to setup the SD card with Marcin, failed because of different errors (2h)

=Sun Jul 9, 2017=
Written a definite manual on how to setup software and hardware in its entirety. The instructions are in the google spreadsheet seen below (Jun 27). (0,5h)

=Sat Jul 8, 2017=
Had some thinking about security, user internal permission restrictions. Would be a pain to explain it all, however, solved it by running scanner on systemstart (there it is always run as root) and trigger the running by a variable settable by the website (clicking on the button).

Additional, reboot works now (and it should now be easy to implement further commands if necessary).

Lastly, some little code optimization (looks far more convenient now), renaming of the host to replab (this is now also what you type into search bar for accessing the website) and I licensed the files under the GPLv3. (6h)

That means the user interface is done and ready for testing. Changes will now only impact the Scanner and Maybe some design wishes (I'm open for requests) for the website.

=Fri Jul 7, 2017=
Took longer than expected, but the uploader contains now a drag and drop and accepts mutliple uploads at once and mirrors the design of the website. (5h)

=Thu Jul 6, 2017=
Integrated the script into the Web Interface, the current model allows an upload via the 3dPrinter website. The upload then automatically converts the file into stl. Currently, the upload allows fcstd and stl files. The Upload blocks the website for the uploader until the upload is complete, after that, the file is already accessible in the Octoprint interface.

The upload is should take about a second per 20 kb of fcstd converting. This means, a 60 kb file takes 3 seconds of 'uploading'. (4h)

Drag and drop and a neater upload interface will be the next goal.

=Wed Jul 5, 2017=
Designed a script to convert fcstd to stl. It's tested and working, however it seems not to work perfectly with all Parts.
I think this is not fault of the script but of freecad. It seems to impact only very complex forms, so I hope it won't impact our work. The script will be added to the zip as soon as it is implemented into the website. (3h)

=Tue Jul 4, 2017=
Wiped the Testpi end redeployed it in the simplest way possible and wrote the instructions down here [[How_to:_Create_Printer_Cluster_Image]] (1h)

=Mon Jul 3, 2017=
Added Lazyload to the iframes for a maximum of performance, added buttons for server management (reboot etc.), merged all data to a zip file with a how to, taking [https://octopi.octoprint.org/ octopi] as a basis. Package will be tested by me tomorrow. (3h)
[[File:PrinterClusterData.zip]]

=Sun Jul 2, 2017=

Wrote a webtemplate for managing multiple instances of octoprint,

additionaly step by step instructions to make the OSE Printer Cluster image out of the octopi (8 h)

=Sat Jul 1, 2017=

Worked on Scanscript, ready for testing (6h)

=Fri Jun 30, 2017=

Got a SD card setup with octopi and written a documentation about how to do it right here

[[How_to:Write_Image_to_SD_Card]]

The Image itself btw can be found here

[https://octopi.octoprint.org/ Octopi]

The hardware setup is displayed in the presentation already, so there is nothing holding us back from testing the software upon a printer.
Additionaly, I've figured out some of the missing pieces and began writing a python script for autorecognition of the 3d printers.
(5h)

=Thu Jun 29, 2017=

Got a step-by step plan about what should be done, learned about the G-Code and found those of interest for me from Marlin.
(M115 gives me unique Data about the printer, M20 to M30 are used to read, write to the sd card and start the printing process from there)
Found out how to reformat fcstd to stl with command line only (for automatic conversion on upload).
(1,5h)

=Tue Jun 27, 2017=

<html><iframe src="https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/embed?start=false&loop=false&delayms=3000" frameborder="0" width="480" height="299" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe></html>

[https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/edit#slide=id.g1e7b20ee3a_0_10 edit]

Researched Methods for cluster management, communication between printer and computer etc.
Most Promising:
[https://github.com/foosel/OctoPrint Octoprint]

This can be run for [http://blog.patshead.com/2016/02/control-multiple-3d-printers-using-a-single-raspberry-pi-with-octoprint.html several printers]

Hardware is defined and set, list and setup in the presentation.
Very rough price estimate: 45 $ + 20$/printer(5h)

=Sun Jun 25, 2017=
Finished FreeCAD test, Video is uploaded to youtube.
https://www.youtube.com/watch?v=nkDFKByIPfE (about 7h)

OSE Linux - 2.0 version from 2020

2017-10-25T19:49:47Z

Christian:

Page under active editing 9/17

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main multiverse" >> /etc/apt/sources.list
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
add-apt-repository ppa:obsproject/obs-studio -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily debsums obs-studio -y

'''Installing Cura
apt-get install python-opengl python-serial -y
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb
printf "\nADD_EXTRA_GROUPS=1\nEXTRA_GROUPS="dialout"\n" >> /etc/adduser.conf

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)
additionally, make sure the last line of the cura setup is run, as this makes the actual communication with the boards possible.

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
Maybe delete some old stuff, like (this will be updated when the iso gets too bloated): 
sudo apt-get purge unity-webapps*
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the (previously emptied) /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]]. The test should verify the following specific usage points, and receive "100% tested and working" condition for the ISO to be considered done (ie, for example, we cannot have the Dimension Drawing Workbench not working in FreeCAD. For the specific usage points that are marked "Not Cricital", they do not count in the grading.

#Is the time zone set correctly? (Not critical)
#[[File:check.png]] Does Chromium connect to wireless internet without a problem?
#Is the version of Arduino 1.6.8 as the default?
#Does Arduino IDE upload sample program to the Mega after selecting the correct board and port under Tools?
#Is OSE Marlin available within Arduino?
#Can you download a file from Part Library on the wiki and open it in FreeCAD?
#Does the Exploded Part Animation workbench create part explosions without crashing?
#Do files download to the desktop (so a new user can find files immediately without having to find the Downloads folder in the directory structure)?
#Can you upload files to the wiki, such as an image?

==Further Development Points==
#Adding critical bookmarks in Chromium

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
*[[IT Support]]
*[[OSE Linux Testing - Marcin]]

Christian Rupp Log

2017-09-19T21:00:09Z

Christian:

{{Status|... Printer Cluster |Post bio on Developers page, Jitsi, Wordpress(?), ISO |...}}
{{RightTOC}}

[[D3D Log]]. [[Development Team Log]]. [[Marcin Log]].
[https://hangouts.google.com/hangouts/_/event/cfvdskolaipjgki95aoufjf3l50?hl=en&authuser=0 OSE Hangout] [https://meet.jit.si/SelfishStarsConjureHeroically Jitsi Meetup].

<html><iframe width="700" height="600" src="https://osedev.org/wiki/Christian"></iframe></html>

=Tue Sep 12, 2017=
Wrote down how the ISO can be created and customized
[http://opensourceecology.org/wiki/OSE_Linux OSE Linux]

=Sun Sep 3, 2017=
Breakthrough with the ISO creation. The software used fixes the errors encountered with the current version. Furthermore, due to the possibility of better testing I could prove my concept of the jitsi plugin, its functional. Additionally, I could test the /etc/skel directory, and its working, further customized settings can now be integrated. I did nearly everything wished from the list (including the new debsum package, which is a reasonable add), including the vocoscreen settings and the freecad macro, and added all up to a new, tested version of the ISO which will go online tomorrow.

There are however (little) flaws left:

For some reason, arduino wont work properly unless started as root, this may however be system specific and basically fixable by running

sudo adduser $USER dialout

maybe I'm able to integrate that in the basic startup process, this may however be complicated. I could also write a little script that starts the program but requires root rights so the user is prompted to provide it.

Additionally there are settings to do regarding cura and blender, however I'm completely unfamiliar with those, this looks like something an expert provides for me (if anyone says he/she knows the perfect setup, contact me!)

Additionally I worked on the OSE server (or, more like it, setup a client on my side). (6h)

=Thu Aug 31, 2017=
Workstation at home is now functional, found a software perfect for our needs, however it still has some flaws to be corrected, I had to comment out some bad source code, its working, documentation follows. the used software is

https://github.com/kamilion/customizer

And its taking out all hazzle with setting up the ISO, and rounds all up with a neat GUI, however lacks of a simple changer of Desktop Enviroments (however, this is kind of luxury, we can just work with xubuntu, lubuntu etc) (5h)

=Sat Aug 26, 2017=
Setup a new workstation here, however didnt work, several errors here, may take some time... (2h)

=Thu Aug 24, 2017=
Unfortunately, I have some hardware problems, but the first version of the ISO is available [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here].

Due to my problems the features explained yesterday are NOT included, but giving out the ISO to find out what default settings suits us best should help getting out a better version.

=Wed Aug 23, 2017=
Did some research with very encouraging results, two processes in particular:

The [https://wiki.ubuntuusers.de/Ubuntu_Customization_Kit/ Ubuntu Customization Kit] lets you create an ISO with a gui and further very easy options in contrast to the very confusing commands to otherwise setup a chroot.

The customization of the 'default user': from that Page, I also derived information on how to customize the users that get created (on starting the live version for instance). This makes a custom desktop possible as well as custom settings for any program imaginable. (1,5h)

=Tue Aug 22, 2017=
Finished the update, got many things to work, got to test the result yet with virtualbox, I'll do that tonight.
Those things were not (yet) possible:

Setting other defaults for vokoscreen (consists only of one binary, personal settings are created for specific user)

Adding the printer to Cura (Although it is probably possible, it basically has the same problem as the above, I'll document further info)

Adding the Macro to freecad (Is also saved into the users folder per default, as there are no macro examples, I couldnt slip it in somewhere)

This means that I placed those files in the /opt folders for further access. (2,5 h) Download link follows after the testing was done.

=Mon Aug 21, 2017=
Updated the iso with some new information, optimized a few steps and tested that (1,5h)

=Thu Aug 17, 2017=
Created a new ISO for OSE Linux, including new software and updating existing. Added new software and some special settings, however not all wishes could be fulfilled, documentation follows (I've shortened the installation process). (4h)

=Wed Aug 16, 2017=
Piwik seems to be highly insecure, so some research had to be done. Probably we'll be switching to Open Web Analytics.

Setup of wordpress for Jose, unfortunately the URL has to be adjusted yet (3h)

=Tue Aug 15, 2017=
Unfortunately, there were serveral issues on the way, primarily coming from the security side... Had to research further and talk with michael about further steps

=Sat Aug 12, 2017=
Got to work on piwik, some problems occured, about half way (hopefully) through. (4h)

=Tue Aug 8, 2017=
Talked with Marcin and Michael about server security. (2h)

=Sat Jul 27, 2017=
Researched my docs about the https encryption, looked through the basic system of piwik and the usual safety-measures. Prepared everything on server for setup (root access still required). (4h)

=Thu Jul 27, 2017=
Took a while to figure out the errors, there were two; rc.local had the wrong permissions, I added the necessary steps to the instructional, and a classic mistake in the Scanner (intendation error...), not quite sure where that came from.

Additionaly I figured out how to make the image for distribution only as small as the files contained, other than the size of my SD card (which would make the use of a 4 GB SD card impossible). All is now uploaded, corrected, tested and well. (5h)

=Wed Jul 26, 2017=
Started the documentation of the testing and created a main article on the printer cluster, including all the used ressources, install instructions, testing results and all the information I collected while I was setting up and configuring the image.
All of this is now collected here: [[3d_Printer_Cluster]]

However, I was confronted with problems on the image I was uploading to my drive, I'll have to redo some things there... (4h)

=Tue Jul 25, 2017=
Got the testing scenario right, tested on and finished.

Did refurbish the code a bit and uploaded the new version.

The Image is now collected and done, it lays in my drive right here [https://drive.google.com/file/d/0ByUmXv7QXHeQLXdEbG55MlM2eXM/view?usp=sharing Printer Cluster] for installation, just follow these Instructions [[How_to:Write_Image_to_SD_Card]]. More detailed Documentation tomorrow. (7h)

=Mon Jul 24, 2017=
Started testing, couldn't however communicate with the Marlin; possible solutions:

1. Marlin wasn't setup properly: check by sending GCode via USB from a 3d print software.

2. Pins aren't setup properly: May need its power from the USB to UART, not only ground... (till now, I power comes from USB)

3. Contact protocol is wrong: Check the Bitrate (with step 1) and the /dev folder on whats appearing on plugging in

=Sat Jul 22, 2017=
Took part of the sprint for the CEB Press, I did insert new rods

Also stayed for the filament extruder. As there was nothing to do for me, I setup my freshly arrived Ardurinos
. All thats missing now for testing is the USB to UART converter, I can and will pick it up on monday (5h)

=Fri Jul 21, 2017=
Preparated the software for testing, adding slicing profile to script, configured Marlin, ready for the ardurinos to arrive(3,5h)

=Thu Jul 20, 2017=
Talked with Michael on how I can help administering the server (1h)

=Wed Jul 19, 2017=
I was given the task of making the wiki more accessible, so I asked myself

How can we organize the current information on the wiki?

The sites have to be hierarchical, so there are main sites, that redirect to more specific undercategories. Crossreferences are no problem of course, this is only about quickly aquiring information. This means also that those hierarchical links should be displayed prominently. For organising the information in that way, we have to map the wiki first, so we can manually decide how the every site should be reachable from the main page.

The following tools will therefore be of use:

[https://www.mediawiki.org/wiki/Extension:VIKI Visualization of the Links]

[https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki_Graph Simpler Variant, maybe interesting if we have to modify the script]

[https://www.mediawiki.org/wiki/Manual:GenerateSitemap.php This way we not only can see every site, we can also make it easier for google users to spot specific site of the wiki]

Additionaly, I ordered the more parts necessary for setting up a printer cluster on my own (at least the software-site). Documentation will follow when I start the setup (2h)

=Friday Jul 14, 2017=
Setup the Pi with marcin, gave me SSH access cia DynDNS (4,5h)

=Wednesday Jul 12, 2017=
Learned about AT code, about how to connect with the RC12 module and some other details for setting up the transceiver (2h)

=Tuesday Jul 11, 2017=
Tried to setup the SD card with Marcin, failed because of different errors (2h)

=Sun Jul 9, 2017=
Written a definite manual on how to setup software and hardware in its entirety. The instructions are in the google spreadsheet seen below (Jun 27). (0,5h)

=Sat Jul 8, 2017=
Had some thinking about security, user internal permission restrictions. Would be a pain to explain it all, however, solved it by running scanner on systemstart (there it is always run as root) and trigger the running by a variable settable by the website (clicking on the button).

Additional, reboot works now (and it should now be easy to implement further commands if necessary).

Lastly, some little code optimization (looks far more convenient now), renaming of the host to replab (this is now also what you type into search bar for accessing the website) and I licensed the files under the GPLv3. (6h)

That means the user interface is done and ready for testing. Changes will now only impact the Scanner and Maybe some design wishes (I'm open for requests) for the website.

=Fri Jul 7, 2017=
Took longer than expected, but the uploader contains now a drag and drop and accepts mutliple uploads at once and mirrors the design of the website. (5h)

=Thu Jul 6, 2017=
Integrated the script into the Web Interface, the current model allows an upload via the 3dPrinter website. The upload then automatically converts the file into stl. Currently, the upload allows fcstd and stl files. The Upload blocks the website for the uploader until the upload is complete, after that, the file is already accessible in the Octoprint interface.

The upload is should take about a second per 20 kb of fcstd converting. This means, a 60 kb file takes 3 seconds of 'uploading'. (4h)

Drag and drop and a neater upload interface will be the next goal.

=Wed Jul 5, 2017=
Designed a script to convert fcstd to stl. It's tested and working, however it seems not to work perfectly with all Parts.
I think this is not fault of the script but of freecad. It seems to impact only very complex forms, so I hope it won't impact our work. The script will be added to the zip as soon as it is implemented into the website. (3h)

=Tue Jul 4, 2017=
Wiped the Testpi end redeployed it in the simplest way possible and wrote the instructions down here [[How_to:_Create_Printer_Cluster_Image]] (1h)

=Mon Jul 3, 2017=
Added Lazyload to the iframes for a maximum of performance, added buttons for server management (reboot etc.), merged all data to a zip file with a how to, taking [https://octopi.octoprint.org/ octopi] as a basis. Package will be tested by me tomorrow. (3h)
[[File:PrinterClusterData.zip]]

=Sun Jul 2, 2017=

Wrote a webtemplate for managing multiple instances of octoprint,

additionaly step by step instructions to make the OSE Printer Cluster image out of the octopi (8 h)

=Sat Jul 1, 2017=

Worked on Scanscript, ready for testing (6h)

=Fri Jun 30, 2017=

Got a SD card setup with octopi and written a documentation about how to do it right here

[[How_to:Write_Image_to_SD_Card]]

The Image itself btw can be found here

[https://octopi.octoprint.org/ Octopi]

The hardware setup is displayed in the presentation already, so there is nothing holding us back from testing the software upon a printer.
Additionaly, I've figured out some of the missing pieces and began writing a python script for autorecognition of the 3d printers.
(5h)

=Thu Jun 29, 2017=

Got a step-by step plan about what should be done, learned about the G-Code and found those of interest for me from Marlin.
(M115 gives me unique Data about the printer, M20 to M30 are used to read, write to the sd card and start the printing process from there)
Found out how to reformat fcstd to stl with command line only (for automatic conversion on upload).
(1,5h)

=Tue Jun 27, 2017=

<html><iframe src="https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/embed?start=false&loop=false&delayms=3000" frameborder="0" width="480" height="299" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe></html>

[https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/edit#slide=id.g1e7b20ee3a_0_10 edit]

Researched Methods for cluster management, communication between printer and computer etc.
Most Promising:
[https://github.com/foosel/OctoPrint Octoprint]

This can be run for [http://blog.patshead.com/2016/02/control-multiple-3d-printers-using-a-single-raspberry-pi-with-octoprint.html several printers]

Hardware is defined and set, list and setup in the presentation.
Very rough price estimate: 45 $ + 20$/printer(5h)

=Sun Jun 25, 2017=
Finished FreeCAD test, Video is uploaded to youtube.
https://www.youtube.com/watch?v=nkDFKByIPfE (about 7h)

Christian Rupp Log

2017-09-13T19:54:49Z

Christian:

{{Status|... Printer Cluster |Post bio on Developers page, Jitsi, Wordpress(?), ISO |...}}
{{RightTOC}}

[[D3D Log]]. [[Development Team Log]]. [[Marcin Log]].
[https://hangouts.google.com/hangouts/_/event/cfvdskolaipjgki95aoufjf3l50?hl=en&authuser=0 OSE Hangout] [https://meet.jit.si/SelfishStarsConjureHeroically Jitsi Meetup].

<html><iframe width="700" height="600" src="https://osedev.org/wiki/Christian"></iframe></html>

=Sun Sep 3, 2017=
Breakthrough with the ISO creation. The software used fixes the errors encountered with the current version. Furthermore, due to the possibility of better testing I could prove my concept of the jitsi plugin, its functional. Additionally, I could test the /etc/skel directory, and its working, further customized settings can now be integrated. I did nearly everything wished from the list (including the new debsum package, which is a reasonable add), including the vocoscreen settings and the freecad macro, and added all up to a new, tested version of the ISO which will go online tomorrow.

There are however (little) flaws left:

For some reason, arduino wont work properly unless started as root, this may however be system specific and basically fixable by running

sudo adduser $USER dialout

maybe I'm able to integrate that in the basic startup process, this may however be complicated. I could also write a little script that starts the program but requires root rights so the user is prompted to provide it.

Additionally there are settings to do regarding cura and blender, however I'm completely unfamiliar with those, this looks like something an expert provides for me (if anyone says he/she knows the perfect setup, contact me!)

Additionally I worked on the OSE server (or, more like it, setup a client on my side). (6h)

=Thu Aug 31, 2017=
Workstation at home is now functional, found a software perfect for our needs, however it still has some flaws to be corrected, I had to comment out some bad source code, its working, documentation follows. the used software is

https://github.com/kamilion/customizer

And its taking out all hazzle with setting up the ISO, and rounds all up with a neat GUI, however lacks of a simple changer of Desktop Enviroments (however, this is kind of luxury, we can just work with xubuntu, lubuntu etc) (5h)

=Sat Aug 26, 2017=
Setup a new workstation here, however didnt work, several errors here, may take some time... (2h)

=Thu Aug 24, 2017=
Unfortunately, I have some hardware problems, but the first version of the ISO is available [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here].

Due to my problems the features explained yesterday are NOT included, but giving out the ISO to find out what default settings suits us best should help getting out a better version.

=Wed Aug 23, 2017=
Did some research with very encouraging results, two processes in particular:

The [https://wiki.ubuntuusers.de/Ubuntu_Customization_Kit/ Ubuntu Customization Kit] lets you create an ISO with a gui and further very easy options in contrast to the very confusing commands to otherwise setup a chroot.

The customization of the 'default user': from that Page, I also derived information on how to customize the users that get created (on starting the live version for instance). This makes a custom desktop possible as well as custom settings for any program imaginable. (1,5h)

=Tue Aug 22, 2017=
Finished the update, got many things to work, got to test the result yet with virtualbox, I'll do that tonight.
Those things were not (yet) possible:

Setting other defaults for vokoscreen (consists only of one binary, personal settings are created for specific user)

Adding the printer to Cura (Although it is probably possible, it basically has the same problem as the above, I'll document further info)

Adding the Macro to freecad (Is also saved into the users folder per default, as there are no macro examples, I couldnt slip it in somewhere)

This means that I placed those files in the /opt folders for further access. (2,5 h) Download link follows after the testing was done.

=Mon Aug 21, 2017=
Updated the iso with some new information, optimized a few steps and tested that (1,5h)

=Thu Aug 17, 2017=
Created a new ISO for OSE Linux, including new software and updating existing. Added new software and some special settings, however not all wishes could be fulfilled, documentation follows (I've shortened the installation process). (4h)

=Wed Aug 16, 2017=
Piwik seems to be highly insecure, so some research had to be done. Probably we'll be switching to Open Web Analytics.

Setup of wordpress for Jose, unfortunately the URL has to be adjusted yet (3h)

=Tue Aug 15, 2017=
Unfortunately, there were serveral issues on the way, primarily coming from the security side... Had to research further and talk with michael about further steps

=Sat Aug 12, 2017=
Got to work on piwik, some problems occured, about half way (hopefully) through. (4h)

=Tue Aug 8, 2017=
Talked with Marcin and Michael about server security. (2h)

=Sat Jul 27, 2017=
Researched my docs about the https encryption, looked through the basic system of piwik and the usual safety-measures. Prepared everything on server for setup (root access still required). (4h)

=Thu Jul 27, 2017=
Took a while to figure out the errors, there were two; rc.local had the wrong permissions, I added the necessary steps to the instructional, and a classic mistake in the Scanner (intendation error...), not quite sure where that came from.

Additionaly I figured out how to make the image for distribution only as small as the files contained, other than the size of my SD card (which would make the use of a 4 GB SD card impossible). All is now uploaded, corrected, tested and well. (5h)

=Wed Jul 26, 2017=
Started the documentation of the testing and created a main article on the printer cluster, including all the used ressources, install instructions, testing results and all the information I collected while I was setting up and configuring the image.
All of this is now collected here: [[3d_Printer_Cluster]]

However, I was confronted with problems on the image I was uploading to my drive, I'll have to redo some things there... (4h)

=Tue Jul 25, 2017=
Got the testing scenario right, tested on and finished.

Did refurbish the code a bit and uploaded the new version.

The Image is now collected and done, it lays in my drive right here [https://drive.google.com/file/d/0ByUmXv7QXHeQLXdEbG55MlM2eXM/view?usp=sharing Printer Cluster] for installation, just follow these Instructions [[How_to:Write_Image_to_SD_Card]]. More detailed Documentation tomorrow. (7h)

=Mon Jul 24, 2017=
Started testing, couldn't however communicate with the Marlin; possible solutions:

1. Marlin wasn't setup properly: check by sending GCode via USB from a 3d print software.

2. Pins aren't setup properly: May need its power from the USB to UART, not only ground... (till now, I power comes from USB)

3. Contact protocol is wrong: Check the Bitrate (with step 1) and the /dev folder on whats appearing on plugging in

=Sat Jul 22, 2017=
Took part of the sprint for the CEB Press, I did insert new rods

Also stayed for the filament extruder. As there was nothing to do for me, I setup my freshly arrived Ardurinos
. All thats missing now for testing is the USB to UART converter, I can and will pick it up on monday (5h)

=Fri Jul 21, 2017=
Preparated the software for testing, adding slicing profile to script, configured Marlin, ready for the ardurinos to arrive(3,5h)

=Thu Jul 20, 2017=
Talked with Michael on how I can help administering the server (1h)

=Wed Jul 19, 2017=
I was given the task of making the wiki more accessible, so I asked myself

How can we organize the current information on the wiki?

The sites have to be hierarchical, so there are main sites, that redirect to more specific undercategories. Crossreferences are no problem of course, this is only about quickly aquiring information. This means also that those hierarchical links should be displayed prominently. For organising the information in that way, we have to map the wiki first, so we can manually decide how the every site should be reachable from the main page.

The following tools will therefore be of use:

[https://www.mediawiki.org/wiki/Extension:VIKI Visualization of the Links]

[https://www.mediawiki.org/wiki/Extension:Semantic_MediaWiki_Graph Simpler Variant, maybe interesting if we have to modify the script]

[https://www.mediawiki.org/wiki/Manual:GenerateSitemap.php This way we not only can see every site, we can also make it easier for google users to spot specific site of the wiki]

Additionaly, I ordered the more parts necessary for setting up a printer cluster on my own (at least the software-site). Documentation will follow when I start the setup (2h)

=Friday Jul 14, 2017=
Setup the Pi with marcin, gave me SSH access cia DynDNS (4,5h)

=Wednesday Jul 12, 2017=
Learned about AT code, about how to connect with the RC12 module and some other details for setting up the transceiver (2h)

=Tuesday Jul 11, 2017=
Tried to setup the SD card with Marcin, failed because of different errors (2h)

=Sun Jul 9, 2017=
Written a definite manual on how to setup software and hardware in its entirety. The instructions are in the google spreadsheet seen below (Jun 27). (0,5h)

=Sat Jul 8, 2017=
Had some thinking about security, user internal permission restrictions. Would be a pain to explain it all, however, solved it by running scanner on systemstart (there it is always run as root) and trigger the running by a variable settable by the website (clicking on the button).

Additional, reboot works now (and it should now be easy to implement further commands if necessary).

Lastly, some little code optimization (looks far more convenient now), renaming of the host to replab (this is now also what you type into search bar for accessing the website) and I licensed the files under the GPLv3. (6h)

That means the user interface is done and ready for testing. Changes will now only impact the Scanner and Maybe some design wishes (I'm open for requests) for the website.

=Fri Jul 7, 2017=
Took longer than expected, but the uploader contains now a drag and drop and accepts mutliple uploads at once and mirrors the design of the website. (5h)

=Thu Jul 6, 2017=
Integrated the script into the Web Interface, the current model allows an upload via the 3dPrinter website. The upload then automatically converts the file into stl. Currently, the upload allows fcstd and stl files. The Upload blocks the website for the uploader until the upload is complete, after that, the file is already accessible in the Octoprint interface.

The upload is should take about a second per 20 kb of fcstd converting. This means, a 60 kb file takes 3 seconds of 'uploading'. (4h)

Drag and drop and a neater upload interface will be the next goal.

=Wed Jul 5, 2017=
Designed a script to convert fcstd to stl. It's tested and working, however it seems not to work perfectly with all Parts.
I think this is not fault of the script but of freecad. It seems to impact only very complex forms, so I hope it won't impact our work. The script will be added to the zip as soon as it is implemented into the website. (3h)

=Tue Jul 4, 2017=
Wiped the Testpi end redeployed it in the simplest way possible and wrote the instructions down here [[How_to:_Create_Printer_Cluster_Image]] (1h)

=Mon Jul 3, 2017=
Added Lazyload to the iframes for a maximum of performance, added buttons for server management (reboot etc.), merged all data to a zip file with a how to, taking [https://octopi.octoprint.org/ octopi] as a basis. Package will be tested by me tomorrow. (3h)
[[File:PrinterClusterData.zip]]

=Sun Jul 2, 2017=

Wrote a webtemplate for managing multiple instances of octoprint,

additionaly step by step instructions to make the OSE Printer Cluster image out of the octopi (8 h)

=Sat Jul 1, 2017=

Worked on Scanscript, ready for testing (6h)

=Fri Jun 30, 2017=

Got a SD card setup with octopi and written a documentation about how to do it right here

[[How_to:Write_Image_to_SD_Card]]

The Image itself btw can be found here

[https://octopi.octoprint.org/ Octopi]

The hardware setup is displayed in the presentation already, so there is nothing holding us back from testing the software upon a printer.
Additionaly, I've figured out some of the missing pieces and began writing a python script for autorecognition of the 3d printers.
(5h)

=Thu Jun 29, 2017=

Got a step-by step plan about what should be done, learned about the G-Code and found those of interest for me from Marlin.
(M115 gives me unique Data about the printer, M20 to M30 are used to read, write to the sd card and start the printing process from there)
Found out how to reformat fcstd to stl with command line only (for automatic conversion on upload).
(1,5h)

=Tue Jun 27, 2017=

<html><iframe src="https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/embed?start=false&loop=false&delayms=3000" frameborder="0" width="480" height="299" allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe></html>

[https://docs.google.com/presentation/d/1XZoDbC9xBgPzMYaNcVtp2aJ7RO_o3_8pGTof9HXa7RA/edit#slide=id.g1e7b20ee3a_0_10 edit]

Researched Methods for cluster management, communication between printer and computer etc.
Most Promising:
[https://github.com/foosel/OctoPrint Octoprint]

This can be run for [http://blog.patshead.com/2016/02/control-multiple-3d-printers-using-a-single-raspberry-pi-with-octoprint.html several printers]

Hardware is defined and set, list and setup in the presentation.
Very rough price estimate: 45 $ + 20$/printer(5h)

=Sun Jun 25, 2017=
Finished FreeCAD test, Video is uploaded to youtube.
https://www.youtube.com/watch?v=nkDFKByIPfE (about 7h)

OSE Linux - 2.0 version from 2020

2017-09-12T20:26:05Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ Doc with detailed Walkthrough]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:24:35Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==Old==
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:23:49Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot()
and look under it, there should be a line going like 
if config.KERNEL is not default
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==old== 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:22:19Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). Additionally, the set setup.sh from the arduino folder must be run to make it a valid program for the user. 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==old== 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:20:24Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==old== 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:19:36Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==old== 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:17:31Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]
 
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]
 
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''
 
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==old== 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:16:44Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

==Old==
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

==Old==
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''

==Old==
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

==old== 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:16:06Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

==Old==
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

==Old==
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''

==Old==
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. 
This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). 
When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!! 
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system). 
The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

old 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:13:45Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

==Old==
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

==Old==
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''

==Old==
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings 
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!!
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system. The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

old 
Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T20:11:56Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

==Old==
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

==Old==
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''

==Old==
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. This has of course to be done before the compiling into a deb file. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using the chroot console to setup our iso.
The following commands will setup the system: 
'''Basic Installation of programs 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list
mount -t proc none /proc
dpkg --add-architecture i386
add-apt-repository ppa:freecad-maintainers/freecad-stable -y
add-apt-repository ppa:freecad-community/ppa -y
add-apt-repository ppa:thopiekar/cura -y
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y
add-apt-repository ppa:js-reynaud/kicad-4 -y
add-apt-repository ppa:webupd8team/brackets -y
add-apt-repository ppa:freecad-maintainers/freecad-daily -y
add-apt-repository ppa:kdenlive/kdenlive-stable -y
apt-get update
apt-get upgrade -y
apt-get install freecad freecad-doc gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser freecad-daily freecad-daily-documentation debsums -y

'''Installing Cura
apt-get install python-opengl python-serial
wget http://download.lulzbot.com/Software/Cura/Packages/Cura_21.08/debian/stretch/cura_21.08-f2748_amd64.deb (or the most current, check it)
dpkg -i cura_21.08-f2748_amd64.deb
rm cura_21.08-f2748_amd64.deb

'''Install Arduino 1.6.8 (NOT the current)
wget https://downloads.arduino.cc/arduino-1.6.8-linux64.tar.xz
tar xvfJ arduino-1.6.8-linux64.tar.xz
rm arduino-1.6.8-linux64.tar.xz
mv arduino-1.6.8 /opt
'''and add the OSE Marlin to the examples
cd /opt/arduino-1.6.8/examples
mkdir OSE
download the file in http://opensourceecology.org/wiki/File:OSE_Marlin.zip
unzip OSE_Marlin.zip and put the contained file called Marlin in the OSE directory, then delete the rest
Give it the right to access it, with chown or simply: chmod 777 -R OSE (theres no inherent danger from that code when accessible)

'''installing inkscape export:
wget http://bigbluesaw.com/media/BigBlueSawDXFOutput-Version0.2.zip
unzip -o BigBlueSawDXFOutput-Version0.2.zip -d /usr/share/inkscape/extensions/
rm BigBlueSawDXFOutput-Version0.2.zip

'''installing threejs blender addon:
wget https://github.com/mrdoob/three.js/archive/master.zip
unzip master.zip
cp -r three.js-master/utils/exporters/blender/addons/io_three /usr/share/blender/scripts/addons
rm master.zip
rm -r three.js-master

'''jitsi extension:
nano /etc/chromium-browser/policies/managed/statkey.json
write in there
{
"ExtensionInstallForcelist":
["kglhbbefdnlheedjiejgomgmfplipfeb;https://clients2.google.com/service/update2/crx"]
}

'''Custom User settings
To make the user experience perfect, we need to adjust some user settings for the freshly logged in user. Unfortunately, the user for the live CD is created on the fly, therefore it cannot be preparated. However, it is possible to manipulate every new user that is created by providing their default folders and everything. This means, we will preparate the user by setting it up: Run the not created ISO by burning it to a stick, hosting it with a vm or similar, and set it up in a way that everything important is added and set. This includes cleaning the desktop and preparing the taskbar, starting Freecad and installing macros and commands there, and prepare Cura to create GCode for the OSE D3D Printer (More details on that is provided on the software list to the specific task). When that is done, copy the ENTIRE personal folder (including all hidden folders) into a safe place in the network, as the live CD will not remember any changes. A Cloud, NAS, or simply [https://help.ubuntu.com/community/SSH/TransferFiles scp] will do the job, however remember not to leave traces, like a remembered password or personal data, as they will be replicated to every new User of the ISO!!!
When you did that, copy all those files (the hidden included, better double check) into the /etc/skel directory of your chroot (you can do that with scp as well as just adding it into the filesystem that is chrooted on the main system. The skel folder is basically replicated as a blueprint to every new created user, so every setting left there is then carried forward to the new created user. Rebuild the ISO, and you should be done!

old 
[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T19:35:36Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

==Old==
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

==Old==
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''

==Old==
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using chroot mainly to setup our iso.
The following commands will setup the system: 
'''Basic Installation 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list 
mount -t proc none /proc 
dpkg --add-architecture i386 
add-apt-repository ppa:freecad-maintainers/freecad-stable -y 
add-apt-repository ppa:freecad-community/ppa -y 
add-apt-repository ppa:thopiekar/cura -y 
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y 
add-apt-repository ppa:js-reynaud/kicad-4 -y 
add-apt-repository ppa:webupd8team/brackets -y 
apt-get update 
apt-get upgrade -y 
apt-get install freecad freecad-doc arduino gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser cura debsums -y 

old 
[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]

OSE Linux - 2.0 version from 2020

2017-09-12T19:31:58Z

Christian:

Page under active editing 3/17

[[Image:oselinux.jpg|thumb|OSE software stack.]]

=What is It?=
OSE Linux is a freely downloadable operating system that contains all software that is used regularly at OSE. It is run as a [[Live USB]] without the user having to modify or upset their usual operating system in any way whatsoever.

This addresses the tens of hours that it would potentially take to download and configure all the software and libraries in common use by OSE. Instead, a single install, taking under half hour of dedicated user time after download, is sufficient to download the entire operating system.

It is a good practice for [[OSE Developers]] to download and use the system to avoid software malfunction, improper settings, and in general the time it takes to download or install various software and its extensions, such as additional workbenches in FreeCAD, browser plugins, etc. OSE uses only open source software to produce all of its work product to facilitate interoperability with a large global team of developers.

'''Please note that OSE uses a lot of custom software - so please save yourself hours of install time and and just download the prepared OSE Linux. We are doing this to make your life easy. Note also that you should not run OSE Linux in a Virtual Machine, as a Virtual Machine will be much slower at computation intensive tasks such as CAD.'''

OSE Linux can be used by downloading the ISO, and creating a bootable USB stick. Instead of using one's regular operating system, one can choose - upon startup - to run the OSE Linux operating system from a USB stick, without installing it on one's hard drive. '''Note that currently you can't save files on the Live Linux - so upload any documents to your log, the wiki, or use cloud-documents where data is not saved locally.'''

=Download the Current ISO Link (For OSE Linux Live End Users)=
==Current==
'''Sep 9 release 
All programs are now arranged to some extent, no setup of cura or freecad needed. All programs asked to date are added and functional. The screen is setup for the working with the OSE software and not just the default look. 
Some people came up with an issue regarding the ethernet connection, although there wasn't much testing yet, the top answer of this question may help [https://superuser.com/questions/351960/can-i-enable-wifi-on-a-ubuntu-live-cd Wifi Ubuntu Live CD]. This will be adressed when a solution is found. 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQcDFyWG9xdndvOGs/view?usp=sharing here]

==Old==
'''Sep 3 release 
same as last version, fixed some breaking bugs and added some basic options as default, as well as the program debsums. This version should be fully operable and its recommended updating to it 
The Download Link is [https://drive.google.com/file/d/0ByUmXv7QXHeQSU1vT01MYmJQb2s/view?usp=sharing here]

==Old==
'''Aug 23 release 
A new version has been released with further, sophisticated options. Some of them are not in an optimal stage, so I am awaiting some feedback how the default should look like. That means setting up the different software parts in a way thats most convenient and sharing it in the [https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/edit#gid=0 software list]. As for now, in the /opt folder (filemanager > system > opt) there is the Macro sheet for freecad and the .ini for the d3d for Cura. The Marlin Software can be found in the examples os the arduino software 
The Download link is [https://drive.google.com/open?id=0ByUmXv7QXHeQUV9EVlozQUVNTFE here]

==Old==
'''APR 28 hybrid release 
Link to shared Google Drive folder containing all versions[https://drive.google.com/drive/folders/0B3BMDf7eJE2IenozczVScXA0ZVk] 
The CURRENT OSE Live iso is named 4-28-17ose0.42.iso '''
*'''LINK TO DOWNLOAD ISO - [https://drive.google.com/file/d/0B3BMDf7eJE2IOGR0enlFU0NBSGc/view?usp=sharing]'''

==Old==
*2/17 - [https://drive.google.com/drive/u/1/folders/0B3BMDf7eJE2IenozczVScXA0ZVk]
*Version 0.3 - [https://drive.google.com/file/d/0B3BMDf7eJE2IM3F5V0ZLaHlBNUU/view?ts=58c8a40b]
*Radme by Jai Kumar - [https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/edit]
MD5SUM:
{{Hint|Latest Version is 0.3 }}

And then create a bootable USB drive with that file.

To do that, GoGoDuck - https://duckduckgo.com/?q=iso+to+usb&t=canonical&ia=web

{{Hint|Instructions for creating a bootable USB are in progress as of 3/14/17 by [[Jai Log]]}}

==Download Tracking==
Need to track the number of downloads just like Arduino does - see this nice example:

[[File:downloadtracking.jpg|800px]]

Once created, this data should be posted at the [[OSE Stats]] Page.

=Software List=
This is a partial list of software that OSE uses:

<html><iframe src="https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/pubhtml?widget=true&headers=false" height=500 width=800></iframe></html>

[https://docs.google.com/spreadsheets/d/1hk1Tec4tkEDe47sEtRu7wySa8U4zYWBEat_dWZezQa0/ edit]

== TO USE the OSE LInux ISO yourself, please skip down the page to the TESTING Section, HOWTO Documents: ==
This How To Create the ISO section is for developers that are working on creating and improving the ISO itself. 
'''End users should either follow the Linux Users or Windows Users HOWTO''' as seen in the Testing section of this page.

[[#Linux HowTo|LinuxHOWTO]]

=How to Create the ISO on an Existing Ubuntu System (For developers - This is not the end-user HowTo) =

We are using the customizer by kamilion:
 
https://github.com/kamilion/customizer/wiki/First-guide
 
however, there is a problem with the iso creation process:
we need to modify the source code, as the kernel download will otherwise fail and disturb the creation of the iso. For that, we have to edit: 
/{Unzipped Master}/src/actions/rebuild.py
go to the line 
detect_boot() 
and look under it, there should be a line going like 
if config.KERNEL is not default 
comment that out (with #) until next else (including the else) and then correct the intendation (as python is very sensitive to that), meaning everything to the next empty line has to be moved left one 4 whitespaces. In the end, it should look like this:
#if config.KERNEL is not "default" or None:
# misc.chroot_exec(('apt-get', 'install', '--yes', \
# config.KERNEL, '-q'))
#else: # use the kernel the user specified in the config.
if arch is not "amd64": # then use the 32bit 'linux-image-generic'
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-image-generic', '-q'))
else: # use the amd64 'linux-signed-generic' for uEFI
misc.chroot_exec(('apt-get', 'install', '--yes', \
'linux-signed-generic', '-q'))

 
 
for starting the software just type into a console: 
sudo customizer-gui

There most of the things are pretty self-explainatory or described on the github page, we will be using chroot mainly to setup our iso.
The following commands will setup the system: 
'''Basic Installation 
echo "deb http://us.archive.ubuntu.com/ubuntu xenial main universe" >> /etc/apt/sources.list 
mount -t proc none /proc 
dpkg --add-architecture i386 
add-apt-repository ppa:freecad-maintainers/freecad-stable -y 
add-apt-repository ppa:freecad-community/ppa -y 
add-apt-repository ppa:thopiekar/cura -y 
add-apt-repository ppa:maarten-baert/simplescreenrecorder -y 
add-apt-repository ppa:js-reynaud/kicad-4 -y 
add-apt-repository ppa:webupd8team/brackets -y 
apt-get update 
apt-get upgrade -y 
apt-get install freecad freecad-doc arduino gimp inkscape audacity libavcodec-extra simplescreenrecorder librecad sweethome3d blender kicad openscad fritzing brackets gnumeric gnumeric-plugins-extra gnumeric-doc freecad-extras-drawing-dimensioning freecad-extras-assembly2 freecad-extras-fasteners gmic gimp-gmic git kdenlive vokoscreen chromium-browser cura debsums -y 

old 
[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

Step 1: Download the Ubuntu iso to customize. Remember the directory where it is saved, because we would need to move it later.

Where do I go to download ubuntu.iso? I originally use a USB drive to install Ubuntu 14 onto my computer (recently ran the upgrade to get version 16). The ISO image is on that USB drive?

[https://docs.google.com/document/d/1pwJHMRnuqmvdpJWd2PCmL_HzQrgnV4T3d4uwxFobtzM/ edit]

I followed the instructions below and received the error listed here.

2.a. sudo apt-get install squashfs-tools genisoimage

3.a. mkdir oseimage

4.a. cp /path/to/saved/ubuntu.iso ~/where/to/save/custom-img

Error -> cp: cannot stat '/path/to/saved/ubuntu.iso': No such file or directory

=Testing=

We are documenting which systems work successfully for Live boot and/or install of the OSE Linux ISO.

Please document 3 things:
#Version of the OSE Linux you are trying to boot and/or install - date or link to the download from above. Note that new versions will be published quarterly. It is impotant to keep notes on the specific version that you are using so there is no confusion on which OSE Linux versions are successful
#Hardware you are using, such as Dell Precision M6500 Laptop
#Operating system that you are using on your hardware - such as Ubuntu 16.04.

To document this for your system, please go to See [[ISO to USB Install Notes]].

=HowTo Document for Linux Users=

Objective: A bootable USB stick that provides the OSE Live desktop, and will run all the OSE programs without touching any existing locally installed OS on the computer.
It's a way to test, and use, the OSE programs (3D design, 2D design, video capture and edit, resource management) and not disturb the current computer setup.

1. Download the ISO (See above for current ISO URL) 
2. Burn ISO to USB 
3. Boot your computer with the USB 
a. have you set the BIOS to boot USB ? 
b. do you know the keystroke for Boot Menu on your computer ? (ESC) or (F8) or (F12), etc 
 
'''Here is the video HowTo for Ubuntu 16.04 users, GUI version'''

<html><video height="400" controls>
<source src="http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm" type="video/webm">
Your browser does not support the video tag.
</video></html>

http://opensourceecology.org/w/images/2/23/OSE_Live_USB_HowTo.webm

<html><iframe src="https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1w2kDCAVJSsMwQuX4gstq-YLM0X2l32H6cTlbD2zwJM4/ edit]

= HowTo Document for Windows Users=
<html><iframe src="https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/pub?embedded=true" height=400 width=80%></iframe></html>

[https://docs.google.com/document/d/1baJdLIh1m7_VjUoDq2-9P1LWRzwUcQkxhl0ZNB_6WoU/ edit]

The links below would help with: '''Setting up the OSE_OS on a Virtual Machine (using VirtualBox) on a Windows System.''' 
Note that some lag might be experienced with such an installation depending on your system specs and some OpenGL glitches have been reported in the past though they seem currently resolved. If the ability to switch seamlessly from Ubuntu to Windows without having to reboot is essential as an option, it might be worth a try: 
[http://www.psychocats.net/ubuntu/virtualbox Installing Ubuntu inside Windows using VirtualBox] 
[https://www.howtogeek.com/howto/2845/install-guest-additions-to-windows-and-linux-vms-in-virtualbox/ Install Guest Additions to Windows and Linux VMs in VirtualBox] 
[https://www.howtogeek.com/187703/how-to-access-folders-on-your-host-machine-from-an-ubuntu-virtual-machine-in-virtualbox/ How to Access Folders on Your Host Machine from an Ubuntu Virtual Machine in VirtualBox]

==Mac==
*'''How to Create a bootable Open Source Ecology (OSE) Linux USB Stick on Mac OS X''' -
[https://gist.github.com/gregoryfoster/35d8037a6a8424661a8a2606c1280785]

=OSE Linux Assists in Providing Technical Support=
Technical support is a service of huge importance to the OSE community. As a [[Distributive Enterprise]], OSE is interested in self-maintaining technical support base that can scale to millions of users.

To achieve this, part of our strategy is to utilize OSE Linux as an essential aspect of OSE's technical support. This is a managed distribution that works out all software-related issues for the OSE community - by providing a Linux distribution that just works.

Software-related issues stand in the way of seamless, distributed, open source collaboration. Overall, OSE Linux saves the OSE developer/user community thousands to millions of hours of total time that would otherwise be spent with people downloading software and making it work. To address this issue, OSE is proposing that any OSE user or developer obtains a copy of OSE Linux. This allows for a completely uniform way to eliminate all software related issues: improper installs, drivers, libraries, package conflicts, bad settings, security issues, software crashes, updates, and any other software issues. This is done by installing and using an entire OSE operating system, with all software prepared. The goal is to produce a stable and widely accessible system that can be run from a USB or that can be installed as a [[Multi-Boot System]]. The release schedule for updates will be quarterly.

=Requirements=
*Follows Best Practices for creating a Linux distribution
*Download statistics are tracked - number vs. Time, and are displayed via a wiki script
*Single configuration with all of OSE-critical software
*Contains libraries - such as tractor design in FreeCAD, etc.
*Has a Team Charter for long term support
*Clear hosting strategy and admin
*Donation option with hosting transparency page of cost and uptime, and user statistics
*Download requires an email for future communications
*Clear OSE Social Contract - contract with the OSS/H community to keep this distribution open source for ever
*Clear contributor agreement
*Clear repositories for design - distributed and pulled into the OSE distribution as current working design libraries.

=Links=
[[IT Support]]