Projman user guide

To make the process of managing projects as smooth as possible for both users and administrators we have created a automated tool, projman, for handling all extrensions and allocations for projects. This tool will be able to handle the bulk of the requests, but for some special cases it will still be required to contact support@uppmax.uu.se  Please see Projman decisions for more info about messages you might get from it.

You run projman on the command line when you are connected to UPPMAX using ssh. You simply give it the information needed to make the changes you want and it will check if the changes are possible. It also displays any general warning flags about the project that could affect the decision.

The options you can give it are

-A or --account   :   The ID of the project you want to change.

# does nothing more than displaying any warning flags the project might have
$ projman -A snic2099-9-99
or
$ projman --account snic2099-9-99

-e or --expiry   :   If you want to specify a new expiry date for the project. Format is YYYY-MM-DD. Can be maximum 6 months from now.

# asks to prolong the project until 2022-12-24
$ projman -A snic2099-9-99 -e 2022-12-24
or
$ projman --account snic2099-9-99 --expiry 2022-12-24

-c or --corehours   :   If you want to change the number of core hours the project has you specify it after the -c option. If you want 5 000 core hours just add -c 5000   If you don't specify anything more than the amount of hours you want, the default time you will get them is 1 month. If you want to have it for longer, see the duration option below.

# asks for 20 000 core hours for 1 month
$ projman -A snic2099-9-99 -c 5000
or
$ projman --account snic2099-9-99 --corehours 5000

-M or --cluster   :   If you for some reason want to request more core hours on a different cluster than the one you are connected to at the moment, you can add -M nameofcluster

# asks for 5 000 core hours on the Rackham cluster for 1 month
$ projman -A snic2099-9-99 -c 5000 -M rackham
or
$ projman --account snic2099-9-99 --corehours 5000 --cluster rackham

-d or --duration   :   If you want to specify a end date for how long you want the resources. Format is YYYY-MM-DD. Without this option the script will use the default value of 1 month from now. The maximum value is 6 months from today.

# asks for 5 000 core hours until 2022-12-20
$ projman -A snic2099-9-99 -c 5000 -d 2022-12-20
$ projman --account snic2099-9-99 --corehours 5000 --duration 2022-12-20

If you want to combine all the options in one go that is not a problem.

# extend the project to 2022-12-24, increase the core hours as well.
$ projman -A snic2099-9-99 -e 2022-12-24 -c 5000 -d 2022-12-20
or
$ projman --account snic2099-9-99 --expiry 2022-12-24 --corehours 5000 --duration 2022-12-20

If you want to have different duration dates for core hours, proj and nobackup you can just run the script once per resource and change the date each time.