Skip to content

Latest commit

 

History

History
81 lines (61 loc) · 2.86 KB

UPGRADE-1.0.2.md

File metadata and controls

81 lines (61 loc) · 2.86 KB

Upgrade from 1.0.1 to 1.0.2

Development Mode

After an update, all files will be reset to the original ownership and rights. So if you've switched to Development-Mode, you need to run the setup script again to re-activate the development mode again.

To do so, open a console and type the following

sudo /opt/appserver/server.php -s dev
# Should return: Setup for mode 'dev' done successfully!

Updating Mac OS X

When updating a Mac OS X installation, we actually do NOT take care about changes in your configuration files. Please BACKUP all customized files, especially etc/appserver/appserver.xml and etc/appserver/conf.d/virtual-hosts.xml to not loose your changes.

Configuration

We've made minor changes in some configuration files. This changes SHOULD NOT affect you in most cases.

General

When updating 1.0.1 to 1.0.2 and not replacing the etc/appserver/appserver.xml with the latest bundled version, it is necessary to remove the serverAdmin and serverSoftware attributes from the <host> node after installation, because the schema didn't allow them now.

So, if your 1.0.1 version looks like

    ...
    <host
        name="localhost"
        appBase="/webapps"
        serverAdmin="[email protected]"
        serverSoftware="appserver/1.0.2-56 (darwin) PHP/5.5.22" />
    ...

after update to 1.0.2 it has to look like

    ...
    <host name="localhost" appBase="/webapps" />
    ...

Move of authentication to appserver-io/http

Up to version 1.0.2 the authentication used within the webserver and the appserver were implemented separately. This has changed and will force an update of server configurations using authentication. So please change the type param of authentication elements to use the new \AppserverIo\Http\Authentication namespace as shown below.

Change

<authentications>
    <authentication uri="^\/auth\/basic\/.*">
        <params>
            <param name="type" type="string">\AppserverIo\WebServer\Authentication\BasicAuthentication</param>
            <param name="realm" type="string">PhpWebServer Basic Authentication System</param>
            <param name="file" type="string">var/www/auth/basic/.htpasswd</param>
        </params>
    </authentication>
    ...
</authentications>

to the following

<authentications>
    <authentication uri="^\/auth\/basic\/.*">
        <params>
            <!-- this HAS been changed with 1.0.2
            <param name="type" type="string">\AppserverIo\Http\Authentication\BasicAuthentication</param>
            -->
            <param name="realm" type="string">PhpWebServer Basic Authentication System</param>
            <param name="file" type="string">var/www/auth/basic/.htpasswd</param>
        </params>
    </authentication>
    ...
</authentications>