User Tools

Site Tools


userspace:howto_use_the_scripts_-_a_short_description

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

userspace:howto_use_the_scripts_-_a_short_description [2011/12/16 12:57]
Thomas_H
userspace:howto_use_the_scripts_-_a_short_description [2021/08/23 08:37]
Line 1: Line 1:
-====== Howto ====== 
  
-===== ...use the listed scripts ===== 
- 
-written by  //[[hungerharke@gmx.de|Thomas_H]] 2011/12/16 12:50// 
- 
-Welcome to the wiki, initiated by users using opsi very proudly and successful. If you want to use Opsi (**O**pen **P**C **S**erver **I**ntegration) be aware, that this system is - like many other servers - none "out of the box". So get rid of any illusion, that you simply install opsi and right after installing you can install every software and operating system. Some work has to be done before you can do this! And nevertheless there are very(!) good instructions and manuals for opsi it's your's to create the most contents and packages for future installations. 
- 
-This wiki shall help to avoid much work to be done twice, because once a package is created successfully, the scripts can - and should - be published here. Remember: others invested lots of time to create these scripts, they spended time to publish them here and you save lots of time by using these scripts. So help others by publishing your own scripts, if you have to create some. 
- 
-This Howto is mostly for the newbies, starting with opsi, trying out the features. With this little Howto they should have the first success by creating a package, without knowing the "why" or "what" in the scripts. The "why" and "what" is something, you will have to learn later and let me say, yes you'll **have** to learn it, otherwise you always will need the help of other users. 
- 
-Of course: best is at last to get some training, you can get informations about training on opsi [[http://www.opsi.org/en/support|here]]. Commercial support is also avail. 
- 
- 
-==== Some words before beginning... ==== 
- 
-    * Read the manuals! We expect that you already have installed and configured your opsi-server on the manual named "Getting Started" 
-    * The published scripts are tested and they all work 
-    * If software is free, so you should find links above the scripts where to get it. If a software is free, and there is no link, so you can add it as a member of the [[http://forum.opsi.org/|forum]] (register yourself) 
-    * Commercial software has to be bought from the manufacturer and has not to be asked for in the [[http://forum.opsi.org/|forum]] ;) 
-    * If a script don't work, so ask politely in the [[http://forum.opsi.org/|forum]]. The error often is to be found between the screen and the chair. 
-    * If you need changes, so don't expect that others do this for you (except you pay UIB for doing this ;) ) Try it first for your own, and if it don't work ask the [[http://forum.opsi.org/|forum]]. 
- 
-And of course I expect, that you know how to open a terminal, or using putty and how to copy and paste some text to a terminal, depending on the way you choose to create a new package. If you work on a Windows-Machine via remote on the opsi-server you might use putty, if you use a VM, you might copy and paste directly to the VM... however, I will not describe the way how to do all these things. I think, if you are going to use a remote installation server, you have to know the basics. 
- 
- 
-==== The "tree"-View ==== 
- 
-Sometimes in the description of the scripts you will find something like this: 
- 
-Tree:\\ 
-<code> 
-TightVNC.jpg 
-TightVNC.reg 
-Tightvnc_win7.reg 
-delsub.ins 
-setup.ins 
-tightvnc_*version*-setup.exe 
-uninstall.ins 
-</code> 
- 
-This shows the tree, so you can see, where to place the files. It always show the content of the CLIENT_DATA folder.  
- 
- 
-==== Using the scripts... ==== 
- 
-For easily creating packages you better install 2 tools on the opsi-server: 
- 
-    * joe (an easy-to-use editor) 
-    * wget (if not installed) 
- 
-Me for myself created a folder named "/opsi-packages" in the root-directory for creating the packages. My account is a member of opsi-admin and the folder has rwx-rights for group-opsi-admin course. Such a folder has many advantages and after creating your packages, you should keep it! Software is changing nearly every day and it's much easier to change the setup.exe and to repack than to start again and again creating folders, calling the opsi-newprod. 
- 
-First follow the instructions on the manual "Getting Started", chapter 4.2 "Creating an opsi package". On the example of VNC (a remote-control-software) we will create a localboot-package. 
-Localboot means, the pc starts from it's own HDD. 
- 
-After entering some informations on the product-information-screen you enter exactly the names "setup.ins" and "uninstall.ins" in the "product-scripts"-screen. Most scripts listed here have a "delsub.ins". This is a subroutine, that will be called by setup.ins or uninstall.ins. You will not enter it in the product-scripts-screen. 
-We will not create any dependencies at this moment.  
- 
-Dependencies are needed is a software needs another package before installed. For example: CDBurnerXP needs .NetFX installed. So you can define, that the package ".NetFX" will be installed first, before opsi install the CDBurnerXP-Software. 
- 
-For VNC we also will not define any product-properties. 
- 
-When done opsi-newprod we will have a new folder in /opsi-packages named (following our example) "vnc". 
- 
-In folder we will find three more other folders, named CLIENT_DATA, OPSI and SERVER_DATA: 
- 
-<code winst> 
---- vnc 
-   | - CLIENT_DATA 
-   | - OPSI 
-   | |- control 
-   | |- postinst 
-   | |- preinst 
-   | - SERVER_DATA 
-</code> 
- 
-Change now to the folder "CLIENT_DATA": 
-<code> 
-minhas-tirith:/opsi-packages/vnc # cd CLIENT_DATA 
-</code>  
- 
- 
-==== Getting the setup-program ==== 
- 
-First we need to download the setup-program, you will mostly find a link in the top-section of each script where we can get it. If not, the software might not be free. In our example we will find TightVNC at http://www.tightvnc.com/download.php 
-Follow the link and watch for the self-installing package for Windows. Do a rightclick on the link and copy the URL of the file. 
- 
-Do a  
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # wget "http://www.tightvnc.com/download/2.0.4/tightvnc-2.0.4-setup.exe" 
-</code> 
-(Attention! The Version-Number 2.0.4 might have changed, when you read this HOWTO!) 
- 
-so the setup-file is stored directly in the folder CLIENT_DATA. 
- 
-Now we need the setup.ins, the uninstall.ins and the delsub.ins. To get them and to fill them with content do the following: 
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # touch setup.ins 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # joe setup.ins 
-</code> 
- 
-Now open in the wiki the page [[userspace:tightvnc|setup.ins]] Mark all inside the box unter "setup.ins", copy it and paste it into joe by doing a SHIFT-INS.  
-Now find the line with a  
-<code winst> 
-Set $Inst_Prg$        = "tightvnc-x.y.z-setup.exe" 
-</code> 
-and change it to the name of the setup-program you have downloaded before. 
- 
-To save the file press <CTRL-K>x 
- 
-Do the same with uninstall.ins and delsub.ins: 
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # touch uninstall.ins 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # joe uninstall.ins 
-</code> 
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # touch delsub.ins 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # joe delsub.ins 
-</code> 
- 
-to avoid any errors during the automated installation also do a 
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # touch Tightvnc_win7.reg 
-</code>  
- 
-and leave it empty. This file normally contains the registry-settings of TightVNC made after a test-installation on a client. It contains the password for the administrator. 
- 
- 
-==== Where to get the bitmap? ==== 
- 
-Try Google, searching for TightVNC and have a look in the pictures. If you find one you like so you can copy it and resize it to 160x160 pixel. Save it as TightVNC.jpg. 
- 
- 
-==== Packing the package ==== 
- 
-Well done. Now leave the folder CLIENT_DATA 
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # cd .. 
-</code> 
- 
-and pack it by using opsi-makeproductfile. 
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # opsi-makeproductfile 
-</code> 
- 
-The software will be packed now. This takes a lil bit of time depending on the amount of files and the size which have to be put into the package.  
-After packaging do a  
- 
-<code> 
-minhas-tirith:/opsi-packages/vnc/CLIENT_DATA # opsi-package-manager -i *.opsi 
-</code> 
- 
-to install the new created package. Do a reload on the localboot-products in the configed, if it's open during installing the new package, otherwise you will not see your new created package. 
- 
-Now you can test it with an opsi-client. 
- 
-Have fun! 
userspace/howto_use_the_scripts_-_a_short_description.txt ยท Last modified: 2021/08/23 08:37 (external edit)