Installation on a Linux Server (Example based on Suse Linux Enterprise Server 11.1) For a quick start!
Copyright September 2006-2013: OOO MASCH Russland Software & Consulting Services St. Petersburg 4 th Release published in 2013 This document was created before releasing the product. Therefore there is no guaranty that all parts described hereto will correspond to parts of the final product release. The information provided in this document represents the topics from OOO MASCH Russland s point of view when publishing the final product release. As OOO MASCH Russland is subject to market fluctuations, it declines all responsibility. The information accuracy in this document cannot be guaranteed by OOO MASCH Russland after published. The information in this document applies to the present release and can be used only for installing. This information can be changed at any time without prior notification. The present document can be used only for information purposes. OOO MASCH RUSSLAND EXCLUDES ANY GUARANTEE EXPRESSED DIRECTLY OR INDIRECTLY TO THE PRESENT DOCUMENT. 2007-2013 OOO MASCH Russland Software & Consulting Services. Copyright. All products or companies names mentioned in this document are registered trademarks of their owners. OOO MASCH Russland Software and Consulting Services" Izmailovskyi Prospect 22a 195 005 St. Petersburg, Russia Seite 2/15
Introduction This documentation gives the overview on the installation of the MASCH CM Studio 2012 on a Linux Server using the SuSE Linux Enterprise Server 11.1 for example. The following system requirements should be met: Apache from Version 2.2.x PHP 5.2.x (Version 5.3.x is not suitable because of missing Zend Optimizer) MySQL 5.0.x Mail-Server with SMTP functionality, which allows relaying. All this packages are already available in the Linux Distributive and can be installed either by the installation of the Linux operating system or later over the option Install Software. Seite 3/15
Installation of the required Software for MASCH CM Studio under Linux Server Operating System 1. Apache WEB Server Ensure that the following components are installed on your Linux Server. If they are not selected, select then and close the dialog with the button Apply. The Apache WEB server must be started or re-started after the successful installation of the components. For that, go into the After successful installation of the components shown here, the Apache web server must be started or restarted. Please change to the terminal mode to the start-execution. Please log in as root 'user in the terminal. You can do this with the following command: # su root passwort # {Now enter the password } Attention! Shown here, # 'represents the command prompt of the terminal and does not belong to your input! Following commands to start and stop the Apache web server are available: /usr/sbin/apache2ctl stop /usr/sbin/apache2ctl start /usr/sbin/apache2ctl restart Please note that in other Linux versions can distinguish both the paths and the command commands. Seite 4/15
2. PHP 5.2.x Ensure that the following components are installed on your Linux Server. If they are not selected, select then and close the dialog with the button Apply. Please note that you must use the version of PHP 5.2.x. Under the version 5.3.x PHP, the CM Studio application will not run without the support of the special MASCH support, since there is no Zend Optimizer for this version as the "out-of-the-box" solution for any Apache / PHP. When shown above software components are installed successfully, you must modify some PHP configuration parameters. Open the config file PHP.INI with a text editor and make the appropriate changes. This can easily be done with the following Terminal command: vi /etc/php5/apache2/php.ini Please note that in other Linux versions can distinguish both the paths and the command commands. The file is opened in VI editor. Please press the button 'i' to enter insert mode. In insert mode, you can make the necessary changes. When you are finished, press the 'Esc' key to exit insert mode. With the command :wq You write the changes to the file and exit the VI editor. Seite 5/15
The following parameters must be adjusted: upload_max_filesize post_max_size max_execution_time max_input_time memory_limit mysql.default_socket upload_max_filesize : post_max_size max_execution_time max_input_time memory_limit Please change it to 200M. Please change it to 200M. Please change it to 2000 (Seconds). Please change it to 2000 (Seconds). Please change it to 512M. After that, the Apache web server must be started or restarted. You can also perform in the terminal. Please sign up as again as, root 'user in the terminal if you have not already. The following commands are available: /usr/sbin/apache2ctl stop /usr/sbin/apache2ctl start /usr/sbin/apache2ctl restart Please note that in other Linux versions can distinguish both the paths and the command commands. Seite 6/15
3. PHP ZEND Optimizer The ZEND Optimzer is required to make the encrypted files of CM Studio application running. The ZEND Optimzer is not included with a Linux operating system and must be downloaded separately and installed. Masch recommends using PHP 5.2.x on Linux, since the CM Studio applications are delivered as compiled and encrypted code. Under the version 5.3.x PHP, the CM Studio application will not run without the support of the special MASCH support, since there is no Zend Optimizer for this version as the "out-of-the-box" solution for any Apache / PHP. If it is not possible for you to get PHP 5.2.x on your server running, please contact our support at http://www.masch.com/gourl.php?ulang=en&url=support_form. If you have a PHP 5.2.x installation, we explain here the installation procedure based on the example of in the SuSE Linux Enterprise Server Version 11.1. For other Linux variants, the paths and names of config files may differ. 1. Start the Terminal 2. You are at the prompt (#) of the terminal, please make sure that you are as 'root' user in the terminal! If you are not logged in as' root'user, you can login with the commands: # su root accordingly and password! 3. Go to the temp directory: # cd /tmp 4. Now, You have to download the Zend Optimizer : o If you are using 32 bit Linux Version, then use the following command: # wget http://downloads.zend.com/optimizer/3.3.9/zendoptimizer-3.3.9-linuxglibc23-i386.tar.gz o If you are using 64 bit Linux Version, then use the following command: # wget http://downloads.zend.com/optimizer/3.3.9/zendoptimizer-3.3.9-linuxglibc23-x86_64.tar.gz 5. Extract the Download-File: o 32-Bit Version: # tar -xzf ZendOptimizer-3.3.9-linux-glibc23-i386.tar.gz o 64 bit Version: # tar -xzf ZendOptimizer-3.3.9-linux-glibc23-x86_64.tar.gz Seite 7/15
6. Go to the Optimizer directory: o 32-Bit Version: # cd ZendOptimizer-3.3.9-linux-glibc23-i386 o 64-Bit Version: # cd ZendOptimizer-3.3.9-linux-glibc23-x86_64 7. Now, create the reuired directories: 1. # mkdir /usr/local/zend 2. # mkdir /usr/local/zend/lib Copy the SO-file of the ZEND Optimizer: # cp -rfv data/5_2_x_comp/zendoptimizer.so /usr/local/zend/lib You have to enter some configuration lines into the PHP.INI file. Use the VI editor for that : # vi /etc/php5/apache2/php.ini Enter the following lines at the end of PHP.INI: [Zend] zend_extension=/usr/local/zend/lib/zendoptimizer.so 11. Then, restart the Apache WEB Server with the following command: # /usr/sbin/apache2ctl restart Please note that in other Linux versions can distinguish both the paths and the command commands. Seite 8/15
5. MySQL Database Server A MySQL database is required to store the data of the CM Studio application. Ensure that the following components are installed on your Linux Server. If they are not selected, select then and close the dialog with the button Apply. After that, the MySQL server must be started or restarted. You can do that in the terminal modus. The following commands are available for that: /etc/init.d/mysql stop /etc/init.d/mysql start /etc/init.d/mysql restart Please note that in other Linux versions can distinguish both the paths and the command commands. Now, the MySQL server is running. The password for the root User must be defined. Per default, the root user does not have a password. This is not acceptable by PHP due to the security reasons. Seite 9/15
Use the terminal and execute the following commands: (You can see the results on the given screenshots) 1. mysql -u root 2. use mysql 3. update user set password=password('ihr Passwort') where user='root'; 4. flush privileges; 5. exit Now, check whether the password change took effect. Try to login to the MySQL with the following command: mysql -u root -p If the MySQL Server let you login, all was OK and you can exit the MySQL console with exit. Seite 10/15
6. Installation of MASCH CM Studio 2012 Please click with the right mouse on the downloaded archive: cmstudio_xxxxxxx_linux_xxxx.zip and use the extraction functionality of the Linux operating system: The contents is extracted tot he directory with the same name as that of the ZIP archive. This directory contains the Manuals, application files and the installer. Please read the manual carefully. The files: check.php installer.php cmstudio_setup.zip must be copied tot he document root of the Apache WEB Server. Since the document directory resides in the system area, you cannot do it with the usual file manager of the Linux Server. Use again the terminal for that to execute the copy command. The document directory is found in: /srv/www/htdocs Please note that in other Linux versions can distinguish both the paths and the command commands. Seite 11/15
The copy commands are: cp /<pfad>/cmstudio_xxxxxxx_linux_xxx/check.php /srv/www/htdocs cp /<pfad>/ cmstudio_xxxxxxx_linux_xxx/installer.php /srv/www/htdocs cp /<pfad>/ cmstudio_xxxxxxx_linux_xxx/cmstudio_setup.zip /srv/www/htdocs Now, we are ready with the preparation and can start the installation of the MASCH CM Studio 2012. The file check.php is used for checking of the technical requirements. The file installer.php is used for extraction of the application files, that resides in the archive cmstudio_setup.zip. Trough that approach, you ensure that the owner of the extracted files is the user, which is used to run Apache WEB Server, so that no problems with the access right should arise.. Open in your browser the following address: http://localhost/check.php If you start the installation from another computer, use the following address: http://{server-ip-adresse}/check.php If you are using another port than 80, use the following address: You should see the following results of checking: http://localhost:xx/check.php Seite 12/15
Now start the file installer.php : http://localhost/installer.php You may receive the following error message: The installer has no write access to the application directory: /srv/www/htdocs Give the write access to the Apache user on this directory. This must be done for the following reason: The owner of the htdocs is the root user. The Apache WEB Server is however running under wwwrun. The user wwwrun must have the write access to this directory. The simple way to do this is: Execute this command in the terminal. chmod 0777 /srv/www/htdocs 0777 allows full access for all. Please contact your system administrator, who can set the permissions according to the security policy of your server accurately. Please note that name of the Apache user may vary on different Linux Versions. Run the installer file again. The error message should not occur anymore and the installation can proceed. Follow the instructions within the CM Studio installation, for more detailed information on the general installation refer to the attached CM Studio Installation Guide. Seite 13/15
9. Creation of the observation job (only for CM Studio.E-ARCHIVE and CM Studio.DMS-SERVER) Some products of the CM Studio Server have a monitoring script, which can observe external sources like FTP server or File Server and import the documents from there into the corresponding archive. The script consists oft wo files: /srv/www/htdocs/modules/dms-archives/check_for_new.php /srv/www/htdocs/modules/dms-archives/check_for_new.sh These files must be adjusted after installation. Open the file check_for_new.php in the VI Editor with the following command: Change the line to or vi /srv/www/htdocs/modules/dms-archives/check_for_new.php $DMS_HOST = "http://{enter your host in check_for_new.php}/"; $DMS_HOST = "http://<ihr Host>/"; $DMS_HOST = "http://<ihr Host>:81/"; If the port is not 80, but, for example, 81. Then, save the changes. Open the file check_for_new.sh in VI Editor with the following command: vi /srv/www/htdocs/modules/dms-archives/check_for_new.sh delete the contents oft he file and enter the following line: php -c /etc/php5/apache2 -f /srv/www/htdocs/modules/dms-archives/check_for_new.php > /srv/www/htdocs/modules/dms-archives/logs/`date +%H.%M.%S`.log Then, save the changes. Seite 14/15
The monitoring script should be periodically executed every X minutes. We recommend the CRON scheduler for that. The CRON Scheduler can be managed over the terminal. In this context, we have to point out an important security aspect. As mentioned above, the Apache process runs under the user "wwwrun". The imported documents must be writable for that user. The best way to do this is to run the monitoring script from this user "wwwrun". In that case, he is the owner of the documents. The script check_for_new.sh may not be allowed to execute per default. You must give the user wwwrun the execution rights on it.. The simple way to do this is: chmod 0777 /srv/www/htdocs/modules/dms-archives/check_for_new.sh This command must be run from the console. 0777 allows full access for all. Please contact your system administrator, who can set the permissions according to the security policy of your server accurately. After that, the script "check_for_new.sh" can be referenced from the CRON scheduler. To do this, enter the following command in the console: crontab -u wwwrun -e The VI editor opens the file. Switch to the insert modus and enter the following: */1 * * * * /srv/www/htdocs/modules/dms-archives/check_for_new.sh */1 means that the script should be executed every 1 minute. Press the ESC button to leave the insert modus. Enter the command: :wq to save the changes and exit the editor. Now, MASCH CM Studio 2012 is completely installed. Use the Online Help to get familiar with the application. Seite 15/15