From: Steve Sheppard Date: Sun, 16 Jan 2011 20:47:52 +0000 (-0500) Subject: adjust scaling of some images; X-Git-Tag: sprint4-merge-nov22~4203^2~243 X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=59c7dc68c4b22fb6b47a184d1d943f58a75ec23a;p=working%2FEvergreen.git adjust scaling of some images; --- diff --git a/1.6/admin/serversideinstallation.xml b/1.6/admin/serversideinstallation.xml index 832e45c6e4..23fc8305e4 100644 --- a/1.6/admin/serversideinstallation.xml +++ b/1.6/admin/serversideinstallation.xml @@ -145,12 +145,12 @@ In the following example, the default shell for the opensrf user is automatically set to /bin/bash to inherit a reasonable environment: - - + + # as the root user: useradd -m -s /bin/bash opensrf passwd opensrf - + Download and Unpack Latest OpenSRF Version @@ -164,13 +164,13 @@ the directory /home/opensrf then download and extract OpenSRF. The new subdirectory /home/opensrf/OpenSRF-1.4.0 will be created: - - + + # as the opensrf user: cd /home/opensrf wget http://evergreen-ils.org/downloads/OpenSRF-1.4.0.tar.gz tar zxf OpenSRF-1.4.0.tar.gz - + Install Prerequisites to Build OpenSRF @@ -185,12 +185,12 @@ distribution keywords table . For example, to install the prerequisites for Ubuntu version 10.04 (Lucid Lynx) you would enter this command: make -f src/extras/Makefile.install ubuntu-lucid . - - + + # as the root user: cd /home/opensrf/OpenSRF-1.4.0 make -f src/extras/Makefile.install [DISTRIBUTION] - + Keyword Targets for OpenSRF <application>"make"</application> Command @@ -267,13 +267,13 @@ include support for Python and Java, add the configuration options and , respectively: - - + + # as the opensrf user: cd /home/opensrf/OpenSRF-1.4.0 ./configure --prefix=/openils --sysconfdir=/openils/conf make - + This step will take several minutes to complete. @@ -282,12 +282,12 @@ user, return to the new OpenSRF build directory and use the make utility to compile, link and install OpenSRF: - - + + # as the root user: cd /home/opensrf/OpenSRF-1.4.0 make install - + This step will take several minutes to complete. @@ -300,12 +300,12 @@ new library path, then run the command ldconfig to automatically read the file and modify the system dynamic library path: - - + + # as the root user: echo "/openils/lib" > /etc/ld.so.conf.d/osrf.conf ldconfig - + Define Public and Private OpenSRF Domains @@ -324,12 +324,12 @@ Jabber - - + + # as the root user: 127.0.1.2 public.localhost public 127.0.1.3 private.localhost private - + Change File Ownerships @@ -337,11 +337,11 @@ user, change the ownership of all files installed in the directory /openils to the user opensrf: - - + + # as the root user: chown -R opensrf:opensrf /openils - + @@ -353,25 +353,25 @@ Before continuing with configuration of ejabberd you must stop that service. As the root user, execute the following command to stop the service: - - + + # as the root user: /etc/init.d/ejabberd stop - + If ejabberd reports that it is already stopped, there may have been a problem when it started back in the installation step. If there are any remaining daemon processes such as beam or epmd you may need to perform the following commands to kill them: - - + + # as the root user: epmd -kill killall beam; killall beam.smp rm /var/lib/ejabberd/* echo 'ERLANG_NODE=ejabberd@localhost' >> /etc/default/ejabberd - + Edit the <systemitem class="service">ejabberd</systemitem> configuration @@ -425,11 +425,11 @@ As the root user, restart the ejabberd service to test the configuration changes and to register your users: - - + + # as the root user: /etc/init.d/ejabberd start - + Register <systemitem class="username">router</systemitem> and @@ -462,8 +462,8 @@ for the users <systemitem class="username">router</systemitem> and <systemitem class="username">opensrf</systemitem> on each domain (remember to replace <emphasis>NEWPASSWORD</emphasis> with the appropriate password):</para> -<screen> - <userinput> + <screen> + <userinput> # as the root user: # Note: the syntax for registering a user with ejabberdctl is: # ejabberdctl register USER DOMAIN PASSWORD @@ -471,7 +471,7 @@ ejabberdctl register router public.localhost NEWPASSWORD ejabberdctl register opensrf private.localhost NEWPASSWORD ejabberdctl register opensrf public.localhost NEWPASSWORD</userinput> -</screen> + </screen> <para>Note that the users <systemitem class="username">router</systemitem> and <systemitem class="username">opensrf</systemitem> and their respective passwords will be used again in <xref linkend="serversideinstallation-passwords"/> when @@ -483,13 +483,13 @@ execute the following commands to create the new configuration files <filename>/openils/conf/opensrf_core.xml</filename> and <filename>/openils/conf/opensrf.xml</filename> from the example templates:</para> -<screen> - <userinput> + <screen> + <userinput> # as the opensrf user: cd /openils/conf cp opensrf.xml.example opensrf.xml cp opensrf_core.xml.example opensrf_core.xml</userinput> -</screen> + </screen> </step> <step xml:id="serversideinstallation-passwords"> <title>Update usernames and passwords in the OpenSRF configuration file @@ -591,7 +591,7 @@ to instead read: /tmp/persist.db Following is a sample modification of that portion of the file: - @@ -618,11 +618,11 @@ to the home directory of each user who will use srfsh. For instance, do the following for the opensrf user: - - + + # as the root user: cp /openils/conf/srfsh.xml.example /home/opensrf/.srfsh.xml - + Edit each user's file ~/.srfsh.xml and make the following changes: @@ -653,7 +653,7 @@ Following is a sample of the file: - @@ -676,30 +676,30 @@ environmental variable PATH by adding a new file path to the opensrf user's shell configuration file ~/.bashrc: - - + + # as the opensrf user: echo "export PATH=/openils/bin:\$PATH" >> ~/.bashrc - + Start OpenSRF As the root user, start the ejabberd and memcached services: - - + + # as the root user: /etc/init.d/ejabberd start /etc/init.d/memcached start - + As the opensrf user, start OpenSRF as follows: - - + + # as the opensrf user: osrf_ctl.sh -l -a start_all - + The flag forces Evergreen to use localhost (your current system) as the hostname. The flag starts the other @@ -734,19 +734,19 @@ OpenSRF using the srfsh utility and trying to call the add method on the OpenSRF math service: - - + + # as the root user: /openils/bin/srfsh - + srfsh# request opensrf.math add 2 2 - + Received Data: 4 ------------------------------------ Request Completed Successfully Request Time in seconds: 0.007519 ------------------------------------ - + For other srfsh commands, type in help at the prompt. @@ -756,11 +756,11 @@ osrf_ctl.sh again. As the opensrf user, stop OpenSRF as follows: - - + + # as the opensrf user: osrf_ctl.sh -l -a stop_all - + @@ -833,13 +833,13 @@ the directory /home/opensrf then download and extract Evergreen. The new subdirectory /home/opensrf/Evergreen-ILS-1.6.1.6 will be created: - - + + # as the opensrf user: cd /home/opensrf wget http://evergreen-ils.org/downloads/Evergreen-ILS-1.6.1.6.tar.gz tar zxf Evergreen-ILS-1.6.1.6.tar.gz - + Install Prerequisites to Build Evergreen @@ -856,12 +856,12 @@ For example, to install the prerequisites for Ubuntu version 9.10 (Karmic Koala) you would enter this command: make -f Open-ILS/src/extras/Makefile.install ubuntu-karmic. - - + + # as the root user: cd /home/opensrf/Evergreen-ILS-1.6.1.6 make -f Open-ILS/src/extras/Makefile.install [DISTRIBUTION] - +
Keyword Targets for Evergreen <application>"make"</application> Command @@ -950,19 +950,19 @@ You will need to install several Perl modules on the other system. As the root user install the following Perl modules: - - + + # as the root user: # first, ensure the gcc compiler is installed: apt-get install gcc # then install the Perl modules: perl -MCPAN -e shell - + cpan> install JSON::XS cpan> install MARC::Record cpan> install MARC::File::XML - + For more information on installing Perl Modules vist the official CPAN site. @@ -977,13 +977,13 @@ do this by creating the new file /etc/ld.so.conf.d/osrf.conf containing a new library path, then run the command ldconfig to automatically read the file and modify the system dynamic library path: - - + + # as the root user: echo "/usr/local/lib" >> /etc/ld.so.conf.d/osrf.conf echo "/usr/local/lib/dbd" >> /etc/ld.so.conf.d/osrf.conf ldconfig - + Restart the PostgreSQL Server @@ -995,11 +995,11 @@ execute the following command (remember to replace PGSQL_VERSION with your installed PostgreSQL version, for example 8.3): - - + + # as the opensrf user: /etc/init.d/postgresql-PGSQL_VERSION restart - + Configure Evergreen @@ -1008,13 +1008,13 @@ and linked later in . As the opensrf user, return to the Evergreen build directory and execute these commands: - - + + # as the opensrf user: cd /home/opensrf/Evergreen-ILS-1.6.1.6 ./configure --prefix=/openils --sysconfdir=/openils/conf make - + Compile, Link and Install Evergreen @@ -1022,12 +1022,12 @@ default Evergreen Staff Client. As the root user, return to the Evergreen build directory and use the make utility as shown below: - - + + # as the root user: cd /home/opensrf/Evergreen-ILS-1.6.1.6 make STAFF_CLIENT_BUILD_ID=rel_1_6_1_6 install - + The Staff Client will also be automatically built, but you must remember to set the variable STAFF_CLIENT_BUILD_ID to match the version of the Staff Client you will use to connect to the Evergreen server. @@ -1040,12 +1040,12 @@ directory /openils/var/web/xul that points to the subdirectory /server of the new Staff Client build: - - + + # as the root user: cd /openils/var/web/xul ln -sf rel_1_6_1_6/server server - + Copy the OpenSRF Configuration Files @@ -1057,8 +1057,8 @@ to opensrf. As the root user, execute the following commands: - - + + # as the root user: cd /openils/conf cp opensrf.xml opensrf.xml.BAK @@ -1067,7 +1067,7 @@ cp opensrf_core.xml.example opensrf_core.xml cp oils_web.xml.example oils_web.xml chown -R opensrf:opensrf /openils/ - + Create and Configure PostgreSQL Database @@ -1091,25 +1091,25 @@ As the postgres user on the PostgreSQL system create the PostgreSQL database, then set some internal paths: - - + + # as the postgres user: createdb evergreen -E UTF8 -T template0 createlang plperl evergreen createlang plperlu evergreen createlang plpgsql evergreen - + Continue as the postgres user and execute the SQL scripts as shown below (remember to adjust the paths as needed, where PGSQL_VERSION is your installed PostgreSQL version, for example 8.3). - - + + # as the postgres user: psql -f /usr/share/postgresql/PGSQL_VERSION/contrib/tablefunc.sql evergreen psql -f /usr/share/postgresql/PGSQL_VERSION/contrib/tsearch2.sql evergreen psql -f /usr/share/postgresql/PGSQL_VERSION/contrib/pgxml.sql evergreen - + Create <systemitem class="username">evergreen</systemitem> PostgreSQL user @@ -1118,14 +1118,14 @@ named evergreen and assign a password (remember to replace NEWPASSWORD with an appropriate new password): - - + + # as the postgres user: createuser -P -s evergreen - + Enter password for new role: NEWPASSWORD Enter it again: NEWPASSWORD - + Create database schema @@ -1137,15 +1137,15 @@ the following commands and replace HOSTNAME, PORT, PASSWORD and DATABASENAME with appropriate values: - - + + # as the root user: cd /home/opensrf/Evergreen-ILS-1.6.1.6 perl Open-ILS/src/support-scripts/eg_db_config.pl --update-config \ --service all --create-schema --create-bootstrap --create-offline \ --hostname HOSTNAME --port PORT \ --user evergreen --password PASSWORD --database DATABASENAME - + On most systems, HOSTNAME will be localhost and PORT will be 5432. @@ -1184,13 +1184,13 @@ Apache modules - - + + # as the root user: a2enmod ssl # enable mod_ssl a2enmod rewrite # enable mod_rewrite a2enmod expires # enable mod_expires - + As the commands execute, you may see warnings similar to: Module SOMEMODULE already enabled but you can safely ignore them. @@ -1201,14 +1201,14 @@ Evergreen installation directory to the Apache directory. As the root user, perform the following commands: - - + + # as the root user: cd /home/opensrf/Evergreen-ILS-1.6.1.6 cp Open-ILS/examples/apache/eg.conf /etc/apache2/sites-available/ cp Open-ILS/examples/apache/eg_vhost.conf /etc/apache2/ cp Open-ILS/examples/apache/startup.pl /etc/apache2/ - + Create a Security Certificate @@ -1219,13 +1219,13 @@ accept the warnings in the Staff Client and browser during testing and development. As the root user, perform the following commands: - - + + # as the root user: mkdir /etc/apache2/ssl cd /etc/apache2/ssl openssl req -new -x509 -days 365 -nodes -out server.crt -keyout server.key - + You will be prompted for several items of information; enter the appropriate information for each item. The new files server.crt and server.key will @@ -1250,7 +1250,7 @@ In the section <Directory "/openils/var/cgi-bin"> replace the line: - Allow from 10.0.0.0/8 + Allow from 10.0.0.0/8 with the line: Allow from all This change allows access to your configuration @@ -1293,17 +1293,17 @@ Debian Lenny, as the root user, edit the Apache configuration file and change the lines: - - + + export APACHE_RUN_USER=www-data export APACHE_RUN_GROUP=www-data - + to instead read: - - + + export APACHE_RUN_USER=opensrf export APACHE_RUN_GROUP=opensrf - + As the @@ -1313,11 +1313,11 @@ modify the value for KeepAliveTimeout and MaxKeepAliveRequests to match the following: - - + + KeepAliveTimeout 1 MaxKeepAliveRequests 100 - + Further configuration changes to Apache may be @@ -1331,7 +1331,7 @@ and modify the section related to prefork configuration to suit the load on your system: - StartServers 20 MinSpareServers 5 @@ -1350,15 +1350,15 @@ following Apache configuration commands to disable the default It Works web page and enable the Evergreen web site, and then restart the Apache server: - - + + # as the root user: # disable/enable web sites a2dissite default a2ensite eg.conf # restart the server /etc/init.d/apache2 reload - + @@ -1468,11 +1468,11 @@ Modify the permissions in the directory /openils/var/cgi-bin to make the files executable: - - + + # as the opensrf user: chmod 755 /openils/var/cgi-bin/*.cgi - + As the opensrf user, @@ -1485,12 +1485,12 @@ before the line [ -z "$PS1" ] && return . This will allow headless (scripted) logins to load the correct environment. - - + + # as the opensrf user: echo "export PERL5LIB=/openils/lib/perl5:\$PERL5LIB" >> ~/.bashrc . ~/.bashrc - + @@ -1513,21 +1513,21 @@ As the root user, start the ejabberd and memcached services as follows: - - + + # as the root user: /etc/init.d/ejabberd start /etc/init.d/memcached start - + As the opensrf user, start Evergreen as follows: - - + + # as the opensrf user: osrf_ctl.sh -l -a start_all - + The flag forces Evergreen to use localhost (your current system) as the hostname. The flag starts the other @@ -1574,12 +1574,12 @@ changes to the library hierarchy. As the opensrf user, execute the following command and review the results: - - + + # as the opensrf user: cd /openils/bin ./autogen.sh -c /openils/conf/opensrf_core.xml -u - + Updating Evergreen organization tree and IDL using '/openils/conf/opensrf_core.xml' Updating fieldmapper Updating web_fieldmapper @@ -1596,16 +1596,16 @@ Refreshing proximity of org units Successfully updated the organization proximity Done - + As the root user, restart the Apache Web server: - - + + # as the root user: /etc/init.d/apache2 restart - + If the Apache Web server was running when you started the OpenSRF services, you might not be able to successfully log into the OPAC or Staff Client until the Apache Web server has been restarted. @@ -1626,11 +1626,11 @@ srfsh commands, type help at the prompt. As the opensrf user, execute the following commands to test your Evergreen connection: - - + + # as the opensrf user: /openils/bin/srfsh - + srfsh% login admin open-ils Received Data: "250bf1518c7527a03249858687714376" ------------------------------------ @@ -1652,19 +1652,19 @@ Request Completed Successfully Request Time in seconds: 1.336568 ------------------------------------ - + If this does not work, try the following: As the opensrf user, run the settings-tester.pl utility to review your Evergreen installation for any system configuration problems: - - + + # as the opensrf user: cd /home/opensrf ./Evergreen-ILS-1.6.1.6/Open-ILS/src/support-scripts/settings-tester.pl - + If the output of settings-tester.pl does not help you find the problem, please do not make any significant changes to your configuration. @@ -1692,11 +1692,11 @@ version 3.0 and later on Ubuntu and Debian distributions). As the root user, start the Staff Client as shown: - - + + # as the root user: xulrunner /home/opensrf/Evergreen-ILS-1.6.1.6/Open-ILS/xul/staff_client/build/application.ini - + A login screen for the Staff Client similar to this should appear: Logging into the Staff Client @@ -1742,11 +1742,11 @@ commands. Note the use of restart to force the new Evergreen modules to be reloaded even if the Apache server is already running. Any problems found with your configuration files should be displayed: - - + + # as the root user: apache2ctl configtest && /etc/init.d/apache2 restart - + Stopping Evergreen @@ -1755,12 +1755,12 @@ Evergreen services. As the opensrf user, stop all Evergreen services by using the following command: - - + + # as the opensrf user # stop the server; use "-l" to force hostname to be "localhost" osrf_ctl.sh -l -a stop_all - + You can also stop Evergreen services without the flag, but the osrf_ctl.sh utility must know the fully qualified domain name for the system on which it will execute. That hostname may @@ -1889,7 +1889,7 @@ Starting the Windows installation of <application>VirtualBox</application> - + @@ -1897,7 +1897,7 @@ Welcome to <application>VirtualBox</application> setup wizard - + @@ -1905,7 +1905,7 @@ Accept the license agreement - + @@ -1913,7 +1913,7 @@ Waiting for installation to complete - + @@ -1921,7 +1921,7 @@ Installation is complete; start <application>VirtualBox</application> - + @@ -2009,43 +2009,55 @@ Debian "Lenny" (5.0) 1.6.1.4 - - download + + + download + VirtualBox image (no preloaded data) Debian "Lenny" (5.0) 1.6.0.1 - - download + + + download + VirtualBox image (no preloaded data) Ubuntu "Karmic Koala" (9.10) 1.6.0.0 - - download + + + download + VirtualBox image (no preloaded data) Ubuntu "Hardy Heron" (8.04) 1.2.3.1 - - download + + + download + VirtualBox image (no preloaded data) Debian Etch (4.0) 1.2.2.3 - - download + + + download + VMware image (preloaded with 13,000 Gutenberg records) Ubuntu "Gutsy Gibbon" (7.10) 1.2.1.4 - - download + + + download + VMware image, contributed by the Hekman Library, Calvin College @@ -2073,11 +2085,7 @@ Start VirtualBox for the first time and select - - File - VirtualBox Media Manager - Add - + FileVirtualBox Media ManagerAdd to locate the prebuilt software image just downloaded (the example shows it was extracted from the original .ZIP file into a temporary directory @@ -2145,7 +2153,7 @@ Starting <application>VirtualBox</application> for the first time - + @@ -2153,7 +2161,7 @@ Selecting the software image in Virtual Media Manager - + @@ -2161,7 +2169,7 @@ New software image added to <application>VirtualBox</application> - + @@ -2169,7 +2177,7 @@ Creating a new VM - + @@ -2177,7 +2185,7 @@ Setting the VM name and OS type - + @@ -2185,7 +2193,7 @@ Setting memory size - + @@ -2193,7 +2201,7 @@ Setting up the Virtual Hard Disk - + @@ -2201,16 +2209,15 @@ Finishing definition of new VM - + -
Summary of the new VM - +
diff --git a/1.6/media/serversideinstallation-staffclient-running-1.png b/1.6/media/serversideinstallation-staffclient-running-1.png index 94a4645efe..4ae44dbc63 100644 Binary files a/1.6/media/serversideinstallation-staffclient-running-1.png and b/1.6/media/serversideinstallation-staffclient-running-1.png differ diff --git a/1.6/media/serversideinstallation-staffclient-running-2.png b/1.6/media/serversideinstallation-staffclient-running-2.png index d25a0f616f..bd04752ede 100644 Binary files a/1.6/media/serversideinstallation-staffclient-running-2.png and b/1.6/media/serversideinstallation-staffclient-running-2.png differ diff --git a/1.6/media/serversideinstallation-staffclient-running-4.png b/1.6/media/serversideinstallation-staffclient-running-4.png index 3ae495edb3..4640fa6555 100644 Binary files a/1.6/media/serversideinstallation-staffclient-running-4.png and b/1.6/media/serversideinstallation-staffclient-running-4.png differ