Store credentials
In a keyring file, you can store credentials for URLs that require authentication, such as repositories, proxy servers, and response files as you copy a package from the command line.
IBM Packaging Utility uses the Eclipse infrastructure in Installation Manager to save credentials to a keyring file. When you use the -keyring file -password password argument, Eclipse creates a keyring file if a keyring file does not exist. If you are using an existing keyring file, the new credentials are added and the previous credentials are not overwritten.
You must create a keyring that only you can access when saving credentials using the Save Password option for a shared instance of Packaging Utility. If you do not specify your own keyring, other users can use your saved credentials. Create a keyring using the -keyring and -password options with pucl.
Multiple users can use the same instance of Packaging Utility in administrator mode. Some repositories might require credentials. When you use the Save Password option without specifying a keyring that only you can access, other users can use your credentials to access the repository.
If you do not save your credentials, you are prompted to enter your credentials each time you access the repository.
For information about the command-line arguments, see Command-line arguments for pucl . For additional information about keyring files, see the Eclipse workbench user guide .
Procedure
To store credentials in a keyring file as you copy a package:
- From a command-line utility, open the Packaging Utility directory.
Operating system Administrator Nonadministrator Windows 2000 and Windows XP Professional C:\Program Files\IBM\PackagingUtility C:\Documents and Settings\user\IBM\PackagingUtility Windows Vista, Windows 2008, and Windows 7 C:\Program Files\IBM\PackagingUtility C:\Users\user\IBM\PackagingUtility Linux and UNIX /opt/IBM/PackagingUtility /opt/IBM/PackagingUtility
- Run the following command:
pucl copy package_ID -prompt -repositories source_repository -target destination_repository -keyring keyring_file -acceptLicenseWhen entering credentials using the -prompt option, the password is not masked. When you enter your password, you can see the text of the password. Include quotation marks around filepaths that have spaces.
Results
- Your credentials are saved in the keyring file in the location that you specified with -keyring keyring_file.
- The package you specified is copied to the destination location.
What to do next
After creating a keyring file, you can use the -keyring keyring_file -password password options with the copy command to authenticate with a protected repository. If the credentials have already been saved to the keyring file, you no longer need the -prompt option in your command.