*************************************************
SELinux Policy Editor for Webmin install document
*************************************************

According to following method, you must install Webmin and SELinux 
Policy Editor.  Before the installation, you need to switch the 
mode of SELinux to permissive mode.


1. Install instructions

1.1. Installation of Webmin

    If Webmin has not been installed on your system, you have to 
    install Webmin anyway. Please refer to the following URL.
    
		http://www.webmin.com/download.html

1.2. Installation of the converter

    The converter converts the inter-configuration files into SELinux 
    original configuration file.
    * Note: You need libselinux-devel, checkpolicy and policy-sources package to compile

    (1) Expand the converter_YYYYMMDD.tgz archive
        
            $ tar xvzf converter_YYYYMMDD.tgz
        
        The 'converter' sub-directry is created.
        
    (2) Edit Makefile
    
        Change to the 'converter' directry. 
        You can edit the "INSTALL_PATH" definition in 'Makefile' file 
        to specify the install path.
    	
    	* The default value is '/etc/security/selinux/converter'.

    	After specifying the install path, compile and install as follows: 
    	
            $ cd converter
            $ vi Makefile
            $ make
            $ su
            # make install
        
    (3) Test converter
    
        To check that the installation of the converter has been finished 
        successfully, type as follows: 
        
            # cd $installpath/converter
            # make
        
        As the result of 'make' command execution, if the following file 
        is created, the installation of the converter has been finished 
        successfully.
        
            $installpath/converter/policy/policy.conf
        
1.3. Installation of SELinux Policy Editor

    (1) Installation
    
        (A) After logging in Webmin as an admin, select the following menu.
        
            Webmin Configuration -> Webmin Modules
            
        (B) Installation of SELinux Policy Editor
        
            First, select the 'selinux_YYYYMMDD.wbm' file  in the 'From local file' 
            input field at the 'Install Module' area. After that, click 
            the 'Install Module' button.
            
    (3) Check of environmental configuration
    
        You should check values in the '/etc/webmin/selinux/config' is correct.
        
        - converter_path : the directry path in which you installed 
                           the converter
        - m4             : the full path for m4 command
        - passwd_path    : the full path for system password file
        - selinux_bin    : the directry path in which there are 
                           SELinux original commands
                           (checkpolicy, setfiles, etc.)
        - policy_file    : the full path for security policy file
        - max_row        : the max number of files in a screen
        - shadow_path    : the full path for shadow password file
        - login_path     : the full path for login command
        - sshd_path      : the full path for SSH Daemon

    (4) Initialization of configuration
	(A) 
	Change to permissive mode.
	# setenforce 0
	(B) Login to Webmin -> Select "SELinux Security-Configuration"
	(C) Select "SELinux Security-Configuration"->
		   "Update configuration"->"update all configuration".
	(D) Reboot.
	Note: To try SELinux Policy Editor run level 3 is recommended, because
policy supports limited services.
