j9 ~ d dl mZ d dl mZ d dl mZ d dlZd dlZd dlZd dlZd dlZd dl Z d dl
Z
d dl Z d dl Z d dl
Z
d dlZd dlZd dlmZ d dlmZ d dlZd dlZd dlZd dlZd dlZd dlZd dl Zd dl m Z d dl m Z d d l!m"Z"m#Z# d d
l$m%Z%m&Z&m'Z' d d l(m)Z) d d lm*Z* d d
lm+Z+ d dlm,Z,m-Z-m.Z. d dl/m0Z0m1Z1m2Z2m3Z3 d dlm4Z4 d dl5m6Z6m7Z7 d dlm8Z9 d dl:m;Z; d dlm?Z? d dl@mAZAmBZB d dlCmDZD d dlEmFZG d dlHmFZI d dlJmKZKmLZLmMZMmNZNmOZOmPZP d dlQmRZR d dlSmTZTmUZU G d d e Z8 G d d e8 ZVd d!iZW G d" d#eX ZYdS )$ )print_function)division)absolute_importN)Set) iteritems)FormattedException) resolve_username_and_doc_root)CP_NAMEdocroot)NoDomain NotSupported
IncorrectData) exec_utility) clselectctl) clpassenger) ClUserSelectClSelect ClExtSelect)APP_STARTED_CONSTENABLED_STATUSDISABLED_STATUSBaseSelectorError)validate_env_vars)format_summaryAPI_1ClSelectExcept)NodeJSConfigError)Website) NodeManager)PythonAppFormatVersionget_venv_rel_path)
PythonManager) Environment)mkdir_p file_read
file_writeget_using_realpath_keys get_abs_reldelete_using_realpath_keys)get_perm)_set_ui_configUIConfigExceptionc e Zd ZdS )r N)__name__
__module__ __qualname__ M/opt/cloudlinux/venv/lib64/python3.11/site-packages/clselector/selectorlib.pyr r H s Dr3 r c e Zd ZdZdS )ClSelectDomainNotFoundzK
Custom exception in case if user doesn't have the specific domain
N)r/ r0 r1 __doc__r2 r3 r4 r6 r6 L s Dr3 r6 statusokc z e Zd Zd Zd Zd ZedQd Zed Zed Z edRd Z
edQd Z ed
Z edRd Z
d Zed
Zd Zd Zed Zed Zd ZdRdZed ZdRdZed Zd ZdQdZd Zd Z d Z d Z d Z d Z d Z!d Z"d! Z#dRd"e$d#e%dz d$e&fd%Z'd& Z(d' Z)dRd(e&e$e$f d"e$d#e%dz d$e&fd)Z*dRd*Z+d+ Z, dSd,Z-ed- Z.dRd.Z/dRd/Z0ed0 Z1dTd2Z2dUd4Z3d5 Z4d6 Z5d7 Z6d8 Z7ed9 Z8d: Z9ed; Z:d< Z;d= Z Z=dRd?Z>dQd@Z?dA Z@edB ZAdVdCZBdD ZCdE ZDdF ZEdG ZFdRdHZGdI ZHdJ ZIdK ZJedL ZKedM ZLeMdN ZNdO ZOdP ZPdS )WCloudlinuxSelectorLibc l || _ d| _ d| _ d| _ d| _ d| _ d| _ d| _ d | _ d | _ d | _
d | _ | j | j k rLdd l m
} | | _ t | _ t j | _
t j | _ d S | j | j k rLdd lm
} | | _ t' | _ t j | _
t j | _ d S | j | j k rdd
lm} | | _ d S d S ) Nz/usr/bin/selectorctlz+/usr/share/l.v.e-manager/utils/dynamicui.py /usr/sbin/cloudlinux-selectornodejspythonrubyphpr )ApplicationsManager)
PhpManager) interpreter_SELECTORCTL_UTILITYDYNAMIC_UI_CTL_CMDCLOUDLINUX_SELECTOR_UTILITYNODEJS_INTERPRETERPYTHON_INTERPRETERRUBY_INTERPRETERPHP_INTERPRETERselector_manager apps_managerselector_user_libselector_old_lib$clselect.clselectnodejs.apps_managerrB r clselectclselectnodejsuserclselectctlnodejsuser$clselect.clselectpython.apps_managerr# clselectpythonuserclselectctlpython clselect.clselectphp.php_managerrC )selfrD rB rC s r4 __init__z CloudlinuxSelectorLib.__init__W s[ &$:!"O +J("* "* & $ !% !% $ t 6 6 6 P P P P P P 3 3 5 5D $/MMD !%-%@D "$,$BD ! ! !
!8
8
8 P P P P P P 3 3 5 5D $1OOD !%-%@D "$,$>D ! ! !
!5
5
5 C C C C C C$.JLLD ! ! ! 6
5r3 c f | j | j k rdS | j j dS )za
Checks that selector is able to work on current os environment
:return:
N)rD rK rL
cl_select_libcheck_requirementsrX s r4 check_selector_is_availablez1CloudlinuxSelectorLib.check_selector_is_availabley s:
t 3 3 3 F
+>>@@@@@r3 c n | j || }| || \ }}|S )z7Get doc_root from application config or raise exception)rM get_app_domain$safely_resolve_username_and_doc_root)rX usernameapp_rootdomain_doc_roots r4 safely_resolve_doc_root_for_appz5CloudlinuxSelectorLib.safely_resolve_doc_root_for_app s8 "11(HEE??&QQ 8r3 Nc t | | \ }}ng# t $ r t |dnd|| dd t $ r t ddt
id t $ r t d || dd w xY w||fS )
a8
Safely resolve username and doc_root by domain,
or resolve document root by username,
or resolve document root and username by effective uid
:param user: str -> name of unix user
:param domain: str -> domain of panel user
:return: tuple -> user, doc_root
userrd NzNo such domain: %(domain)szNo such user: %(user)s)rd rj messagecontextz+Nodejs selector not supported for %(panel)spanelz3Domain %(domain)s is not owned by the user %(user)s)r r r6 r
r r
r )rj rd result_userresult_doc_roots r4 ra z:CloudlinuxSelectorLib.safely_resolve_username_and_doc_root s " +H , , , (K
( ) < ;/G"( $
L
T"( $
O++s
A$A;c d}t \ }}| d}nHt | t sd}n0| d | d d}n |dk r |dk rd}n| d dk rd}|S ) z
Check whether selector should be run through "su - user"
:param opts: dict of parsed cli params
:return: True if should be run through su or False if not
TNF--user--domainr
--interpreterrA )r+
isinstancedict)optsresulteuidegids r4 should_be_runned_as_userz.CloudlinuxSelectorLib.should_be_runned_as_user s ZZ
d <FFD$'' FF
(^
#Z(8(@FF
QYY4199FF
/
"e
+
+F
r3 c \ | d dk o | d d uot j dk S )Nrt rA rr r )osgeteuid)rw s r4 should_run_user_without_cagefsz4CloudlinuxSelectorLib.should_run_user_without_cagefs s8 O$- !H~T)!z||q !r3 c . t j | }|S )z
Resolves user eigher with passed username or with getting current
user ID
:param user: str or None -> username to be resolved
:return: obj -> pwd user object
)pwdgetpwnam)rj userdatas r4 _get_user_pwd_dataz(CloudlinuxSelectorLib._get_user_pwd_data s <%%r3 c 6 | |t di d dS dS )z
Check if user and domain are None
:param user: name of unix user
:param domain: domain of panel user
:return: None
NBUser or domain parameter must be specified if current user is rootrk r ri s r4 user_and_domain_checkerz-CloudlinuxSelectorLib.user_and_domain_checker s: B?"C8 8
DDc > ddi} t j rd| d< | S Nr FT)r r ress r4 get_nodejs_selector_statusz0CloudlinuxSelectorLib.get_nodejs_selector_status. s+ !5) == ) +&*C" #
r3 c : d| j j rt nt iS )N PHPSelector)rL r r r r] s r4 get_php_selector_statusz-CloudlinuxSelectorLib.get_php_selector_status5 s 1F1W l~~]lmmr3 c | j }| | |S # t $ r }| | cY d }~S d }~ww xY wN)rL get_summaryr get_selector_statusr r )rX r r s r4 r z!CloudlinuxSelectorLib.get_summary8 s )'3355C JJt//11 2 2 2J ) ) )%%a(( ( ( ( ( ( ( )s AA
A-A("A-(A-c > ddi} t j rd| d< | S r )r# r r s r4 get_python_selector_statusz0CloudlinuxSelectorLib.get_python_selector_status@ s+ !5) ?? + +&*C" #
r3 c t t j | j S # t $ r t ddi w xY w)Nrl zNo such user: `%(user)s`)r r pw_dirKeyErrorr )rj s r4
get_user_homez#CloudlinuxSelectorLib.get_user_homeG sR <%%, , 5"
s 7c t }| | |S r )r r r r )rX r s r4 get_nodejs_summaryz(CloudlinuxSelectorLib.get_nodejs_summaryP s: mm''))
4++--...
r3 c $ | | }| j | j k r | j |||d }n<| j | j k r | j |||d }nt
|g}| j | j k r| d | | |:| j | j k r| d | | | ||| }|S )aD
Runs script to execute other script inside user app environment
:param user: str -> owner of application
:param app_root: str -> application directory
:param script_name: str -> name of script
:param script_args: list of str -> arguments for the script
:return: dict
npmr? z
run-scriptNz--)
r rD rH rM get_binary_pathrI NotImplementedErrorappendextend_run_interpreter) rX rj rc script_name script_args user_homeinterpreter_pathcmdrx s r4
run_scriptz CloudlinuxSelectorLib.run_scriptU s% &&t,, t 6 6 6 # 0 @ @h 5 2 2
!8
8
8 # 0 @ @h 8 5 5 &'' ' t 6 6 6 JJ| $ $ $
; " 4#:::
4 JJ{ # # #&&sIx@@
r3 c : t j | t j || t j t j d } | \ }}n'# t $ r}t d| |dd d}~ww xY wd |j
| | }t d ||fD rKt j
}d | d
} t j | }
|d | d |
d
z
}dt# j | i} | ddi |j
dk r
d|j
| d< | S )z
Run interpreter in users environment
:param cmd: list -> command to execute
:param user_home: -> user home directory
:param app_root: -> app path
:return: dict
T)argscwdstdoutstderrtextz6run-script call: `%(args)s` failed with error: %(err)s)r r rk Nz%returncode: {}
stdout:
{}
stderr:
{}
c 3 B K | ]}d | v V dS )z
out of memoryN)lower).0outputs r4 z9CloudlinuxSelectorLib._run_interpreter.. s/ PPV&,,..0PPPPPPr3 z/proc/z/limitsaD
Out of memory error may be caused by hitting LVE limits
or "Max data size", "Max address space" or "Max resident set" process limits
Please check LVE limits and process limits. Readjust them if necessary
More info: https://docs.cloudlinux.com/shared/cloudlinux_os_components/#known-restrictions-and-issues
process limits "z":
datar8 successr zScript exit code: warning)
subprocessPopenr} pathjoinPIPE communicateOSErrorr r
returncodestripanygetpidpathlibPath read_textbase64 b64encodeencodedecoder ) r r rc pr r r
output_stringpidproc_limits_pathprocess_limitsrx s r4 r z&CloudlinuxSelectorLib._run_interpreterr s
"',,y(;; ?:?
G
G
G ]]__NFFF 2$'22" "
&
L LLNN LLNN PP?OPPP P P
)++C 4 4 4 4 $\*: ; ; E E G GN P (8 P P >L P P P
M &*=+?+?+A+ABBIIKKL
x+,,, <1 CQ\ C CF9
s
A% %
B /BB c | j | j k r| j | S | j | j k r| j S d S Nwebsite)rD rK rL r rH )rX r s r4 get_fullz CloudlinuxSelectorLib.get_full s[ t 3 3 3(44W4EE E t 6 6 6(4466 6 7 6r3 c t }t j }t | D ]\ }}||xx dz
cc< | D ]}||d |d< | S )a_
Add selector usage statistics (amount of
domains that use some version, etc)
Fist parameter is an array with such format:
[{'version': '5.6'}, {'version': '7.6'}]
Output is an array with such format:
[{'version': '5.6', 'users': 10}, ...]
:type versions_list: list
:rtype: list
version total_users)r get_user_version_map collectionsCounterr )
versions_listuser_version_mapversion_user_maprj r items r4 _add_statistics_fieldz+CloudlinuxSelectorLib._add_statistics_field s (>>>>@@&.00 &'7 8 8 + +MD' W % % % * % % % %! D DD"24 ?"CD r3 c ^ | j | j k rSt | j d }t |dt
}t
j | }n#| j | j }ni }| d dk r d|d i}n|}|S )zG
Retrieves supported versions list and default version
Fjson)r api_versionNr8 ERRORrl )
rD rK r r r r r loadsrL get)rX r json_dataselectorctl_resultrx s r4 get_supported_versionsz,CloudlinuxSelectorLib.get_supported_versions s t 3 3 3D ,--99%@@D&tFNNNI!%I!6!6
"
.!%!6!B!B!D!D !# ! !( + +w 6 6 29 =>FF'F
r3 c |r|gnd}| j | j k r| j || S | d S )z3
Retrives current version for user
Nz Supported only by php selector)rD rK rL get_current_versionr )rX rj rd s r4 r z)CloudlinuxSelectorLib.get_current_version sS 'vv4 t 3 3 3(< '(9 :OO > > >I%%)))I*>?????")9===== >
"?33s )A
AAc | j | j k r| S | j | j k r| S | j | j k r| S d S r )rD rH r rI r rK r r] s r4 r z)CloudlinuxSelectorLib.get_selector_status ss t 6 6 62244 4
!8
8
82244 4
!5
5
5//11 1 6
5r3 c | j j S r rL r r] s r4 php_selector_is_disabledz.CloudlinuxSelectorLib.php_selector_is_disabled s (999r3 c | j j S r r r] s r4 php_selector_is_enabledz-CloudlinuxSelectorLib.php_selector_is_enabled s $55r3 c | j | j k rdS ddlm}m} n# t
$ r Y dS w xY w | rQ| s= | }|r1 |d }| d sdS n# t $ r Y nw xY wdS )z
Returns True when MultiPHP system default PHP version is alt-php and PHP Selector is NOT disabled
For details please see LVEMAN-1170
Fr )is_ea4_enabledread_cpanel_ea4_php_confdefaultzea-phpT) rD rK clcagefslib.selector.configurer r ImportErrorr
startswithr )rX r r conf default_phps r4 check_multiphp_system_defaultz3CloudlinuxSelectorLib.check_multiphp_system_default s
t 3 3 35 _ _ _ _ _ _ _ _ _ 55 > D$A$A$C$C ++--D
"&y/K&11(;; $ #t$ Dus
++ A9 9
BBc | j | j | j fv rqt | D ]Z\ }} | || }n.# t
$ r!}| | cY d }~c S d }~ww xY w|t k r|c S [t S | } |d }n5# t $ r( | d| j
d| j cY S w xY wd |D }t | |z
r^| dd
t | |z
d| j
d| j d S d
} g }
t | D ]u\ }} | r5t | j t! | n4t | j t! | | d z
} v| t% | k rt S | d
k r&d d
| t% | |
iS | d |
S )Navailable_versionszcorrupted answer from z --json --summary --interpreter c h | ]
}|d S r r2 )r xs r4 z?CloudlinuxSelectorLib.set_supported_versions.. s I I I!9 I I Ir3 z invalid alternative versions (z, z), see z --summary --interpreter z for valid versionsr r r8 z>WARNING: only {} of {} commands was successful. Errors was: {}z&All commands were failedErrors was: {})rD rH rI r set_version_statusr r r r r rE setkeysr r enable_versionstrdisable_versionr r ) rX versionsr enable_disablerx r r alternatives_listalternatives_versionsr errors_list to_enables r4 set_supported_versionsz,CloudlinuxSelectorLib.set_supported_versions s 79P R R R+4X+>+>
"
"' 1 ! 4 4^W M MFF( 1 1 1 --a00000000001[((!MMM ) //11 > )*> ? > > >%%%)))4+;+;'= > >
>
>
> > !J I7H I I I x}} "7 7 '%%%IIc(--// 2 25J JKKKKTMfMfMf$$$&' '
'
"+H"5"5 GY
I)**99#g,,GGGG)**::3w<<HHH qLGG c(mm # #
q[[ ++16'3x==++V+V
%% '77=vk7J7JL L
Ls/ A
A- A( A-(A- B% %/CCc B | j | j | nv# t j j j $ r t dd|id t j j t f$ r,}| t | cY d }~S d }~ww xY wt S N No such php version: %(ver)sverrk ) rL switch_default_versionrQ clselectexceptr NoSuchAlternativeVersionBaseClSelectExceptionr r r r )rX r r s r4 set_default_versionz)CloudlinuxSelectorLib.set_default_version8 s :$0%< 79PRVRf g g g//77 7 h gr3 c t j s&t j st j rKt | j dgd \ }}}|dk r)| d || S d S )Nz--sync-conf=allT)r r z"Can not sync UI with reason: {} {})detect is_cpanelis_pleskis_dar rF r r )rX retcodeoutr s r4 r z CloudlinuxSelectorLib.update_uiq s K !2!2 Kflnn K ,'*;),;;GZY`;aa (MM$'''*@
>
>
>55c!ff========
>M 4 3s 4A B 4!BB B c | j | j k rb | j ||| nC# t j j $ r,}| t | cY d }~S d }~ww xY wt S r )
rD rK rL set_optionsrQ r, r. r r r )rX optionsr r r s r4 rF z!CloudlinuxSelectorLib.set_options s t 3 3 3
>%11'7G1TTTT*@
>
>
>55c!ff========
>s 0 A0!A+%A0+A0c > || dd }||dk r't d | j | j | j k r@t
j d| }|st dd|id | d S |S t |t t f r;| j | j k r t t | S t | S |d
k rt d d|id |S ) a3
Attempts to get or verify version to be passed to external program
Currently supported version is one digit (6 or 8).
If version is None, return a default version
:param version: str or None -> version to be verified or found
:return: str -> digit as string
Nr z {} default version not definedz(?P\d+)z#Incorrect selector version: %(ver)sr* rk r nativez Unsupported version: %(ver)s)
r r r r rD rH rematchgroupru intfloatr )rX r r ms r4 resolve_versionz%CloudlinuxSelectorLib.resolve_version sO ? " 6 6 8 8 < <=NPR S SO &/R*?*?$%E%L%LTM]%^%^___ 4#:::H 0/BB P(5Z6;_5M*O *O P P Pwwy)))&& gU| , , $ 4#:::3w<<((( 7||# h -K.3W-="? "? @ @
@r3 c
| || | | }|!t t j | }| || \ }} | j | j k r+| j ||||| |||| | j
|
no| j | j k r%t j
||||| n:| j | j k r*| j ||||| ||||| j
|
nD# t j j $ r-} | t% | cY d} ~ S d} ~ ww xY wt& S )a
Creates application for specified user, interpreter and version
If user is None we hope that the external application resolves a user
Currently NodeJS supported only
:param domain: str -> domain of the application
:param app_root: str -> app path relative to user home
:param app_uri: str -> URI path of the application
:param version: str or None -> version of the interpreter
:param user: str or None -> username of user who owns the app
:param app_mode: str or None -> application mode (development or production)
:param startup_file: str or None -> main application file
:param env_vars: json_string or None -> enviroment variables for application
:param entry_point: Application entry point (used only for python interpreter).
:param passenger_log_file: Passenger log filename
:return: dict
N)rf env_vars startup_file domain_name entry_pointrM passenger_log_filerf )r rf app_moderS rT rU rM rW )rx )r rQ r r r ra rD rI rO createrM rJ rQ clselectctlrubyrH r, r. r r r )
rX rc app_urir rj rd rY rT rS rV rW rf r s
r4
create_appz CloudlinuxSelectorLib.create_app s $
$$T6222&&w// (H)=)=>>H BB4PPh A 4#:::%,,T8WgX`6>\9?[:>:K`r - t t t t !T%:::(//h[c/dddd!T%<<<%,,(GWx %| &T5F[m -
&< A A A11Q1@@ @ @ @ @ @ @ A s )B*D E("E
EEc t j |j | }t j | }t j |j }| |t j z s||k rt dd| id t j | st dd| id |S )z
Resolve app root to absolute path and checks if it exists
:param app_root: str -> relative a user homedir app path
:param userdata: obj -> pwd user object
:return: str -> absolute path to app
z No such application: %(app)sapprk ) r} r r r realpathr sepr isdir)rc r app_path
real_app_path real_homes r4 _get_application_pathz+CloudlinuxSelectorLib._get_application_path s 7<<::((22
G$$X_55 '' BF(:;; A
QZ@Z@Z -K.3X->"@ "@ A A
Aw}}]++ A -K.3X->"@ "@ A A
A r3 c
t }| |d | | }| ||
t
j t
j
| }t
j |j }|
|t
j z st dd|id | j
r| j
|| nd}
fd|r| d pg ng D } | r|| vrt dd|id t
j | st dd|id t# |d 5 }
|
} | dt) j | i ddd n # 1 swxY w Y |S # t. $ r.} | t3 | d d
cY d} ~ S d} ~ ww xY w) a
Reads file and returns its content as Base64 string
:param app_root: str -> path to app relative to user home
:param user: str -> username to resolve app path
:param config_path: str -> file to be read (relative to app path)
:return: dict
Nz&Configuration file not found: %(path)sr rk c h | ]?}t j t j | @S r2 r} r r` r r frc s r4 r z8CloudlinuxSelectorLib.read_app_config.. I
G RW\\(A 6 6 7 7
r3 config_filesrbr strerrorrI )r rC r r rf r} r r` r r r ra r rM get_app_configr existsopenreadr r r r Exceptionr getattr)rX rc config_pathrj rx r full_config_pathre
app_configregistered_pathsrk r r rc s @r4 read_app_configz%CloudlinuxSelectorLib.read_app_config s !!## $$T4000**400--hAA 7++BGLL;,O,OPPG$$X_55 **9rv+=>> G & 4
JNIZdT&55dHEEE`d
@JRz~~n55;PR
08H H H G & 4
w~~ .// G &(8 9
N&--
Ivvxx
vv'7'='='D'D'F'F GHHH
I
I
I
I
I
I
I
I
I
I
I
I
I
I
I M N N N11'!Z2L2LMM M M M M M M NsC H AG8, H 8G<<H ?G< H
H=#H82H=8H=c | |d | | }| || t j t j | }t j |j }| |t j z st dd|id | j r| j || nd} fd|r|
d pg ng D } | r|| vrt dd|id t |d 5 }
|
t! j | ddd n # 1 swxY w Y t$ S # t& $ r.} | t+ | dd cY d} ~ S d} ~ ww xY w)
a
Saves data passed as Base64 string to specified file
:param content: data for saving in app's config
:param app_root: str -> path to app relative to user home
:param user: str -> username to resolve app path
:param config_path: str -> file to be read (relative to app path)
:param content: str -> Base64-encoded string
:return: dict
Nz)Invalid configuration file path: %(path)sr rk c h | ]?}t j t j | @S r2 ri rj s r4 r z8CloudlinuxSelectorLib.save_app_config..: rl r3 rm wbro rI )r r rf r} r r` r r r ra r rM rp r rr writer b64decoder rt r ru )
rX rc rv contentrj r rw re rx ry rk r rc s
@r4 save_app_configz%CloudlinuxSelectorLib.save_app_config# sL
$$T4000**400--hAA 7++BGLL;,O,OPPG$$X_55 **9rv+=>> J & 4
JNIZdT&55dHEEE`d
@JRz~~n55;PR
08H H H J & 4
N&--
3(11222
3
3
3
3
3
3
3
3
3
3
3
3
3
3
3 N N N11'!Z2L2LMM M M M M M M NsB F (F8 F FF F F
G #G G Gc t | }|| d|g n)| | d| g nt d |S )Nrs rr r )listr r )rj rd r result_argss r4 _add_user_or_domainz)CloudlinuxSelectorLib._add_user_or_domainN sf 4jj
F 3 4 4 4 4
$ / 0 0 0 0 !eff fr3 Fc Z | || | j | j k rt dd| j id |D ] }| j ||| t S # t j j $ r,}|
t | cY d}~S d}~ww xY w)an
Uninstall described modules for user's webapp
:param app_root: directory with webapp
:param modules: comma-separated list of modules to uninstall
:param user: name of unix user
:param domain: domain of user
:param skip_web_check: skip check web application after changing its properties
:return: None
zJUninstall command is available only for python interpreter, not %(interp)sinterprk N) r rD rI r rO uninstallr rQ r, r. r r )rX rc modulesrj rd skip_web_checkmoduler s r4 uninstall_modulesz'CloudlinuxSelectorLib.uninstall_modulesY s
$$T6222 t 6 6 6 g d . " "
!
H
H%//hGGGG
H
&< : : :11#a&&99 9 9 9 9 9 9 :s !A* *B*>!B% B*%B*r2 c | || | j | j k rn | j |||| j t S # t j j $ r,}|
t | cY d}~S d}~ww xY w| j | j k r |r+|D ]'}| j |||d|| j (n?|r&| j ||d||| j nd} |
| S t S # t j j $ r,}|
t | cY d}~S d}~ww xY wt dd| j id )a
Install described modules for user's webapp
:type domain: domain of user
:param user: name of unix user
:param app_root: directory with webapp
:param skip_web_check: skip check web application after change it's properties
:param spec_file: file containing modules and their versions to install
:param modules: list of installed modules
:return: None
)r rM Nz9Please, specify modules or requirements file with modules Unknown interpreter: %(interp)sr rk )r rD rH rO installrM r rQ r, r. r r rI r )
rX rc rj rd r spec_filer r r r s
r4 install_modulesz%CloudlinuxSelectorLib.install_moduless s
$$T6222 t 6 6 6
#%--dH^;?;L . N N N
#" *@
>
>
>55c!ff========
>
!8
8
8
# ?") V V -55dHfdcqCGCT 6 V V V VV ?)11$$ AO^b^o 2 q q q q VC 99#>>> #" *@
>
>
>55c!ff========
>
!< d . " "
s< #A B&!B
B
B&A+D E-!EEEc j | |d | j | j k r!t j || n | || }n3# t $ r t j dd|i t $ r d}Y nw xY w| j | j | j fv r$| j
|||| j n t j dd| j i nC# t j j $ r,}| t' | cY d}~S d}~ww xY wt( S )z
Destroy specified application root directory and user name
:param app_root: Application directory
:param user: name of unix user
:return: dict
Nz\No such application or it's broken. Unable to find app-root folder by this path %(app_root)src rk )rf rM r r )r rD rJ rQ r[ destroyrg TypeErrorClSelectExceptions WrongDatar6 rH rI rO rM InterpreterErrorr, r. r r r rX rc rj rf r s r4 destroy_appz!CloudlinuxSelectorLib.destroy_app s
$$T4000 : 4#888(00x@@@@ $ # C CD( S SHH ,6![ '! . $ $ $ #HHH$ #(?AX'YYY)11$8?C?P 2 R R R R -= A!)4+; <> > > > &< : : :11#a&&99 9 9 9 9 9 9 :sB 1C+
A! C+ !-BC+ BAC+ +D+?!D& D+&D+c | |d | || }| j | j | j fv r#| j |||| j n t j dd| j i t S # t j j
$ r,}| t | cY d}~S d}~ww xY w)z
Start specified application root directory and user name
:param app_root: Application directory
:param username: name of unix user
:return: dict
Nr r rk )r rg rD rH rI rO startrM r r r rQ r, r. r r rX rc rb rf r s r4 start_appz CloudlinuxSelectorLib.start_app s
$$Xt444
:;;HhOOH D$;T=T#UUU%++Hh$J[\\\\(9 = %t'7 8: : : : &< : : :11#a&&99 9 9 9 9 9 9 :s A1B
C
!C?C
C
c | |d | || }| j | j k r#| j |||| j nP| j | j k r#| j |||| j n t j dd| j i t S # t j j
$ r,}| t | cY d}~S d}~ww xY w)z
Destroy specified application root directory and user name
:param app_root: Application directory
:param username: name of unix user
:return: dict
Nr r rk )r rg rD rH rO restartrM rI r r r rQ r, r. r r r s r4 restart_appz!CloudlinuxSelectorLib.restart_app s
$$Xt444 :;;HhOOH 4#:::%--h(DL]^^^^!T%<<<%--h(DL]^^^^(9 = %t'7 8: : : : &< : : :11#a&&99 9 9 9 9 9 9 : B B8 8C8 !C3-C83C8c | |d | || }| j | j k r#| j |||| j nP| j | j k r#| j |||| j n t j dd| j i t S # t j j
$ r,}| t | cY d}~S d}~ww xY w)z
Start specified application root directory and user name
:param app_root: Application directory
:param user: name of unix user
:return: dict
Nr r rk )r rg rD rH rO stoprM rI r r r rQ r, r. r r r s r4 stop_appz CloudlinuxSelectorLib.stop_app s
$$T4000 :;;D(KKH 4#:::%**48TEVWWWW!T%<<<%**48TEVWWWW(9 = %t'7 8: : : : &< : : :11#a&&99 9 9 9 9 9 9 :r c d|z dz }d|z dz }t j t j | ddd D ]}t j | s t
|d }| |v s||v ra| | | }| || } t || d # t $ rY t j \ }
}
} t j
t t j | Y w xY wdS ) z
Replace old prompt and env_var in binaries in new environment
Working with bytes here, because of python binary
(:*binrn )moder} N)r globr} r r rb r& replacer' IOErrorsysexc_infor r~ r tracebackprint_tb) new_envold_envnew_relold_rel
old_prompt
new_prompt
venv_bin_file old_activate
_new_activate new_activatere
traceback_s r4 6_replace_old_env_and_prompt_in_binaries_in_environmentzLCloudlinuxSelectorLib._replace_old_env_and_prompt_in_binaries_in_environment sx Gmc)1133
Gmc)1133
!Yrw||GS%'M'M N N
J
JM7== //
JJ#,]#F#F#FL ~~''<77: ;U;U(4(<( > C
C
c L t j | s&t | t j | | dS t j | D ]5}t
j t j | | | 6t j | dS )z
Move all items from old directory of application to new directory
:param old_directory: full real path to old directory of applicaton
:param new_directory: full real path to new directory of applicaton
N)
r} r rq r% renamelistdirshutilmover rmdir)
old_directory
new_directoryr s r4 _move_app_from_old_dir_to_newz3CloudlinuxSelectorLib._move_app_from_old_dir_to_newA s w~~m,, $ M " " " Im] 3 3 3 3 3
=11
N
N BGLL = =}MMMM H] # # # # #r3 c
| j | } t ||| }n%# t $ r t j d|z w xY wt
|| \ }}t
|| \ }} t j | n3# t $ r&}
t j
t |
d}
~
ww xY w| ||| } t || | t j
| # t $ r Y nw xY w| ||| } t ||| }
n%# t $ r t j
d|z w xY w|
d }|
d }| j ||| | j }| j | j k rPt' || \ }}t
|| \ }}t
|t' ||| d \ }}n| j | j k rt
|t* j | j j j | \ }}t
|t* j | j j j | \ }}nt7 t* j |d }t* j |d }t* j | }t* j | st+ j | t? j || | ! || | j | j k r| " ||| | | j | j k rt' || \ }}n:| j | j k r | j # || }nt7 | j j $ ||| }| j% }t ||| d } | tL k rmtO j( || || ) d
d } tO j* |||| j |||d | tO j+ || tY ||| |||< | j - || dS )
a
Move user's application from directory to new_directory
:param user: application owner. unix like user name
:param old_directory: current directory with application
:param new_directory: new directory for application
:return: None
8No such application (or application not configured) "%s"Nr r app_summaryr r rI
app_statusrW rT rf rT rW ).rM get_user_config_datar( r r NoSuchApplicationr) r check_directory
ValueErrorr r r AppRootBusyrO _get_environmentnamerD rI r" rH r} r r rN environmentsDEFAULT_PREFIXr dirnamerq makedirsr r r r _get_prefixr$ r r r unconfigurer configurer r* write_full_user_config_data) rX rj r r full_configrx old_absr new_absr r new_user_summaryold_user_summaryold_user_app_summaryrf r env_namer* rel_venv_old_envre _new_envr r new_env_dirprefix environmentr r passenger_log_file_to_sets r4 _relocatez CloudlinuxSelectorLib._relocateS s< '<0? @ @
@ @ ( 2$W-(99 --=m-L : N NNR t 6 6 6 -dM B BMC%h KHa &'mSIII!LN NKHaa
!8
8
8%dBGLL&3BG-M -M N NKHa &dBGLL&3BG-M -M N NKHaa &'' '',,x,,',,x,,gooh// w~~k** % K $ $ $ GW%%% **7G<<< t 6 6 6 G GQXZacj k k k t 6 6 6)$
>>IAvv
!8
8
8*66t]KKFF%'' ',9EEhPTV\]] ((**1,T=+NN|\
* * * #D- 8 8 8(3M(B(F(FG[]a(b(b % !$
ud>NPVai/9./I5N
P
P
P
P
m 4 4 4 #4 DDD%/ M" 55dKHHHHHs? . "A:B
B?!B::B?C? ?
D D 'D9 9"Ec X | j | j | j fv r| ||| n2| j | j k r"t
j |||d nC# t
j j $ r,}|
t | cY d}~S d}~ww xY wt S )a=
Call selectorctl to relocate application from old_app_root to new_app_root
:param user: application owner
:param old_app_root: current application directory (current application name)
:param new_app_root: new application directory (new application name)
:return: json
N)
rD rI rH r rJ rQ r[ relocater, r. r r r )rX rj old_app_root new_app_rootr s r4 r z CloudlinuxSelectorLib.relocate s : D$;T=T#UUUt\<@@@@!T%:::(11$ lTXYYY&< : : :11#a&&99 9 9 9 9 9 9 :s A A" "B"6!B B" B"c d}t j | || }t j ||| }t j | t j | k rdS t j | }t j | st j | t j || dS )a
:param old_doc_root: path to old doc root of application
:param old_alias: old alias (uri) of application
:param new_doc_root: path to new doc root of application
:param new_alias: new alias (uri) of application
:return: None
r N) r} r r r` r rb r r rC ) old_doc_root old_alias new_doc_root new_aliasr old_htaccess_filenew_htaccess_filenew_htaccess_paths r4 _transit_htaccess_filez,CloudlinuxSelectorLib._transit_htaccess_file s GLL y( K K GLL y( K K
7 - . .7##$566 7 7 F GOO,= > >w}} .// + K) * * * %'899999r3 c | j | } t ||| }n5# t $ r( t j d | w xY w| ||| } t ||| } n5# t $ r( t j d | w xY w| d }
| d } ||
nt j
| } | j |||| }
|
j }|| d t k ru|| dd }t# j ||| | j
|dd ||d
|
t# j |||
| | | t# j || n || }| | |
|| | |d
< |||d< | j || dS )a
Change application URI
:param user: application owner. unix like user name
:param directory: directory with application. (app-root)
:param alias: new alias (app-uri) for application or None if change only the domain
:param new_doc_root: NEW doc_root to transit application to
:param new_domain: NEW domain to transit application to
:return: None
z8No such application (or application not configured) "{}"r r Nr r rW TtransitrT r )r r r\ rd )rM r r( r r r r r r r get_aliasrO r rD r r r r r r r r r )rX rj r r
new_domainr r rx apps_summaryold_app_summaryr r r r r r s r4 _transitz CloudlinuxSelectorLib._transit sf '<(B(BCWY](^(^ % !$ 9d>NPVX\^g%J~4N#<
>
>
>
>
T9iQ]lx y y y y i 0 0 0 0 # + ' ' i y Y Y Y )
9 !#-Jx 55dKHHHHHs . 2A ;B
2B?c |d}n| || \ }}| j | j | j fv r| ||||| nB| j | j k r$t j |||| nt nC# t j
j $ r,}| t | cY d}~S d}~ww xY wt S )aV
Call selectorctl to transit application to new_app_uri
:param user: application owner
:param app_root: application directory (application name)
:param new_app_uri: new uri or None if change only the domain
:param new_domain: new domain or None if change only the app_uri
:return: json
NrX )ra rD rI rH r rJ rQ r[ r r r, r. r r r )rX rj rc new_app_urir r re r s r4 r z CloudlinuxSelectorLib.transit( s :! # "&"K"KDR\"]"]< D$;T=T#UUU
dHlJ TTTT!T%:::(00xWc0dddd)+++&< : : :11#a&&99 9 9 9 9 9 9 :s BB C&!C
C
Cc d}|r, | | }n# t j $ r Y nw xY w| j ||j | |dk rt j d dS )z
Install nodejs extensions to new nodejs environment and change
symlink //node_modules to new environment.
Raise exception `WebAppError` if npm will return non-zero code
r z t j dd } t j j d | t j dj z < j d S )NrW rT r
%s_version)r r r r rD r rM r )
r r rx r r rf r rX rj r s
r4 actionz5CloudlinuxSelectorLib._change_version..action s #D) 4 4 4(3I(>(B(BCWY](^(^ % !$ 5$:JF]e/9./I5N
P
P
P
P
i 0 0 0FMK "<$2B#B C 9 9$ L L L L Lr3 )rd r r z,An error occured during changing version. %sN)rM r r( r r r rO r r rD as_dict_create_environment_ensure_version_enabledr r8 rI r rH r r summaryr _get_info_about_webappcheck_response_from_webappr )rX rj r r r old_environmentnew_environmentinstalled_extensionsuser_summary_datar
app_domainr r r rx r rf r s ```` @@@@@r4 _change_versionz%CloudlinuxSelectorLib._change_versiono s '<R S S S S
!8
8
8 , ,T9oOc d d d ( / 5 5-dI?PQQ y) ,,..5 1 H HVZ [ [z M M M M M M M M M M M M M
k%@@% ! A
&1
k
k
k(45cfi5ijjj
k
FHHHHHs! 7 "A< G H*HHc 4 | j | j | j fvrt | j | j k rM| j || dt j }|t j k rddiS | j || t k r| |||| n| ||| t S # t j j $ r,}| t% | cY d}~S d}~ww xY w)ax
Call selectorctl to change current interpreter version to new_version for application
:param user: application owner
:param app_root: application directory (application name)
:param new_version: new nodejs interpreter version
:param skip_web_check: skip check web application after change it's properties
:return: json
app_versionr8 zThis application was created by too old version of python selector and we cannot change version without migration to the new application format. To do that you can use `cloudlinux-selector migrate` command or just click button in web UI.)r N)rD rH rI r rM rp r r! LEGACYget_app_statusr r, _change_version_for_stopped_appr rQ r, r. r r )rX rj rc new_versionr r. r s r4 change_versionz$CloudlinuxSelectorLib.change_version s> : (?AX'YYY)) 4#::: " / > >tX N N R R!#9#@ B B "8"??? #L //h??CTTT$$T8[Q_$```` 44T8[QQQ &< : : :11#a&&99 9 9 9 9 9 9 :s% A8C ;AC D+!D DDc $ | j | j k s| j | j k ro| || } | j |||| d S # t $ r,}t j d | d }~ww xY wd S )NzRUnable to set environment variables in htaccess file for the application.Error: {})
rD rI rH rg rM add_env_vars_for_htaccessrt r r r )rX rj rc rS rf r s r4 set_variables_for_litespeedz1CloudlinuxSelectorLib.set_variables_for_litespeed s t 6 6 6$:JdNe:e:e;;D(KKH
!;;D(HV^_____
(4 &s
;f:es A
B
!'BB
c | j | } t ||| }
n%# t $ r t j d|z w xY w| j | j k r8|6|
d |k r*|
d t j k rt j
d |||
d< |||
d< |||
d< |||
d< |||
d k s|j|g||
d k rN||
d < | j | j k r9| j
||| } | j ||| | |
|d
k rdn||
d < | j || } t! j | }
t |||
}|d }| j }|d
}|d }t! j | |6|
d !t! j |||| j ||| n4t! j |||| j |||
d | t! j || | j || | ||| dS )al
Set application mode, environment variables and startup_file for application
:param config_files: names of config files (such as requirements.txt or etc)
:param entry_point: the specified entrypoint for application
:param user: application owner. unix like user name
:param directory: directory with application
:param app_mode: expected application mode
:param env_vars: dict with environment variables for application
:param startup_file: main file for application
:param passenger_log_file: Passenger log filename
:return: None
r NrS r. zUnable to set environment variables. Application was created too long time ago. Please, migrate your application to newer version before changing interpreter versionrY rV rm rT rI rW r r r )r )rf rW r )rM r r( r r r rD rI r! r/ r r rO _get_full_path_to_startup_file
setup_wsgir r r$ r _unconfigurer r r r6 )rX rj r rY rS rT rV rm rW r app_config_datastartup_file_full_pathenv user_summaryuser_app_summaryr r rf
htaccess_paths r4 _set_variablesz$CloudlinuxSelectorLib._set_variables s. '</#t'>>>-1-B-a-a !$. .* )44T9F\^ijjj!- ASVX@X@X^p 45'88yIIC&.t44L 6tY U U $W-E__&&-F' 2H ,Z 8M $m < < < <#(;(;N(K(K(S%dIud>NPVai9KM M M M M %dIud>NPVai3B3F3F~3V3V9KM M M M D),,, 55dKHHH ((y(CCCCCs . "Ac
" |O t t j | } n.# t t f$ r | d cY S w xY wd} | j | j | j fv rA| j
|| t k r | |||| |||| n |
|||| |||| t S # t j j $ r,}
| t% |
cY d}
~
S d}
~
ww xY w)ak
Call selectorctl to set variables for application
:param config_files: names of config files (such as requirements.txt or etc) (only for python)
:param entry_point: the specified entrypoint for application (only for python)
:param user: application owner
:param app_root: application directory (application name)
:param app_mode: application mode
:param env_vars: json_string with environment variables for application
:param startup_file: main file for application
:param passenger_log_file: Passenger log filename
:return: json
Nz/wrong json format for environment variable list)r r r r r r rD rH rI rM r0 r rA _set_variables_for_stopped_appr rQ r, r. r ) rX rj rc rY rS rT rV rm rW env_dictr s r4
set_variablesz#CloudlinuxSelectorLib.set_variables8 s`
i,TZ-A-ABB z*
i
i
i556ghhhhh
i H : D$;T=T#UUU%44T8DDHYYY##D(Hh Vaco$68 8 8 8 33D(HhXd4? Oac c c &< : : :11#a&&99 9 9 9 9 9 9 :s. !& &AAA8C D"!D D Dc | j | }|S # t $ r}|j |j dcY d}~S d}~ww xY w)z
Retrieves info about all installed interpreters and user(s) applictions
:param user: User name for read applictions. If None all users will be processed
:return: Dict with info
)rx rm N)rM get_applications_users_infor rl rm )rX rj result_dictr s r4 get_apps_users_infoz)CloudlinuxSelectorLib.get_apps_users_infoZ sc ? +GGMMK ? ? ? iAI>> > > > > > > ?s
A<AAc | | j | s!t j ||d dS )z
Check whether particular interpreter version is enabled and raises
exception if not
:param username: user to include in exception
:param new_version: new interpreter version
zversion is not enabledN)rL is_version_enabledrQ r UnableToSetAlternative)rX r2 rb s r4 r# z-CloudlinuxSelectorLib._ensure_version_enabledf sF $77 DD r)@@;Xpqq q r rr3 c " | || | j || }| j |||d }t | }| j |||d }|D ]7} | | # t j j
j $ r Y 4w xY w| j | } || | d| j
z < | j || dS )z
Changes version for stopped application
:param username: application owner
:param app_root: application directory (application name)
:param new_version: new nodejs interpreter version
:return: None
Nr )r# rM get_interpreter_version_for_apprO r" r r8 r rQ r, r r r rD r )
rX rb rc r2 old_versionr' r r( r rx s
r4 r1 z5CloudlinuxSelectorLib._change_version_for_stopped_appp s*
$$[(;;;'GGRZ[[ /CCHhXceijj _ 7 7 9 9:: /CCHhXceijj' I
11)<<<<*9O
&;;HEE
@K
8 \D,< <= 55h
KKKKKs B((CCc | j | } |r || | d< |r || | d< |r*|| | d k r || | d< |r || | d< |r || | d< ||dk r || | d< n d| | d< | j || | ||| dS ) a
Sets new app_mode, environment variables and startup file for stopped NodeJS application
:param config_files: names of config files (such as requirements.txt or etc) (only for python)
:param entry_point: the specified entrypoint for application (only for python)
:param str username: application owner
:param str app_root: application directory (application name)
:param str app_mode: New application mode, can be None
:param dict env_vars_dict: New environment variables, can be None
:param startup_file: New startup file, can be None
:param passenger_log_file: Passenger log filename
:return: None
rY rS rT rV rm NrI rW )rM r r r r6 )
rX rb rc rY
env_vars_dictrT rV rm rW rx s
r4 rC z4CloudlinuxSelectorLib._set_variables_for_stopped_app s &;;HEE
8/7Jx , =/2=Jx / @3?Jx 0 ).@B.F.F9KJx !5 6 69=Jx !5 6 55h
KKK ((8]KKKKKr3 c l t t | d d S )z
Retrieves major version from full. If already short, return it with no difference
:param version: Full/short
:return: Short version as string
.r )r rN splitr s r4 get_major_version_from_shortz2CloudlinuxSelectorLib.get_major_version_from_short s+ 3w}}S))!,--...r3 c t t d } t }| D ]}| | dS )z
Replace mysqli extension to nd_mysqli for defaults.
Warning: only for PHP. See LVEMAN-1399 for details
:return:
rA N)r r get_all_alternatives_datar r list_extensions)alt_php_versions_list
cl_ext_select alt_php_vers r4 replace_mysqliz$CloudlinuxSelectorLib.replace_mysqli si !%Xe__%N%N%P%P%U%U%W%W X X #
0 7 7K ) )+ 6 6 6 6 7 7r3 c t j ddg t j ddg t j g d t j dg | dS )zf
Setup php selector for work
(suggested to use after native php is installed)
cagefsctlz--force-updatez
--remount-all)r= zmake-defaults-configz--jsonrt rA z//usr/share/l.v.e-manager/utils/cache_phpdata.pyN)r check_outputr\ )clss r4 setup_selectorz$CloudlinuxSelectorLib.setup_selector s .> ?@@@ o >??? !C !C !C D D D !R STTT r3 c | j | j k rt t j rt
S | j t
S # t $ r,}| t | cY d}~S d}~ww xY w)zn
Scan users home dirs for .htaccess files and import
applications to new config file.
N) rD rI r r< r? r rM $import_legacy_applications_to_configrt r r )rX r s r4 run_import_applicationsz-CloudlinuxSelectorLib.run_import_applications s
t 6 6 6% %
\^^ : B B D D D : : :11#a&&99 9 9 9 9 9 9 :s A
B !B>B B c | j | j k rt d | j || t
S )z_
Convert applications created in older selector
versions to new format
z/Migration is only available for python selector)rD rI r rM migrate_applicationr )rX rj rc s r4 run_migrate_applicationz-CloudlinuxSelectorLib.run_migrate_application sM
t 6 6 6% '< = =
=
--dH===r3 )NNr )NNNNNNN)NNF)NNFNr2 )NF)Qr/ r0 r1 rY r^ rg staticmethodra r{ r r r r r r r r r r r r r r r r r r r r r r r r& r/ r r4 r r rv r7 r: r rD rF rQ r] rf rz r r r r r r r r r r r r r r r r r r r, r3 r6 rA rE rI r# r1 rC rU r\ classmethodra rd rg r2 r3 r4 r; r; V s[ 1 1 1D A A A ., ., ., \.,` \. ! ! \!
\
\
\ \ " " "H \ n n n) ) ) \ \
: * * \*X7 7 7 7 \ * *H H H H 4 4 42 2 2: : :6 6 6 0*L *L *LX
gn PT 8 8 8
c3h
#
PWZ^P^
jn
B HLim* * * *X \ $3N 3N 3N 3Nj)N )N )N )NV \ 4* * * *X" " "H: : :(: : :,: : :, J J \J,% % %N $ $ \$"pI pI pId ( : : \:23I 3I 3I 3Ij 0q q q& \6A A A AF": ": ":H UD UD UDn : : :D
?
?
?
?r r rL L L6 L L LB / / \/ 7 7 \ 7
[
: : :
r3 r; )Z
__future__r r r r r r r r} r r rK r r r r typingr future.utilsr cldetectlibr< clselect.clselectctlnodejsuserrQ clselect.clselectexceptclselect.clselectctlpythonclselect.clselectctlrubyclselect.clselectpythonuserclselect.clselectnodejsuserclcommon.clexceptionr clcommon.clpwdr clcommon.cpapir
r clcommon.cpapi.cpapiexceptionsr r
r cllimits.libr r r r r r clselect.baseclselectr r r r r clselect.clselectctlphpr r r r clselect.clselectnodejsr clselect.modelsr $clselect.clselectnodejs.node_managerr rT r! r" &clselect.clselectpython.python_managerr# (clselect.clselectpythonuser.environmentsr$ PythonEnvironment(clselect.clselectnodejsuser.environmentsNodeJsEnvironmentclselect.utilsr% r& r' r( r) r* secureior+ clconfig.ui_config_libr, r- r6 r objectr; r2 r3 r4 r s & % % % % % & & & & & &
" " " " " " % % % % ! ! ! ! " " " " " " " " 3 3 3 3 3 3 8 8 8 8 8 8 + + + + + + + + P P P P P P P P P P % % % % % % 8 8 8 8 8 8 8 8 8 8 g g g g g g g g g g g g < < < < < < 9 9 9 9 9 9 9 9 H H H H H H 5 5 5 5 5 5 # # # # # # < < < < < < A @ @ @ @ @ U U U U U U U U U U U U D D D D D D D D ' ^ U U U U UF U U U U Ur3