Table of Contents

Download WIKI installation files

This entire NetYCE Wiki can be installed locally at your NetYCE server. This will offer the full search capabilities of this site, but without the Internet access or the login requirements.

The local NetYCE WIKI installation consists of two parts. First there is the DokuWiki engine setup for NetYCE wiki and secondly the actual Wiki content. Both can be downloaded from this page and are daily updated. Normally, only the Wiki content part needs to be regularly downloaded and installed on your local YCE-server(s).

wiki-engine.bin
yce-wiki.bin

These NetYCE wiki installation distribution files can be installed using the NetYCE web-based front-end using the Admin - System - System status page. After requesting the full report, locate the “Install Wiki distribution” button and click the Choose file button next to it. Select the downloaded file and confirm (or drag it onto the Choose file button). Then click the Install Wiki distribution button.
Both parts need to be installed this way.

IMPORTANT
Before the wiki-engine and yce-wiki packages are installed, the system requires some one-time modifications.

Follow the “Regular setup” steps below. Should they fail, then please have the system administrator review or execute the steps in the “manual setup”.

Regular setup

The regular setup involves a semi-automatic process for its first-time installation. The following steps will make the NetYCE system modifications to create a virtual host on your NetYCE server to use a dedicated unique URL for the NetYCE Wiki.

(1)

Add an alias (or Cname) to the DNS for this NetYCE server to access the Wiki.
E.g. yce-wiki.my.domain.

(2)

The application manager of the NetYCE system must login on the server and run - as yce user - the setup script: yce_setup.pl

Enter the chosen Wiki alias name and domain at the appropriate questions of this setup script. Below a section of the dialog involved with this setup:

:::
Login setup:
    Domain name for login (single-sign-on cookie)? [netyce.org]
    Hours until Login session expiry (single-sign-on cookie)? [12]
Login setup:
  Single-sign-on domain          Expire (hrs)
  netyce.org                     12
  Is this Login setup correct?  [Y]
Wiki setup:
    'yceseven' will use the NetYCE public Wiki server? [Y] n
    The (alias) name of the local Wiki server? [wiki] wiki
    the domain name of the local Wiki server? [netyce.org] netyce.org
Wiki setup:
  Local    Protocol Hostname             Domain                                   Ip-address
  yes      http     wiki                 netyce.org
  Is this Wiki setup correct?  [Y] y
:::

When finishing the process, an updated Apache http configuration file will be generated and installed. The subsequent restarting of the http server will activate this change.

(3)

While at it, the administrator needs to verify that the PHP module for the Apache http server, mod_php is installed.

$ rpm -qa | grep -i php
php-common-5.3.3-49.el6.x86_64
php-cli-5.3.3-49.el6.x86_64
php-5.3.3-49.el6.x86_64

The actual version numbers will likely to have changed to more recent values.

If mod_php is not installed, then do so using yum or rpm. The commands may vary depending on the administration procedures used by your organization.

$ sudo yum install mod_php
Loaded plugins: fastestmirror, security
Setting up Install Process
Loading mirror speeds from cached hostfile
 * base: mirror.i3d.net
 * extras: nl.mirror.babylon.network
 * updates: mirror.prolocation.net
base                                                                                   | 3.7 kB     00:00
extras                                                                                 | 3.4 kB     00:00
mariadb                                                                                | 2.9 kB     00:00
updates                                                                                | 3.4 kB     00:00
updates/primary_db                                                                     | 4.7 MB     00:01
Package php-5.3.3-49.el6.x86_64 already installed and latest version
Nothing to do

(4)

Now download and install the “wiki-engine.bin” and “yce-wiki.bin” files.

First the wiki-engine, then the yce-wiki. At the completion of the latter, the URL of step () will be linked to the yce-wiki content and any customer special Wiki pages included in your license file will be installed.

Before installation:

Executing:

Completed installation:

Manual setup

The “Manual setup” is a guide that can be used instead of the procedure above, but also serves to verify the procedure made all appropriate modifications. Especially if the httpd configuration file is not alterable by the yce functional user.

(1)

The NetYCE wiki installation distribution files can also be installed on the command line (as 'yce' user).
First upload the downloaded 'wiki-engine.bin' image to your NetYCE server, then install it as user 'yce' using the command: sh wiki-engine.bin.

This will create a file tree under /opt/ycelib/wiki. If a previous installation was found, it is renamed to wiki.0.

Likewise, install the Wiki content image using sh yce-wiki.bin

This will create a file tree under /opt/ycelib/farm/yce-wiki. If a previous installation was found, it is renamed to yce-wiki.0.

If your /opt/yce/etc/yce_setup.xml file has the required attributes for <wiki /> under the <yce name=“(hostname)”> object, then a url-like symlink to the yce-wiki directory might already exist.

(2)

Add an alias (or Cname) to the DNS for this NetYCE server to access the Wiki.
E.g. yce-wiki.my.domain.

(3)

Run - as yce user - /opt/yce/system/yce_setup.pl

Enter the chosen Wiki alias name and domain at the appropriate questions of this setup script.
This will modify the <wiki> attributes in the file /opt/yce/etc/yce_setup.xml

 <wiki domain="my.domain" ip="" local="yes" name="yce-wiki" proto="http" />

(4)

Ensure the Apache mod_php is installed. See the “Regular setup” for details.

(5)

Modify the /etc/httpd/conf/httpd.conf configuration file in the following manner:

1) Define the various VirtualHosts as being based on the server name (instead of ip-address):

 NameVirtualHost *:80

2) Insert a new VirtualHost for the new Wiki alias:

 <VirtualHost *:80>

  ServerName yce-wiki.my.domain
  ServerAlias yce-wiki
  DocumentRoot "/opt/ycelib/wiki"

</VirtualHost>

This section must appear BEFORE the VirtualHost of non-aliased the NetYCE application.

When completed, restart the http server (sudo /etc/init.d/httpd restart).

(6)

The wiki alias specified in the VirtualHost section above must link to the wiki content directory. The content directory is located in /opt/ycelib/farm/yce-wiki. Create a symbolic link from this directory to the specified wiki alias name:
As 'yce' user:

 cd /opt/ycelib/farm
 ln -s yce-wiki yce-wiki.my.domain

Ensure the PHP server can access the session directory to store temporary session information
As 'root' user:

 cd /var/lib
 chown -R yce.nms php

Alternatively:

 cd /opt/ycelib/wiki
 echo "php_value session.save_path '/var/opt/yce/jobs/session'"> .htaccess
 mkdir /var/opt/yce/jobs/session

(7)

When making manual changes to the http configuration file, you need to make an additional step to ensure your changes are not overwritten by future automatic updates.

As yce user, edit the file /opt/yce/etc/yce_setup.xml and modify the <configs> attribute for httpd in keep:

<configs crontab="update" httpd="keep" mysql="update" network="update" />