Posts: 1,062
Dave
Joined: 20 Jan 2010
#1
I have written up a how to for remaster.sh, there is a pdf copy as well as what is written below.

PDF COPY

========= SCRAPER REMOVED AN EMBEDDED LINK HERE ===========
url was:"http://www.daveserver.info/antiX/remaster-guide.pdf"
linktext was:"remaster-guide.pdf"
====================================


Quick Guide to using remaster.sh

Before using remaster.sh, you will need to know how to install applications from the command line. It is also very beneficial to know the basic bash commands for document management. Terminal applications such as mc and nano work with remaster.sh, however not all the applications work.

How to start with remaster.sh
- open terminal by:
menu --> terminal
or
menu --> run
type: roxterm
press: ok

- the terminal should open in your user directory, verify this by
type: pwd
press: enter / return

- output should be similar to this template
/home/USERNAME

- if pwd does not show an output similar to the above template, procede with the following
type: cd $HOME
press: enter / return

- verify this once again with pwd. Once you are in the correct directory make a new remaster directory for organization. This is done by:
type: mkdir my-remaster
press: enter / return

- Now change to your remaster directory, become root user and run remaster.sh
type: cd my-remaster
press: enter / return
type: su
press: enter / return
type: YOUR ROOT PASSWORD ( Established durring the install )
press: enter / return
type: remaster.sh
press: enter / return

- Now you have run remaster.sh, point it to the correct .iso, I preffer to use a iso downloaded to the hard disk.
type: /home/USERNAME/PATH-TO-ISO
press: enter / return

- You are now in the remaster console. You can now add packages, edit configurations, and add your own twists to the antiX iso. Here are several notes that will help you with your remaster.

1. If you need any internet connectivity it should be made through ethernet, I am not sure if all wirelesses do not work, but mine does not.
2. you will need to add packages via apt or manually through dpkg.
3. global configuration files are normally found in /etc/PACKAGE
4. user configuration files (those found in /home/USERNAME/) are to be placed in /etc/skel
5. application templates, default configs / settings are found in /usr/share/
6. desktop / menu shortcuts are found in /usr/share/applications
7. local scripts ( such as remaster.sh ) are found in /usr/local/bin
8. For space saving locals / some documentation can be removed, do not remove documentation that will be helpful to the end user.
9. there are a few scripts that run to setup antix live, boot cheat codes, slim login settings, etc... Be aware of these files, some are in /etc/init.d for loading on startup and some in /usr/share/antiX. These scripts can be edited but be carefull as them will effect the way your live cd works drastically
10. A convenient way I think to set the user prefferances in the gui, is to build a machine from a fresh install, configure it the way you like, then copy the configuration files from /home/USERNAME to /etc/skel of your remaster. To open both these using thunar, you would
11. remember to run apt-get clean to remove all the packages that were downloaded, this is a large space hog if not done.

menu --> run
type: thunar /home/USERNAME
press: enter / return
menu --> run
type: thunar /home/USERNAME/my-remaster/remaster/new-squashfs/etc/skel
press: enter / return

You can then copy and edit your user config files through the graphical user interface, rather than learning how to edit every different configuration file so it will work.

- Once you are done remastering your iso or even if you would like to take a break, press CTRL + D. The next questions will be talked through here, so you can answer them accordingly
1. Do you want to remove"/root/.bash_history","/root/.synaptic/log/","/var/lib/apt/lists/*" (Y/n)?
- this would be your remembered commands, installation log, and apt package lists, answer y and press enter /return if you want them removed.
2. Are you ready to start building the ISO (Y/n)?
- This would be y if you would like to make a cd image of your remaster, n if you are planning on working on it later. Press enter / return after answered. If n is answered then the script will closed till later, when you are ready to work on it again.
open terminal
type: cd /home/USERNAME/my-remaster
press: enter / return
type: remaster.sh -c
press: enter / return
Now you are in the remaster console once again, finish up your iso and follow the rest of the instructions.

3. Would you like to amend your version file (y/N)?
- If you would like to edit the name of your version then answer y, if not n. Press enter / return when answered.
If y, when the editor opens
edit the file
press: CTRL + X ( when done )
press: y
press: enter / return
4. The ISO file will be placed by default in"/home/USERNAME/my-remaster/remaster" directory. Is that OK (Y/n)?
- pretty self expainatory, but if answered n you will need to enter a path. EG: /home/USERNAME/my-remaster and press enter / return.
5. Enter the name of the ISO file (default: remastered.iso)
- this will be the name of the .iso file for antix M11 full it is antiX-M11-686.iso. This can be changed later by renaming if a mistake is made. Simply type the name you would like EG: my-remaster-1.iso and press enter / return.

That is it, you should now have a remastered copy of antiX!!!
Posts: 20
Sombreros
Joined: 16 May 2008
#2
Thank you Dave that's exactly what I was looking.