Toggle navigation

Chyrp Image Guide

Version Lite-2017.03

Websoft9 Chyrp Stack is a pre-configured, ready to run image for running Chryp on Alibaba Cloud.

Chyrp is a blogging engine designed to be lightweight while retaining functionality. It is driven by PHP and MySQL (or SQLite), and has a great standard theme and robust module engine. You can personalize and modify it any way you want.All of your content is powered by a unique Feathers system that allows Chyrp to be whatever you want it to be. You can post anything and everything, or just stick to the default Text feather and run a regular blog. Chyrp destroys the fine line between a blog and a tumblelog.

Application Software(Chyrp-Lite 201703)
Software directory: /data/wwwroot/chyrp

Infrastructure(PHP5.6,APACHE2.4)
PHP Configuration File: /etc/php.ini
Default Apache Vhost Configuration File: /etc/httpd/conf.d/vhost.conf
Apache Vhost Configuration directory: /etc/httpd/conf.d
Apache Log Files: /var/log/httpd

Database(MYSQL5.7)
Database install directory: /usr/share/mysql
Database data directory:  /data/mysql
Database Configuration File: /etc/my.cnf
PhpMyAdmin install directory: /usr/share/phpmyadmin

After the installation of Image,please verify it

  • Login on Alibaba Cloud console,get you Internet IP Address
  • Open you Chrome or Firefox on your local PC,visit the http://Internet IP Address and you can enter the installation page directly,if there no response from browser,please check the Security Group settings to ensure that port 80 is been allowed

It is recommended to complete two steps before the the installation:

  • Domain resolution if you want to use domain for this application (Add an A record to the Internet IP Address of Server from Domain Control Panel)
  • Modify the MySQL password of root through http://Internet IP Address/phpmyadmin

Then access the installation page and complete the installation wizard for the following steps:

  1. Local Chrome or Firefox to visit http://yourdomain/install.php or http://Internet IP Address/install.php,you will enter the configuration inerface of installation
  2. You should complete the Database Configuration below(hostname is “localhost” and usename/password please refer to the relevant section of documentation:Will be used Usernames and Passwords) and Admin Accout,then click “install me” to next step
  3. When the installation is completed,it will go the following interface
  4. Please don’t forget to delete the “install.php” by Putty below.
    [root@iZbp1i4rjdsy216yq7lgucZ ~]# cd /data/wwwroot/chryp
    [root@iZbp1i4rjdsy216yq7lgucZ chyrp]# mv install.php install.php.bak

  5. Click the “Login to your Administration” button to enter the backend of Chryp

Three usernames and passwords are required for application installation, application using, andapplication maintenance:

1、Chyrp:Username and Password is set by youself when installation,
Backend URL:http://youdomain.com/admin
2、MySQL Database:Default username and password is root/123456
Control Panel URL:http://Internet IP Address/phpmyadmin
3、Linux Server:Username is root,Password is set by youself when buying.
Please Using the Putty for ssh remote and WinSCP for SFTP

Note:You can reset the password of OS through Cloud Console if you have forgotten it

 

Connect to a Linux instance using Windows OS

This section uses PuTTY as an example. PuTTY can be downloaded here.

You can connect to a Linux instance via PuTTY as follows:

  1. Start Putty.exe.
  2. Enter the public IP address of the instance in Host Name (or IP address).
  3. Use the default port 22.
  4. Select SSH as Connection Type.
  5. Type a session name in Saved Sessions, and then click Save. In later logins, you may directly load the session without re-entering the IP address.
  6. Click Open to connect.
  7. Upon first connection, the following dialog box will be displayed. Click Yes.
  8. As prompted, enter the username and password for the Linux ECS instance. The password will not be displayed on-screen. Press the Enter key to complete connection to the instance.

When you connect your computer to the Linux instance successfully, you can operate the instance from your computer.

Use SFTP you can mange file,upload and download file,configure Server.

  1. Start WinSCP. Login Dialog will appear.
  2. Then select your File protocol(SFTP) on the dialog
  3. Enter your host name to Host name field, username to User name and password to Password like below
  4. You may want to save your session details to a site so you do not need to type them in every time you want to connect. Press Save button and type site name.
  5. When appear the dialog below,please select the “yes”
  6. You can manane Linux file below
  7. WinSCP can integrate the Putty and transfer the log in information to Putty
  8. Now you can use Putty(Not need to log in) from the menu bar of WinSCP

Following is the step for access phpMyadmin

  1. Open Chrome or Firefox on your local PC
  2. visit the http://Internet IP Address/phpMyAdmin,you can enter the login page
  3. select you language,Username:root,Password:123456
  4. Click the button “Go”

Keeping Chyrp up to date is important to make sure that your blog is as safe and as awesome as possible.

  1. Download the latest version of Chyrp from https://github.com/xenocrat/chyrp-lite/releases
  2. Copy your config files1 to somewhere safe.
  3. Disable any Modules/Feathers that you downloaded for the release you’re upgrading from.
  4. Overwrite your current Chyrp installation files with the new ones.
  5. Restore your config files1 back to /includes/.
  6. Upgrade by navigating to upgrade.php, and restore any backups.
  7. Re-enable your Modules/Feathers.
  8. Run the upgrader again. It will run the Module/Feather upgrade tasks.

The config files vary depending on what you’re upgrading from. Any of these in are considered “config files”:

/includes/config.yaml.php
/includes/database.yaml.php
/includes/config.yml.php
/includes/database.yml.php
/includes/config.php
/includes/database.php

Chyrp provides online backup and restore functionality,Log in to the application as an administrator,you can do it

Backup

