docs.roxen.com
main | demo | docs
download | community | pike
2000 Roxen Internet Software
Suggestions, Comments or Complaints
manuals@roxen.com

DocsRoxen2.0Administrator ManualInstallation


  • Software Installation
  • Administration Interface
  • Creating a Site
  • Upgrading a 1.3 site
  • Java support
  • Databases
  • Software Installation

    The software installation installs Pike and Roxen on your system. It is either done through a binary or source package. Binary packages are precompiled for each operating system and are the easiest to install. Source packages are compiled by the user and require a complete development environment. They are for people who want full control over what they install, or a last resort if a binary package fails.

    Some functions, such as the Java, PHP4 and database support, require external systems or libraries to work. These systems or libraries should be installed before Roxen. If a library is installed after Roxen it might become necessary to reinstall Roxen or Pike. Fortunately the reinstallation is simple and does not affect the web sites you have created.

    Unix Binary Installation

    The Unix binary release is distributed as a self-installable archive, actually a combination of a sh-script and a tar archive. The result is an executable with its own installation script that guides you through the installation.

    To install the binary release, simply run the archive:


    ./roxen-2.0.[build]-[os].sh

    It will take a while for the script to extract the Pike binary and start the real installation script. When it has finished it will prompt for the location of your installation:


    Roxen installation prefix (roxen will be added) [ /usr/local ]:

    If you do not enter anything Roxen will be installed in /usr/local/roxen/. Roxen is always installed in a directory called roxen.

    Next it will ask you if you want to install Pike separately, as opposed to only as a part of Roxen. Installing Pike separately is recommended since it will make it possible to run other Pike programs as well. If you answer yes you will be prompted for the location of the Pike installation.


    Install Pike separately? [ Y/n ]:
    Pike installation prefix [ /usr/local/ ]:

    Now the actual installation of the software will take place. This takes a while and produces some more or less interesting messages. Next the installation script will create an administration interface server. If you were updating or reinstalling rather than installing a new 2.0 server you can abort the script here.

    The script will prompt for the name and URL of the administration interface server, as well as the user name and password for a administraion interface user. Note that it is no longer necessary for the administration interface to run under its own port, you could assign it a URL on your normal server, for example http://my-domain/admin/. See the Ports chapter for more information.

    You should probably use HTTPS for the administration interface, so that it is not possible to eavesdrop on it. Don't forget to change the certificate of that port, since it will use the unsecure demo certificate if you don't. See the Ports chapter for further information.


    Roxen 2.0 administration interface installation script
    Creating an administration interface server in ../configurations/
    Server name [Administration Interface]:
    Port [http://*:11822/]:
    Administrator user name [administrator]:
    Administrator Password:
    Administrator Password (again):
    Ok? [y]:

    The last stage of the installation process asks whether you want your Roxen to connect to update servers automatically or not. If you allow it the builtin update client will fetch information about new software and updates as well as news about Roxen. The information will be displayed in the Admin tab of the administration interface.

    If you don't allow this it is still possible to use the update client, it will connect to the update server and fetch information when you tell it to. The disadvantage is that you won't get automatic alerts about new security fixes and other important news.

    If you allow the update client to do automatic connections the script will also help you create a Roxen Community user. The Roxen Community, http://community.roxen.com/, is a community for Roxen users. The update server is part of Roxen Community.


    Roxen 2.0 has a built-in update system. If enabled it will periodically
    contact update servers over the Internet. Do you want to enable this?
    Ok? [y]:
    If you have a registered user identity at Roxen Community
    (http://community.roxen.com), you may be able to access
    additional material through the update system.
    Press enter to skip this.
    Roxen Community Identity (your e-mail): wing@roxen.com
    Roxen Community Password:
    Roxen Community Password (again):

    Now the installation is complete and the Roxen server will be started. You can connect to the administration interface by connecting to the port you configured. If you cannot connect you should look at the debug log file, roxen/logs/debug/default.1.

    Unix Source Installation

    The Unix source release is distributed as a tar.gz archive. It contains the source code for the Pike interpreter, necessary libraries and the Roxen server itself. The installation will work on any system, but libraries for all supported functionality is not included. Thus libraries for native database support, for image file format support (TIFF, JPEG), TrueType rendering, Java, PHP4 or GTK/GNOME support is not included.

    If you are installing on a Linux or FreeBSD system most libraries will be shipped with the distribution. The commercial Unix system does however usually not ship these libraries, so you will have to install them yourself. See Appendix foo for a complete list of libraries used by Pike/Roxen.

    It is necessary to install the external libraries before you install Roxen. If you later find out that some function is lacking because of a missing library you will have to reinstall Roxen, or rather the Pike interpreter. A reinstallation is done in the same way as an installation and does not affect the web sites you have created. The installation script will find the previous installation of Roxen and upgrade rather than overwrite it.

    The installation process consists of four steps; configuration, compilation, software installation and Roxen installation.


    ./configure --prefix=/usr/local
    make
    make install
    cd /usr/local/roxen/server
    ./create_configinterface

    The configuration is done automatically by a script created with GNU autoconf. It finds out about your system and how to compile on it. It will find which libraries are installed and if they can be used. Usually this will be fully automatic but in some cases it might be necessary to manually force the configuration system to find some libraries. See appendix bar for a list of configurations options, or use ./configure --help.


    ./configure --prefix=/usr/local/

    The configure script produces a log about what happens. A longer version of the log is also stored as config.log. If the configure script failed to find a certain library that does exist the config.log file will give you valuable clues to why, and what you can do to fix it. Once you have fixed the problem you can run configure again.


    holt roxen-2.0.22-src $ ./configure --prefix=/usr/local/
    creating cache ./config.cache
    checking whether make sets ${MAKE}... yes
    checking for a BSD compatible install... /usr/local/bin/install -c
    configure: warning: Converted . to /home/wing/test/roxen-2.0.22-src,
    If this does not work, please use an absolute path to the configure script.
    checking for gcc... gcc
    checking whether the C compiler (gcc ) works... yes
    checking whether the C compiler (gcc ) is a cross-compiler... no
    checking whether we are using GNU C... yes
    checking whether gcc accepts -g... yes
    checking how to run the C preprocessor... gcc -E
    checking for AIX... no
    checking for minix/config.h... no
    Beginning of configure log

    After the software is configured its time to compile it. This is done by invoking make which will in turn use the necessary compilers, linkers and whatnot. The compilation takes a while and produces another long log of information. Usually all messages can be ignored, but in case of errors they will provide important clues to what went wrong.


    make

    holt roxen-2.0.22-src $ make
    make[1]: Entering directory `/home/wing/test/roxen-2.0.22-src/odbc'
    link gcc -DPACKAGE=\"libiodbc\" -DVERSION=\"2.50\" -DHAVE_LIBDL=1 -DSTDC_HEADERS=1 -DHAVE_STRERROR=1 -I. -I/home/wing/test/roxen-2.0.22-src/odbc -I/home/wing/test/roxen-2.0.22-src/odbc -I/home/wing/test/roxen-2.0.22-src/odbc -I/usr/local/include -g -O2 -fPIC -W -Wall -Wpointer-arith -Wno-unused -Wstrict-prototypes -O2 -ffast-math -msupersparc -c catalog.c
    mkdir .libs
    /home/wing/test/roxen-2.0.22-src/pike/bin/smartlink gcc -DPACKAGE=\"libiodbc\" -DVERSION=\"2.50\" -DHAVE_LIBDL=1 -DSTDC_HEADERS=1 -DHAVE_STRERROR=1 -I. -I/home/wing/test/roxen-2.0.22-src/odbc -I/home/wing/test/roxen-2.0.22-src/odbc -I/home/wing/test/roxen-2.0.22-src/odbc -I/usr/local/include -g -O2 -fPIC -W -Wall -Wpointer-arith -Wno-unused -Wstrict-prototypes -O2 -ffast-math -msupersparc -c -fPIC -DPIC catalog.c -o .libs/catalog.lo
    Beginning of make log

    When the software has been compiled it is time to install it. This is usually done by make install. The make command, that is used to handle the compilation process, is used to handle the installation process as well. The software will be installed in the directory that you specified with the --prefix= argument to configure, by default /usr/local/.

    Roxen and Pike will both be installed separately, in their own directories (pike/ and roxen/). A link to the pike binary will also be created in bin/. The roxen directory can later be moved anywhere on your system. However the pike directory cannot be moved. In case you want Pike and Roxen in different places you should set the --prefix= argument to the configure script for Pike, not Roxen.

    Upgrading to a newer 2.0 release, or reinstalling the same release, is also done with make install. Only the roxen/server/ directory, that contains the actual software, will be affected. No logs, configurations or user data will be touched. After the installation the old version of the software will be moved from roxen/server/ to roxen/server.old/.

    The installation also produces a progress log that is mainly interesting in case of errors.


    make install

    make[1]: Entering directory `/home/wing/test/roxen-2.0.22-src/odbc'
    make[1]: `libiodbc.la' is up to date.
    make[1]: Leaving directory `/home/wing/test/roxen-2.0.22-src/odbc'
    make[1]: Entering directory `/home/wing/test/roxen-2.0.22-src/pike/src'
    make[2]: Entering directory `/home/wing/test/roxen-2.0.22-src/pike/src/modules'
    Making CommonLog
    make[3]: Entering directory `/home/wing/test/roxen-2.0.22-src/pike/src/modules/CommonLog'
    make[3]: Leaving directory `/home/wing/test/roxen-2.0.22-src/pike/src/modules/CommonLog'
    Making Gdbm
    Beginning of make install log

    The next step is to create an administration interface server. If you are upgrading or reinstalling you do of course not need to, your old configuration will do. This is done by invoking the create_configinterface script located in the roxen/server/ directory. If is the same script that is used by the binary installation, so we won't describe it in detail again.


    cd /usr/local/roxen/server/
    ./create_configinterface

    Roxen 2.0 administration interface installation script
    Creating an administration interface server in ../configurations/
    Server name [Administration Interface]:
    Port [http://*:11822/]:
    Administrator user name [administrator]:
    Administrator Password:
    Administrator Password (again):
    Ok? [y]:
    Roxen 2.0 has a built-in update system. If enabled it will periodically
    contact update servers over the Internet. Do you want to enable this?
    Ok? [y]:
    If you have a registered user identity at Roxen Community
    (http://community.roxen.com), you may be able to access
    additional material through the update system.
    Press enter to skip this.
    Roxen Community Identity (your e-mail): wing@roxen.com
    Roxen Community Password:
    Roxen Community Password (again):

    The last step of the software installation is to start the server and connect to the administration interface. This is done by invokning the start script in the roxen/server/ directory. The progress of the server can be seen in the debug log, roxen/logs/debug/default.1


    cd /usr/local/roxen/server/
    ./start

    12854 : Executing ./bin/roxen -DMODULE_DEBUG -DKEEP_ALIVE -DENABLE_THREADS
    -M./etc/modules -I./etc/include -I./base_server -P. -w base_server/roxenloader
    .pike
    4:59:39 : ----------------------------------------------------------
    0m 0.0s : Pike v0.7 release 139, Roxen WebServer 2.0.22
    : Loading pike modules ... Done [253.3ms]
    : Loading roxen ... Done [6636.3ms]
    : Adding languages ... Done [918.17ms]
    : Initiating argument cache ... Done [20.20ms]
    4:59:47 :
    0m 8.6s : Enabling the configuration Configuration Interface ...
    : Registered http://*:11822/ for Configuration Interface
    : Enabled Configuration Interface in 406.4ms
    : Starting five threads to handle requests.
    : -- Total boot time 9.0 seconds ---------------------------
    4:59:48 :
    0m 9.0s : ** 2000-03-31 04:59 pid: 12896 ppid: 12887 uid: wing
    :
    Beginning of debug log