Ensim Pro for Linux 10.1.0 Hotfix 08 Release notes Introduction ------------ Reourceop utility does not work with EPL 10.1.0 Hotfix information ------------------ Hotfix date: 11/01/2007 Applies to: Ensim Pro for Linux - 10.1.0 for FC2, FC4, RHEL4, CentOS4.3, CentOS4.4 Hotfix file information ----------------------- This hotfix contains the following files: FC2: epl-cli-pack-10.1.0-fc.2.23.i386.rpm : 40c45b1c51e04d7ebe27c79bd276b9b0 epl-framework-10.1.0-fc.2.23.i386.rpm : 0fae146acabd4e84f6c539b7d2fdd606 epl-frontend-common-10.1.0-fc.2.23.i386.rpm : 74a06b3d894fb7dd831b921fdffa9b10 eplapi-10.1.0-fc.2.23.i386.rpm : 0ff502d625d6147697103fc477a93d63 FC4: epl-cli-pack-10.1.0-fc.4.23.i386.rpm : 8f75c6dd2e5d6b3bb0dba65f43dc330b epl-framework-10.1.0-fc.4.23.i386.rpm : e2c017e2a3e78f3c9d51a73328eecc01 epl-frontend-common-10.1.0-fc.4.23.i386.rpm : f419becea70231e4d1e8e229fef73327 eplapi-10.1.0-fc.4.23.i386.rpm : 3f842ed788574f07331d677a63492d71 RHEL4: epl-cli-pack-10.1.0-rhel.4ES.23.i386.rpm : d5c6f2adda05ae8e54d352417ee4f964 epl-framework-10.1.0-rhel.4ES.23.i386.rpm : 53d57f31f6fcd07f1df732b0e455f843 epl-frontend-common-10.1.0-rhel.4ES.23.i386.rpm : 6c9d3a5135a7d198dc44257c56f804e8 eplapi-10.1.0-rhel.4ES.23.i386.rpm : dca5a693e7664e21c1f409b0776125c0 Resolved Issues --------------- This hotfix resolves the following issue. Issue: Reourceop utility does not work with EPL 10.1.0 Resolution: Resourceop utility is replaced by CLI's which can be used for customization. Prerequisites : N/A Time requirements and customer impact : N/A Installing the hotfix --------------------- This section explains how to install the hotfix. Pre-installation instructions: Installation instructions: 1] Upgrade the RPM. FC2: rpm -Uvh epl-cli-pack-10.1.0-fc.2.23.i386.rpm rpm -Uvh epl-framework-10.1.0-fc.2.23.i386.rpm rpm -Uvh epl-frontend-common-10.1.0-fc.2.23.i386.rpm rpm -Uvh eplapi-10.1.0-fc.2.23.i386.rpm FC4: rpm -Uvh epl-cli-pack-10.1.0-fc.4.23.i386.rpm rpm -Uvh epl-framework-10.1.0-fc.4.23.i386.rpm rpm -Uvh epl-frontend-common-10.1.0-fc.4.23.i386.rpm rpm -Uvh eplapi-10.1.0-fc.4.23.i386.rpm RHEL4: rpm -Uvh epl-cli-pack-10.1.0-rhel.4ES.23.i386.rpm rpm -Uvh epl-framework-10.1.0-rhel.4ES.23.i386.rpm rpm -Uvh epl-frontend-common-10.1.0-rhel.4ES.23.i386.rpm rpm -Uvh eplapi-10.1.0-rhel.4ES.23.i386.rpm CentOS4: Note: Use RHEL4 rpms for CentOS4. Post-installation instructions: 1] service epld restart Help ---- Customizing a GUI resource : A resource is a customizable unit. You can customize 5 types of resources in the EPL Control Panel. They are, XML files, XSL stylesheets, JavaScript files, Image files and HTML stylesheets. In order to customize any resource you need to first download it to a local file, make the required changes to the local file, and upload the file to the server. The various operations supported by EPL Resource Customization are list, download, customize and revert. The 'list' operation is used, when you want to list all the available resources, or any one particular resource. The 'download' operation is used, when you want to download a particular resource to a local file. The 'customize' operation is used, when you want to upload a local resource to the EPL Control Panel, thereby customizing a particular resource. The 'revert' operation is used, when you want to revert back any customization that has been done previously using the customize operation. The four commands that can be used to perform the above mentioned operations are. /usr/bin/ensim/GUIResourceList /usr/bin/ensim/GUIResourceDownload /usr/bin/ensim/GUIResourceDownload /usr/bin/ensim/GUIResourceRevert In order to view the help information for each of the above commands, you need to specify the context first. That is, you must specify the role and the username to view the help for these commands. /usr/bin/ensim/GUIResourceList --role --user --help /usr/bin/ensim/GUIResourceDownload --role --user --help /usr/bin/ensim/GUIResourceCustomize --role --user --help /usr/bin/ensim/GUIResourceRevert --role --user --help The supported roles are ISP, reseller and siteadmin. If you are an ISP or a reseller, then the username is your login name. If you are a site administrator, the username must be of the form @. Where the username is the site administrators login name and the domainname is name of site. 1] The GUIResourceList Command Usage: GUIResourceList [options] Options marked with * are required options. Options: -h, --help show this help message and exit --role=ROLE Role [isp|reseller|siteadmin] * --user=USER User * --skin=SKIN Skin [cocoon|mercury|classic] Default: cocoon --url=URL URL Here, 'skin' specifies the skin name to be used. The 'url' specifies the relative URL of the resource that needs to be customized. This should begin with /static/. 2] The GUIResourceDownload Command Usage: GUIResourceDownload [options] Options marked with * are required options. Options: -h, --help show this help message and exit --role=ROLE Role [isp|reseller|siteadmin] * --user=USER User * --skin=SKIN Skin [cocoon|mercury|classic] Default: cocoon --url=URL URL * Here, `skin' specifies the skin name that is to be used. The `url' specifies the relative URL of the resource that has to be downloaded. This should begin with /static/. The output of the download operation can be redirected to a local file. 3] The GUIResourceCustomize Command Usage: GUIResourceCustomize [options] Options marked with * are required options. Options: -h, --help show this help message and exit --role=ROLE Role [isp|reseller|siteadmin] * --user=USER User * --url=URL URL * --skin=SKIN Skin [cocoon|mercury|classic] Default: cocoon --uri=URI URI * Here, `skin' specifies the skin name that is to be used. The `url' specifies the relative URL of the resource that is to be customized. This should begin with /static/. The 'uri' specifies the local resource to be used for customizing the URL. This parameter can be specified in the standard URI syntax, which means that any of the following are valid arguments for this option: /tmp/logo.gif file:///tmp/logo.gif http://mywebsite.com/logo.gif ftp://myuser:password@mysite.com/logo.gif 4] The GUIResourceRevert Command Usage: GUIResourceRevert [options] Options marked with * are required options. Options: -h, --help show this help message and exit --role=ROLE Role [isp|reseller|siteadmin] * --user=USER User * --url=URL URL * --skin=SKIN Skin [cocoon|mercury|classic] Default: cocoon * Here, `skin' specifies the skin name that is to be used. The `url' specifies the relative URL of the resource that has to be reverted back. This should begin with /static/. Examples: 1] Case 1: Adding/Editing/Removing Links on the ISP Administrator Navbar An ISP Administrator, wants to add/edit/remove some links on the ISP Administrator Navigation Bar. For example, if the ISP Administrator wants to customize the Navigation Bar for the cocoon skin, the steps are: First, make sure that the resource /static/xml/isp.navbar.xml exists: /usr/bin/ensim/GUIResourceList --role isp --user admin --url /static/xml/isp.navbar.xml Next, download the resource: /usr/bin/ensim/GUIResourceDownload --role isp --user admin --url /static/xml/isp.navbar.xml > /tmp/isp.navbar.xml Now, make the required changes to /tmp/isp.navbar.xml. In this case, search for the nodes, and add the nodes as per your requirement. Next, upload the resource to the Control Panel: /usr/bin/ensim/GUIResourceCustomize --role isp --user admin --skin cocoon --url /static/xml/isp.navbar.xml --uri /tmp/isp.navbar.xml The resource has now been customized. To ensure that the resource has been customized, list the resource again: /usr/bin/ensim/GUIResourceList --role isp --user admin --url /static/xml/isp.navbar.xml Now, login to the Control Panel and/or refresh the Control Panel GUI to see the changes. To revert back your changes: /usr/bin/ensim/GUIResourceRevert --role isp --user admin --skin cocoon --url /static/xml/isp.navbar.xml 2] Case 2: Re-positioning the Login Info section on the ISP Navbar An ISP Administrator, wants to reposition the Logged In Section on the Navigation bar, so that it appears below the links on the Navbar. For example, if the ISP Administrator wants to customize the Navigation Bar for the cocoon skin. Here are the steps he would follow: First, make sure that the resource /static/xsl/isp.navbar.xsl exists: /usr/bin/ensim/GUIResourceList --role isp --user admin --skin cocoon --url /static/xsl/isp.navbar.xsl Next, download the resource: /usr/bin/ensim/GUIResourceDownload --role isp --user admin --skin cocoon --url /static/xsl/isp.navbar.xsl > /tmp/isp.navbar.xsl Now, make the required changes to /tmp/isp.navbar.xsl. In this case, search for the section:
Make the necessary modifications by copying the entire
node, and repositioning it to your liking. Then save the changes. Next, upload the resource to the Control Panel: /usr/bin/ensim/GUIResourceCustomize --role isp --user admin --skin cocoon --url /static/xsl/isp.navbar.xsl --uri /tmp/isp.navbar.xsl The resource has now been customized. To make sure that the resource is indeed customized, list the resource again: /usr/bin/ensim/GUIResourceList --role isp --user admin --skin cocoon --url /static/xsl/isp.navbar.xsl Now, login to the Control Panel and/or refresh the Control Panel GUI to see the changes To revert back your changes: /usr/bin/ensim/GUIResourceRevert --role isp --user admin --skin cocoon --url /static/xsl/isp.navbar.xsl 3] Case 3: Customizing an arbitrary image An ISP Administrator wants to customize a particular image on the Shortcuts section of your Control Panel for the cocoon skin. For example, the image is the Section Image of the "Email" section. Therefore, you need to customize the URL /static/images/email.gif. Assuming that the new image exists at http://www.ensimsite.com/images/inbox.gif, you can customize the "/static/images/email.gif" resource in one step: /usr/bin/ensim/GUIResourceCustomize --role isp --user admin --skin cocoon --url /static/images/email.gif --uri http://www.ensimsite.com/images/inbox.gif -------------------------------------------------------------------------------- Ensim Corporation 1366 Borregas Avenue Sunnyvale, California 94089