Introduction. Installation of SE S AM E BARCODE virtual machine distribution. (Windows / Mac / Linux)

Transcription

1 Installation of SE S AM E BARCODE virtual machine distribution (Windows / Mac / Linux) Introduction A "virtual machine" is a fake computer within a true one. An underlying software (here VirtualBox) is used to emulate a pseudo-hardware. Virtual machine can be distributed as a ready-made fully configured system. Instead of installing a full bunch of softwares working together it is therefore easier to set once a packaged application. Furthermore a virtual machine can be executed on various hardware platforms (PC, Mac,...). Due to the number of softwares used by SE S AM E BARCODE we packaged all of them in a virtual application. We hope that you will find this solution easier! Depending of your underlying hardware we propose two packages: A demo version for small systems (typically one dual-core 32 bits processor, 4Gio RAM, 10Gio free space on hard drive) : SESAME_SERVER_demo32.ova package ; A fully functional version for true computations (recommended : four (or more) cores on 64 bits processor (or 2x2), 8 (minimum), 12 (correct) or 16 (better) Gio RAM, 50 to 500 Gio free space on hard disk) : SESAME_SERVER_64.ova package.

2 VirtualBox installation Note: You have to be administrator of the computer used for this installation. Make sure that you have all rights and permissions required. If a step aborts during this installation, in particular when trying to start VirtualBox software installation, this means that your user status on the computer does not have the required privileges. In this case contact your computer administrator. Dowload VirtualBox Navigate to and click on "Downloads" button. Choose the VirtualBox platform packages corresponding to the host operating system of your computer, i.e. Windows, Mac, Linux or Solaris. Save the corresponding file on your computer then execute it to install Virtual Box. Install VirtualBox You can keep all default options when you do not find any specific information in this guide. * The first window presents the installation process, click next to pursue * The second window proposes to select the way users want features to be installed. The user can change the default location by clicking the "Browse" button. Then click on «next» * The third window displays the options of creation of shortcut on desktop and Quick Launch Bar (on windows system). Select the options you need and click "Next". * At the fourth window, click "Yes" to perform the installation. Then click "Install" button to start the installation process. When the installation is complete, click the "Finish" button.

3 Install SE S AM E BARCODE appliance Open VirtualBox. The application should look like the figure below. This window is the "VirtualBox manager": In the file menu at the left top of the window, select the link «import appliance». A new window opens entitled "Welcome to the Appliance Import wizard". Click the «choose» button and get the "SESAME_SERVER_demo32.ova" or "SESAME_SERVER_64.ova" file depending on your host system. Then import it by clicking "Next". A window entitled "Appliance Import Settings" opens. You can change settings such as: name of the VM, number of processors, ram capacity according to the specifications of your computer. You can keep all defaults parameters; they can be also changed at any time after the installation process when the virtual machine is halted. Note that for the 64bits version you may already expand the number of processors and RAM size according to your system. In this window, check the box "Reinitialize the MAC address of all network card" that insures that there is no MAC address conflict in your organization network. Finally click "Import" to start the installation. Note: By default Tomcat 8080 port is redirected to your host machine port You can change this configuration at this step in "Network", button "Ports redirection". You can use the any free port over Congratulations, the Sesame VM is now installed on your computer!

4 Running SE S AM E BARCODE Virtual Machine In the VirtualBox manager the VM Sesame appears on the left pane (the window manager) which lists all the VMs installed on your computer. The right pane displays the properties of the virtual machine currently selected. By clicking on the VM Sesame, the Settings button is highlighted on the top panel. In the settings you can change the parameters of the VM Sesame. A description of each parameter and option is available in the panel at the bottom of the window, by pointing out the given parameter/option with the mouse. Help documentation is also available for more details. To start the VM SE S AM E BARCODE, you can double-click on its entry in the machines manager or select its entry and press the "Start" button on the top. A window opens, corresponding to the scrren of your VM. Four lines will soon display. Choose «Ubuntu, with Linux generic-pae» and press enter on your keyboard (or wait 10 seconds). This is the default operating system. The machine is booting. Note: The virtual machine must be running in order to use SE S AM E BARCODE! The VM Login should look like the figure below: In the login dialog box enter "sesame" as login and also "sesame" as an initial password. You are now logged into the VM.

5 SE S AM E BARCODE configuration and management The window of the Virtual machine includes four shortcuts: Change Linux sesame's password It allows to change the password user sesame. Click the icon, a window opens. If asked, enter in the dialog box the current sesame's password. Enter the new password twice. Click Enter, the new password is activated for the user sesame. Change Tomcat6 password. It allows to change the password of Tomcat6 web server. Click the icon, a window opens. If asked, enter in the dialog box sesame's password. You then get write access to the config XML file. Change the value of the "password" field, then save the file and close the editor. Restart TOMCAT6: Use it to reboot the server Tomcat, if it dropped down. If asked, enter sesame's password to gain the rights to restart Tomcat web service. Restart POSTGRESQL: Use it to reboot the PostgreSQL server, if locked by example. If asked, enter sesame's password to gain the rights to restart PostgreSQL databases service.

6 Connection to SE S AM E BARCODE If you work from the host computer, open SE S AM E BARCODE in your browser with the URL: You can also access the web application from another computer of the network using the IP address or computer's name of the host computer on which the VM is installed and running. Simply replace localhost by the name or IP address of your computer. Within SE S AM E BARCODE login page the initial login is "admin" and password is "admin". Once logged in, click on the "Administration" tab: Create your first user (you) as administrator: In the "Users" area, click on the button "New" in the lower part of the form, then enter a username, a password and check the "Administrator" box. Save. If the creation succeeded you may logout and log in again using this new account. You can now change the password of the the "admin" account in order to avoid hacking. You are now the administrator. Create your first project: As for users, click the New button in the projects form, enter a project name, and save. Allow yourself to use this project by creating an entry in the access control list: Click the New button, get your project in the Project drop-down list, your name in the User drop-down list and save the combination.

7 Updating Sesame via the Tomcat6 server Note: Make sure none of your dear colleagues is working before updating SE S AM E BARCODE. It is more than likely that new version will be available from time to time for bugs corrections or improvements. Check our website. If a new version is available, download the.war file corresponding. From a web browser (eg. firefox), open the URL: If you don't open the browser from the host computer running the VM, replace "localhost" by the name or IP address of your host. If you changed the port during configuration, replace 9999 by your port number. Enter in the dialog box tomcat6's admin name ("sesame" by default) and password (the one you previously configured in Change Tomcat6 password ). The Tomcat6 manager should look like the figure below: In the Command column corresponding to the Path «SESAME_BARCODE», click on the "Undeploy" button. Once the old version removed, click on the button after Select WAR file to upload. Select the new.war file downloaded from the SE S AM E BARCODE web site, and upload it to your server. This may take a few seconds depending on your computer. Congratulations!! You have updated SE S AM E BARCODE.