USBmaker

From Open 1-To-1

Revision as of 15:26, 4 February 2010 by Dtrask (Talk | contribs)
Jump to: navigation, search

Contents

Updated Image - please test!

I have uploaded an updated image for use with the imaging solution below. This is the GOLD version of the new image. We're using a whole new imaging technology so it can be put on any size hard drive provided it will fit (the image is about 5gb) The image can be downloaded HERE Unzip it and put the contents into the "images" folder on your USB imaging stick. Test the image like crazy and report any bugs you find..etc.

UPDATE: files are now in ZIP format

NOTE on beta images: BETA means just that. It's a testing version...not necessarily ready for production. Please test thoroughly before doing any large scale deployment. If it breaks your machine...you get to keep both pieces  ;-) Please report any issues to the open1to1 discussion list.


If you are on a Windows machine...I encourage you to download and install 7-Zip (which is Open Source), a very powerful unarchiver for many file types. Visit 7-Zip.org for more information.


So...you're ready to try it out!  :-) BEGIN HERE

The developers for Open1to1 have been striving to make the deployment of the Open1to1 image as easy and painless as possible. One way to accomplish this is with the USB-maker. The Open1to1 USB-maker will automatically download the pieces you need and create your bootable USB stick for use with the Open1to1 imaging solution.


What you'll need

At least a 4 gb USB stick (the more images you wish to experiment with the bigger the usb stick you should have)

A Linux or Windows computer (sorry...no Mac client yet *can you help us develop one?*)

An internet connection (the usb-maker files are quite small so speed should not be a big issue, however the image file is quite large...broadband is recommended)

Let's get started!

Windows Version

First, download the Windows version of usb-maker HERE. Next, make sure your USB stick is inserted into the computer. Once downloaded, right-click on the file and "extract" or unzip it. Once unzipped, open the folder "usb-maker-win32" and click usb-maker. (fig 1)

View fig 1

Once usb-maker is launched, simply click OK and let the magic happen (be SURE to insert your USB stick prior to launching usb-maker) fig 2

View fig 2

Once the usb-maker has completed, select "Exit". (Reboot is ONLY to be used if you downloaded an image and plan to reimage the computer that you are currently using...this WILL ERASE your computer...so please select "Exit") fig 3

View fig 3

Now let's download the latest Open1to1 image file, unzip it, and place the contents into the "images" folder on the USB stick. Download the latest image HERE (this file is LARGE...about 2 gb) fig 4

View fig 4

NOTE: the usernames and passwords for the image are as follows

User Type Username Password
admin user netbook netbook
limited power user teacher teacher
limited user student student


Once you've copied the image file(s) into the "images" folder on the USB stick you're ready to go! Now it's time to learn how to use the Configuration Tool! fig 5

View fig 5



Linux Version

Before you begin Make sure you have a USB stick inserted into the computer. The USB stick should be formatted FAT32. Depending on your computer you make also need to install one or two additional files for the usb-maker to work. Most commonly these files are mtools and p7zip-full. (the usb-maker program will tell you if they are missing, but you may want to run the commands below just to be sure)

These commands assume that you are using Ubuntu, Open1to1, or another Debian-based linux distribution. If you are using Fedora or another non-Debian distribution, please substitute the proper syntax for your situation. NOTE: usb-maker for linux has only been tested on Ubuntu, Resara, Debian, and Open1to1 at this point in time...if you are using another distribution and it works for you...please share your results!

sudo apt-get install mtools p7zip-full

First, click HERE to download the latest usb-maker for linux. Next you'll need to extract it...this can be done via the GUI by double-clicking and using your system unarchiving program...OR you can use the terminal (aka command-line) by going to the directory where you downloaded the file and typing:

UPDATE: Until I fix the stuff below...the new usbmaker for linux is a shell script. Download it and run it...you MAY need to make it executable prior to running it. To do this...

sudo chmod a+x usbmake-linux.sh

Stuff below may be outdated

tar -xzvf usb-maker-linux.tgz

Once you extract it...go to the folder "usb-maker-linux" and open it up. Inside you'll find an executable shell file called "usb-maker.sh". fig 1

View fig 1

Double click and choose "Run". fig 2

View fig 2

Once you click "Run" you'll see the main screen of the usb-maker program. fig 3

View fig 3

All you need to do now is click "OK" and that will begin the process of creating your USB imaging stick. fig 4

View fig 4

Now let's download the latest Open1to1 image file, unzip it, and place the contents into the "images" folder on the USB stick. Download the latest image HERE (this file is LARGE...about 2+ gb)

Once you've copied the image file(s) into the "images" folder on the USB stick you're ready to go! Now it's time to learn how to use the Configuration Tool!

Configuration Tool

Currently the configuration tool only runs on Linux and Windows.

Running the Configuration Tool in Linux

NOTE: Depending on your linux installation...you may need to install the package libqt4-gui before you use the Configuration Tool. To do so...type:

apt-get install libqt4-gui

If you have a Linux machine already set up...simply stick the USB stick you created with usb-maker into your machine. Once it's loaded, click the file "Configure Image Linux.sh". Select "Run". fig 1

View fig 1

Once you click and launch the Configuration Tool you can now make some configuration changes (decisions). On the first screen (General tab) you have the option of telling the "imaging program" to allow you to manually enter a hostname at first boot...or you can automatically generate one with a prefix of your choosing and the machines MAC address appended to it. Example: Franklin-High-School-netbook-080027ed4731 You can decide what works best for your situation. You can (and should) change the default passwords. You should change the "admin" password (aka netbook user) to something else as the password is published on this web site. Last is the creation of the swapfile. This is enabled by default to allow many netbooks to be able to go into "hibernation" mode. If this is not important to you, you can disable it. When in doubt...go with the defaults. See screenshot for more info.

View screenshot


On the next screen (Software tab), you have the option of uninstalling some of the default packages that have been installed. If you wish to remove packages from the image, you should experiment with this before committing it to all of your machines. Leaving a package checked means that NOTHING will happen...the package will remain where it is. Unchecking a box will REMOVE the package from the image. See screenshot 2 for more information.

View screenshot 2

On the last screen (SSH Access tab) you can enable or disable SSH on the machine. SSH is often used by administrators to connect to a computer remotely to transfer files, remotely administer, and conduct troubleshooting. It's enabled by default, but you can choose to disable it if you wish. Experienced administrators can also provide "trusted" keys if they wish. (This is not necessary, but merely a convenience) See screenshot 3 for more information.

View screenshot 3

Running the Configuration Tool in Windows

To use the Configuration Tool in Windows, simply insert the USB stick you created using usb-maker and then click the file "Configure Image Windows.bat" to launch the tool. See screenshot for more information.

View screenshot

For more detailed information see the section above on using the tool in Linux...the screens and options are identical.

Important Notes

Once you've finished with the Configuration Tool, you can copy the "settings" folder to many other USB imaging sticks created with usb-maker. No need to run the configuration tool multiple times. If you wish to change or update your settings...simply insert the USB stick...run the Configuration Tool and the old settings will be overwritten with the new ones. See screenshot for more information:

View screenshot

As indicated above, you'll need to download the Open1to1 image (or create your own with the USB imaging stick). This file(s) can be downloaded here. Once downloaded...unzip the file and copy the contents into the "images" folder on the USB imaging stick. You can then copy the "images" folder from one USB imaging stick to another. See screenshot for more information:

View screenshot

Personal tools