Welcome to the (none) Documentation
(none) Version: (none)
You can view this document as one long file by clicking here.
You can view this document as one long file by clicking here.
These are the default directories created by installing Ape Base Compile System. You will undoubtably make some of your own as well.
[root@localhost:/ape/_compile]$ tree ./include/ ./include/ |- _blank_build_script-copy_to_create_your_own.sh # actual file copy in ./scripts lis linked to |- ape_config.sh # master configuration |- ape_functions.sh #common functions file |- ape_init.sh # (none) init file |- ape_variables.sh # internal system variables `- scripts_common.sh # the file that your script will eventually execute to compile with [root@localhost:/ape/_compile]$ (none)This is where the non-user portions of the compile system live. Please fo not edit them unless you really, absolutely, positively know what you are doing. The only exception is the file "ape_config.sh", which you can customize to suit your desired environment. Customizing "ape_config.sh" will alter default configuration values for all scripts.
This is a place for you to store arbitrary scripts which you have set to run using Triggered Commands. For more information about when you can trigger commands, see variables such as APE_CONF_POST_CONFIGURE_CMD in the (none) section. If a file named " ${APE_CONF_PACKAGE_NAME}- ${APE_CONF_VERSION}.post-install.sh" is created in the ./post-install directory, it will be assumed to be your intended APE_CONF_POST_RPM_INSTALL_CMD script. It will be included in the disrtibution as " /${APE_CONF_BASE_DEST_PARENT_DIR} /${APE_CONF_DEST_DIR_LABEL} /${APE_CONF_VERSION}/bin/${APE_CONF_PACKAGE_NAME}-${APE_CONF_VERSION}.post-install.sh" but not run at RPM installation until entered as the value of APE_CONF_POST_RPM_INSTALL_CMD.
[root@localhost:/ape/_compile]$ tree -dl ./rpms/ ./rpms/ |- centos # centos rpms | |- el4 | | |- i386 | | |- ia64 | | `- x86_64 | |- el5 | | |- i386 | | |- ia64 | | `- x86_64 | |- gold4 # final production ready rpms | | |- i386 | | |- ia64 | | `- x86_64 | `- gold5 # final production ready rpms | |- i386 | |- ia64 | `- x86_64 |- misc # unknown or undetected *nix brand | |- gold # final production ready rpms | | |- i386 | | |- ia64 | | `- x86_64 | |- i386 | |- ia64 | `- x86_64 |- mrepo-src # mrepo mirror dir if mrepoHttpd is built |- mrepo-www # mrepo web root if mrepoHttpd is built |- up-mrepo.sh # script for updating the local mrepoHttpd install `- redhat -> centos # symlinked back to ./centos [root@localhost:/ape/_compile]$ (none)
There are three RPM archive directories created by default. They are ./rpms/centos, ./rpms/misc and ./rpms/redhat which is a symbolic link to ./rpms/centos. Additionally, (none) will create a directory tree for your OS or disro if it can be detected, but release subdirectories will not be created for non-RHEL based disributions. If the OS or distro can't be detected, created RPMs will be placed in the ./rpms/misc tree.
Red Hat based distributions will contain subdirectories for the release, such as ./rpms/centos/el4. Though a Fedora tree is not created at installation, it will also contain directories such as ./rpms/fedora/fc7 when needed.
The "./rpms" directory will be kept orderly even if mounted remotely from machines of differing architectures, provided you use mostly default names and locations for produced RPMS. If the mrepohttpd ("./scripts/ape.mrepoHttpd-2.2.8.sh") is built and installed, it will utilized the "./rpms" sirectory as it's source. As you find builds you are happy with, you may want to copy the RPM to your gold repository and have the rest of your non-development architecture feed from that. You can also build an RPM directly to the gold directories by using the -g option for -r when you run your script.
This is your primary working directory. A copy of "_blank_build_script-copy_to_create_your_own.sh" is there waiting for you to create your own compile scripts with. The user scripts will be discussed in detail later.
[root@localhost:/ape/_compile]$ tree ./skels/ ./skels/ |- epm-4.1 # skel directory for the 4.1 version of EPM | `- bin | `- link_to_current.epm-4.1.sh # script to automate linking the 4.1 version to current |- mrepoHttpd # generic mrepoHttpd skel dir - all version will get these | |- LICENSE # duh | |- conf # the apache conf directory | | |- conf.d | | | `- mrepo.conf #settings for mrepo - not a vhost | | |- extra # apache extras | | |- magic #mime file | | |- mime.types # mime types file | | |- mrepoHttpd.conf # minimal httpd.conf | | `- original# original httpd configs for reference | `- etc # local /etc | |- init.d | | `- mrepoHttpd # file usable for chkconfig | |- mrepo.conf # mainly empty mrepo.conf | |- mrepo.conf.d | | `- apelocal.repo.conf # the ape local mrepo repositories | |- sysconfig | `- yum.repos.d | `- apelocal.repo # a yum config for checking the local repo |- mrepoHttpd-2.2.8 # version specific skel - only applied to 2.2.8 | `- bin | `- link_to_current.mrepoHttpd-2.2.8.sh # link build of 2.2.8 to the current version `- link_to_current._template_.sh # template link-to-current file [root@localhost:/ape/_compile]$ (none)
This may look complicated, but it's not. There's just a lot in example stuff there. The function of the ./skels directory is to store files you wish copied to your installation directory after the make install step.
[root@localhost:/ape/_compile]$ tree -ld ./util ./util |- bin # semi-stable extra utilities |- dev-extra # unstable extra utilities |- docs # documentation | |- images | `- src | |- about | |- conf_vars | |- root_dirs | |- sys_vars | |- tut | `- usage `- tmp-build # a temp directory for (none) to use [root@localhost:/ape/_compile]$ (none)
There is some neat stuff in here, but most of it is experimental. The ./tmp-buld directory is exactly what it sounds like. A temporary storage space. As such, you may wish to clean it out every so often.
The main thing of interest to you should be the documentation (./doc) subdirectory. The rest of the ./util directory will have to wait to be documented until each part is stable.