Technology Tools for Ministry

Installing the WEC Starter Package

Setting Server Permissions

For Linux-based servers, the third step in installing the WEC Starter Package is to set permissions so the Apache web server can modify essential downloaded and extracted files. For Windows-based servers you can skip to the next step.  

The Apache web server application typically runs under a different user account and must also have the ability to read and write to some of the files in the WEC Starter Package. These files are stored in the following four folders: 

  1. fileadmin 

  2. typo3conf 

  3. typo3temp 

  4. uploads 

Hosting environments differ and you may or may not have access or privilege to certain server commands. Please read through the options below and choose the first one that suites your situation best. 

Setting shared group access provides good security and ease of use, but this level of control is not available through many hosting providers.  

  1. If you can create a shared group that includes both your username and the username the web server program uses (the web server username is “nobody” on many Linux installations), then create the group and use one of the two methods below to set permissions to give that group and owner read/write access (octal 0770) to the folders listed above.

  2. If you cannot create a shared group or cannot add the web server's username to the group, then use one of the two methods below to set permissions to give world, group and owner read/write access (octal 0777) to the folders listed above. This is the most common option.

 

Setting permissions via FTP

To set the file/folder access permissions using a windows-based FTP client program: 


  1. Select the four folders or change permissions one at a time.

  2. Right-click to open the shortcut menu and select Permissions or Properties.

  3. Click the options to select read (R) and write (W) permissions, or in the Octal field:

    1. for a shared group, type 0770 to give group and owner read/write access

    2. for a non-shared group, type 0777 to  give world, group and owner read/write access

  1. Select the Recursive option to set all files and folders within these folders to the same permissions. Selecting this option is very important. Click OK.

Setting permissions via SSH

Using SSH (Secure Shell), the file/folder permissions can be set manually or using a provided shell script.  

To set file/folder permissions manually, use the chmod command for each of the four folders.

  1. Be sure to use the -R argument to make the chmod command recur into all the subdirectories to set each file and folder with the same permissions.

    1. For a shared group, use 770 to give group and owner read/write access

    2. For a non-shared group, use 777 to  give world, group and owner read/write access

Example: Setting permissions for group and owner using chmod 

> chmod -R 770 fileadmin

> chmod -R 770 typo3conf
> chmod -R 770 typo3temp

> chmod -R 770 uploads

 

 

Example: Setting permissions for world, group, and owner using chmod 

> chmod -R 777 fileadmin

> chmod -R 777 typo3conf
> chmod -R 777 typo3temp

> chmod -R 777 uploads

 

You can quickly set the file/folder permissions for these directories to world, group, and owner access using the provided shell script named set_permissions.sh.

  1. This script sets permissions recursively to 777 for all four folders.

  2. The set_permissions.sh script is located in the web server root directory. In that directory, you will also find the four folders: fileadmin, typo3conf, typo3temp, and uploads. 

Example: Setting permissions using prepared shell script (SSH) 

> ./set_permissions.sh

 

  wec_starter_install_01.sxw 13 / 22

Not a member yet? click here to register.