To backup Chryp, follow the steps below:

  1. Log in to the application as an administrator.
  2. Select the top-level “Admin” menu item.
  3. Click the “Manage” tab.
  4. On the resulting page, click the “Export” tab.
  5. Ensure that all the listed entities are selected and click the “Export” button.

note:The backup process will now begin and you will be prompted to download the backup file to your desktop.

Restore

To restore, follow the steps below:

  • Extract the contents of the backup file created during the export process.
  • Log in to the application as an administrator.
  • Select the top-level “Admin” menu item.
  • Click the “Manage” tab.
  • On the resulting page, click the “Import” tab.
  • For each of the listed entities, select the corresponding file from the extracted backup.
  • Click the “Import” button to begin the restoration process.

The PHP configuration file allows you to configure the modules enabled, the email settings or the size of the upload files. It is located at /etc/php.ini.

There are some PHP settings that need to be sufficient when running your application,The values for PHP.ini below are suggested values only.

  • memory_limit – Minimum: 128M Recommended: 512M or better
  • upload_max_filesize – Minimum: 20M
  • post_max_size – Minimum: 20M
  • max_execution_time: At Least 120 Recommended: 300

After modifying the PHP configuration file, restart both Apache and PHP-FPM for the changes to take effect:

# systemctl restart httpd

How to modify the allowed limit for upload?

Modify the  /etc/php.ini file to increase the allowed size for uploads:

; Maximum size of POST data that PHP will accept.
post_max_size = 16M
; Maximum allowed size for uploaded files.
upload_max_filesize = 16M

then,restart the apache

# systemctl restart httpd

How to change the max_execution_time?

If you receive the message “Maximum execution time of 30 seconds exceeded”.You may also like to extend the max_execution_time for PHP and you can modify it by two methods below

Method one: edit your  /etc/php.ini


; Maximum execution time of each script, in seconds
; http://php.net/max-execution-time
; Note: This directive is hardcoded to 0 for the CLI SAPI
max_execution_time = 90
; Maximum amount of time each script may spend parsing request data. It's a good
; idea to limit this time on productions servers in order to eliminate unexpectedly
; long running scripts.

Method two: edit your .htaccess:


<IfModule mod_php5.c>
php_value max_execution_time 90
</IfModule>

How to use your language?

Chyrp is multilingual! If your first language isn’t English, you can apply a new localization to Chyrp to make it speak your language.

  1. Download and the translation.
  2. Upload the .mo file to the includes/locale/subfolder/LC_MESSAGES folder.
  3. Open your web browser and navigate to your Chyrp Lite administration console.
  4. Click on the Settings tab, and change the Language option.

How To Change Administrator Password?

For security, it is recommended that you change the default administrator password as soon as possible. Follow the steps below:

  1. Log in to the application as an administrator.
  2. Select the left-level “Admin” menu item.
  3. Click the “Manage” tab.
  4. On the resulting page, click the “Users” tab.
  5. Find the record for the administrator user and click the “Edit” symbol for that record.

How to Install Additional Modules?

 

Chyrp Lite isn’t complete without activating a few extensions. Many useful extensions come bundled with Chyrp Lite, and you can also create your own extensions or download extensions created by other users.

##Installing Extensions To install extensions, you have to determine what type of extension it is. It can be a module, a feather, a theme, or a translation. There’s a different setup process for each type.

Feathers

  1. Download and unzip the feather
  2. Upload the feather to the feathers folder.
  3. Open your web browser and navigate to your Chyrp Lite administration console.
  4. Click on the Extend tab, and then the Feathers sub tab.
  5. Find the Feather you wish to install and click the Enable button.

You can now use the feather by navigating to the Write tab and choosing the feather you uploaded.

Modules

  1. Download and unzip the module.
  2. Upload the module to the modules folder.
  3. Open your web browser and navigate to your Chyrp Lite administration console.
  4. Click on the Extend tab.
  5. Find the Module you wish to install and click the Enable button.

The module is now installed and is ready for action. Keep in mind that some modules may conflict with each other if they do similar tasks. If a module conflicts with another module that is enabled, the conflict will be reported beneath the module’s description.

Themes

  1. Download and unzip the theme.
  2. Upload the theme to the themes folder. Make sure that it is contained in its own folder.
  3. Open your web browser and navigate to your Chyrp Lite administration console.
  4. Click on the Extend tab, and then the Themes sub tab.
  5. Find the theme you wish to select and click on the Select button.

 

Use domain you should complete the following steps:

Step One:Domain resolution

e.g,If you using the AliCloud Domain product,you should log in to your Domain Console Panel

And find the domain name resolution interface,then add an A record to the Internet IP Address of Server from Domain Control Panel.

Step One:modify the vhost file

  1. Using SFTP to edit the /ect/httpd/conf.d/vhost.conf
  2. Modify the domain related information like below,then save it
    <VirtualHost *:80>
    ServerName www.mydomain.com
    ServerAlias mydomain.com
  3. Using putty to run the command “systemctl restart httpd”

Apache http service

~# systemctl start httpd
~# systemctl stop httpd
~# systemctl restart httpd

MySQL  service

~# systemctl start mysqld
~# systemctl stop mysqld
~# systemctl restart mysqld

When install new extension from back-end it will not successful,may be the permissions of file and folder is not appropriate,you should change it

Web site root permissions to follow:
file 644,folder 755 ,Permissions Users and groups apache,apache
If there is a file permissions problem, execute the following three commands:

~# chown -R apache.apache /data/wwwroot/chyrp
~# find /data/wwwroot/chyrp -type d -exec chmod 755 {} \;
~# find /data/wwwroot/chryp -type f -exec chmod 644 {} \;