Use this page to specify options for the registration of an asset with the asset repository. Default values for the options are used if you do not specify a value. If the asset is an OSGi application, additional information about bundle download status is displayed.
To view this administrative console page, click Select options for importing an asset page on the asset import and update wizards.
. This page is similar to theSpecifies a logical name for the asset. An asset name must be unique within a cell and cannot contain an unsupported character.
An asset name cannot begin with a period (.), cannot contain leading or trailing spaces, and cannot contain any of the following characters:
Unsupported characters | ||
---|---|---|
/ forward slash | $ dollar sign | ' single quote mark |
\ backslash | = equal sign | " double quote mark |
* asterisk | % percent sign | | vertical bar |
, comma | + plus sign | < left angle bracket |
: colon | @ at sign | > right angle bracket |
; semi-colon | # hash mark | & ampersand (and sign) |
? question mark | ]]> No specific name exists for this character combination |
This Asset name field is the same as the Name setting on an Assets page.
Information | Value |
---|---|
Data type | String |
Specifies a description for the asset.
Specifies the directory to which the product imports the asset file.
Information | Value |
---|---|
Data type | String |
Units | Full path name |
Specifies the type of asset content. Examples of asset type include Java archive (JAR) files, shared libraries, enterprise application archive (EAR) files, and enterprise bundle archive (EBA) files.
The asset type suggests the content of the asset. For example an asset packaged as a JAR file might contain a web module, portlet and web service, and an asset packaged as an EBA file contains an OSGi application.
This setting is read-only. You cannot edit this setting.
Information | Value |
---|---|
Data type | String |
Units | File type |
Default | none |
Specifies access permissions for asset binaries that the product expands to the asset binaries destination URL.
You can specify file permissions in the text field. You can also set some of the commonly used file permissions by selecting them from the list. List selections overwrite file permissions set in the text field.
You can set one or more of the following file permission strings in the list. Selecting multiple options combines the file permission strings.
Multiple-selection list option | File permission string set |
---|---|
Allow all files to be read but not written to | .*=755 |
Allow executables to execute | .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 |
Allow HTML and image files to be read by everyone | .*\.htm=755#.*\.html=755#.*\.gif=755#.*\.jpg=755 |
Instead of using the multiple-selection list to specify file permissions, you can specify a file permission string in the text field. File permissions use a string that has the following format:
file_name_pattern=permission#file_name_pattern=permission
where file_name_pattern is a regular expression file name filter (for example, .*\\.jsp for all JSP files), permission provides the file access control lists (ACLs), and # is the separator between multiple entries of file_name_pattern and permission. If # is a character in a file_name_pattern string, use \# instead.
If multiple file name patterns and file permissions in the string match a uniform resource identifier (URI) within the asset, then the product uses the most stringent applicable file permission for the file. For example, if the file permission string is .*\\.jsp=775#a.*\\.jsp=754, then the abc.jsp file has file permission 754.
1 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war |
2 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jsp |
3 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF/MANIFEST.MF |
4 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/WEB-INF/classes/MyClass.class |
5 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/mydir/MyClass2.class |
6 | /opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/META-INF |
The file pattern matching results are:
/opt/WebSphere/profiles/AppSrv01/installedApps/MyCell/MyApp.ear/MyWarModule.war/MyJsp.jspand you specify the following file pattern string:
.*MyApp.ear$=755#.*\.jsp=644The file pattern matching results are:
Access permissions specified here are at the asset level. You can also specify access permissions for asset binaries in the node-level configuration. The node-level file permissions specify the maximum (most lenient) permissions that can be given to asset binaries. Access permissions specified here at asset level can only be the same as or more restrictive than those specified at the node level.
Information | Value |
---|---|
Data type | String |
Specifies the assets to which this asset is related.
Information | Value |
---|---|
Data type | String |
Default | none |
Specifies whether the product examines the asset references specified during asset importing or updating and, if validation is enabled, warns you of incorrect references or fails the operation.
An asset typically refers to resources using data sources for container-managed persistence (CMP) beans or using resource references or resource environment references defined in deployment descriptors. The validation checks whether the resource referred to by the asset is defined in the scope of the deployment target of that asset.
Select true (enable the check box) for resource validation and to stop operations that fail as a result of incorrect resource references. Select false (empty check box) for no resource validation.
Information | Value |
---|---|
Data type | String |
Default | false (empty check box) |
For an enterprise bundle archive (EBA) asset, displays the current bundle download status for all bundles in the asset. This item is only displayed if your asset is an EBA asset, which means that it contains an OSGi application.
You cannot update an EBA asset until bundle downloads are complete from any previous update, and until the business-level application that uses the asset has picked up the previous updates by being restarted. Before you try and update bundle versions, you can use the EBA dependency information to check the bundle download status of the asset. The status displayed is one of the following values:
If bundle downloads for the asset are complete, or no bundle downloads are required, you can update the asset using either of the methods described in Maintaining bundle versions for an EBA asset.
If bundle downloads for the asset are complete, and a new version of the EBA asset is available, restart the business-level application to bring the EBA composition unit up-to-date and to run the newer configuration.